Using Process Manager

Table Of Contents

Using Process Manager

Starting Process Manager

Starting the Server Components

Starting the Client Component

Viewing the Process Manager Window

Viewing the CWBlue Tab

Viewing the CWBlue Tab Details

Maps and SNA View Daemons and Processes

Viewing the Services Tab

Viewing the Services Details

Process Manager Services

Configuring the Process Manager

Sample CWBlue.conf File

Sample Services.conf File

Changing Maps Processes and Services

Restarting the Process Manager

Changing Process Manager Properties

Using Process Manager

The CiscoWorks Blue Process Manager provides an interface for starting, monitoring, and stopping the Maps and SNA View daemons and processes and Process Manager services. The Process Manager starts automatically when your system starts. When Process Manager starts, it starts all the Maps and SNA View processes that are marked as Autostart and it restarts any processes that have been stopped abnormally and are marked for Restart.

The following topics describe how to use the Process Manager:

• Starting Process Manager describes how to start the Process Manager.

• Viewing the Process Manager Window describes how to use the Process manager window.

• Configuring the Process Manager describes how to configure the information displayed on the CWBlue tab and the Services tab.

• Restarting the Process Manager describes how to restart the Process Manager when it has stopped.

• Changing Process Manager Properties describes how to change write access and the user prompt.

Starting Process Manager

This topic describes how to start the Process Manager. Process Manager consists of a server component that monitors and maintains the running processes and a client component that displays the results in a graphical user interface.

Starting the Server Components

From the command line, use the cwb start servers command to start all CiscoWorks Blue servers, including the database server and the Process Manager server. Because starting the database and naming servers requires root authority, you should always run cwb start servers as the root user:
/opt/CSCOcb/bin/cwb start servers

From the command line, use the cwb start pm command to start just the Process Manager server:
/opt/CSCOcb/bin/cwb start pm

Starting the Client Component

You can start the Process Manager client from the Administration application or from the command line. From the command line, use the cwb start ProcMgrClient command:
/opt/CSCOcb/bin/cwb start ProcMgrClient

From the Administration application, click Process Manager.

Viewing the Process Manager Window

The Process Manager window contains two tabs:

•The CWBlue tab displays all the Maps and SNA View processes configured to run under Process Manager. The CWBlue tab is described in " Viewing the CWBlue Tab."

•The Services tab displays the Process Manager services. The Services tab is described in " Viewing the Services Tab."

Viewing the CWBlue Tab

The CWBlue tab ( ) displays a list of the Maps and SNA View processes in a single window.

Figure 5-1 Process Manager CWBlue Tab

Fields

The CWBlue tab contains the following fields:

Field

Description

Name

Name of this process.

See " Maps and SNA View Daemons and Processes" for a list of the Maps daemons and processes that can be monitored with Process Manager.

Process ID

Process ID of this process, if it is running.

State

Status of this process. The status colors are used as follows:

•Green means that the process is currently active.

•Blue means the process is in its initial state and has not been started.

•Red means the process has been run and then stopped.

•Yellow means the process is being started or stopped.

Last Message

Last message issued by this process.

This is usually a status message that tells you what the process did last or why the process stopped.

Buttons

The buttons on the CWBlue tab provide the following functions:

Button

Description

Start

Starts running the selected process.

Stop

Stops running the selected process.

Stop All

Stops all running processes.

Details

Displays the Details window ( ) for the selected process.

Exit

Stops the Process Manager client and closes the window.

Help

Displays the online help.

Viewing the CWBlue Tab Details

You can see detailed information about each process. Select a process and click Details in the CWBlue tab to view the details of the selected process. The Details window ( ) is displayed.

Figure 5-2 CWBlue Details Window

Fields

The Maps Details window contains the following fields:

Field

Description

Process Name

Name of the Maps process, as listed in the section " Maps and SNA View Daemons and Processes."

Description

Description of the process.

Version

Version of the process.

Executable

Full path name for the executable file for the process.

Arguments

Command line switches for the process.

Autostart

Indicates whether the process is configured to start automatically:

•Yes means it will be automatically started.

•No means that it will not be automatically started unless some other process is dependent on it.

•Restart means that it will be automatically started and, if it stops abnormally, it will be restarted automatically. However, if you use Process Manager to stop this process, it will not be restarted automatically.

