Bookshelf Home | Contents | Index | PDF     

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

Installing the Siebel Web Server Extension

The installation program sets up the Siebel directory structures, copies required files and components to the target disk, and configures the host environment.

Multiple-version instances of the SWSE on a single Web server are not supported in a production environment.

On IHS and HP-Apache2 servers you also must modify the following two lines in the httpd.conf file:

Listen:port number

SeverName:port number

where:

Listen = IP Address of Web Server machine

SeverName = Machine name

For example:

172.20.167.154:16131

sdch70a012.siebel.com:16131

To prevent installation problems related to permissions, the user who installs the SWSE should be the same user or have the same permissions as the user who installed the Web server instance.

To avoid DVD swapping, copy all installation files, including the required language files, to a common installation directory within your system or use the Network Image Creator. For more information, see Selecting Your Media for Installation. If you elect not to install directly from DVD, you will not see some of the prompts regarding swapping the DVD in the following procedure.

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

To install the Siebel Web Server Extension under UNIX

  1. (Solaris only) Instantiate an instance of the Web server and record the port number at which it is listening.
  2. Uninstall your existing SWSE.
  3. If you are installing from DVD, insert the appropriate DVD for the Siebel applications into the DVD drive, and mount this DVD:
    • Siebel eBusiness Applications, Base Applications for UNIX_OS
    • Siebel Industry Applications, Base Applications for UNIX_OS

      where:

      UNIX_OS = Your UNIX operating system, such as AIX, HP-UX, or Solaris

      NOTE:  The volume label for the DVD is seaUNIX_OSunibase (for Siebel eBusiness Applications) or siaUNIX_OSunibase (for Siebel Industry Applications), where UNIX_OS is aix, hpux, or sol.

  4. Open a new shell and unset any Siebel environment variables.
  5. Verify the directories and permissions to those directories into which you will install the product. You must have read, write, and execute permission.
  6. Navigate to the root directory of the DVD or to the appropriate network directory, if you are installing from a network image.
  7. Navigate to UNIX_OS/Server/Siebel_Web_Server_Extension, where UNIX_OS is your UNIX operating system, such as AIX, Solaris, or HPUX (for HP-UX), and open a new shell.

    NOTE:  To install the SWSE, you must install using a user account that can modify the Web server files appropriate for your installation: Sun ONE Web Server, IBM HTTP Server, or HP-Apache 2 Web server files.

  8. To start the SWSE installation process, enter the following command, appending any desired flag described in Additional Flags for Installation Commands.

    ./setupUNIX_OS

    where

    UNIX_OS = Your operating system (sol, aix, hpux)

    The Installer Welcome screen appears.

  9. Click Next.

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

  10. Depending on whether you are installing your SWSE files for the first time or adding a new language to an existing instance, take the appropriate action, and then click Next:
  11. Enter the fully qualified path to the installation directory and click Next.

    The Installer Language Selection screen appears.

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

    All servers are installed with at least one primary (base) language. Additional languages can be installed at a later date, if desired. For more information, see Global Deployment Guide.

    When installing languages at a later date, you must also reinstall any patches that 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. 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 on Siebel SupportWeb.

    The Installation Verification screen appears.

  13. Click Next.

    The Installation Progress screen appears, and the installer creates uninstaller folder.

    • If you are installing more than one language, the Primary Language screen appears. Proceed to Step 14.
    • If you are installing only one language, the Web Server Root Directory screen appears. Proceed to Step 15.
  14. Select the primary language for this installation and click Next.

    The Web Server Root Directory screen appears.

  15. Select the root directory for the SWSE on your Web server and click Next.

    The installer proceeds to install the specified files. After the files have been copied to the installation location, this message appears:

    Setup did not find the lang language pack on the current media. Please insert the DVD containing the lang language pack and select the setupUNIX_OS file from the lang folder.

    where:

    lang = The code for the language you are installing, such as enu for U.S. English.

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

    NOTE:  For Siebel Industry Applications, the Windows and UNIX Language Packs are on different DVDs.

  16. Remove the current DVD from the drive and insert the appropriate Language Pack DVD.

    A dialog box titled Navigate to the executable on the lang Language Pack DVD appears and displays a file called siebel.ini. However, you do not need to do anything with this file.

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

  17. Open setupUNIX_OS under UNIX_OS/Server/Siebel_Web_Server_Extension/lang directory, where UNIX_OS is for your UNIX operating system and lang is the code for the Language Pack you are installing, such as enu.

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

  18. When installation of all the language files is completed, the installer prompts you again for the base DVD.

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

  19. Reinsert the base DVD, navigate to UNIX_OS/Server/Siebel_Web_Server_Extension/setupUNIX_OS, and click OK.

    The Load Balancing Configuration screen appears.

  20. Select the desired load-balancing method for your environment and click Next.
    • If you select Single Siebel Server in the Enterprise, proceed to Step 21.
    • If you select Use a Third Party Load Balancer, proceed to Step 22.
    • If you select Use Siebel Load Balancing, proceed to Step 23.
  21. Enter Hostname for the Siebel Server and the port number (default 2321) for the SCBroker component. Click Next and proceed to Step 24.

    This port is used for all communications between the Web server and the Siebel Server. Make sure the port you specify for the SCBroker (Siebel Connection Broker) component is not occupied by any other applications, other Siebel components (such as Siebel Gateway Name Server), or other Siebel Server instances. If you have installed multiple Siebel Servers on this machine, make sure you enter a unique SCBroker port for each Siebel Server instance.

    If you need to change the SCBroker port number later, use Siebel Server Manager to specify a value for the Static Port Number parameter (alias PortNumber). For more information about SCBroker, see Siebel System Administration Guide and Deployment Planning Guide.

  22. Enter virtual IP address or hostname and virtual port number for a third-party load balancer, if you use one. Click Next and proceed to Step 24. For information on writing routing rules for third-party HTTP load balancers, see the Deployment Planning Guide.
  23. Enter the full path to the virtual host file (lbconfig.txt). Click Next and proceed to Step 24.

    This file must already exist. For more information, see Siebel Web Server Extension Installation Requirements.

  24. Enter the name of your Enterprise Server and click Next.

    The Compression Type screen appears.

  25. Select the type of compression you want to use for communications between the Web Server and the Siebel Servers, and click Next:

    None

    ZLIB

    The Encryption screen appears.

  26. Select the encryption type the Siebel Web Clients should use to communicate with the Application Object Managers and click Next:

    NONE. No networking encryption.

    RSA. Required protocol if you will be using the RSA Security Systems 128-bit strong encryption feature for data transport.

    NOTE:  The Application Object Managers to which the Siebel eBusiness Applications connect must be configured to use the same protocol. For more information, see Installing the Siebel Server.

    The Web Server HTTP Port screen appears.

  27. Accept the default HTTP port (80), or enter a new port number, and click Next.

    The Installer Configuration Web Server HTTPS (Secure HTTP) Port screen appears.

  28. Accept the default Web Server HTTPS port (443), or enter a new port number, and click Next.

    The Web Update Protection Key screen appears.

  29. Enter the Web Update Protection Key that your administrator will use for Web maintenance.

    For information on what this key is used for, see About the Web Update Protection Key.

    The Anonymous Login Employee Name screen appears.

  30. Enter the anonymous employee login ID and click Next.

    NOTE:  This value should be a login ID that any employee may use to access the Login view. The login ID should be a valid client login with privileges to navigate to Login views.

    The Anonymous Login Employee Password screen appears.

    This parameter is for employees who may browse applications without logging in.

    NOTE:  If you do not want to enable this feature for some employees, you can bypass this screen without entering anything by just clicking Next.

  31. If you use this parameter, enter the anonymous login password, confirm it, and click Next.

    The Anonymous Login Contact Name screen appears.

  32. Enter the anonymous login contact name and click Next.

    The Anonymous Contact Password screen appears.

  33. Enter the anonymous login password, reconfirm it, and click Next.

    The Deploy Secure Sockets Layer screen appears.

  34. Indicate whether you want to deploy secure socket in your enterprise or not, by selecting or clearing the Yes box on this screen.
  35. On the Certificate File Name screen, enter the following and click Next:

    Certificate File Name. The certificate file name.

    CA Certificate File Name. The certificate authority file identifying the trusted authority who issued the certificate.

    The Private Key File Name screen appears.

  36. Enter the following and click Next:

    Private Key File Name. Name of the private key file.

    Private Key File Password. Password for the private key file name.

    Private Key File Password (confirm). Password you entered in the preceding example.

    The Peer Authentication screen appears.

  37. Select whether or not you want Peer Authentication.

    The Restart screen appears.

  38. Indicate whether or not you want to restart the Web server now to complete the changes and click Next.

    NOTE:  If you did not choose to restart your Web server earlier during configuration, your changes will not take effect until you do so.

    The Installer Verification screen appears.

  39. Verify the settings:
    • To apply the settings, click Next.
    • If you want to change any, use the Back button to go back and update any parameters. You can use the Next button to return to this screen and confirm your new values.

      The Configuration Wizard displays the message that the SWSE has been successfully installed.

  40. Click Finish.

