Commands and Processes

cwbmonitord

DLSw and RSRB monitor daemon.

cwbdlswpollerd

DLSw poller daemon.

cwbrsrbpollerd

RSRB poller daemon.

cwbtrapd

DLSw and RSRB trap daemon.

Command

cwb {start | stop} cwbmonitord

Optional Arguments

-h

Displays a help message.

-v

Displays the version.

-c

Starts with an empty client list. Without this option, the monitor daemon reestablishes the list of GUI application clients that were registered when it was last run. See the "Client List Table" section.

-t sleep_time

Specifies the number of seconds the daemon waits from when it completes one cycle until it starts the next cycle.

UDPport

Specifies the User Datagram Protocol port to which the monitor daemon listens for communication from the GUI client applications. The default is port 6000. If you want the monitor daemon to listen to a different port number, enter that number here. If you change the port number here, you must also change it in the runprocess script.

Command

cwb start cwbrsrbpollerd [-h | -v] [PollerSleepTime]

cwb stop cwbrsrbpollerd

Syntax Description

-h

Displays a help message.

-v

Displays the version.

PollerSleepTime

Specifies a slow polling timer value, which is the number of seconds the daemon can wait from when it completes one cycle until it starts the next cycle. The default PollerSleepTime is 600 seconds.

Command

cwb start cwbdlswpollerd [-h | -v] [-P PollingSleepTime] [-C PollingSleepTime] [PollingSleepTime]

cwb stop cwbdlswpollerd

Syntax Description

-h

Displays a help message.

-v

Displays the version.

-P PollingSleepTime

Specifies the non-key-peer polling timer value in seconds; the number of seconds the poller waits from when it completes one cycle until it starts the next cycle. The -P option starts the poller daemon for non-key-peer polling and sets the sleep-time value. If you omit the -P PollingSleepTime value, the default is 600 seconds.

-C PollingSleepTime

Specifies the key-circuit polling timer value, in seconds; the number of seconds the poller waits from when it completes one cycle until it starts the next cycle. The -C option starts the poller daemon for circuit polling and sets the sleep-time value. If you omit the -C PollingSleepTime value, the default is 1200 seconds.

PollingSleepTime

This option starts the poller daemon for key-peer polling and sets the sleep-time value. If you omit the PollingSleepTime value, the default is 600 seconds.

dlswNodeUpTime

ciscoDlswUpTime

dlswTConnOperLocalTAddr

ciscoDlswTConnOperLocalTAddr

dlswTConnOperConnectTime

ciscoDlswTConnOperConnectTime

dlswTConnOperState

ciscoDlswTConnOperState

dlswCircuitS1DlcType

ciscoDlswCircuitS1DlcType

dlswCircuitS1RouteInfo

ciscoDlswCircuitS1RouteInfo

dlswCircuitS2TDomain

ciscoDlswCircuitS2TDomain

dlswCircuitS2TAddress

ciscoDlswCircuitS2TAddress

dlswCircuitState

ciscoDlswCircuitState

Command

AppnPollerServer

appnNodeCpName

ibmappnNodeCpName

appnNodeType

ibmappnNodeType

appnLocalTgOperational

ibmappnLocalTgOperational

appnLocalTgCpCpSession

Command

cwbhcmdd [-h | -v] domain_name

Syntax Description

-h

Displays a help message.

-v

Displays the version.

domain_name

Enter the name of the host domain.

Command

cwbhmond [-h | -v] domain_name

Syntax Description

-h

Displays a help message.

-v

Displays the version.

domain_name

Enter the name of the host domain.

Command

cwb {start | stop} [pm | name]

cwb start servers

Syntax Description

start

Starts the specified process by the process_name.

stop

Stops the specified process by the process_name.

pm

Starts or stops the Process Manager server. The Process manager, in turn, starts all Maps and SNA View autostarted processes.

name

Starts or stops the CiscoWorks Blue (corba osagent) name server, which is required for using the Process Manager and Message Logger. When Process manager starts, it automatically starts the name server.

start servers

Starts all autostartable servers.

sysObjectID

ipAdEntIfIndex