Dependencies

Lists processes that must be running before this process is started.

Timeout

Time the Process Manager waits for an Initialization Complete notification from the started process.

Start Time

Date and time the process was last started.

If the process was never started, this field is 0.

Stop Time

Date and time this process was stopped.

If the process is currently running, this field is 0.

Process ID

Process ID of the named process.

State

Status of the process.

Last Message

Last message sent by the process to the Process Manager.

Maps and SNA View Daemons and Processes

The following table shows the Maps and SNA View daemons and processes that can be monitored in Process Manager:

Process Name

Description

cwbrsrbpollerd

RSRB Poller daemon, which polls RSRB MIBs.

cwbdlswpollerd

DLSW Poller daemon, which polls DLSw MIBs.

cwbmonitord

Monitor daemon, which updates Maps Motif applications with changes.

cwbtrapd

Trap daemon, which registers with the network management system trap process.

AppnPollerServer

APPN Poller process, which polls APPN MIBs.

cwbsnamapsd

CiscoWorks Blue Web daemon, which gets requested database information for the web server.

cwbhcid_domain_name

cwbhcid_server_domain_name

cwbhcmd_server_domain_name

SNA View host connection interface, which gets messages from the mainframe host.

The cwbhcid (tcp) and cwhci_server(lu62) tasks will have multiple entries in the CWBlue.conf file, one for each domain. The process name for each entry has the domain name appended.

Note   Only one domain is supported for LU 6.2.

cwbhcmdd

TCP/IP version of SNA View host command server daemon, which sends commands to the mainframe host. There is an instance of cwbhcmdd for each domain.

cwbhmond

TCP/IP version of SNA View monitor/discover daemon. There is an instance of cwbhmond for each domain.

Note   The cwbhcmdd and cwbhmond TCP/IP processes are transient daemons. They are started by cwbhcid_domain_name, not by the Process Manager. Once started, their status is displayed by Process Manager. When cwbhcid stops, these two stop as well, and disappear from the Process Manager window

Automatic Starts and Dependencies

Depending on the selections you make during configuration, some processes are set up to start automatically when Process Manager starts, and some processes are made dependent on others.

Autostarted Processes

The following processes are started automatically depending on your configuration options:

Configuration Option

Processes Autostarted

APPN

AppnPollerServer

DLSw

cwbdlswpollerd and cwbtrapd¹ start automatically.

RSRB

cwbrsrbpollerd and cwbtrapd ¹ start automatically.

TCP host connection

cwbhcid starts automatically.

Note   If you configure an LU 6.2 host connection, you must configure the LU 6.2 transaction programs. The SNA mainframe application will then cause cwbhcid_server_domain to start.

¹The cwbtrapd process is started only if a network management system was integrated during installation.

Dependent Processes

The following processes start only after other processes are started:

Process

Depends on

cwbmonitord

CWBMsgLogServer, CWBDBAdapter

AppnPollerServer

CWBMsgLogServer

cwbhcid

cwbhcid_server_domain

CWBMsgLogServer, CWBDBAdapter

cwbsnamapsd

CWBMsgLogServer, CWBDBAdapter, AppnPollerServer (only when APPN configured)

cwbdlswpollerd

CWBMsgLogServer, CWBDBAdapter

cwbrsrbpollerd

CWBMsgLogServer, CWBDBAdapter

cwbtrapd

CWBMsgLogServer, CWBDBAdapter

Viewing the Services Tab

The Services tab displays a list of all the Process Manager services, as shown in .

Note   In this release, the terms process and service are used interchangeably.

Figure 5-3 Process Manager Services Tab

Fields

The Services tab contains the following fields:

Field

Description

Name

Name of the service.

Process ID

Process ID of the service.

State

Current service status. The status colors are used as follows:

•Green means that the service is currently active.

•Blue means the service is in its initial state and has not been started.

•Red means the service has been run and then stopped.

Last Message

Last message sent by service.

Buttons

The buttons on the Services tab provide the following functions:

Button

Description

Start

Starts running the selected service.

Stop

Stops running the selected service.

Stop All

Stops all running services.

Details

Displays the Details window ( ) for the selected service.

Exit

Stops the Process Manager client and closes the window.

Help

Displays the online help.

