Installation

JaxView is designed to be easy to install. The JaxView set up package contains all the components needed for most deployments. You can install and start using JaxView in less than an hour. This section gives you the steps you use to install a new JaxView server or upgrade an existing installation.

The JaxView Installation Package

The installation package (JaxViewSetup.zip) includes the files and components needed to install and run JaxView. The following is a description of the package contents:

Windows Package

• JaxViewService.exe - The executable installer for the JaxView server. This includes this user documentation.

• mm_stub.jar - This Java archive (jar) file includes the JaxRpc handler that can be installed on remote Web service containers when using optional the JaxView Agent Stub Architecture.

• JBoss.zip - This zip archive file includes the patch files for the correct version of the JBoss container when using the optional J2EE monitoring capability.

• VCRTArchive.zip - If you are installing JaxView on Microsoft Windows XP Pro, some DLL's are missing that need to be installed for the JaxView service to run. This zip file includes those need DLL's. See Note

• capeconnect-client.jar - This is a Java archive needed for optional monitoring of CapeClear servers. This jar file needs to be installed in the class path on the CapeClear server.

• Readme - A brief introduction to JaxView which include the installation instructions JaxView.

• ReleaseNotes - Hisotrical release notes for the new features and changes in this release of JaxView.

System Requirements

The following are the system requirements for installing the JaxView management server on the platforms indicated:

Microsoft Windows Platforms

• Windows XP Professional, 2000 Pro, or 2000 server
• Intel Pentium processor (or equivalent) at 500 MHz or faster
• 512 MB RAM or more
• 2 GB disk space or more
• Web browser with ActiveX support enabled (Internet Explorer 6, Firefox 1.5)
• The person installing needs to be an administrator on the machine

Apple Mac OS X Platforms

• Mac OS X
• 500 MHz Processor or faster
• 512 MB RAM or more
• 2 GB disk space or more
• Web browser with ActiveX support enabled (Internet Explorer 6, Firefox 1.5)
• The person installing needs to be an administrator on the machine

Linux Platforms

• Linux
• 500 MHz Processor or faster
• 512 MB RAM or more
• 2 GB disk space or more
• Web browser with ActiveX support enabled (Mozilla or Firefox 1.5)
• Java JRE 1.5 or later (recommended)

Installing the JaxView Server

The following sections describe the steps you use to install JaxView on the indicated platforms.

Installing on Microsoft Windows platforms

JaxView is installed as a service on Microsoft Windows platforms. You use the following steps to install JaxView:

To install JaxView on Windows platforms:

1. Download or copy the setup archive file: JaxViewSetup.zip.
2. Unzip the setup archive file. By default, this will create a folder named \JaxView.
3. Inside the JaxView folder, run the installation executable: JaxViewSetup.exe
4. Follow the instructions in the installation wizard to complete the installation.
5. Confirm that the JaxView is running. You can view the Services by clicking on Start -> Control Panel -> Administrative Tools -> Services.
6. Confirm that you can access the JaxView login page at: http://<hostname>:9090/Hubble/servlet/LoginServlet

Installing on Linux platforms

You use the following steps to install and run JaxView on Linux platforms:

To install JaxView on Linux platforms:

1. Download or copy the setup archive file: JaxView.linux.tar.gz.
2. Extract the setup archive file. By default, this will create a folder structure such as ManagedMethods/JaxView.
3. Inside the JaxView folder, find the shell script startJV. You use this script to start the JaxView server (java) process.
4. Confirm that you can access the JaxView login page at: http://<hostname>:9090/Hubble/servlet/LoginServlet

At this point the JaxView manager has been installed and started. An simple Calculator service is included with JaxView as an example Web service. This service is disabled after you add your own Web services definition objects to JaxView. To record and manage Web service requests and responses in the environment you will need to configure JaxView and possibly other elements in the target SOA environment. JaxView has several deployment options to choose from depending on your operational requirements and management objectives. See the section JaxView Deployment Options for more information on how JaxView can be used to manage service-oriented environments.

Upgrading a JaxView Installation

Updating an existing JaxView install with a newer version can be done using the following procedure.

To upgrade an existing JaxView installation:

1. Download the updated JaxView installation package
2. Make a backup copy of your current JaxView directory. You will need to restore the configuration files out of this backup later
3. Stop the JaxView service
4. Unzip the download package
5. Use the executable installation wizard to install the new JaxView version OVER your previous installation. Your Web service message data will not be overwritten. The installer will automatically start the JaxView service.
6. Stop JaxView service of the new installation
7. From your backup copy of the previous JaxView version, copy all the xml files from the JaxView/Config directory into the JaxView/Config directory where the newer version is installed.
8. From your backup copy of the previous JaxView version, copy the JaxView/Messages, JaxView/Templates, JaxView/Logs, JaxView/Scripts, and JaxView\tomcat\webapps\Hubble\Report into the new install directories.
9. Restart the new JaxView and you should see all of the configuration data from your previous installation.