Operating Siebel through Command Line Interface

Author(s)
Ashish Malhotra
Radhika Bhasin

Date written: (25/03/09)

DECLARATION

We hereby declare that this document is based on our personal experiences. To the best of our
knowledge, this document does not contain any material that infringes the copyrights of any
other individual or organization including the customers of Infosys.

Ashish Malhotra
Radhika Bhasin

Project Details
 Projects involved: NSNCRMUK
 H/W Platform: UNIX
 S/W Environment: Siebel 7.7
 Appln. Type: CRM
 Project Type: Implementation

Target readers: All

CONTENTS

INTRODUCTION..............................................................................................................1
COMMANDS TO LOG INTO SERVER.......................................................................................2
To start the server manager....................................................................................2
COMMANDS..................................................................................................................2
To list the servers on server manager.......................................................................2
To set a particular Siebel Server, if there are more than one Siebel server....................2
To list all the components on a particular server........................................................2
List all environment variables..................................................................................2
List a particular environment variable.......................................................................2
List all tasks to the targeted/ all Siebel Server(s).......................................................2
List all tasks to a specific Siebel Server(s).................................................................2
List a specific task..................................................................................................2
Stop/ kill a specific task..........................................................................................2
Difference between stop and kill..............................................................................2
COMMAND TO GENERATE/ EXTRACT NEW DATABASE..................................................................2
Task to generate new database...............................................................................2
Task to extract new database only...........................................................................2
Task to extract new database and Full Get................................................................2
COMMAND TO RUN AN EIM TASK........................................................................................2
COMMAND TO GENERATE DATABASE TRIGGERS.........................................................................2

Page 1 of 10 6/29/2022
 COMMAND TO START WORKFLOW MONITOR AGENT (WORKMON)...................................................2
COMMAND TO INVOKE WORKFLOWS.....................................................................................2
Starting and Shutting down Siebel/ Gateway/ Web server through command line................2

Introduction

When Siebel and Gateway servers are installed on AIX/ UNIX box, we do not have a GUI
interface to run various tasks/ commands. So we telnet/ use tools (putty) to run the
commands and tasks to run workflows/ schedule jobs/ EIM tasks etc.Some basic commands
are listed in this document which have been used by us in our project:

Commands to Log into Server

 Login to the server by doing telnet to that IP/ using Putty.

 Provide valid username and password.
 After successful login following prompt appears:

 Change directory to cd /siebeldev/siebsrvr (where Siebel server is installed)

 To execute environment variables execute command: . ./siebenv.sh (this command
will set / refresh Siebel paths)
 Now we are in directory: ServerName:/siebeldev/siebsrvr/ >

Let us take following naming conventions:

EnterpriseServer = siebeldev
GatewayServer = GateServ01
SiebelServer = siebserv01
Username = sadmin
Password = *****

 To start the server manager

srvrmgr /e EnterpriseServer /g GatewayServer /s SiebelServer /u UserName /p Password
Using naming conventions, we get:

Page 2 of 10 6/29/2022
 srvrmgr /e siebeldev /g GateServ01 /s siebserv01 /u sadmin /p *****

After Siebel server manager has started with a message – “Connected to 1 server(s) out of
a total of 1 server(s) in the enterprise”, following prompt appears:

srvrmgr:siebserv01>

Commands

 To list the servers on server manager

srvrmgr:siebserv01>list servers
O/P as below:

Page 3 of 10 6/29/2022
  To set a particular Siebel Server, if there are more than one Siebel server

NOTE: this command will work if we do not specify a Siebel server during the
srvrmgr command
srvrmgr:siebserv01>set server SiebelServer
Or
srvrmgr:siebserv01>set server SiebServ01
And thereafter all the commands are targeted on that particular Siebel server. To disconnect
from the server we use unset command.

 To list all the components on a particular server

srvrmgr:siebserv01>list components for server <SiebelServerName>
(Replace <SiebelServerName> with the siebel server name)
i.e.
srvrmgr:siebserv01>list components for server SiebServ01
O/P as below:

Wildcard characters can also be used in UNIX commands

srvrmgr:siebserv01>list components for server Sieb%
This will list all the components of Siebel servers that start with Sieb.
O/P as below:

 List all environment variables

srvrmgr:siebserv01>show
O/P as below:

Page 4 of 10 6/29/2022
  List a particular environment variable
srvrmgr:siebserv01>show <VariableName>
Or
srvrmgr:siebserv01>show header
O/P as below:

 List all tasks to the targeted/ all Siebel Server(s)

srvrmgr:siebserv01>list tasks

 List all tasks to a specific Siebel Server(s)

srvrmgr:siebserv01>list tasks for server SiebelServer
Or
srvrmgr:siebserv01>list tasks for server SiebServ01
O/P as below:

Page 5 of 10 6/29/2022
  List a specific task
srvrmgr:siebserv01>list task <TaskId> (given by column TK_TASKID in the above
screenshot)
Or
srvrmgr:siebserv01>list task 16412
O/P as below:

 Stop/ kill a specific task

srvrmgr:siebserv01>stop task <TaskId>
This command will stop the task specified in TaskId.

srvrmgr:siebserv01>stop task <TaskId> for server SiebServ01

This command will stop the task specified in TaskId for SiebServ01 server.

srvrmgr:siebserv01>kill task TaskId

This command will kill the task specified in TaskId.