ifIndex

ipAdEntNetMask

ifType

dot1dSrPortLocalSegment

ifPhysAddress

dot1dSrPortBridgeNum

ipAdEntAddr

dot1dSrPortTargetSegment

rsrbRemotePeerEncapsulation

rsrbRemotePeerState

rsrbRingLocal

rsrbVirtRingIPAddr

rsrbRemotePeerIPAddr

rsrbRingBridge

rsrbRingType

dlswNodeStatus

ciscoDlswStatus

dlswTConnOperLocalTAddr

ciscoDlswTConnOperLocalTAddr

dlswTConnOperConnectTime

ciscoDlswTConnOperConnectTime

dlswTConnOperState

ciscoDlswTConnOperState

dlswTConnOperConfigIndex

ciscoDlswTConnOperConfigIndex

dlswTConnConfigTDomain

ciscoDlswTConnConfigTDomain

dlswTConnConfigLocalTAddr

ciscoDlswTConnConfigLocalTAddr

dlswTConnConfigRemoteTAddr

ciscoDlswTConnConfigRemoteTAddr

dlswCircuitS1DlcType

ciscoDlswCircuitS1DlcType

dlswCircuitS1RouteInfo

ciscoDlswCircuitS1RouteInfo

dlswCircuitS2TDomain

ciscoDlswCircuitS2TDomain

dlswCircuitS2TAddress

ciscoDlswCircuitS2TAddress

dlswCircuitState

ciscoDlswCircuitState

appnNodeCpName

ibmappnNodeCpName

appnNodeType

ibmappnNodeType

appnNodeBrNn

Command

cwb {start | stop} process_name

cwb stop all

Syntax Description

start

Requests the Process Manager to start a process using a process_name.

stop

Requests the Process Manager to stop one or more processes.

process_name

Specifies the process name of the process to stop or start.

stop all

Requests the Process Manager to:

· Stop all running CiscoWorks Blue processes, including all clients and servers.

· Stop the Process Manager and Name servers.

Command

cwb start admin [-p portno] [-v] [-h]

Syntax Description

start

Starts the specified application.

admin

Starts the CiscoWorks Blue Administration application (cwbadmin), which lets you start and stop Maps and SNA View processes and discover network devices.

[-p portno]

Specifies a port number for discovery work-in-progress information. The first discovery process spawned uses the specified port number or the default port number. The default is 57193. For each subsequent spawned discover process, the port number is increment by 1. Subsequent discover processes are spawned when you select a protocol (say RSRB) first and start discover, then select another protocol (say DLSw) and start discover again. The second discover process uses a port number 1 greater than the first.

[-v]

Displays the version.

[-h]

Displays a usage statement.

Command

cwb start dlsw [-u portno] [-p portno] [ -k | -g ] [-f device_name][ -v ] [ -h ]

Syntax Description

start

Starts the specified user application.

dlsw

Starts the DLSw GUI application, the DLSW executable, the DLSw poller daemon (cwbdlswpollerd), and the monitor daemon (cwbmonitord).

-u portno

Specifies a port for socket communications with the monitor daemon. The runprocess script defaults to port 6000. If the monitor daemon has been changed to listen to another port, make the same change in this option in the script.

-p portno

Specifies a port for socket communications with the discovery process when it is launched by the dlsw application. The runprocess script defaults to port 6011. If another application is using this port, you can specify another port with this option.

-k

Starts with the key devices view. This is the default.

-g

Starts with the global view.

-f device_name

Starts with the focus view for the specified device.

-v

Displays the version.

-h

Displays a usage help statement.

Command

cwb start rsrb [-u portno] [-p portno] [-g] [-f device_name] [-v] [-h]

Syntax Description

start

Starts the specified user application.

rsrb

Starts the RSRB GUI application, the RSRB executable, the RSRB poller daemon (cwbrsrbpollerd), and the monitor daemon (cwbmonitord).

-u portno

Specifies a port for socket communications with the monitor process. The script defaults to port 6000. If the monitor daemon has been changed to listen to another port, make the same change in this option in the script.

-p portno

