shell commands

Session Manager Shell Commands
Contents
■ 1 Initialization and Recovery Commands
■ 1.1 start
■ 1.2 stop
■ 2 Logging Commands
■ 2.1 acalls
■ 2.2 clcalls
■ 2.3 clgrep
■ 2.4 smlogclear
■ 2.5 sm
■ 2.5.1 clogin/clogoff
■ 2.5.2 logrestart
■ 2.6 smlogrestart
■ 3 Maintenance commands
■ 3.1 changeMgmtIP
■ 3.2 initDRS
■ 3.3 initTM
■ 3.4 IPchange
■ 3.5 runsmconsole
■ 3.6 setup_snmp
■ 3.7 smclust
■ 3.8 smconfig
■ 3.9 smstat
■ 3.10 swversion
■ 4 Product/Alarm IDs
■ 4.1 getProductID

■ 4.2 setProductID
■ 4.3 spiritAgentCLI
■ 5 ASSET commands
■ 5.1 asset-hw
■ 5.2 asset-report
■ 5.3 asset-version
■ 5.4 asset-shell
■ 5.5 asset-cold-boot
Initialization and Recovery Commands
start
Starts the SM processes either singly or as a whole.
[root@asm ~]# start -?
USAGE: start -a [-c]
start -s application [-cm]
-a will start all applications
-c will continually display system status
-m when combined with -s, will manually start the service if watchd
is not running.
-p make start persistent (e.g. after a Linux reboot).
-s will start a specific application/service, which can be:
logevent
atd
crond
ntpd
sshd
syslog
postgres-db
sm-mgmt
sm-maint
sipas-MS
sipas-SD
sipas-SH
sipas-LH
sipas-LES
secmod
rename_callfile

sal-agent
-? display this help message
stop
Stops the SM processes either singly or as a whole.
[root@asm ~]# stop -?
USAGE: stop -a [-cbfinp]
stop -h [-cbfinp]
stop -r [-cbfinp]
stop -s application [-Sbcfmnp]
-a will stop all applications
-c will continually display system status
-f will override any warnings/errors encountered with with the -a, -h,
-r and -s options
-h will stop all applications and then execute a processor halt
-i immediately stop all applications without allowing them to clean up
-m when combined with -s, will manually stopt the service if watchd
is not running.
-n do not prompt before prior to executing this command
-p make stoppage persistent (i.e. service not started).
-r will stop all applications and then execute a processor reboot
-S do not return until application(s) is stopped. Normally, this
command returns when the stop request has been received by the
system.
-s will stop a specific application/service, which can be:
logevent
atd
crond
ntpd
sshd
syslog
postgres-db
sm-mgmt
sm-maint
sipas-MS
sipas-SD
sipas-SH
sipas-LH
sipas-LES
secmod
rename_callfile
sal-agent
-? display this help message

Logging Commands
acalls
turns the ASSET call logging output (from /var/log/asset.log) into the same format as that in the calls.log file. It's output can be given to the
clcalls command (with the - option).
clcalls
This command is used to analyze call logs and group messages into individual call sequences. This includes subscriptions/notify events, and
registrations
There are several options that allow you to filter and present calls in several different ways.
[root@asm ~]# clcalls -?
clcalls [option]... [-|calls.log...]
- stdin has calls.log stream
if no file is specified than calls.log is assumed
-a read and convert messages from asset.log instead
-l when processing standard log files, use latest
-n show numeric IP addresses
-p show TCP/UDP ports
-v verbose (--showDelta,--showIndent,--showName,--showTime)
-vv verbose+ (--showMessage, --showPorts)
Call Filtering
-g pat only show those calls that have one message that matches pat
(tag matching message with a *)
-gr pat only match the request/response line
-go pat only show those messages that match pat
--noINV do not show INVITE/BYE calls
--noREG do not show REGISTER calls
--noSUB do not show SUBSCRIBE/NOTIFY calls
--noIncomplete do not show incomplete calls
--noGood do not show good calls (bad ones only)
--noGood2 do not show good calls, nor PRA, nor UPD errors
--onlyINVITE -oi only show INVITE messages
--onlyINVITEcomplete
-oic INVITE/OK/BYE
--onlyIncomplete -oinc only show incomplete calls
--MessageOnly -mo don't group messages into calls
--noLinkCalls do not link calls together with Via: tag= parameter

Call Message Filtering
--noMsg do not show messages associated with calls (headline only)
--noCM do not show messages to/from CM
Call Headline information
-csv show calls in csv file format => --noMsg
--showCallTimes -sct show time between certain messages {in ms}
--showHeadlineIP -ship show IP info on headline
--showSize -ssiz show message counts and sizes on headline
--showTags -stag show various tags and call-id's on headline
Call Message information
--showDelta -sd show time from call beginning on each message
--showIndent -si indent call endpoints into different columns
--showMessage -sm show the full SIP message
--showNameIP -sni show IP address along with name
--showPorts -sp show TCP/UDP ports (same as -p)
--showSig -ssig show call signatures
--showTime -st show time of day for each message
--showTrying -stry show trying messages too
--Summary summarize calls (at bottom)
--SummaryOnly don't show calls
--sumReg -sur show summary of registered contacts
--sumSig -sus show summary of call signatures
--sumCallTimes -suct show summary of call timing
--sumEpt -suept show summary by endpoint
clgrep
from the calls.log, display the full message that has any part that matches the grep pattern
smlogclear
Run with a module as an argument, this command clears the logs for that module (which should be stopped first). This eliminates any ability
to debug past problems.
sm
See smclust below for background information.

clogin/clogoff
To enable call logging for the Service Host (SH) execute
[root@asm ~]# sm clogon
ServiceHost calls.log: changing state to INFO
To disable, run
[root@asm ~]# sm clogoff
ServiceHost calls.log: changing state to WARN
logrestart
■ To clear the logs and restart the Service Host use
[root@asm ~]# sm logrestart
watchdog stopping sipas-SH
shutdownsvc succeeded
watchdog starting sipas-SH
addsvc succeeded
■ to clear all the logs and restart all SIP A/S services (Service Host/Management Server/Service Director):
[root@asm ~]# sm logrestart all
watchdog stopping sipas-SH
shutdownsvc succeeded
watchdog stopping sipas-SD
shutdownsvc succeeded
watchdog stopping sipas-MS
shutdownsvc succeeded
watchdog starting sipas-SH
addsvc succeeded
watchdog starting sipas-SD
addsvc succeeded
watchdog starting sipas-MS
addsvc succeeded

smlogrestart
Run with a module as an argument, this command stops, clear logs, then starts the module. This command may be removed in later releases.
Maintenance commands
changeMgmtIP
This script points a Session Manager at a new System Manager IP address.
[root@asm ~]# changeMgmtIP
Usage: /opt/Avaya/bin/changeMgmtIP IP_ADDRESS
initDRS
This script is used to manually start DRS Replication and initial loading of the database.
initTM
This script can be used to update the enrollment password used in Trust Management during installation. If you change or reinstall System
Manager you will have to run it as well.
[admin@asm ~]$ /opt/Avaya/bin/initTM
Enrollment Password:
Initializing Session Manager Trust Management
Finished configuring Trust Management
Restarting Session Manager Maintenance
shutdownsvc succeeded
addsvc succeeded
IPchange