|
|
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:
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.
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
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.
The Process Manager window contains two tabs:
The CWBlue tab (Figure 5-1) displays a list of the Maps and SNA View processes in a single window.
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 |
|
State | Status of this process. |
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. |
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 (Figure 5-2) for the selected process. |
Help | Displays the online help. |
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 (Figure 5-2) is displayed.
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:
|
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. |
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. |
cwbhmond | TCP/IP version of SNA View monitor/discover daemon. |
The cwbhcmdd and cwbhmond TCP/IP processes are transient daemons. They are started by the cwbhcid daemon, not by the Process Manager. Once started, their stastus is displayed by Process Manager. When cwbhcid stops, these two stop as well, and disappear from the Process Manager window
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.
The following processes are started automatically depending on your configuration options:
| Configuration Option | Processes Autostarted |
|---|---|
APPN | AppnPollerServer |
DLSw | cwbdlswpollerd and cwbtrapd1 start automatically. |
RSRB | cwbrsrbpollerd and cwbtrapd1 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. |
| 1The cwbtrapd process is started only if a network management system was integrated during installation. |
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 |
The Services tab displays a list of all the Process Manager services, as shown in Figure 5-3:
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. |
Last Message | Last message sent by service. |
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 (Figure 5-4) for the selected service. |
Help | Displays the online help. |
You can see detailed information about each service. Select a service and click Details in the Services tab to view the Services Details window (Figure 5-4) for the selected service.
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:
|
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. |
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. |
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.
The following services are started automatically when the Process Manager server starts:
The following services start only after other processes are started:
| Process | Depends On |
|---|---|
CWBMsgLogServer | Nothing |
CWBDBAdapter | CWBMsgLogServer |
CWBHTTPAdapter | CWBMsgLogServer |
CWBOSAMonitor | CWBMsgLogServer |
CWBPMMonitor | CWBMsgLogServer |
This topic describes several ways you can configure the way the Process Manager runs. It contains the following subtopics:
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
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:
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:
|
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. |
The following sample CWBlue.conf file shows the file contents after you install CiscoWorks Blue:
# The ProcessManager 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 30
AppnPollerServer N CWBMsgLogServer /opt/CSCOcb/etc/runprocess AppnPollerServer 50
cwbhcid_MVSD R CWBMsgLogServer,CWBDBAdapter /opt/CSCOcb/etc/runprocess cwbhcid_MVSD,MVSD 30
cwbsnamapsd R CWBMsgLogServer,AppnPollerServer,CWBDBAdapter /opt/CSCOcb/etc/runprocess cwbsnamapsd 30
cwbdlswpollerd R CWBMsgLogServer,CWBDBAdapter /opt/CSCOcb/etc/runprocess cwbdlswpollerd 30
cwbrsrbpollerd R CWBMsgLogServer,CWBDBAdapter /opt/CSCOcb/etc/runprocess cwbrsrbpollerd 30
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,CWBMsgLogServer,-F,cwblogger.log,-P,/opt/CSCOcb/logs,-PMCserverName,CWBProcessMgr,-ORBagentPort,44542
CWBDBAdapter R CWBMsgLogServer /opt/CSCOcb/etc/runprocess CWBDBAdapter 100
CWBHTTPAdapter R CWBMsgLogServer /opt/CSCOcb/etc/runprocess CWBHTTPAdapter 70
CWBOSAMonitor R CWBMsgLogServer /opt/CSCOcb/etc/runprocess CWBOSAMonitor 50
CWBPMMonitor Y CWBMsgLogServer /opt/CSCOcb/etc/runprocess CWBPMMonitor 50
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.
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
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. |
Posted: Wed Jun 30 06:37:44 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.