Specifies a port for socket communications with the discovery process when it is launched by the rsrb application. The script defaults to port 6001. If another application is using this port, you can specify another port with this option.

-g

Starts with the global view.

-f device_name

Starts with the focus view for the specified device.

-v

Displays the version.

-h

Displays a usage help statement.

Command

cwb start appn [-f device_name [-r ead_community_string]] [-v] [-h]

Syntax Description

start

Starts the specified user application.

appn

Starts the APPN GUI application, the APPN executable, and the APPN poller server daemon (AppnPollerServer).

-f device_name

Specifies the host name or IP address of an APPN node to be used as the network topology agent. You must either identify a network topology agent with this option or in the cwbinit file. If you do not name a network topology agent, the APPN poller will terminate.

-r read_community_string

Specifies the read community string for the router specified by device_name. APPN uses the read_community_string when communicating with an APPN node. If you do not enter a read community string, the APPN application uses the default read community string specified in the cwbinit file or, if there is not one there, the default string "public."

-v

Displays the version.

-h

Displays a usage help statement.

Command

cwb start MsgLogClient

Syntax Description

start

Starts the specified user application.

MsgLogClient

Starts the Message Log client (viewer) application.

Command

cwb start ProcMgrClient

Syntax Description

start

Starts the specified user application.

ProcMgrClient

Starts the Process Manager client (viewer) application.

Command

cwb kill all

Command

cwb show {versions | status}

Syntax Description

versions

Displays the version information about all CiscoWorks Blue servers.

status

Displays the current status of all CiscoWorks Blue servers and processes.

Command

cwb tac [-o outputdirectory]

Syntax Description

-o outputdirectory

Specifies a directory where the command output is saved.

If you omit this operand, the output is saved as file cwbtac_n.tar.Z in a temporary directory, where the n is incremented for each successive use. The cwb tac command searches for a temporary directory in this order: /usr/tmp, /var/tmp, /tmp.

You can specify an output directory in which to save the output of the cwb tac command:

· You can specify an absolute directory by preceding the path with a / character. If the specified directory does not exist, the cwb tac command prompts you to create it. The following command saves the zipped file as /usr/cwblue/cwbtac_1.tar.Z.

· You can specify a relative directory. This directory is always relative to /opt/CSCOcb/etc. The following command saves the zipped file as /opt/CSCOcb/etc/tac/cwbtac_1.tar.Z.

Command

cwb {create seed | clear db | config | verify | tac}

Syntax Description

create seed [-s seedfile]

Creates a seed file from the devices in the CiscoWorks Blue database.

-s seedfile specifies the name of the seed file to create. If you omit this parameter, the seed file is named seed.file.

clear db

Clears the CiscoWorks Blue Database and the appnfile file. All data will be lost. To regenerate, discovery must be run for all protocols. You must be the root user to use the cwb clear db command.

The cwb clear db command stops all clients and servers, clears the database and the appnfile file, then restarts all servers.

config

Runs the cwbconfig application to configure CiscoWorks Blue host connection and port usage. You must be the root user to use the cwb config command.

verify

Runs the CiscoWorks Blue verification program to verify that you installed the applications correctly, and to check your configuration files and the database.

Command

uninstall.sh

Command

runprocess process_name

Syntax Description

process_name

The name of the Maps process to be executed.

Parameter

-MLCenableFilters token1[:token2 ... :tokenn]

Syntax Description

token1[:token2 ... :tokenn]

One or more message severity codes separated by colons(:). The allowable message severity codes are:

Debug---Useful when debugging a problem in conjunction with Cisco's Technical Assistance Center.

Error---Generates messages when any operational error condition occurs.

Warning---Generates messages when an error condition occurs that is not fatal.

Info---Generates messages to notify you of status information.

Trace---Generates detailed operational log messages.

SNMP Trace---Generates detailed SNMP trace log messages.

UITrace---Generates trace log messages from user interface.

IPCTrace---Generates detailed log messages for socket operations and interprocess communication.

Dump---Generates dumps.

InternalTrace---Generates internal operational log messages.

The Error and Info message categories are enabled automatically.

Command

cwbupgrade.sh