Siebel Installation Guide for Microsoft Windows > Installing and Configuring Siebel Management Agents and Siebel Management Server > Process of Configuring Siebel Management Agents and Siebel Management Server >

Using Perl Scripts to Finish Configuring Siebel Management Agents and Siebel Management Server

This topic describes how to execute a series of Perl scripts provided with Siebel Business Applications. These scripts are a mandatory part of configuring Siebel Management Agents and Siebel Management Server for use with Siebel ADM. For more information about these Perl scripts, see Perl Scripts for Configuring Siebel Management Agent and Siebel Management Server.

Before you execute these scripts, use the Siebel Management Agent Configuration Wizard to configure each installed instance of Siebel Management Agent, as described in Configuring Siebel Management Agents. Then use the Siebel Management Server Configuration Wizard to configure the installed instance of Siebel Management Server and to register at least one installed instance, and up to two installed instances, of Siebel Management Agent, as described in Configuring Siebel Management Server.

This task is a step in Process of Configuring Siebel Management Agents and Siebel Management Server.

Executing the getservers.pl and makeagentconfig.pl Scripts

Use this procedure to execute the Perl scripts getservers.pl and makeagentconfig.pl. Execute these scripts on the Siebel Management Agent computer (where a Siebel Server is also installed). Review this topic before you execute these scripts.

To execute the getservers.pl and makeagentconfig.pl scripts

1. Copy the file configuration.globals.xml from the Siebel Management Server installation to the directory where you will execute the Perl scripts.

   To execute the Perl scripts on the Siebel Management Agent computer, copy the file from MgmtSrvrInstallDir\pref\system (on the Siebel Management Server computer) to MgmtAgentInstallDir\bin (on the Siebel Management Agent computer).

2. Navigate to the directory MgmtAgentInstallDir\bin (on the Siebel Management Agent computer).
3. Execute getservers.pl. From the command line, execute the following command:

   perl getservers.pl -g GatewayServerHostname:GatewayServerPortNumber -e SiebelEnterpriseName -u SiebelUsername -p SiebelUserPassword -l DeploymentLanguage

   For example, you might enter a command like this for Siebel CRM version 8.1.1.11:

   perl getservers.pl -g sdchs21n044:4330 -e sieb81 -u sadmin -p db2 -l enu

   NOTE:  Specifying the port number (and the preceding colon) is optional if the Siebel Gateway Name Server uses the default port of 2320.

   The following appears in the output window (in this example, sieb81 is the name of the Siebel Enterprise):

   Running SrvrMgr
   Parsing output from SrvrMgr
   Writing output to sieb81
   Generating configuration globals XML file
   Renaming configuration globals XML file

   This command invokes srvrmgr and retrieves data from the Siebel Gateway Name Server, then writes output to the configuration.globals.xml file and to a file named for the Siebel Enterprise, such as sieb81 (do not rename this file).

4. (Optional) If the port number that you are using for Siebel Management Agent is not the default of 1199, then you can edit the output file named for the Siebel Enterprise (such as sieb81) to specify the correct port number. Or, if you do not edit this file, then you can edit the port number for each Siebel Management Agent in a different file later in this procedure. See Step 8.
5. Execute makeagentconfig.pl. From the command line, execute the following command:

   perl makeagentconfig.pl SiebelEnterpriseName

   The following appears in the output window:

   Writing configuration.agents.xml

6. Copy the following files to the directory MgmtSrvrInstallDir\pref\system (on the Siebel Management Server computer):
   • configuration.globals.xml
   • configuration.agents.xml
   • sieb81 (in this example, sieb81 is the name of your Siebel Enterprise)
7. Open the file configuration.agents.xml and verify that it contains an entry key for each Siebel Management Agent, in the following format:

   <entry key="SiebelServerName" value="SiebelServerName:SiebelServer:SiebelEnterpriseName:service:jmx:rmi://HostofAgent/jndi/rmi://HostofAgent:PortofAgent/jmx/siebel/agent" />

   For example, it might contain an entry similar to the following:

   <entry key="SDCHS21N008" value="sdchs21n008:SiebelServer:sieb81:service:jmx:rmi://SDCHS21N008/jndi/rmi://SDCHS21N008:1199/jmx/siebel/agent" />

8. If necessary, update the Siebel Management Agent port numbers in configuration.agents.xml. Do this if you are using nondefault port numbers and did not edit the intermediate output file to change the port number, as described in Step 4.

   NOTE:  Unless you performed Step 4, the file configuration.agents.xml is generated with the RMI registry port for Siebel Management Agents assumed as the default of 1199. If any of the Siebel Management Agents use a port number other than 1199, then you must manually edit the entries in this file to use the correct port numbers.

Executing the admconfig.pl Script

Use the following procedure to execute the Perl script admconfig.pl. Execute this script on the Siebel Management Server computer, after executing the scripts getservers.pl and makeagentconfig.pl. Review this topic before you execute admconfig.pl.

This script generates the files deploy_enterprise_name.bat and entprofile_enterprise_name.xml. In these file names, enterprise_name is the name of the Siebel Enterprise.

To execute the admconfig.pl script

1. Log in to the computer where you are running Siebel Management Server.
2. Change to the MgmtSrvrInstallDir\pref\system directory.
3. Execute admconfig.pl. From the command line, execute the following command:

   perl MgmtSrvrInstallDir\bin\admconfig.pl -e SiebelEnterpriseName -s SCBrokerPortNumber -p ADMDefaultPackageLocation -r MgmtSrvrInstallDir

   For example, on Windows you might enter a command like this for Siebel CRM version 8.1.1.11:

   perl C:\sba81\mgmtsrvr\bin\admconfig.pl -e sieb81 -s 2321 -p C:\sba81\mgmtsrvr\adm\packages -r C:\sba81\mgmtsrvr

   The following information appears in the output window (in this command, sieb81 is the name of the Siebel Enterprise):

   Creating deploy_sieb81.bat
   Creating entprofile_sieb81.xml

   This example command creates the file deploy_sieb81.bat in the MgmtSrvrInstallDir\pref\system directory and the file entprofile_sieb81.xml in the MgmtSrvrInstallDir\adm directory.

   See also About Configuring Siebel Management Agents and Siebel Management Server.