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

Using Perl Scripts to Register Additional Siebel Management Agents and Configure Siebel ADM

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

This topic describes how to execute a series of Perl scripts provided with Siebel Business Applications to register additional instances of Siebel Management Agent with Siebel Management Server and to configure Siebel ADM (where Management Agent is on Windows).

If you have more than two instances of Management Agent installed, first register at least one of them (up to two) using the Management Server Configuration Wizard. Then follow the first procedure in this topic to register the remaining Management Agents with the Management Server.

If you have Siebel ADM (where Management Agent is on Windows), also follow the second procedure in this topic.

Executing these Perl scripts invokes the srvrmgr executable to retrieve information from the Siebel Gateway Name Server about installed Siebel Servers and Management Agents, then generates XML files containing data needed by Management Server.

After verifying or updating port numbers in these files, you then copy the XML files to the Management Server (updating existing files).

You would also use the Perl scripts if your Management Server needs to work with more than one Siebel Enterprise, such as if you are monitoring multiple Enterprises using Siebel Diagnostic Tool.

NOTE:  If you add more Siebel Servers with Management Agents later, perform this task again to register them with the Management Server.

The Perl scripts provided are:

• getservers.pl
• makeagentconfig.pl
• admconfig.pl (for ADM) - provided with Management Agent on Windows only, not UNIX

The Perl scripts are provided as part of both the Management Agent and Management Server installations. They are located in:

• MgmtAgentInstallDir\bin (Management Agent installation directory, on Windows or UNIX)
• MgmtSrvrInstallDir\bin (Management Server installation directory, on Windows only)

NOTE:  Executing the Perl scripts must be done on a machine on which you have installed a Siebel Server. In general, this topic assumes that you execute the Perl scripts on a Management Agent machine, because it is also a Siebel Server machine.

To register additional Management Agents

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

   If you are executing the Perl scripts on the Management Agent machine, copy the file from MgmtSrvrInstallDir\pref\system (on the Management Server machine) to MgmtAgentInstallDir\bin (on the Management Agent machine).

2. Navigate to the directory MgmtAgentInstallDir\bin (on the Management Agent machine).
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, enter:

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

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

   The following appears in the output window (where sieb80 is the name of the Enterprise):

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

   The command above invokes srvrmgr and retrieves data from the Gateway Name Server, then writes output to the configuration.globals.xml file and to a file named for the Siebel Enterprise—for example, sieb80 (do not rename this file).

4. 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

5. Copy the following files to the directory MgmtSrvrInstallDir\pref\system (on the Management Server machine):
   • configuration.globals.xml
   • configuration.agents.xml
   • sieb80 (where sieb80 is the name of your Siebel Enterprise)
6. Open the file configuration.agents.xml and verify that it contains an entry key for each 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 may contain an entry similar to the following:

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

7. If necessary, update the Management Agent port numbers in configuration.agents.xml.

   The file configuration.agents.xml is generated with the RMI registry port for Management Agents assumed as the default of 1199. If any of the 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.

8. (For Siebel Diagnostic Tool deployments only) Copy the configuration.agents.xml file from this folder:

   MgmtSrvrInstallDir\pref\system

   to this folder:

   MgmtSrvrInstallDir\tomcat\webapps\DiagTool\WEB-INF

   NOTE:  The target folder above is created after you run Management Server for the first time.

To execute admconfig.pl

1. (For Siebel ADM deployments only) Execute admconfig.pl. From the command line, execute the following command.

   NOTE:  This step is necessary only for Siebel ADM deployments where Siebel Management Agent is installed on Windows. Execute this script multiple times if Siebel ADM must support multiple Siebel Enterprises.

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

   For example, enter:

   perl admconfig.pl -e sieb80 -s 2321 -p C:\sba80\mgmtsrvr\adm\packages -r C:\sba80\mgmtsrvr

   The following information appears in the output window (where sieb80 is the name of the Siebel Enterprise):

   Creating deploy_sieb80.bat
   Creating entprofile_sieb80.xml

   The above command creates the file deploy_sieb80.bat in the MgmtSrvrInstallDir\pref\system directory and the file entprofile_sieb80.xml in the MgmtSrvrInstallDir\adm directory.