Viewing the Services Details

You can see detailed information about each service. Select a service and click Details in the Services tab to view the Services Details window ( ) for the selected service.

Figure 5-4 Services Details Window

Fields

The Services Details window contains the following fields:

Field

Description

Process Name

Name of the Services process, as described in " Process Manager Services."

Description

Description of service.

Version

Version of the process.

Executable

Full path name for the executable file for the process.

Arguments

Command line switches for the process.

Autostart

Indicates whether the process is configured to start automatically:

•Yes means it will be automatically started.

•No means that it will not be automatically started unless some other process is dependent on it.

•Restart means that it will be automatically started and, if it stops abnormally, it will be restarted automatically. However, if you use Process Manager to stop this process, it will not be restarted automatically.

Dependencies

Lists processes that must be running before this service can be started.

Timeout

Time the Process Manager waits for an Initialization Complete notification from the started process.

StartTime

Date and time the process was last started.

If the process was never started, this field is 0.

StopTime

Date and time this process was stopped.

If the process is currently running, this field is 0.

Process ID

Process ID of the named process.

State

Status of the process.

Last Message

Last message sent by the process to the message log.

Process Manager Services

The following Process Manager services can be monitored in the Services tab:

Process Name

Description

CWBMsgLogServer

Message log server logs messages from the Maps and SNA View applications and daemons. To view the messages, use the message log viewer (cwb start MsgLogClient).

CWBHTTPAdapter

Starts and monitors the web server.

CWBOSAMonitor

Monitors the osagent process, which provides CORBA naming services.

CWBDBAdapter

Starts and monitors the database servers.

CWBPMMonitor

Monitors the Process Manager server. If the Process Manager server dies, this process stops all Maps processes and restarts the Process Manager server.

Automatic Starts and Dependencies

Depending on the selections you make during configuration, some services are set up to start automatically when Process Manager starts, and some services are made dependent on others.

Autostarted Processes

The following services are started automatically when the Process Manager server starts:

•CWBMsgLogServer

•CWBDBAdapter

•CWBHTTPAdapter

•CWBOSAMonitor

•CWBPMMonitor

Dependent Processes

The following services start only after other processes are started:

Process

Depends On

CWBMsgLogServer

Nothing

CWBDBAdapter

CWBMsgLogServer

CWBHTTPAdapter

CWBMsgLogServer

CWBOSAMonitor

CWBMsgLogServer

CWBPMMonitor

CWBMsgLogServer

Configuring the Process Manager

This topic describes several ways you can configure the way the Process Manager runs. It contains the following subtopics:

• Monitoring the Process Manager

• Configuring Process Manager Tabs

Monitoring the Process Manager

The CWBPMMonitor process monitors the Process Manager to ensure that it remains active. If the Process Manager is not running, the CWBPMMonitor process stops all other CiscoWorks Blue processes and then restarts the Process Manager server which in turn starts all the other servers.

Use the CWBProcessMgrWaitTime parameter in the /opt/CSCOcb/etc/cwbinit file to specify how often, in minutes, the CWBPMMonitor process wakes up to check whether the Process Manager is running. The default value is 10 minutes.
*********************************************************************# This section is used by the Process Manager monitor process, which# monitors the state of the CiscoWorks Blue Process Manager.
# This parameter controls how often, in minutes, the CWBPMMonitor# process wakes up and makes sure that the Process Manager process is# running on the system. If it is not running, this process stops# all CWBlue processes and restarts Process Manager, which restart# all servers.CWBProcessMgrWaitTime = 10

Use the showWarnings parameter in the /opt/CSCOcb/etc/cwbinit file to specify whether the Verification program should issue warning messages.
# *********************************************************************# This section is used by the Verification Utility which validates# the CiscoWorks Blue installation.# Flag indicating whether or not the verification utility should issue# warnings. If "true" warnings are issued, "false" otherwise.
showWarnings = true
Configuring Process Manager Tabs

The Process Manager is configured, during Maps or SNA View installation, to monitor the complete set of processes and to automatically start those processes that support the protocols (DLSw, APPN, and RSRB) that you want to manage. The settings that govern the Process Manager are stored in the following configuration files in /opt/CSCOcwbC/etc:

•CWBlue.conf contains the settings for monitoring processes common to both Maps and SNA View.

