Siebel Server Installation Guide for UNIX > Installing the Siebel Gateway >

Installing and Configuring the Siebel Gateway

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

NOTE:  In general, it is recommended the installation be conducted by a non-root user for simpler administration and maintenance. However, root access is required if you plan to configure the Gateway Server or Siebel Server for auto-start.

You must use only one CD-ROM drive for the entire installation, swapping CDs as needed. In other words, do not use a second CD-ROM drive for additional CDs.

To avoid CD swapping, copy all installation files, including the required language files, to a common installation directory within your system. For more information, see Creating a Staging Point.

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

To install the Siebel Gateway

  1. Install the UNIX_OS Server Programs, Siebel Enterprise Server Base CD-ROM onto the network

    2. where:

    UNIX_OS is your UNIX operating system, such as Solaris, HP-UX, or AIX.

    NOTE:  The volume label for the CD is seaUNIX_OSsesbase or seaUNIX_OSsiabase (for Siebel Industry Applications), as appropriate to the Siebel applications you are installing. This step may not be required, depending on how you access the CD-ROM.

    As a convenience, you may also want at this time install the seaUNIX_OSseslanguage or seaUNIX_OSsialanguage (for Siebel Industry Applications) CD-ROM, as applicable, into the drive of the machine on which you want to install the Siebel Gateway.

    If you choose to copy the CD contents to a directory location on a remote file system, you should hard mount the remote host through NFS, as follows:

    mount host:/directory_on_host /mount_point

    where:

    host is the machine name.

    directory_on_host is the directory to be mounted.

    mount_point is the name you want to use for the mount point.

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

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

  3. Navigate to the /ses directory from the CD mount point and open a new shell.
  4. Unset any Siebel-specific environment variables. To view current environment variable settings, enter env in the shell window.
  5. To start the Siebel Gateway installation process, enter the following command, appending any desired flag described in Additional Flags for Installation Commands.

    6. ./setupUNIX_OS

    where:

    UNIX_OS is your UNIX operating system, such as Solaris, HP-UX, or AIX.

    The Installer Welcome screen appears.

    NOTE:  Using third-party terminal emulators are not supported when connecting from a Windows machine to a UNIX server to perform a GUI installation. Running the GUI installer from one UNIX machine to install on another UNIX machine or on the local UNIX machine is supported. If you need to use a Windows machine to perform a UNIX installation, telnet to the UNIX server and install in console mode. For details on installing in console mode, see Console-Mode Installation.

  6. Click Next.

    7. If you have installed other Siebel components on the same machine, the installer displays the message that an existing installation has been found.

  7. Depending on whether you are installing your Siebel Gateway files for the first time or adding a new language to an existing instance, take the appropriate action, then click Next.
  8. Enter the fully qualified path to the installation directory that you recorded in Deployment Planning Worksheets or click Browse to choose a different directory.

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

  9. Click Next.

    10. The Installer Product Selection screen appears.

  10. Select the Siebel Gateway Server. Other components can be installed later.

    11. NOTE:  If you choose to install additional products at the same time as the Siebel Gateway, it will not be necessary to enter some of the same information, such as language choice, twice. For this reason the installation steps described in Installing the Siebel Server will not appear in the exact order as described.

  11. Click Next.

    12. NOTE:  When installing on AIX, the Next button may not be immediately visible. If the Next button is not visible, resize the GUI.

    The Setup Type screen appears.

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

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

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

    14. All servers are installed with at least one language. Additional languages can be installed at a later date, if desired.

    When installing languages at a later date, you must also reinstall any patches that may have been run on the directory.

    NOTE:  In a Unicode-enabled database environment, you can install any of the available Siebel language packs. In a non-Unicode database environment, you must consider the correlation of the language packs you want to install and the characters supported by your database code page. For example, in a Western European code page database, you can only install Western European language packs such as English, French, Spanish, or German language packs. And in a Japanese code page database, you can only install Japanese or English language packs.

    For a list of supported code pages and encoding strategies, see System Requirements and Supported Platforms.

    The Installer Verification screen appears.

  14. To copy the files for the selected product into the installation location, click Next.

    15. The Installer Progress screen appears.

    After the files have been copied to the installation location, a warning screen appears with the following message.

    Setup did not find the Siebel Language Code language pack on the current media. Please insert the CD containing the Siebel Language Code and select setupUNIX_OS from the Siebel Language Code folder.

  15. If you have not yet done this, insert the appropriate language CD-ROM into the drive of the machine onto which you are installing the Siebel Gateway, and navigate to the location of the selected language (ses/language/), where language stands for the Siebel language code.

    16. NOTE:  The volume label for the CD is either seaUNIX_OSseslanguage or siaUNIX_OSseslanguage, as appropriate. If you are installing Siebel Industry Applications, you will use siaUNIX_OSseslanguage.

    Clear the filter dialog box, if needed, to be sure that you can see the appropriate files.

  16. Select setupUNIX_OS and click OK.

    17. The Installer Language Pack Progress screen appears.

    When installation of all the language files has been completed, the installer prompts you again for the base CD-ROM.

    Please re-insert the base CD and browse to the setupUNIX_OS file to enable setup to continue.

  17. Navigate again to the base CD mount point on the network, locate ses/setupUNIX_OS, and click OK.

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

  18. Select the primary(base) language and click Next.

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

    The Gateway Port screen appears.

  19. Accept the default Gateway Port Number or change it, then click Next.

    20. The Installer Autostart screen appears.

    CAUTION:  If you will be operating this Siebel Gateway as part of a cluster, do not use Autostart. The Siebel Gateway service must always be started and stopped through the corresponding cluster scripts or agents.

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

    21. NOTE:  This setting programs the Siebel Gateway to accept additional configuration instructions to start automatically each time the host machine restarts. To actually implement automatic startup, you must also complete the configuration steps described in Configuring the Siebel Gateway for Automatic Start.

    The Installer Configuration Verification screen appears.

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

    22. CAUTION:  Your installation process will vary from the procedure shown here. For example, you may have elected to install the Siebel Gateway and the Siebel Server at the same time. In this instance, the installer will skip from this point in the Gateway installation to Step 20 in the To install the Siebel Server procedure.

  22. To complete the installation, click Finish.

To verify the installation

  1. Navigate to the $SIEBEL_ROOT/gtwysrvr directory and source the Siebel environmental variables. Choose the appropriate command for your UNIX shell or its variant.

    2. Korn or Bourne shell:

    . ./siebenv.sh

    TIP:  Make sure there is a space between the initial period and ./siebenv.sh.

    C-shell:

    source siebenv.csh

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

    4. 7.x.x [15049] LANG_INDEPENDENT full release

    or

    7.x.x [15049] ENU full release

    where:

    ENU = U.S. English.


 Siebel Server Installation Guide for UNIX 
 Published: 24 June 2003