About the Web Update Protection Key

The Web Update Protection Key is the password your Siebel administrator uses to refresh the application image files on your Web server your developers have updated and placed on the Siebel Server after customizing the Siebel application with Siebel Tools.

The Web server contacts the Siebel Server, refreshing these images each time the administrator restarts the Web server. However, administrators can achieve the same result, refreshing the images by just entering this password in a command line, particularly when deploying multiple Web servers. For more information on this topic, see Security Guide for Siebel eBusiness Applications.

NOTE:  Although the Web Update Protection Key is set during SWSE configuration, you may change it later on, if desired, by editing it in the eapps.cfg file, located in the bin subdirectory of your SWSE installation.

To avoid the Web server cycling every time the SWSE directory images are refreshed, complete the following procedure.

To refresh the SWSE directory structure without cycling the Web server

  1. Log in to the application.
  2. Type the following URL into the Address field of the browser:

    http://host:port/application/start.swe?SWECmd=UpdateWebImages&SWEPassword=passwd

    where:

    host = The name of the Web server machine

    port = Web Server listen port (Not required if using the default port, 80)

    application = Any Siebel application, such as callcenter_enu, sales_enu, and so on

    passwd = Password defined in eapps.cfg by WebUpdatePassword

    For example:

    http://siebe1:81/callcenter/start.swe?SWECmd=UpdateWebImages&SWEPassword=siebel

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