Bookshelf v7.5: Creating Additional Servers Within an Existing Siebel Enterprise Server

Siebel Server Installation Guide for UNIX > Installing the Siebel Server > Post-Installation Tasks for Siebel Server >

Creating Additional Servers Within 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, so that you can test the connection to the additional servers. For information about installing the SWSE, see Installing Siebel Web Server Extension.

Use the installer to create additional Siebel Servers in an existing Siebel Enterprise Server. You may also use this script to reconfigure existing Siebel Servers.

NOTE: Typically, you will only create multiple Siebel Servers on one machine for test or development purposes. It is strongly recommended that you create only one Siebel Server per machine in your production environment.

To configure an additional Siebel Server

Log on to the machine where the Siebel Server software is installed as the Siebel Service Owner.

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 SIEBEL_ROOT variable is set to the Siebel root directory.

NOTE: 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.

If the Siebel environment variables are not set or are set incorrectly, navigate to the $SIEBEL_ROOT/siebsrvr directory and choose the appropriate command for your UNIX shell or its variant.

Korn or Bourne shell:

. ./siebenv.sh

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

C-shell:

source siebenv.csh

CAUTION: Before sourcing siebenv.sh, 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 pathname for your database client library directory. If you do not set up the database environment properly, you will receive an error message.

Enter config_server to start the Siebel Enterprise Server configuration script.

The config_server script accepts the command-line flags described in the following table.


Flag	Parameter	Description
`-r`	`siebel_root`	(Required) The full path to the Siebel root directory. If the $`SIEBEL_ROOT` environment is set to the Siebel root directory, then there is no need to have the `-r` switch and value in your command line. 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 the `server_config` without `-r` switch.
`-g`	`siebel_gateway`	(Required) The IP address or network name of the Siebel Gateway. If the $`SIEBEL_GATEWAY` environment is set to the IP address or network name of the Siebel Gateway, then there is no need to have the `-g` switch and value in your command line. 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 the `server_config` without `-g` switch.
`-e`	`enterprise_server`	(Optional) The Siebel Enterprise Server in which to operate; if it 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 it is not specified, you will be prompted with a list of existing Siebel Servers and given the option of defining new Siebel Servers.

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, the config_server script prompts you with the current settings for the Siebel Server and allows you to modify them.

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.

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

Repeat the steps described under Installing and Configuring the Siebel Server.

The config_server script will exit after it has completed the chosen task.

Creating New Siebel Servers and Siebel Remote

When installing multiple Siebel Servers on a single machine, only the first Siebel Server installed can be configured to support Siebel Remote.

If you need to enable Siebel Remote on each Siebel Server, put these Siebel Servers in separate directories (in other words, they should not share the same installation files).