Page 6 of 10 6/29/2022
 srvrmgr:siebserv01>kill task TaskId for server SiebServ01
This command will kill the task specified in TaskId for SiebServ01 server.

 Difference between stop and kill

Kill command signals the Siebel Server to use operating system control to terminate the
task. Kill command means selecting Stop task from Menu button three times in succession
on a running task.

Command to Generate/ Extract new database

 Task to generate new database

After logging in to server manager, following command is used to generate new database:
srvrmgr:siebserv01>start task for comp GenNewDb

 Task to extract new database only

After logging in to server manager, following command is used to extract new database:
srvrmgr:siebserv01>start task for comp DbXtract with client = <DB USERNAME>

 Task to extract new database and Full Get

srvrmgr:siebserv01>start task for comp DbXtract with client = <DB USERNAME>,
ExtractRepos = TRUE

Ensure to register USER as mobile Web client by:

 Log in to your Siebel application using an account with access to the Administration -
Siebel Remote screen.
 From the application-level menu, choose Site Map > Administration - Siebel Remote >
Mobile Clients.
 In the Parent Server form, choose the HQ parent node which is the default value.
 In the Mobile Clients list, click New to add the user as Mobile Client.

Command to run an EIM task

After logging in to server manager, following command is run to execute job that loads data
from EIM tables to base tables:

srvrmgr:siebserv01>start task for comp eim with config=”IFB_FILE_NAME”, ErrorFlags=1,

TraceFlags=1, SQLFlags=8, ExtendedParams=”BATCHRANGE=<NUMBER1>-<NUMBER2>”

The flags are activated to log transactions and the values may vary.
 Setting the Error Flags parameter to 1 produces a detailed explanation of rows that
were not successfully processed.
 Setting the SQL Flags parameter to 8 creates a log of all SQL statements that make
up the EIM task.
 Trace flags contain logs of various EIM operations. Setting Trace Flag=1 provides a
summary (after each batch) of the elapsed time in EIM steps.

Command to generate database triggers

After logging in to server manager, following commands are given whenever server is
restarted, Existing workflow policies are modified or new workflow policies are created.

Page 7 of 10 6/29/2022
 srvrmgr:siebserv01>run task for comp GenTrig with
EXEC=True,Remove=True,PrivUser=siebel,PrivUserPass=<Password>,AlertLevel=2,
ErrorFlags=1, TraceFlags=1, SQLFlags=8

srvrmgr:siebserv01>run task for comp GenTrig with

EXEC=True,Remove=False,PrivUser=siebel,PrivUserPass=<Password>,AlertLevel=2,
ErrorFlags=1, TraceFlags=1, SQLFlags=8

Command to start Workflow Monitor Agent (WorkMon)

After logging in to server manager, following command is given:

srvrmgr:siebserv01>start task for comp WorkMon with GroupName=’WORKFLOW_GROUP’,

ActionInterval=10

Command to invoke Workflows

After logging in to server manager, following command is given:

srvrmgr:siebserv01>start task for comp WfProcMgr with ProcessName=’WORKFLOW_NAME’

Starting and Shutting down Siebel/ Gateway/ Web server through command line
The procedure to Start/ Recycle services on AIX box is:

 Login to the server by doing telnet to that IP/ using Putty.

 Provide valid username and password.
 After successful login following prompt appears:

2. For Siebel Server:

 Change directory to cd /siebel/siebsrvr (path where Siebel server is installed)
 To execute environment variables execute command: . ./siebenv.sh (this command
will set / refresh Siebel paths)
 Now type cd bin to move to directory: ServerName:/siebel/siebsrvr/bin >
 Type ls –l *st* - will give output as:

Page 8 of 10 6/29/2022
  1st command list_server all: will give the last time Siebel server was started/
stopped.
 2nd command start_server all: will start the Siebel server.
 3rd command stop_server all: will stop the Siebel server.

3. For Gateway server:

 Change directory to cd /siebel/gtwysrvr
 To execute environment variables execute command:  . ./siebenv.sh (this command
will set / refresh Siebel paths)
 Now type cd bin to move to directory: ServerName:/siebel/gtwysrvr/bin >
 Type ls –l *st* - will give output as:

 1st command list_ns: will give the last time Gateway server was started/ stopped.
 2nd command start_ns: will start the Gateway server.
 3rd command stop_ns: will stop the Gateway server.

Page 9 of 10 6/29/2022
 4. For Web Server:
 Change directory to cd /usr/IBMIHS/bin to move to directory:
ServerName:/usr/IBMIHS/bin >
Information about webserver installation path (:/usr/IBMIHS/bin) can be fetched from
“eappweb.config.log” file.
Wherever the web server is installed, this log file can be found with the name,
“eappweb.config.log”.
For e.g. in our case it can be found in /siebel/eappweb/
 Type ls –l *st* - will give output as:

Since we can see above that the process owner is root and root needs special
permissions, so to execute these files we need special permissions which only root user
has. To login to ROOT use following commands:

 su –  (this user has privileges to execute processes owned by root)

 root’s valid Password: ***** (password is case sensitive)
 . /startapa  (this command will start the apache server)
 . /stopapa  (this command will stop the apache server)

Using ROOT user, one should never traverse to any of the Siebel Installation
folders.After the start / stop of Web server, we should EXIT from using the root(su)
user.

REFERENCES

 Siebel Bookshelf

Page 10 of 10 6/29/2022