Installing the Natural Web I/O Interface Client on Oracle GlassFish Server

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


Installation Steps

On Oracle GlassFish Server, the Natural Web I/O Interface client consists of a web application (natuniweb.war).

The Natural Web I/O Interface client is installed using the Administration Console of Oracle GlassFish Server. It can also be installed automatically (autodeploy).

The following is assumed:

  • <host> is the name of the machine on which the application server is installed.

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

  • <adminport> is the name of the port where the Administration Console is installed. In a default installation, this is port 4848.

  • <glassfish> is the path to the directory in which the application server is installed. In a default installation on Windows, this is C:\glassfish3\glassfish.

The following topics are covered below:

First-time Installation

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

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

    Or:
    Natural for UNIX, Natural for OpenVMS and Natural for Windows: Copy the complete contents of the nwo/<platform>/j2ee/v<nnnn>/GlassFish directory from the installation medium 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 the application server is running.

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

    http://<host>:<adminport>

    This opens the Administration Console.

  5. Deploy the web application:

    1. Select the tree node Applications.

    2. Choose Browse.

    3. Go to the directory containing the web application natuniweb.war and select the web application.

    4. Choose OK.

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

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

    Or:
    Natural for UNIX, Natural for OpenVMS and Natural for Windows: Copy the complete contents of the nwo/<platform>/j2ee/v<nnnn>/GlassFish directory from the installation medium 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. Start the application server.

  4. Copy the web application natuniweb.war into the directory <glassfish>\domains\domain1\autodeploy.

Update Installation

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

  1. Make a backup copy of your sessions.xml file which is located in <glassfish>/domains/domain1/applications/natuniweb/WEB-INF/lib. If you have changed any other files (such as style sheets), also make backup copies of these files.

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

    Or:
    Natural for UNIX, Natural for OpenVMS and Natural for Windows: Copy the complete contents of the nwo/<platform>/j2ee/v<nnnn>/GlassFish directory from the installation medium to a directory of your choice on your hard disk.

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

    tar -xvf nwonnnn.tar
  4. Make sure that the application server is running.

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

    http://<host>:<adminport>

    This opens the Administration Console.

  6. Select the tree node Applications and undeploy the natuniweb application.

  7. Deploy the new version of the web application natuniweb.war as in a first-time installation.

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.