Installing Dependent Runtime Environments, Apache Tomcat, Apache Axis, and MySQL

In general, the software in Table A-1 consists of simple class packages that the build and runtime environment uses. Apache Tomcat and MySQL are noticeable exceptions; each requires specialized handling.

Installing Apache Tomcat and Apache Axis

The Apache Tomcat and Apache Axis installation can be a little tricky. After installation, you need to go further and install your own JAR files that both Apache Tomcat and Apache Axis use while running the samples. You need quite a few additional JAR files because of the way you will build the samples in the book. Chapter 13, "Exploring the Physical Tiers Pattern," explains the environment in more detail.

Installing Apache Tomcat, installing Apache Axis, and deploying the dependent JAR files for your environment are relatively complex processes. You should break up the steps to ensure that each of the product installations is working before moving on to the next one. If you are installing Apache Tomcat and Apache Axis, follow these steps:

Install Apache Tomcat, which is typically as easy as downloading the executable binary file (identified by the .exe extension on Windows) and running it on your computer. Read the instructions if you run the executable and the next step does not work as planned.
Start Apache Tomcat (typically from the Start Tomcat program icon installed in the Apache Tomcat 4.1 program group ) and verify its proper installation ”typically by going to http://localhost:8080. You should see a welcome page with the Apache Tomcat logo when you make contact with the Apache Tomcat server. This should take about 1 “2 seconds.
Assuming step 2 was successful, shut Apache Tomcat down (again, you can use the program icons installed under the Apache Tomcat 4.1 program group; in this case, you would use the Stop Tomcat program icon).
Install Apache Axis according to the installation instructions. To install Apache Axis, you typically unzip the downloaded file ( xml-axis-10.zip ) to a permanent directory. Then, locate the webapps directory within the expanded directory, something such as ./xml-axis-10/webapps . Copy the contents of the webapps directory to the Apache Tomcat Web applications directory ”typically /Program Files/Apache Group/Tomcat 4.1/webapps . The Apache Tomcat “specific directory (in this case, Tomcat 4.1 ) may change with the version number of Apache Tomcat.
Start Apache Tomcat again using the program icon.
Verify the Apache Axis installation by going to the management console at http://localhost:8080/axis.
Shut down Apache Tomcat using the program icon.
Go to the /java/WebServicesBook/bin directory and install the samples and remaining environment (assuming you have downloaded all of the dependent software and fixed the build.properties file) by running the command ant finishinstall .
Start Apache Tomcat again using the program icon.

Note	These steps and Uniform Resource Locators (URLs) are relatively stable; however, you may choose to customize them for your own installation. If you do customize the installation, make sure you appropriately modify the previous instructions.

Installing MySQL

The book's chosen JDO implementation, LiDO, uses the MySQL relational database for persistence underneath the JDO Application Programming Interface (API). Installing MySQL is relatively simple, but there is some information you will want in order to become handy with MySQL. Assuming you installed MySQL to the /mysql directory, you will use several utilities from the /mysql/bin directory (see Table A-2). Installing MySQL is typically as easy as downloading the EXE file and running through the installation process that starts by running the executable.

Table A-2: MySQL Utilities
UTILITY	DESCRIPTION
`winmysqladmin.exe`	This is the administration console for MySQL. After running this utility, you will find an additional icon in your Windows system tray. Display this console to monitor the database. The Database tab lists the databases that reside in your local installation. You will use the `wsbook` database. Create `wsbook` by selecting the Create Database contextual menu in the Databases section of the dialog box. You create tables with an `ant` build step, `buildtables` (see the section "Building the Examples" for more information).
`MySqlManager.exe`	This allows you to run simple SQL commands against the tables. This is a fun way to view the structure of the persistent data.
`mysqlshutdown.exe`	This shuts down a running instance of MySQL.