•Services.conf contains the settings for monitoring services, such as the message log server.

Normally you would not need to make any changes in these configuration files. However, you might want to change selected default values (such as the Autostart value) or process dependencies. To make changes to the way individual processes are run, you can edit the runprocess command script, which is described in "Commands and Processes."

The CWBlue.conf configuration file contains entries that describe the Maps and SNA View processes to be monitored and managed by the Process Manager. The Services.conf file contains entries that describe the Process Manager services to be monitored and managed by the Process Manager. Each file is made up of a series of entries, one for each process or service. Each entry is in the following format:
process_name autostart? dependencies executable arguments time_out

The entry contains the following fields:

Entry

Description

process_name

Name of the process or service.

autostart?

Indicates whether the process is to start automatically:

•Y means it is started automatically. Process Manager will try to autostart this process once.

•N means it is not started automatically.

•R means it is started automatically and, if it is killed, it is restarted automatically. Process Manager tries to autostart this process for some period. However, if you use Process Manager to stop this process, it is not restarted automatically.

dependencies

One or more process names separated by commas (,). Each dependent process in the list must be started before the subject process is started. If there are no dependencies, use one hyphen (-) as a place holder.

executable

Complete directory path and executable command.

arguments

Set of command-line arguments (switches) and their associated values separated by commas (,) that the Process Manager will use to start the process.

time_out

Time the Process Manager waits for a notification from the application. When the time expires, the Process Manager does not change the starting state. It reports a timeout error.

Sample CWBlue.conf File

The following sample CWBlue.conf file shows the file contents after you install CiscoWorks Blue:
# The Process Manager Configuration File for Maps/SNAView processes.# Each line contains 6 tokens separated by spaces
# Format:# process_name AutoStart Dependencies Executable Args TimeOut
# process_name :Name of the process
# autoStart :(Y/N) Whether ProcessManager should automatically# [re]start this process
# Dependencies :(A list of process_name each separated by ',')# Each process in the list has to be started before the particular process# can be started. If there are no dependencies, a single '-' is used.
# Executable :Complete path to the executable representing the process
# Args :Arguments to the process, separated by ',' ; If no arguments are# required, a '-' should be specified.
# TimeOut :(timeout value) The time in seconds, until which the PM# waits for a 'InitializationComplete' notification from the# started process). Once it receives the notification, the state of# the process is moved from starting->Ready.
cwbmonitord N CWBMsgLogServer,CWBDBAdapter /opt/CSCOcb/etc/runprocess cwbmonitord 30AppnPollerServer N CWBMsgLogServer /opt/CSCOcb/etc/runprocess AppnPollerServer 50cwbhcid_MVSD R CWBMsgLogServer,CWBDBAdapter /opt/CSCOcb/etc/runprocess cwbhcid_MVSD,MVSD 30cwbsnamapsd R CWBMsgLogServer,AppnPollerServer,CWBDBAdapter /opt/CSCOcb/etc/runprocess cwbsnamapsd 30cwbdlswpollerd R CWBMsgLogServer,CWBDBAdapter /opt/CSCOcb/etc/runprocess cwbdlswpollerd 30cwbrsrbpollerd R CWBMsgLogServer,CWBDBAdapter /opt/CSCOcb/etc/runprocess cwbrsrbpollerd 30

Sample Services.conf File

The following sample Services.conf file shows the file contents after you install CiscoWorks Blue:
CWBMsgLogServer R - /opt/CSCOcwbC/bin/CWB_msgLogServer -MLCname,CWBMsgLogServer,-N,CWBMsgLogServer,-PMCname,CWBMsgLogServer,-MLCserverName,CWBMsg LogServer,-F,cwblogger.log,-P,/opt/CSCOcb/logs,-PMCserverName,CWBProcessMgr,-ORBagentPort, 44542
CWBDBAdapter R CWBMsgLogServer /opt/CSCOcb/etc/runprocess CWBDBAdapter 100CWBHTTPAdapter R CWBMsgLogServer /opt/CSCOcb/etc/runprocess CWBHTTPAdapter 70CWBOSAMonitor R CWBMsgLogServer /opt/CSCOcb/etc/runprocess CWBOSAMonitor 50CWBPMMonitor Y CWBMsgLogServer /opt/CSCOcb/etc/runprocess CWBPMMonitor 50
Changing Maps Processes and Services

