Bookshelf Home | Contents | Index | PDF     

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

Installing Additional Siebel Servers for an Existing Siebel Enterprise Server

Before creating additional Siebel Servers, you should have installed and configured your Web server, and installed and configured the Siebel Web Server Extension (SWSE) plug-in. Doing this allows you to test the connection to the additional servers. For information about installing the SWSE, see Installing the Siebel Web Server Extension.

Run the Siebel Enterprise Server installer to install Siebel Servers on additional machines in your Siebel Enterprise.

Alternatively, you can use the config_server script to create an additional Siebel Server on a single machine where Siebel Server is already installed, as described in the following procedure.

NOTE:  Creating multiple Siebel Servers on a single machine is typically done only for test or development purposes. In your production environment, it is strongly recommended that you create only one Siebel Server per machine.

To create an additional Siebel Server on a single machine

  1. Log on as the Siebel Service Owner to the machine where the Siebel Server software is installed.
  2. In the shell window, enter env and verify that the environment variable SIEBEL_GATEWAY is set to the actual Gateway IP address or network name of the Siebel Gateway, and the variable SIEBEL_ROOT is set to the Siebel root directory.

    The config_server script uses the values for these environment variables unless they are overridden by command-line arguments. For details on the switches you can use, see Step 4.

  3. If the Siebel environment variables are not set or are set incorrectly, navigate to the $SIEBEL_HOME directory and choose the appropriate command for your UNIX shell to source the Siebel environment file.

    Bourne or Korn shell

    . ./siebenv.sh

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

    C shell

    source siebenv.csh

    Before sourcing the Siebel environment file, make sure you have your database environment set up correctly. Specifically, verify that the LD_LIBRARY_PATH (Solaris), SHLIB_PATH (HP-UX), or LIBPATH (AIX) environment variable contains the full path name for your database client library directory. If you do not set up the database environment properly, you will receive an error message.

  4. Start the Siebel Enterprise Server configuration by entering config_server.

    The config_server script accepts the command-line flags described in Table 17.

  5. If you did not specify a Siebel Server with a command-line flag, you must choose an existing server to configure or select the option to create a new server:
    • If you choose to edit an existing server, it has to be a server that has not been configured yet. You cannot use the wizard to reconfigure an already configured server. To reconfigure a server, you have to uninstall and reinstall the server.
    • If you choose to create a new Siebel Server, the config_server script prompts you to choose a new directory for the Siebel Server and to configure it.

      CAUTION:  You cannot install your second Siebel Server in the same root directory as your first Siebel Server.

  6. For the remaining steps you need to follow, see the steps described under Installing and Configuring the Siebel Server.

    The config_server script exits after it completes the chosen task.

Flags for config_server Script

Table 17 lists all the flags you can use with the config_server script to configure a Siebel Server.

Table 17. Config_server Flags
Flag
Parameter
Definition
Description

-r

siebel_root

(Required) The full path to the Siebel root directory

If -r is not specified in your command line, the value of the $SIEBEL_ROOT environment variable is used, so you have to make sure this environment variable is set prior to executing server_config without the -r switch.

If $SIEBEL_ROOT is set to the Siebel root directory, then there is no need to have the -r switch and value in your command line.

-g

siebel_gateway

(Required) The Siebel Gateway Name Server, in the form of the IP address or network name followed by a colon and the port number (by default, this is 2320)

If -g is not specified in your command line, the value of the $SIEBEL_GATEWAY environment variable is used, so you have to make sure this environment variable is set prior to executing server_config without the -g switch.

If $SIEBEL_GATEWAY is set to the IP address or network name of the Siebel Gateway Name Server, then there is no need to have the -g switch and value in your command line.

-e

enterprise_server

(Optional) The Siebel Enterprise Server in which to operate

If the Enterprise Server is not specified and multiple Siebel Enterprise Servers are defined, you will be prompted with a list of the Siebel Enterprise Servers.

-s

siebel_server

(Optional) The existing Siebel Server to configure

If this Siebel Server is not specified, you will be prompted with a list of all existing Siebel Servers and given the option of defining new ones.

Enabling Siebel Remote for Multiple Siebel Servers on a Machine

When installing multiple Siebel Servers on a single machine, normally only the first Siebel Server installed can be configured to support Siebel Remote. If you need to enable Siebel Remote on each Siebel Server, install these Siebel Servers into separate directories, so that they do not share the same installation files.

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