Bookshelf Home | Contents | Index | PDF     

Siebel Installation Guide for UNIX > Configuring Siebel Enterprise Server and Related Components > Configuring Siebel Management Agent and Siebel Management Server >

Configuring Siebel Management Agent

This topic is part of Configuring Siebel Management Agent and Siebel Management Server.

This topic describes how you configure the Siebel Management Agent after installation. You configure using the Siebel Configuration Wizard - Siebel Management Agent Configuration (the Management Agent Configuration Wizard).

In general, this topic assumes that you configure Siebel Management Agent immediately after you install it (whether you install it with Siebel Server or install it separately). Optionally, you can cancel configuration and launch it later.

Installation of Management Agent (when it is not included with a Siebel Server installation) is described in Installing Siebel Management Agent.

NOTE:  On Microsoft Windows, if you are using database authentication, in order to select the Configuration Wizard option to start the Management Agent immediately, you must have already installed the Siebel Database schema and seed data. For details on performing these tasks, see Configuring the Siebel Database.

To configure Siebel Management Agent

  1. If you will launch the Management Agent Configuration Wizard manually at the command line, open a new command window. If the wizard is launched by the installer, go to Step 3.
  2. Set the following environment variables, according to your operating system. In Step 3, launch the wizard at the command line in the same command window.
    • AIX:

    setenv LIBPATH SIEBEL_ROOT/siebsrvr/mgmtagent/lib:{LIBPATH}

    setenv PATH SIEBEL_ROOT/siebsrvr/mgmtagent/bin:{PATH}

    • HP-UX:

    setenv SHLIB_PATH SIEBEL_ROOT/siebsrvr/mgmtagent/lib:{SHLIB_PATH}

    setenv PATH SIEBEL_ROOT/siebsrvr/mgmtagent/bin:{PATH}

    • Linux and Solaris:

    setenv LD_LIBRARY_PATH SIEBEL_ROOT/siebsrvr/mgmtagent/lib:{LD_LIBRARY_PATH}

    setenv PATH SIEBEL_ROOT/siebsrvr/mgmtagent/bin:{PATH}

    where SIEBEL_ROOT is the parent directory for the installation.

    NOTE:  The commands above assume that Management Agent was installed as part of Siebel Server installation. If you installed it separately, use similar paths but remove references to the siebsrvr directory level. It is recommended to save the commands you require into a shell script.

  3. If necessary, launch the Siebel Management Agent Configuration Wizard.

    For more information, see About Configuring Siebel Enterprise Server and Related Components and Launching the Siebel Configuration Wizard. Specific command-line examples are shown in Commands for Launching Configuration Wizards.

    If you installed Management Agent as part of Siebel Server installation, go to Step 5. If you installed Management Agent separately, go to Step 4.

  4. The wizard requests the location of the home directory for the Siebel Server on the machine where you install the Siebel Management Agent. For example, on Windows this could be:

    C:\sba80\siebsrvr

    Enter the location of the home directory for the Siebel Server, then click Next.

    A screen appears that requests the account details of the Siebel user who accesses Siebel Management Agent.

  5. Enter the Siebel user name and password, confirm the password, then click Next.

    The wizard requests the location of the JRE home directory.

  6. Click Browse to navigate to the JRE home directory. Select the directory, then click Next.

    The wizard displays a check box that allows you to enable RC2 encryption for the Siebel user account you specified in Step 5. By default, the check box is clear. For more information about RC2 encryption, see Siebel Security Guide.

  7. Take the appropriate action:
    • Select the check box to enable RC2 encryption of the Siebel user's password, then click Next. Specify or verify the full path to the RC2 key file.
    • Leave the check box clear, then click Next to leave the Siebel user's password encoded in base64 Content-Transfer-Encoding.

      The wizard requests the port number for the RMI Registry. Requests to connect to this Siebel Management Agent use this port number (default 1199).

  8. Enter the port number for the RMI Registry or accept the default, then click Next.

    The wizard requests the type of authentication to deploy for Siebel Management Agent. You must select the same type of authentication for both Siebel Management Server and any Siebel Management Agents that connect to this Siebel Management Server. For more information about authentication types, see Siebel Security Guide.

  9. Select the type of authentication, then click Next.
    • If you selected LDAP or Database, go to Step 10 and specify the path to the security adapter file. Use one of these options for production deployments.
    • If you selected None, go to Step 11. This option is not suitable for production deployments.

      NOTE:  For deployments using Siebel ADM, None will allow ADM to perform deployments without any authentication credentials (anyone with access to the ADM server installation directory can run deployments).

  10. Specify the path to the security adapter file (located in the bin subdirectory of the Management Agent installation directory), then click Next.
    • For LDAP, specify the file secadp.cfg.
    • For database authentication, specify the file odbcsecadp.cfg.

      For database authentication, after you configure the software you must edit the file odbcsecadp.cfg before operation so it contains values like the following. Set DSConnectString to your ODBC data source name (such as SBA_80_DSN, where SBA_80 is the name of the Siebel Enterprise). Set DSTableOwner to the owner of the Siebel schema (such as siebel).

    [ServerDataSrc]
    DSConnectString = SBA_80_DSN
    DSTableOwner = siebel

    The wizard asks if you want to deploy the Secure Sockets Layer (SSL) protocol for Siebel Management Agent. For more information about SSL, see Siebel Security Guide.

  11. Take the appropriate action:
    • To deploy SSL, select the check box, then click Next. Proceed to Step 12.
    • Leave the check box clear if you do not want to deploy SSL, then click Next.
      • On Microsoft Windows, the wizard requests the Microsoft Windows account details for the machine that hosts the Siebel Management Agent. Proceed to Step 15.
      • On UNIX, proceed to Step 17.
  12. Take the appropriate action:
    • Select Client to use the SSL protocol for communication from the client, then click Next. (In this context, the client is the Siebel Management Server.) The wizard requests the name of the Truststore file. Proceed to Step 14.
    • Select Dual to use the SSL protocol for communications in both directions (between the Management Server and the Management Agents), then click Next. The wizard requests the Private Key File Name and Private Key File Password. Proceed to Step 13.
  13. Enter values for the Private Key File Name and Private Key File Password, then click Next.

    The wizard requests the name of the Truststore file.

  14. Enter the name of the Truststore file, then click Next.
  15. Enter the Windows User Account and the Windows User Account Password, confirm the password, then click Next.

    The wizard asks if you want to start Siebel Management Agent.

  16. Take the appropriate action:
    • To start Siebel Management Agent when configuration completes, select the check box and click Next.

      NOTE:  On Microsoft Windows, if you are using database authentication, in order to select this option, you must have already installed the Siebel Database schema and seed data. For details on performing these tasks, see Configuring the Siebel Database.

    • To start Siebel Management Agent at a later time, leave the check box clear and click Next.

      The wizard summarizes the selections you have made.

  17. Review this information and take the appropriate action:
    • If the information is correct, click Next to complete the configuration. A dialog box appears that asks if you want to execute the configuration. Proceed to Step 18.
    • If the information is incorrect, click Back to return to the parameter you need to modify.
  18. Click OK to execute the configuration and complete the configuration of the Siebel Management Agent.
  19. If you launched the Configuration Wizard from the installer, return to Installing Siebel Management Agent to complete the installation.

    After you have configured all Management Agents:

    
Siebel Installation Guide for UNIX Copyright © 2011, Oracle and/or its affiliates. All rights reserved. Legal Notices.