CATALINA_HOME

When the installer is run an attempt is made to register the ServicePower RJServer as a service. However if the environment variable CATALINA_HOME is already set then the service registration will fail. In order to do this manually perform the following steps:

Set up the following system environment variable:

CATALINA_HOME = C:\Program Files\SERVICEPower\RJServer

Open a command prompt in administrator mode and run the following command to install the tomcat service (note the quotes are required because there is a space in CATALINA_HOME):

"%CATALINA_HOME%\bin\service.bat" install

Once the installer has been run the output "The service 'ServiceRJS' has been installed." should be displayed. To remove the service simply run the same command exchanging "remove" for "install". Running in administrator mode is required on Windows.

Note the Apache Tomcat installation is dependent on Java's JRE 7 and will not work if this is not installed. See the pre-requisites document for further information.

Routing J Server Road Network Data

Due to the size and number of files in the Routing J Server Road Network Data a file bundle will be provided instead of an installer. This should be unzipped to a location accessible by the Routing J Server.

It is also recommended that the data be installed onto a separate disk, as RJS is read heavy.

Installing RJServer

Windows

When installing ServicePower RJServer, the supplied setup.exe file should be used to install the application. The setup.exe file ensures that any prerequisites are installed properly before starting the installation process.

Select 'Next' to continue the installation or 'Cancel' to stop the installation.

Select 'Next' to continue the installation or 'Cancel' to stop the installation.

Now select the installation folder to be used for the application. It is recommended that the default location is chosen.

Now confirm that the installation can go ahead.

If the User Account Control dialog appears select 'Yes' to allow the installer to continue. Now click close to finish the installation.

Note the following two screens 'Locate Data' and 'Locate the Routing Update File Path' are custom install screens and do not have a 'Back' button. If 'Cancel' is pressed on either of the custom install screens then the installation is aborted and a custom error message is displayed.

Simply click 'OK' to return back to the original installer screens.

After aborting the custom install action and selecting 'OK' click close to stop the installation process.

Now enter the locations of the Road Network Data in the format provided in the on screen example. The directory information cannot be manually entered and must be provided using the folder browser dialog opened using the 'Add Directory' button. If a mistake is made then the 'Remove Directories' button can be used to clear the current dataset list. Once the dataset list is complete click 'Next' to continue the installation or cancel to abort the installation.

Now enter the directory where updates to the Routing J Server Road Network Data will be placed after installation. If a mistake is made when chosing a dircectory the 'Restore Default Folder' button can be used to return the file path to its original value.

Now click 'Close' to complete the installation process.

Installation Validation

Once Routing J Server is installed, you can test that the application is running correctly by navigating to the following URL:

http://<servername>:<portno>/routing/servlet/routing?debug=true

If you have successfully installed the application correctly, you should see a screen similar to the following.