If you want to use the Natural Web I/O Interface client with Sun Java System Application Server, you must proceed as described in this document. The following topics are covered:
The Natural Web I/O Interface client is installed using the Adminstration Console of Sun Java System Application Server.
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 Adminstration Console is installed. In a default installation, this is port 4848.
<sunas> is the path to the directory in which the application server is installed. In a default installation on Windows, this is C:/Sun/AppServer.
The following topics are covered below:
To install the Natural Web I/O Interface client
Download the Natural Web I/O Interface client for Sun Java System Application Server from the Component Download area in ServLine24 (http://servline24.softwareag.com/public/) 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>/sun-apps
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
Edit the file <sunas>/domains/domain1/config/server.policy and add the following setting in order to enable the Java Logging API:
grant {
permission java.util.logging.LoggingPermission "control";
};
Important:
If you do not add this setting, the resource adapter will
not start and the Natural Web I/O Interface client will therefore be
inoperative.
Make sure that the application server is running.
Open your web browser and enter the following URL:
http://<host>:<adminport>
This opens the Adminstration Console.
Deploy the resource adapter naturalunicode.rar:
Open the tree node Applications > Connector Modules.
Choose .
Select naturalunicode.rar as the package file to be uploaded to the application server.
Choose . "naturalunicode" is automatically included as the application name.
Choose .
Define the JNDI name for the resource adapter:
Open the tree node Resources > Connectors > Connector Connection Pools.
Choose .
Enter "NatPool" (the name is arbitrary) as the name.
Select naturalunicode as the resource adapter.
Each connection to a Natural host results in a new connection being made. Since each user requires a unique host session, connection pooling cannot be used. Therefore, you should make sure there are enough sessions for your users. The default maximum number is "32".
Choose .
Choose .
Choose .
Open the tree node Resources > Connectors > Connector Resources.
Choose .
Enter "eis/NaturalUnicodeRA" as the JNDI name.
Select NatPool (or whatever name you specified previously) as the pool name.
Choose OK.
Deploy the enterprise application natuniapp.ear:
Open the tree node Applications > Enterprise Applications.
Choose .
Select natuniapp.ear as the file to upload.
Choose .
Choose . The deployment may take several minutes.
Restart the application server.
To update the Natural Web I/O Interface client
Make a backup copy of your sessions.xml file which is located in ../AppServer/domains/domain1/applications/j2ee-apps/natuniapp/natuniweb_war/WEB-INF. 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 Sun Java System Application Server from the Component Download area in ServLine24 (http://servline24.softwareag.com/public/) 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>/sun-apps
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
Edit the file <sunas>/domains/domain1/config/server.policy and make sure that the following setting has been defined:
grant {
permission java.util.logging.LoggingPermission "control";
};
Important:
This setting is required as of Natural Web I/O Interface
Version 1.3.2. If this setting is missing, the resource adapter will not start
and the Natural Web I/O Interface client will therefore be
inoperative.
Make sure that the application server is running.
Open your web browser and enter the following URL:
http://<host>:<adminport>
This opens the Adminstration Console.
Undeploy the resource adapter naturalunicode.rar:
Open the tree node Resources > Connectors > Connector Connection Pools.
Mark the check box Natpool (or the check box for whatever name you specified previously).
Choose .
Open the tree node Applications > Connector Modules.
Mark the check box naturalunicode.
Choose .
Undeploy the enterprise application natuniapp.ear:
Open the tree node Applications > Enterprise Applications.
Mark the check box natuniapp.
Choose .
Deploy the resource adapter naturalunicode.rar as in a first-time installation.
Define the JNDI name for the resource adapter as in a first-time installation.
Deploy the enterprise application natuniapp.ear as in a first-time installation.
Copy your backup files back to the required places.
Restart the application server.
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.
