3. Installation and Configuration. 3.1 Java Development Kit (JDK)

Transcription

1 3. Installation and Configuration 3.1 Java Development Kit (JDK) The Java Development Kit (JDK) which includes the Java Run-time Environment (JRE) is necessary in order for Apache Tomcat to operate properly as this is a Tomcat prerequisite. Download the Java SE Development Kit from Sun Microsystems website html After completing the download execute the JDK file jdk-7u15-windows-x64.exe) and follow the on-screen instructions. If you follow the default installation settings, the Installation directory is C:\Program Files\Java\jdk1.7.0_15\ 3.2 Apache Tomcat Download Apache Tomcat 5.5 from and make sure to select the Binary Distributions as shown in the following figure

2 Execute file apache-tomcat exe and follow the on-screen instructions by accepting the start of the installation wizard and accepting the license agreement. Select Normal installation for the Select the type to install and click Next. Specify a new port number to access the Tomcat server from a web browser or leave the default port to Indicate a User Name and Password for the Administrator The next windows will ask to specify the location of the Java Virtual Machine. The path should be filled in automatically assuming you have already installed the JDK earlier.

3 Click Next to install into the default location or specify a new path in the Destination Folder and then click Next. Now click Next and wait for the installation to complete. When this is finished uncheck the boxes to View the Readme unless you wish to view it and Start Tomcat Server as the Tomcat server will be tested through Eclipse (Section 3.3) with the Sysdeo plug-in to confirm that the plug-in and Tomcat server are both working correctly. 3.3 Eclipse Download eclipse indigo from The Eclipse IDE for Java Developers is recommended.

