Siebel Installation Guide for UNIX: Servers, Mobile Web Clients, Tools > Installing the Siebel Gateway Name Server >

Installing and Configuring the Siebel Gateway Name Server


This section provides instructions for installing and starting the Siebel Gateway Name Server as part of standard Siebel Enterprise Server deployment.

In most cases, the installation should be conducted by a nonroot user for simpler administration and maintenance.

NOTE:  Whether you install as root or as a nonroot user affects how you would configure autostart for Siebel Gateway Name Server, as described in Configuring the Siebel Gateway Name Server for Automatic Start.

NOTE:  If you are installing from a remote machine, or using X-connectivity software to access a UNIX machine from a Windows machine, see also Installing from a Remote Server Machine.

The Siebel Enterprise Server installer verifies not only that you have the required software for installation of Siebel version you are installing, but that the software is at the version level necessary.

NOTE:  The following procedure is for installing the base product. For patch installation instructions, refer to the Maintenance Release Guide provided with the patch. See also About Installing Siebel Releases.

To install the Siebel Gateway Name Server

  1. Log on to the server, using the Siebel service owner account that you recorded in the copy you made earlier of the worksheet in Deployment Planning Worksheet.

    NOTE:  If the Siebel Gateway Name Server is installed by root, then only root can stop and start the server. Use a Siebel account other than root that has the correct authorizations to install. For more information on creating Siebel accounts, see Creating the Siebel Service Owner Account.

  2. Open a new shell and navigate to the Siebel image location for the current software version. Then navigate to the directory where the installer is located.

    For example, for Solaris, navigate to Siebel_Image/Solaris/Server/Siebel_Enterprise_Server.

    where:

    • Siebel_Image = The directory for your version-specific Siebel network image, such as
      /Siebel_Install_Image/7.8.2.0.
  3. Unset any Siebel-specific environment variables. To view current environment variable settings, enter env in the shell window.
  4. To start the Siebel Gateway Name Server installation process, enter the following command. Optionally, append any flags described in Additional Flags for Installation Commands.

    ./setupUNIX_OS

    where:

    • UNIX_OS = Your UNIX operating system, such as sol, hp, or aix

      The Installer Welcome screen appears.

  5. Click Next.

    If you have installed other Siebel components of the same version on the same machine, the installer displays the message that an existing installation has been found. In such a case, proceed to Step 6. Otherwise, click Next and proceed to Step 7.

  6. Depending on whether you want to install a new instance of Siebel software or add a new language to an existing instance, take the appropriate action.
    • To install the Siebel Enterprise Server software in a new instance, select None as the default and click Next. Proceed to Step 7.
    • To install a new language in an existing instance, select the displayed instance and click Next. Proceed to Step 11.

      For additional information about installing multiple Language Packs, see Siebel Server Installation Requirements.

      The Installer Path screen appears.

  7. Enter the fully qualified path to the installation directory that you recorded in a copy of the worksheet in Deployment Planning Worksheet or click Browse to choose a different directory.

    NOTE:  The directory name should be standard alphanumeric characters, including the underscore. No other characters or spaces are allowed.

  8. Click Next.

    The Installer Product Selection screen appears.

  9. Select the Gateway Name Server and click Next.

    Other Siebel Enterprise Server (SES) components can be installed later. Alternatively, if you choose to install additional components at the same time as the Siebel Gateway Name Server, it is not necessary to enter some of the same information, such as language choice, twice. In this case, the installation steps described in Installing the Siebel Server will not appear in the exact order as described.

    If you install more than one component at once, the Siebel Enterprise Server installer and the Siebel Software Configuration Wizard prompt you for the installation parameters of each component individually and in the sequence required.

    For more information about different ways of deploying Siebel Enterprise Server components, see the Deployment Planning Guide.

    NOTE:  Before proceeding, review the preinstallation requirements for each component you plan to install and perform any necessary preinstallation tasks. See Siebel Gateway Name Server Installation Requirements and other applicable sections.

  10. Choose the type of installation to perform from the following options; then click Next to continue.

    NOTE:  For the Siebel Gateway Name Server, all three options install the same components.

    • Typical. Installs all Siebel Gateway components.
    • Compact. Installs only those components necessary to run the Siebel Gateway, but no additional components or help.
    • Custom. Lets you customize your installation by choosing the specific components you want to install.

      The Install Selected Language Packs screen appears.

  11. Choose the language or languages to be installed and click Next.

    Servers are installed, at a minimum, with the primary (base) language in which each server will run. This is the primary (base) language for your Enterprise Server. Optionally, you can install one or more additional languages.

    When installing languages at a later date, you must also reinstall any patch releases that were previously installed.

    NOTE:  Before you install Language Packs, see the information about code pages in Planning RDBMS Installation and Configuration, and see Siebel Gateway Name Server Installation Requirements.

    The installer displays the location into which it will install the Siebel Gateway Name Server and any other servers you have elected to install, and also the disk space required for the software you are installing.

  12. Click Next to copy the files for the selected products into the installation location. Alternatively, to change any settings, click Back, adjust your selections, and click Next to return to this screen.

    The installer proceeds to install the specified files.

    A message appears, stating that language files are being installed.

    The Installer Progress screen appears and displays the progress of the installation followed by additional configuration screens.

    Which screen appears next depends on whether you are installing one or multiple languages.

    • If you are installing more than one language, the Primary Language screen appears. Proceed to Step 13.
    • If you are installing only one language, the Gateway Port screen appears. Proceed to Step 14.
  13. Select the primary (base) language and click Next.

    NOTE:  This is the primary (base) language for your Siebel Enterprise—the language in which you want your Siebel Server to run and in which you normally want to read messages.

    The Port Number screen appears.

  14. Accept the default Gateway Port Number or change it and click Next.

    For more information about port numbers and Siebel Gateway Name Server, see Siebel Gateway Name Server Installation Requirements.

    The Installer Autostart screen appears.

  15. Choose whether the Siebel Gateway Name Server should autostart on restart, or not, and then click Next.

    If you will be clustering this Siebel Gateway Name Server, do not configure it for automatic start; otherwise, select automatic start. The automatic start setting programs the Siebel Gateway Name Server to accept additional configuration instructions to start automatically each time the host machine restarts. To actually implement automatic start-up, you must also complete the configuration steps described in Configuring the Siebel Gateway Name Server for Automatic Start.

    The Installer Configuration Verification screen appears.

  16. Verify the Siebel Gateway Name Server settings and click Next to accept, or Back to go back and change a setting.

    NOTE:  Your installation process may vary from the procedure provided in this section, depending on what components you have selected to install. For example, you may have elected to install the Siebel Gateway Name Server and the Siebel Server at the same time. In this instance, the installer will skip from this point in the Siebel Gateway Name Server installation to Step 2 (in Installing the Siebel Server).

    The Finish screen appears.

  17. To complete the installation, click Finish.

To verify the installation

  1. Navigate to $SIEBEL_ROOT/gtwysrvr/bin.
  2. Using an editor like vi, open the base.txt file. It lists the type of installation just completed, for example:

    7.8.2 [19213]

Siebel Installation Guide for UNIX: Servers, Mobile Web Clients, Tools