Managing NerveCenter - Controlling NerveCenter from the Command Line - ovpa -
ncstop      paserver

ovpa

NAME

ovpa

SYNOPSIS


   Ovpa [ -logLevel Error | Warning | Debug | Trace ]
    [ -traceOutputFile FileName ] [ -traceOutputStdout ]
    [ -traceResync ] [ -traceInform ] [ -traceLoadDb ]
    [ -traceParentComp ] [ -traceMapUpdates ] [ -traceConnects ]
    [ -traceAll ] [ -pc ] [ -writeParentsToFile NcHostName ]
    [ -heartbeat seconds ] [ -ignoreUnmanagedIntf ]
    [ -initNcStatusInOV ] [ -ignoreCapability ]
    [ -noResolveCommunityOnResync ] [ -defGlobalCommunity filename ]

DESCRIPTION

Runs the NerveCenter OpenView Platform Adapter (OVPA).

OpenView (OV) must be running before you can run OVPA. To issue an ovpa command (with or without switches) by itself and without also using ovstart, you must first remove the OVPA local registration file (ovpa.lrf) from the list of services that are started by OV. For more information, refer to Integrating NerveCenter with a Network Management Platform.

OPTIONS


   -logLevel Error | Warning | Debug | Trace

Set logging level, default value is Warning.


   -traceOutputFile FileName

Set the output of logging messages to be a file with FileName.


   -traceOutputStdout

Set the output of logging messages to be standard output. This option can be used with -traceOutputFile filename so that logging messages can be written both to the screen and the output file.


   -traceResync

Enable logging messages for resync (node source) and resync parents. Logging messages contain node information including parent information OVPA is sending to Nerve Center.

To use this option, the log level must also be set to either debug or trace.


   -traceInform

Enable logging messages for status informing from NerveCenter to OpenView. It shows status change messages from NerveCenter, whether the status change information is sent to OpenVien or is logged into OpenView database.

To use this option, the log level must also be set to either debug or trace.


   -traceLoadDb

Enable logging messages for loading nodes and interfaces from the OpenView database at initialization stage. It shows each node and each interfaces are loaded.

To use this option, the log level must also be set to either debug or trace.


   -traceParentComp

Enable logging messages for the details of how the parents are computed for each Nerve Center host.

To use this option, the log level must also be set to either debug or trace.


   -traceMapUpdates

Enable logging messages for the processing of OpenView events regarding changes. This option displays the significant data that arrived with an OpenView event, how ovpa is processing that event, and whether network topology needs to be updated or not.

To use this option, the log level must be set to either debug or trace.


   -traceConnects

Enable logging messages for connections from the NerveCenter server, and from OpenView. It also shows why the port is disconnected.

To use this option, the log level must also be set to either debug or trace.


   -traceAll

Enable logging messages for resync, inform, loadDb, parentComp, mapUpdates, and connects.

To use this option, the log level must also be set to either debug or trace.


   -pc

Enable parent computing. Without this option, no parent information is computed for any NerveCenter host, including the requests of resync parents from NerveCenter server, and the command line option -writeParentsToFile


   -writeParentsToFile NcHostName

When -pc is turned on, OVPA computes parent-child relationships, writes to the file NcHostName_PC.dat, and exits.


   -heartbeat seconds

The ovpa process and the NerveCenter server process exchange heartbeats. You can configure how often the heartbeat is sent from OVPA using the -heartbeat switch. If OVPA doesn't receive a heartbeat from NerveCenter in the specified time then it will close the connection to that server's port. Default heartbeat rate is 300 seconds.


   -ignoreUnmanagedIntf

If this switch is used OVPA does not send NerveCenter server any unmanaged interfaces within a node. You may want to restrict the interfaces that NerveCenter server must poll to only interfaces that OpenView is currently managing. If you have many subobject scope alarms and nodes, this switch to improves polling performance.


   -initNcStatusInOV

Synchronizes the status of a NerveCenter icon and its managed nodes.


   -ignoreCapability

Determines whether OVPA keeps track of OpenView's capability information, such as IsRouter.For more information, see Integrating NerveCenter with a Network Management Platform.

-ignoreCapability prevent ovpa from keeping track of capability data. This increases ovpa's speed and decreases its memory usage.

This switch can be turn on when a user wants to force the node to be added to NC server, regardless of capabilities.


   -noResolveCommunityOnResync

When this option is turned on, OVPA does not obtain the community strings during a resync or resync parents. You can use this argument when you are sure that the community has not changed since the initial OpenView database import to improve resync performance.


   -defGlobalCommunity filename

Instead of retrieving community strings through OpenView, you can retrieve them from a file. This option is used to give the filename where user defines default community strings.


   -info

print out the version of OVPA


   -help

Help information for OVPA

notes

If you want these settings to take effect every time OVPA is started, edit the file ovpa.lrf to include these switches. On Windows, the file is located in the OpenView/lrf directory. On UNIX, the file is located in the opt/OSInc/nc/OV/lrf directory. For example, to have OVPA compute parenting information only during a resync you would modify ovpa.lrf to read:


   ovpa:/opt/OSInc/nc/OV/bin/ovpa:
   OVs_YES_START:ovwdb:-pc_noupdate:OVs_WELL_BEHAVED:5:


ncstop paserver
29 July 2003