Recommendations for Using the Command-Line Interface

This topic provides recommendations for using the Server Manager command-line interface.

• Target specific Siebel Servers without using the /s or -s flag:

  • Use the directive for server siebel_server_name in individual commands. Specifying the name of a specific Siebel Server targets the command to only that Siebel Server.

  • Use a partial name with the % wildcard character to target the command to all of the Siebel Servers with names matching the pattern. Only patterns that start or end with the wildcard character are matched. Wildcards in the middle of the string are not matched. For example, the following command lists components for all of the Siebel Servers with a name beginning with WF:

    list components for server WF%
    

  • Use the command set server siebel_server_name. To return to the mode where commands are targeted to all of the Siebel Servers, use unset server. For more information about these commands, see "Siebel Server Manager Environment Commands".

    
    

    Note: When you are using the set command, the connections to other Siebel Servers are maintained and continue to run.

    
    

• Start srvrmgr using the /s or -s flag for frequent list operations. Parse the resulting data for each Siebel Server. Aggregate the list data for the enterprise externally to the srvrmgr process. This method improves performance by keeping srvrmgr from serializing the operations.

• Use the show clause to specify only the columns with data that you are using. For more information about using the show clause, see "List Command Configuration".

• Use the /i or -i option to open a single long-running srvrmgr session and send it commands rather than using the /c or -c option. You can also execute commands conditionally from a script, by using the /i or -i option.

• When using srvrmgr commands from a file or script, use the sleep command to configure wait periods (in seconds) before the next srvrmgr command. For example, after starting the Siebel Server, use the sleep command to wait until the Siebel Server and its component are running before issuing the next command.

• Use the read command during an active srvrmgr session to dynamically input srvrmgr commands from a file.

• Specify a value for the parameter TaskTag when starting a new task. This text appears in the list tasks command if you include the TK_TASKTAG column. For example, enter a command like the following:

  list tasks show TK_TASKTAG
  

• Start srvrmgr using the /z or -z flag to connect to a server group. For example, on a Windows server, enter a command like the following:

  srvrmgr /g gateway1 /e enterprise1 /z server_group_name /u sadmin /p pwd
  

  On a UNIX server, enter a command like the following:

  srvrmgr -g gateway1 -e enterprise1 -z server_group_name -u sadmin -p pwd
  

  This command connects you to all of the Siebel Servers assigned to the server group.