After you make changes to the Services.conf or CWBlue.conf configuration file, you must activate those changes by stopping and restarting the Process Manager server, as described in " Restarting the Process Manager." The Process Manager restarts, starting any processes specified as autostart in the changed configuration file.

Restarting the Process Manager

After you stop the Process Manager server, you can restart it from the command line using the following commands:
/opt/CSCOcb/bin/cwb start pm

Restart the Process Manager client from the command line using the following command:
/opt/CSCOcb/bin/cwb start ProcMgrClient
Changing Process Manager Properties

You can edit the Process Manager properties file to change Process Manager properties. The file is /opt/CSCOcwbC/classes/com/cisco/AM/conf/kubit/ process/displayMain.properties.

You can change the following values:

Value

Meaning

WriteAccess

true—runs the Process Manager client in read/write mode so that the Process Manager client can display processes and can start or stop processes.

false—forces the Process Manager client into read-only mode so that the Process Manager client can display processes, but cannot start or stop processes.

PromptUser

true—prompts the user when stopping Process Manager.

false—suppresses the prompt when stopping Process Manager.

Field	Description
Name	Name of this process. See " Maps and SNA View Daemons and Processes" for a list of the Maps daemons and processes that can be monitored with Process Manager.
Process ID	Process ID of this process, if it is running.
State	Status of this process. The status colors are used as follows: •Green means that the process is currently active. •Blue means the process is in its initial state and has not been started. •Red means the process has been run and then stopped. •Yellow means the process is being started or stopped.
Last Message	Last message issued by this process. This is usually a status message that tells you what the process did last or why the process stopped.

Button	Description
Start	Starts running the selected process.
Stop	Stops running the selected process.
Stop All	Stops all running processes.
Details	Displays the Details window ( ) for the selected process.
Exit	Stops the Process Manager client and closes the window.
Help	Displays the online help.

Field	Description
Process Name	Name of the Maps process, as listed in the section " Maps and SNA View Daemons and Processes."
Description	Description of the process.
Version	Version of the process.
Executable	Full path name for the executable file for the process.
Arguments	Command line switches for the process.
Autostart	Indicates whether the process is configured to start automatically: •Yes means it will be automatically started. •No means that it will not be automatically started unless some other process is dependent on it. •Restart means that it will be automatically started and, if it stops abnormally, it will be restarted automatically. However, if you use Process Manager to stop this process, it will not be restarted automatically.
Dependencies	Lists processes that must be running before this process is started.
Timeout	Time the Process Manager waits for an Initialization Complete notification from the started process.
Start Time	Date and time the process was last started. If the process was never started, this field is 0.
Stop Time	Date and time this process was stopped. If the process is currently running, this field is 0.
Process ID	Process ID of the named process.
State	Status of the process.
Last Message	Last message sent by the process to the Process Manager.

Process Name	Description
cwbrsrbpollerd	RSRB Poller daemon, which polls RSRB MIBs.
cwbdlswpollerd	DLSW Poller daemon, which polls DLSw MIBs.
cwbmonitord	Monitor daemon, which updates Maps Motif applications with changes.
cwbtrapd	Trap daemon, which registers with the network management system trap process.
AppnPollerServer	APPN Poller process, which polls APPN MIBs.
cwbsnamapsd	CiscoWorks Blue Web daemon, which gets requested database information for the web server.
cwbhcid_domain_name cwbhcid_server_domain_name cwbhcmd_server_domain_name	SNA View host connection interface, which gets messages from the mainframe host. The cwbhcid (tcp) and cwhci_server(lu62) tasks will have multiple entries in the CWBlue.conf file, one for each domain. The process name for each entry has the domain name appended. Note Only one domain is supported for LU 6.2.
cwbhcmdd	TCP/IP version of SNA View host command server daemon, which sends commands to the mainframe host. There is an instance of cwbhcmdd for each domain.
cwbhmond	TCP/IP version of SNA View monitor/discover daemon. There is an instance of cwbhmond for each domain.

