Installing the Natural Web I/O Interface Client on Apache Tomcat

If you want to use the Natural Web I/O Interface client with Apache Tomcat, you must proceed as described in this document. The following topics are covered:

Installation Steps

The Natural Web I/O Interface client is installed using the Tomcat Manager.

The following is assumed:

  • <install-dir> is the path to Software AG's main installation directory. By default, this is C:\SoftwareAG on Windows and /opt/softwareag on UNIX.

  • <host> is the name of the machine on which Apache Tomcat is installed.

  • <port> is the name of the port where Apache Tomcat is installed. In a default installation, this is port 8080.

  • <tomcat> is the path to the directory in which Apache Tomcat is installed.

The following topics are covered below:

First-time Installation

Start of instruction setTo install the Natural Web I/O Interface client

  1. Natural for Windows and UNIX: Copy the complete contents of the <install-dir>/natural/INSTALL/nwoclient/j2ee/v<nnnn>/tomcat directory to a directory of your choice on your hard disk.

    Or:
    Download the Natural Web I/O Interface client for Apache Tomcat from Empower (https://empower.softwareag.com/) and unzip the contents to a directory of your choice on your hard disk.

  2. On UNIX platforms: Dearchive the TAR file using the following command: 

    tar -xvf nwonnnn.tar

  3. Make sure that Apache Tomcat is running.

  4. Open your web browser and enter the following URL: 

    http://<host>:<port>/manager/html

    This opens the Tomcat Manager.

  5. Deploy the web application file natuniweb.war:

    • Under Select WAR file to upload select the path to the file natuniweb.war.

    • Choose Deploy.

  6. In the Tomcat Manager, look for the application Natural Web I/O Interface Client and choose Reload.

Update Installation

Start of instruction setTo update the Natural Web I/O Interface client

  1. Natural for Windows and UNIX: Copy the complete contents of the <install-dir>/natural/INSTALL/nwoclient/j2ee/v<nnnn>/tomcat directory to a directory of your choice on your hard disk.

    Or:
    Download the Natural Web I/O Interface client for Apache Tomcat from Empower (https://empower.softwareag.com/) and unzip the contents to a directory of your choice on your hard disk.

  2. On UNIX platforms: Dearchive the TAR file using the following command: 

    tar -xvf nwonnnn.tar

  3. Shut down Apache Tomcat.

  4. Create a backup copy of your sessions.xml file, which is located in <tomcat>/webapps/natuniweb/WEB-INF.

  5. Start Apache Tomcat.

  6. Open your web browser and enter the following URL: 

    http://<host>:<port>/manager/html

    This opens the Tomcat Manager.

  7. Select natuniweb.war in the list of installed applications.

  8. Choose Undeploy.

  9. Deploy the new version of the Natural Web I/O Interface client as in a first-time installation.

  10. Restore the sessions.xml file that you have backed up previously.

Installation Verification

It is assumed that http://<host>:<port> is the URL of your application server.

Start of instruction setTo verify the installation

  1. Enter the following URL in your web browser:

    http://<host>:<port>/natuniweb/natural.jsp

    For example:

    http://myhost:8080/natuniweb/natural.jsp

    The Natural Web I/O Interface client is now started in your browser. The entries which appear in the resulting logon page depend on the settings in your configuration file. For further information, see Configuring the Client.