Table Of Contents

RME Command Reference

RME Command Reference

---

This appendix provides a list of the RME commands.

Command	Description
backup.pl	Backs up the database. NMSROOT/bin/perl backup.pl backdir [logfilename [numberGen] ]
dbpasswd.pl	Changes the database password along with its access configuration files. NMSROOT/bin/dbpasswd.pl {all | dsn=data source [opwd=old password] [pfile=properties file] | listdsn}
dbRestoreOrig.pl	Re-initializes the RME data (database and file system), if the RME data is corrupted and the database restore operation has failed. Syntax: NMSROOT/bin/perl NMSROOT/bin/dbRestoreOrig.pl dsn=dsnname dmprefix=dmprefixname [ npwd=newpassword ] Where: dsn=xxx xxx is the ODBC data source name for the database For Common Services, dsn=cmf For RME, dsn=rmeng dmprefix is required for constructing database engine process name. For Common Services, dmprefix=Cmf For RME, dmprefix=RME All the user configurable variable parameters are case-sensitive. Ensure that you enter the exact value as mentioned here—if not, the database will get corrupted.
dig	Sends domain name query packets to name servers. Dig (domain information groper) is a flexible command line tool which can be used to gather information from the Domain Name System servers. Dig has two modes: •Simple interactive mode which makes a single query •Batch which executes a query for each in a list of several query lines. All query options are accessible from the command line. NMSROOT/bin/dig [@server] domain [query-type] [query-class] [+query-option] [-dig-option] [%comment]
dmgtd	Process manager daemon. Specify the tcp port to use the Daemon Management protocol on. All clients will need to have the env var PX_DMGTHOST and env var set. Daemon Manager Protocol enabled applications can report additional status. Daemon Manager sends status information to Syslog (facility: LOG_DAEMON). NMSROOT/bin/dmgtd [ -p port -v] [ names ]
pdexec / pdshow / pdterm	Controls process manager. NMSROOT/bin/pdshow [ appName1 appName2 ... ] NMSROOT/bin/pdexec [ appName1 appName2 ... ] NMSROOT/bin/pdterm [ appName1 appName2 ... ] •To get status of registered processes appName1, appName2, ..., send a request to CRM process manager using the command: pdshow [appName1 appName2 ...] •To start the registered process appName1 if it is not running, send a request to CRM process manager using the command: pdexec appName1 •To stop the registered application appName1 if it is running send a request to CRM process manager using the command: pdterm appName1 pdshow will show the status of all processes registered if no arguments are given. pdexec and pdterm require one or more appNames. where appNameN represents the registered name of each process that is registered with CRM process manager.
pdmsg	Broadcasts a string to all registered daemons under Daemon Management that are in the "Running Normally" state. To use this command, Daemon Management server must be running. NMSROOT/bin/pdmsg msg-string
pdreg	Registers and unregisters applications with CRM Process Manager. NMSROOT/bin/pdreg [-r appName -e pgm [-f pgmFlags ] [-d dependencies ] [-n] [-t 0|p|n ] ]|[-u appName ]|[-l appName ] •To register a process and invoke it without the -n or -t option. pdreg -r appName appName must be 25 alphanumeric characters or less. •To unregister a process and shut it down if the process is running. pdreg -u appName •To list the registry for a particular daemon. pdreg -l appName
pdrun.pl	A wrapper to run a command-line instruction within the CiscoWorks environment. The command line instruction to be run needs to be double quoted as the argument. If the command-line instruction itself contains double quotes, precede it with a back slash. To run a command line instruction within the CiscoWorks environment: NMSROOT/bin/perl pdrun "pdshow \"ANIServer jrm\""
removeJrmJobs.pl	Removes all the existing JRM jobs from cmf database. This is used in remote upgrade from RME 3.5.x and RME 3.4.x. NMSROOT/rigel/scripts/rme/removeJrmJobs.pl
restorebackup.pl	Restores an earlier backup of the database. NMSROOT/bin/perl NMSROOT/bin/restorebackup.pl [-d BackupDirectory] [-gen GenerationNumber] [-t TempDirectory] [-help] Where: •NMSROOT is the CiscoWorks installation directory •[-d BackupDirectory] Directory where RME 3.4 or RME 3.5 backup data is available. This is mandatory. •[-gen GenerationNumber] Version to be migrated to RME 4.2. By default, it will restore the latest backup data. If generations 1 through 5 exist, then 5 will be the latest. This is optional. •[-t TempDirectory] Temporary directory used by restore framework to extract the content of backup archive. By default the temporary directory is created under NMSROOT as NMROOT/tempBackupData. You can customize this, by using this -t option, where you can specify your own temp directory. This is to avoid overloading NMSROOT. This will be deleted after the data restoration is complete. This is optional. •[-help] Provides help. When used with -d Backup Directory syntax, shows correct syntax along with available suites and generations.
uninstall.sh	Uninstallation program that removes files and settings. Uninstallation allows you to remove only RME or remove CiscoWorks CD One as well. To remove CD One, you must remove RME as well. Before removing RME, you must first remove any applications that depend on RME. NMSROOT/bin/uninstall.sh