4 The installation package is a compressed ZIP file so any extraction software that can handle ZIP files such as WinZip ( or WinRar ( are required. Using the extraction software, extract the files to a suitable location on your hard disk such as C:\Program Files\eclipse. Locate the eclipse folder in the location that you extracted the files to and execute eclipse.exe When you execute Eclipse for the first time you must select a workspace where all your saved projects will be stored. Check Use this as the default and do not ask again checkbox in order to make this the default location and not receive any more notifications. 3.4 Sysdeo Tomcat Launcher Plugin Now the Sysdeo Tomcat Eclipse plug-in will be installed to make it easy to enable/disable the Tomcat server from within eclipse. The installation of the plug-in does not differ from other Eclipse plug-ins: After downloading the plug-in from or search for the plug-in from the eclipse website. Unzip and place the com.sysdeo.eclipse.tomcat_x.x.x (where x.x.x represents the version number) folder into the Eclipse's "plug-ins" directory, and start Eclipse. Verify that the plug-in has been installed by selecting from the menu bar Help About Installation Details then select the Plug-ins tab and look for the following entry shown in the picture below:

5 Eclipse normally uses a Java Runtime Environment (JRE), and not a full Java Development Kit (JDK), but Tomcat must have access to a JDK. You should, therefore, first define a JDK for Tomcat. From the menu bar select Window Preferences Java and select the Installed JREs tab by clicking on the left hand side of the Java tab: As you can see only a JRE is available. Press the "Add..." button to add a JDK to the list. Select Standard VM and press the "Next" button:

6 Select the Directory button to specify the path to find the JDK that we downloaded. When this is complete everything about the JDK will be filled in automatically so select Finish to complete the addition.

7 Now uncheck the JRE and check the newly added JDK that was added. Select OK and restart Eclipse to confirm the changes. You should now tell the plug-in where your Tomcat system is located. From the menu bar select Window Preferences Tomcat and select 1. Tomcat version number to be Version 6.x 2. Tomcat home (this automatically sets the configuration file) to be Directory path where you installed Tomcat\Apache Software Foundation\Tomcat 6.0 or if you used the default path provided by Tomcat then the path would be C:\Program Files\Apache Software Foundation\Tomcat 6.0 Now select Apply to confirm the changes.

8 Still within the Preference tab expand the Tomcat tab by clicking on the left hand side of the tab and within the Tomcat base indicate the path where Tomcat is to be located at either Directory path where you installed Tomcat\Apache Software Foundation\Tomcat 6.0 or if you used the default path provided by Tomcat then the path would be C:\Program Files\Apache Software Foundation\Tomcat 6.0. Now select Apply to confirm the changes.

9 Now select the JVM Setting within the Tomcat tab and select from the drop down menu for JRE to be the JDK that we added earlier. Now select Apply to confirm the changes and then select OK. You do not need to complete the Tomcat Manager App as this was already specified during the installation of Apache Tomcat. However, if you are not able to login to the Apache Tomcat Manager which is shown later in this section, then you may return to Tomcat Manager App and fill in a username and password to gain access. Select OK to exit the Preferences window.

10 Tomcat can be activated and deactivated either inside or outside of Eclipse. The advantage of controlling this functionality through Eclipse is to utilize Eclipse s debugging features. Therefore, it is very beneficial to use the Sysdeo plug-in and the following step will indicate how to setup and test the plug-in. After installing the Sysdeo plug-in the following menu should have appeared in the menu bar and new icons should have appeared in the tool bar: If this is not the case, then to add these changes to the menu and tool bar go to Window Customize Perspective and the following window will be presented. In the Tool Bar Visibility tab within Tool Bar Structure make sure the Tomcat field has a check mark inside the box as shown in the figure above. Selecting the Menu Visibility tab, within the Menu Structure make sure the Tomcat field has a check mark inside the box:

11 Selecting the Command Groups Availability tab, within the Available command groups make sure the Tomcat field has a check mark inside the box and then select OK to exit:

12 Now it is time to test the Sysdeo plug-in and verify that Tomcat can be enabled and disable through Eclipse. To enable Tomcat, select the following icon from the Tool Bar : This will cause an output in the Console tab indicating that Tomcat is operational: To confirm this is true, using a web browser (IE, Firefox, Google Chrome, Safari, etc.) enter in the following web address The following web page should be presented which indicates that Tomcat is now running:

13 To access Apache Tomcat Manager, under Administration select Tomcat Manager. This will present a new window asking for a username and password. Enter the username and password that was chosen during the installation of Apache Tomcat: The following administrative page will be presented where information about the computer system along with deployed running web applications:

14 To stop Tomcat, select the following icon from the Tool Bar : Output will be shown in the Console of Eclipse similar to starting Tomcat to indicate that Tomcat has shutdown. To restart Tomcat, select the following icon from the Tool Bar : Output will be shown in the Console of Eclipse similar to starting Tomcat to indicate that Tomcat has restarted. The procedure outlined here for the EMR source can be repeated for the VT and UDDI source. Download the source for the EMR WAR file (emr.war) from the MACSeie project zip file

15 Unzip EMRJavaSystem-Binaries+DB.zip file, you can find the emr.war, osdsf.war, and uddirep.war In the Tomcat Manager under WAR file to deploy select the browse button and locate the emr.war file then select Deploy to add the EMR source to the Tomcat server. This will extract all files from the WAR file and enable the EMR system for use. The EMR, VT and UDDI are located in the webapps directory of Tomcat at C:\Program Files\Apache Software Foundation\Tomcat 6.0\webapps Repeat these steps for the VT and UDDI:

16 If the deployment process failed with error like No projects are found to import. This problem is due to no ".project" in war package. You can create a new java project from existing source rather than importing. Add the EMR, VT, UDDI and CDSSService projects to eclipse by selecting from the menu bar File Import : This will present a new window to specify what to import. Under the General folder select Existing Projects into WorkSpace and then select Next to continue:

17 Now the project location must be located. Make sure that the Select root directory radio button is selected, select Browse and locate the EMR source folder which should be located at (Tomcat installation directory)\apache Software Foundation\Tomcat 5.5\webapps\. Select Finish to complete the import: 3.4 MySQL MySQL is a relational database management system (DBMS) that is required for the MacSeie to operate properly. Download the latest version of MySQL Community Server from

18 Make sure to select the Windows platform and download the Windows MSI Installer (x86) as this will provide a wizard to make installation easier: Execute file mysql-installer-community-x.x.xx.x (x represents the version number) and follow the on-screen instructions by accepting the start of the installation wizard by selecting Next :

19 Place a check in the check box for Install As Windows Service, create a name for the new Windows service or leave the default MySQL and check Launch that MySQL Server automatically. When ready select Next to continue: Place a check in the check box for Modify Security Settings and enter as the new root password. This will allow login with the new password entered with root username. When ready select Next to continue: A summary page will be presented to indicate that configuration of the system is ready to start. When ready select Execute to continue:

20 When configuration is complete select Finish to exit. Now you install MySql can the Workbench from MySql Installer application by selecting Add/Modify Products and Features. MySql workbench is a GUI Tools for Windows allows you to access databases.

21 Then select Application tab to install MySql workbench CE5.2 The procedure here for outlined the

22 EMR database can be repeated for the VT and UDDI databases. Download the backup schema for the EMR database (MACSeie-EMR.sql) from the MACSeie zip folder. To import the database we need to use the MySQL workbench application then by connecting to the local instance MYSQL. After connected to the local instance, restore the database open the backup file (MACSeie-EMR.sql) by selecting File Open Script. Search for the location of the backup file and select Open :

23 Then we execute the script to build up the EMR database instance. Repeat these steps for the VT and UDDI databases. Finally the J Connector is required for the EMR, VT and UDDI to access their corresponding databases. Download the ZIP version of J Connector from

24 J Connector is in a compressed ZIP file so any extraction software that can handle ZIP files such as WinZip ( or WinRar ( are required. Using the extraction software, extract the files and copy mysql-connector-java-x.x.xbin.jar (x represents the version number) into the common lib directory of Tomcat at (Tomcat installation directory)\apache Software Foundation\Tomcat 5.5\common\lib\ : In Eclipse make sure to include mysql-connector-java-x.x.x-bin.jar into the build path of the project by selecting the project from the package explorer then select File Properties or right click on the project in the package explorer and selecting Properties. In the properties window select Java Build Path then the Libraries tab.confirm that the mysql-connector-java-x.x.x-bin.jar is present:

25 If not, then select Add External JARs and locate the mysql-connector-java-x.x.xbin.jar which from a previous step above should be located in the common lib directory of Tomcat at (Tomcat installation directory)\apache Software Foundation\Tomcat 6.0\lib\ :

26 3.5 Axis2 Axis2 is an implementation of the Simple Object Access Protocol (SOAP) that is required for web service implementation. Download the latest WAR file version of Axis2 from Using a web browser, (IE, Firefox, Google Chrome, Safari, etc.) enter the following web address to access the Tomcat server home page:

27 Under Administration select Tomcat Manager. This will present a new window asking for a username and password. Enter the username and password that was chosen during the installation of Apache Tomcat: The following administrative page will be presented where information about the server along with deployed running web applications:

28 In the Tomcat Manager under WAR file to deploy select the browse button and locate the axis2.war file then select Deploy to add Axis2 to the Tomcat server. This will extract all files from the WAR file and enable Axis2 for use. Axis2 is located in the webapps directory of Tomcat at (Tomcat installation directory)\apache Software Foundation\Tomcat 5.5\webapps\ :

29 To confirm that Axis2 is available, in a web browser (IE, Firefox, Google Chrome, Safari, etc.) enter in the following web address The following web page should be presented which indicates that Axis2 has been deployed: Verify that Axis2 is running properly select the Validate link from the Axis2 web page above. This will check to make sure all necessary resources are available. The following page shows a successful validation. Note the statements that core Axis2 libraries are present and Axis version service is found:

30 Download the CDSSService.aar file from ( Now to upload a service select the Administration link from the Axis2 home page. The following administration login page is shown. Enter the default login information (username: admin password: axis2) and select Login to continue: After successful login, the Axis2 administration page will be presented. Select the Upload Service link:

31 The following service upload page will be shown. Select Choose File and browse to the location of CDSSService.arr. When finished select Upload :

32 Notification of the new service will be shown. To verify that the new service has been uploaded successfully, from the Axis2 home page select Services. This will show all services that are available and running. Verify that the CDSSService service is present and active: 3.6 Testing MACSeie To test that MACSeie is available and working, make sure that Tomcat is online and running. In a web browser (IE, Firefox, Safari, etc.) enter the following URL and a login page should

33 3.7 Login To logon to the system, insert the user name as admin, the password id admin and the second level passcode as You may face a logon problem like Access denied for user 'root'@'localhost' (using password: NO).To solve this problem simple open daobak.xml file in org.osdsf.persistence.dao from EMR project and modify the root password to match the root password in you MySQL database. Once you successes logon, try to execute a query by inserting a ALIM in the search box and selecting the name as search criteria. If you error once you click on search, for example: Unable to perform query: P.DOBDATE is not found. Then in this case you need to access the EMR database and execute th following script: ALTER TABLE emr.patient ADD DOBDATE int AFTER DOBDAY; After that restart the tomcat server and re-logon to the system.