Configuration Option	Processes Autostarted
APPN	AppnPollerServer
DLSw	cwbdlswpollerd and cwbtrapd¹ start automatically.
RSRB	cwbrsrbpollerd and cwbtrapd ¹ start automatically.
TCP host connection	cwbhcid starts automatically. Note If you configure an LU 6.2 host connection, you must configure the LU 6.2 transaction programs. The SNA mainframe application will then cause cwbhcid_server_domain to start.

Process	Depends on
cwbmonitord	CWBMsgLogServer, CWBDBAdapter
AppnPollerServer	CWBMsgLogServer
cwbhcid cwbhcid_server_domain	CWBMsgLogServer, CWBDBAdapter
cwbsnamapsd	CWBMsgLogServer, CWBDBAdapter, AppnPollerServer (only when APPN configured)
cwbdlswpollerd	CWBMsgLogServer, CWBDBAdapter
cwbrsrbpollerd	CWBMsgLogServer, CWBDBAdapter
cwbtrapd	CWBMsgLogServer, CWBDBAdapter

Field	Description
Name	Name of the service.
Process ID	Process ID of the service.
State	Current service status. The status colors are used as follows: •Green means that the service is currently active. •Blue means the service is in its initial state and has not been started. •Red means the service has been run and then stopped.
Last Message	Last message sent by service.

Button	Description
Start	Starts running the selected service.
Stop	Stops running the selected service.
Stop All	Stops all running services.
Details	Displays the Details window ( ) for the selected service.
Exit	Stops the Process Manager client and closes the window.
Help	Displays the online help.

Field	Description
Process Name	Name of the Services process, as described in " Process Manager Services."
Description	Description of service.
Version	Version of the process.
Executable	Full path name for the executable file for the process.
Arguments	Command line switches for the process.
Autostart	Indicates whether the process is configured to start automatically: •Yes means it will be automatically started. •No means that it will not be automatically started unless some other process is dependent on it. •Restart means that it will be automatically started and, if it stops abnormally, it will be restarted automatically. However, if you use Process Manager to stop this process, it will not be restarted automatically.
Dependencies	Lists processes that must be running before this service can be started.
Timeout	Time the Process Manager waits for an Initialization Complete notification from the started process.
StartTime	Date and time the process was last started. If the process was never started, this field is 0.
StopTime	Date and time this process was stopped. If the process is currently running, this field is 0.
Process ID	Process ID of the named process.
State	Status of the process.
Last Message	Last message sent by the process to the message log.

Process Name	Description
CWBMsgLogServer	Message log server logs messages from the Maps and SNA View applications and daemons. To view the messages, use the message log viewer (cwb start MsgLogClient).
CWBHTTPAdapter	Starts and monitors the web server.
CWBOSAMonitor	Monitors the osagent process, which provides CORBA naming services.
CWBDBAdapter	Starts and monitors the database servers.
CWBPMMonitor	Monitors the Process Manager server. If the Process Manager server dies, this process stops all Maps processes and restarts the Process Manager server.

Process	Depends On
CWBMsgLogServer	Nothing
CWBDBAdapter	CWBMsgLogServer
CWBHTTPAdapter	CWBMsgLogServer
CWBOSAMonitor	CWBMsgLogServer
CWBPMMonitor	CWBMsgLogServer

Entry	Description
process_name	Name of the process or service.
autostart?	Indicates whether the process is to start automatically: •Y means it is started automatically. Process Manager will try to autostart this process once. •N means it is not started automatically. •R means it is started automatically and, if it is killed, it is restarted automatically. Process Manager tries to autostart this process for some period. However, if you use Process Manager to stop this process, it is not restarted automatically.
dependencies	One or more process names separated by commas (,). Each dependent process in the list must be started before the subject process is started. If there are no dependencies, use one hyphen (-) as a place holder.
executable	Complete directory path and executable command.
arguments	Set of command-line arguments (switches) and their associated values separated by commas (,) that the Process Manager will use to start the process.
time_out	Time the Process Manager waits for a notification from the application. When the time expires, the Process Manager does not change the starting state. It reports a timeout error.

Value	Meaning
WriteAccess	true—runs the Process Manager client in read/write mode so that the Process Manager client can display processes and can start or stop processes. false—forces the Process Manager client into read-only mode so that the Process Manager client can display processes, but cannot start or stop processes.
PromptUser	true—prompts the user when stopping Process Manager. false—suppresses the prompt when stopping Process Manager.