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:
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:
<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:
To install the Natural Web I/O Interface client using the
Administration Console
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.
On UNIX platforms: Dearchive the TAR file using the following command:
tar -xvf nwonnnn.tar
Make sure that the application server is running.
Open your web browser and enter the following URL:
http://<host>:<adminport>
This opens the Administration Console.
Deploy the web application:
Select the tree node Applications.
Choose .
Go to the directory containing the web application natuniweb.war and select the web application.
Choose .
To install the Natural Web I/O Interface client automatically
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.
On UNIX platforms: Dearchive the TAR file using the following command:
tar -xvf nwonnnn.tar
Start the application server.
Copy the web application natuniweb.war into the directory <glassfish>\domains\domain1\autodeploy.
To update the Natural Web I/O Interface client
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.
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.
On UNIX platforms: Dearchive the TAR file using the following command:
tar -xvf nwonnnn.tar
Make sure that the application server is running.
Open your web browser and enter the following URL:
http://<host>:<adminport>
This opens the Administration Console.
Select the tree node Applications and undeploy the natuniweb application.
Deploy the new version of the web application natuniweb.war as in a first-time installation.
It is assumed that http://<host>:<port> is the URL of your application server.
To verify the installation
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.
