Activating the Natural Web I/O Interface Daemon on UNIX

This document covers the following topics:


General Information

When a Natural Web I/O Interface daemon is used, a procedure to activate the daemon may be called during system startup.

The Natural installation process provides a Natural Web I/O Interface daemon start/stop service procedure. The name of the procedure will be generated depending on the installation directory.

Furthermore, the Natural installation process determines the platform automatically and prepares the system (V style or AIX) to execute the start/stop service procedure during start/stop of the system. Depending on the platform, the system directory for initialization and, if needed, the runlevel startup directories will be selected. The start/stop service procedure will be copied to the system directory for initialization and links will be created in the runlevel startup directories.

The Natural installation process installs the Natural Web I/O Interface daemon start/stop service when sudoers permissions are available. You can also set up this service manually as described below, or you can use the script install_daemon_nwosrvd in the <install-dir>/Natural/INSTALL directory.

To verify the operation of the Natural Web I/O Interface daemon, invoke a Natural Web I/O Interface client on Windows and connect to the system on which the server runs. Use the port that was specified when starting the Natural Web I/O Interface daemon.

Preparing the Startup Procedure

The procedure sag<install-dir-number>nwosrvd in the <install-dir>/Natural/INSTALL directory may be used as a script or script template to invoke Natural Web I/O Interface daemon during system startup.

The Software AG Installer assigns an internal number to each installation directory. This is reflected by the notation <install-dir-number> in the above procedure name. The instructions below assume that you use an installation directory with the internal number 1. Therefore, the procedure name sag1nwosrvd is used. If you have several installation directories and if you want to copy scripts, you may need to adapt the number in the procedure name.

The following topics are covered below:

Preparing the System V Style Startup Procedure

To set up the system, proceed as described below:

  1. Log in as user "root".

  2. Copy the script sag1nwosrvd to the init.d system directory.

    In this description, init.d and rc3.d (see further below) stand for the relevant path for the platform you are using. The following table shows where the init.d and rc3.d directories are located on the various platforms.

    Platform System Directory for Initialization Runlevel Startup Directory
    Oracle Solaris /etc/init.d /etc/rc3.d
    HP-UX /sbin/init.d /sbin/rc3.d
    Linux /etc/init.d /etc/init.d/rc3.d or /etc/init.d/rc5.d
  3. If already available, create a backup copy of your current sag1nwosrvd file contained in the init.d directory (see the above table).

  4. If you do not use the default values, set the following environment variables in the sag1nwosrvd procedure:

    NAT_HOME Location where Natural was installed.
    NATADM The login name of the Natural system administrator responsible for this Natural Web I/O Interface daemon. It is assumed that this administrator account is called "sag", and that the user ID is already known to the system. It does not have to be a user with root privileges.
    NWODIR Home directory of the product located at <install-dir>/Natural/nwo.
    NWONODE Name of the node on which the Natural Web I/O Interface daemon is installed.
    NWO_SRVDCONF <install-dir>/Natural/nwo/$NWONODE/nwosrvd.conf

    Note:
    The Bourne shell does not allow blanks before and after the equals sign in the lines to be customized.

  5. Create a link "S66sag1nwosrvd" to the sag1nwosrvd procedure in the rc3.d directory (see the above table).

    You may create a link to the Natural Web I/O Interface daemon start/stop procedure in the runlevel 3 startup directory of your UNIX machine. The rc3.d directory contains several Bourne shell scripts or links to Bourne shell scripts that start with "S" followed by a number. The Natural Web I/O Interface daemon start/stop procedure uses the number "66". A lower number will be executed first. If you add a file or a link to this directory, the respective code is executed when the system changes to "multi-user mode".

Preparing the AIX Startup Procedure

To set up the system, proceed as described below:

  1. Log in as user "root".

  2. Copy the script sag1nwosrvd to the etc system directory.

  3. If you do not use the default values, set the following environment variables in the sag1nwosrvd procedure:

    NAT_HOME Location where Natural was installed.
    NATADM The login name of the Natural system administrator responsible for this Natural Web I/O Interface daemon. It is assumed that this administrator account is called "sag", and that the user ID is already known to the system. It does not have to be a user with root privileges.
    NWODIR Home directory of the product located at <install-dir>/Natural/nwo.
    NWONODE Name of the node on which Natural Web I/O Interface daemon is installed.
    NWO_SRVDCONF <install-dir>/Natural/nwo/$NWONODE/nwosrvd.conf

    Note:
    The Bourne shell does not allow blanks before and after the equals sign in the lines to be customized.

  4. The /etc/inittab file supplies the script to the init command's role as a general process dispatcher. Therefore, enter a record with the sag1nwosrvd script in the /etc/inittab file using the mkitab command. For example:

    mkitab "sag1nwosrvd:3:wait:/etc/sag1nwosrvd > dev/console"
  5. Verify your changes to make sure that the changes made consist only of those changes desired.