Version 6.3.13 for Windows
 —  Natural Web I/O Interface  —

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

Note:
If you want to install on Oracle GlassFish 2.0, see Installing the Natural Web I/O Interface Client on Sun Java System Application Server. The information below applies to Oracle GlassFish 3.1.

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

Although Oracle GlassFish Server is the successor of Sun Application Server, the installation is different from the one described for Sun Application Server. 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:

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.

Top of page

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.

Top of page