|
|
A site system administrator is responsible for configuring ViewRunner for HP OpenView applications, in most cases. This site system administrator must have a high familiarity with the UNIX operating system.
Following is a list of guidelines for configuring ViewRunner applications:
Table 9-1 details the parameters that you can set to configure the server and client applications. Table 9-1 also includes information about each variable, including its name, description, range, default value, and unit (where applicable).
| Environment Variable Name | Description | Range | Default Value | Unit | ||
|---|---|---|---|---|---|---|
MAX_LOOPRUNNERS_PER_NETMON | Specifies the number of Cisco 6100 Series systems that are handled by a single View Network Monitor instance. If there are more than the specified value, multiple View Network Monitor applications are started by View Process Monitor to manage the Cisco 6100 Series systems. | 1 or above | 100 | Num | ||
SERVICE_HEARTBEAT_CHECK_TIMEOUT | Sets the periodic polling interval for View Process Monitor to check the health of all other ViewRunner server applications:
At this time-out, if any of the server instances are not running, View Process Monitor restarts the respective application. | 1 or above | 60 | sec | ||
CLIENT_HEARTBEAT_CHECK_TIMEOUT | Sets the periodic polling interval for the ViewRunner client to check whether the connection to the ViewRunner server is healthy and reconnect if necessary. This value must be the same in both the remote client configuration file and the server configuration file. | 1 or above | 180 | sec | ||
MAX_OPERATOR_LOGIN_RETRIES | Specifies the number of login attempts that are allowed for a ViewRunner user before disabling the user. If the number of consecutive failed login attempts exceeds the value of this parameter, that user is disabled until a ViewRunner administrator reenables the account. | 1 or above | 3 |
| ||
SNMP_TIMEOUT | Specifies the duration after which the ViewRunner server attempts to retransmit an SNMP request if the Cisco 6100 Series system agent has not responded. This and SNMP_RETRIES determine whether communication with the agent has been lost. | 1 or above | 10 | sec | ||
SNMP_RETRIES | Specifies the number of times the ViewRunner server sends requests to the Cisco 6100 Series system agent if a response has not been received within the specified SNMP_TIMEOUT interval. If the Cisco 6100 Series system agent does not respond within this number of retries, ViewRunner asserts a LOSS_OF_COMMUNICATION alarm on the Cisco 6100 Series system. | 1 or above | 3 |
| ||
AUTO_DISCOVER_TIMEOUT | Sets the periodic polling interval for ViewRunner servers to discover any new Cisco 6100 Series systems that are added to the network (to the topology database). This requires that IP Discovery is enabled in HP OpenView. | 1 or above | 1800 | sec | ||
PERFORM_PERIODIC_SYNC | Enables or disables automatic periodic configuration synchronization of Cisco 6100 Series systems.
It is preferable to do periodic syncs with a cron job rather than through the use of this variable. | 0 to 1 | 0 |
| ||
SYNCHRONIZE_TIMEOUT | Sets the periodic polling interval for the View Network Monitor to perform automatic configuration synchronization. This value is not used if PERFORM_PERIODIC_SYNC is 0. | 1 or above | 1800 | sec | ||
COMMUNICATION_LOSS_TIMEOUT | Sets the periodic polling interval for View Network Monitor to communicate with the agent for which communication is lost. | 1 or above | 120 | sec | ||
PROCESSMON_HEARTBEAT_CHECK | Sets the periodic polling interval when the ViewRunner server applications, View Alarm Formatter, View Data Collector, and View Network Monitor, check to see whether the View Process Monitor is running. | 1 or above | 60 | sec | ||
TRAP_INFO_RETRIEVAL_TIMEOUT | Sets the periodic interval when View Alarm Formatter polls Cisco 6100 Series system agents to verify the trap sequence number and the number of outstanding critical, major, and minor alarms. | 1 or above | 120 | sec | ||
ALARM_SYNC_CONFIRM_TIMEOUT | Sets the interval at which ViewAlarm Formatter determines whether it has missed any traps. It compares the sequence number of the last alarm received against the sequence number of the last trap delivered by the Cisco 6100 Series system. This interval is provided to ensure that "stuttering" alarms do not cause excessive equipment synchronizations. | 1 or above | 15 | sec | ||
CLLI_CODE_SIZE | Specifies the size of the CLLI1 code value for the Cisco 6100 Series system. Any CLLI code should not exceed this limit. | 1 to 255 | 32 |
| ||
RELAY_RACK_INFO_SIZE | Defines the storage space for relay rack information for each Cisco 6100 Series system. | 1 to 255 | 32 |
| ||
AD_SNMP_TIMEOUT | Sets the interval after which autodiscovery requests are resent to the HP OpenView application, ovtopmd, if there is no response from HP OpenView. | 1 or above | 10 |
| ||
AD_SNMP_RETRIES | Specifies the number of times autodiscovery requests are sent to the HP OpenView application, ovtopmd, if there has been no response from HP OpenView. | 1 or above | 1 |
| ||
SYNC_ON_OUT_OF_SYNC_DETECT | Enables or disables an automatic synchronization by View Network Monitor when configuration is detected to be out of sync between the Oracle database and a Cisco 6100 Series system.
| 0 to 1 | 1 |
| ||
NUM_FILES_SAVED_PER_LR | Specifies the maximum number of NVRAM configuration files defined that are saved per Cisco 6100 Series system in the NSS directory for that Cisco 6100 Series system. $VRS_HOME/NSS/<IP Address of Cisco 6100 Series>/ The directory contains the most recently saved NSS files up to the number specified by this parameter. The oldest files are deleted when this number is exceeded. | 1 or above | 5 |
| ||
DISPLAY_VIEWMAP_LOG_WINDOW | Specifies whether the ViewMap Log window should be shown when ViewMap starts up. A user can open or close the window manually once ViewMap is running.
| 0 to 1 | 0 |
| ||
VIEWMAP_LOG_WINDOW_MAX_SIZE | Specifies the maximum number of lines to show in the ViewMap Log window. | 1 or above | 500 |
| ||
VIEWMAP_LOG_WINDOW_SIZE | Specifies the initial number of lines to be used for the View Map Log window. | 1 or above | 10 |
| ||
ADD_TIME_STAMP_TO_LOG_MESSAGE | Specifies whether the ViewMap log messages are to be time stamped.
| 0 to 1 | 1 |
| ||
DISABLE_INTELLIGENT_CONFIG_SYNC | Enables or disables intelligent configuration synchronization.
| 0 to 1 | 0 |
| ||
SET_REQUEST_SYNCHRONIZE_TIMEOUT | Specifies how often the servers update the database with the cached snmpInSetRequests value. | 1 or above | 300 | sec | ||
MAX_GLOBAL_CONFIGURATION_SYNCS | Specifies the maximum number of configuration synchronizations that can be done across the entire ViewRunner for HP OpenView system simultaneously. | 1 or above | 15 |
| ||
MAX_CONFIGURATION_SYNCS_PER_NETMON | Specifies the maximum number of parallel configuration synchronizations that can be done by any single vrNetMon process. | 1 or above | 1 |
| ||
TFTP_TIMEOUT | Specifies the amount of time ViewRunner waits for a TFTP transfer to complete. It does not set a time-out for the TFTP server. | 1 or above | 20 | min | ||
TRACE_FILE_MONITOR_TIMEOUT | Defines the time-out for monitoring the trace file size. | 1 or above | 600 | sec | ||
DEFAULT_UPSTREAM_MARGIN | Sets the site-configurable subscriber default upstream margin. | 0 to 12 | 6 | dB | ||
DEFAULT_DOWNSTREAM_MARGIN | Sets the site-configurable subscriber default downstream margin. | 0 to 12 | 3 | dB | ||
DEFAULT_UPSTREAM_RATE | Sets the site-configurable subscriber default upstream rates. See ViewRunner documentation for valid values. |
| 1080 |
| ||
DEFAULT_DOWNSTREAM_RATE | Sets the site-configurable subscriber default downstream rates. See ViewRunner documentation for valid values. |
| 7168 |
| ||
DEFAULT_TIMER_TYPE | Sets the site-configurable default---the timer type default. | 1=none | 3 |
| ||
DEFAULT_TIMEOUT_VALUE | Sets the site-configurable subscriber defaults--- time-out value. | 1 to 240 | 100 | min | ||
SC_RESET_TIMEOUT | Specifies the time-out for system controller reset and for clear provisioning, which invokes a system controller reset. This is used in Software Download and in Restore Configuration. The system controller might take a long time to reset if it is loading a new image. |
| 20 | min | ||
DELETE_NSS_AFTER_SWD | Specifies if the NSS file that is saved during Software Download should be deleted after the Software Download is complete. | 0=do not delete | 1 |
| ||
COMMUNICATION_SYNC_PER_MESSAGE_FREQUENCY | Determines the frequency at which a communication synchronization message is sent between two processes communicating via a UNIX pipe. The parameter should be interpreted as for every <x> messages sent, the process sends 1 communication sync message. If the parameter is set to 0, the process does not send messages based on this rate. | 0=no sync message | 8 | num. of mes- sages sent | ||
COMMUNICATION_SYNC_TIME | Determines the time-based rate at which a communication synchronization message is sent between two processes that are communicating using a UNIX pipe. The parameter should be interpreted as the process sends a communication sync message every <xx> seconds. If the parameter is set to 0, the process does not send the messages based on time. The time-based rate has no affect during those intervals that have already sent a communication sync message based on the per message rate. | 0=no sync message | 20 | sec | ||
DEFAULT_IDLE_TIMER_VALUE | Sets the site-configurable subscriber defaults---idle timer value. | 0 to 60 | 30 | min | ||
DEFAULT_SESSION_TIMER_VALUE | Sets the site-configurable subscriber defaults---session timer value. | 0 to 240 | 120 | min | ||
DEFAULT_LOCKOUT_TIMER_VALUE | Sets the site-configurable subscriber defaults---lockout timer value. | 0 to 60 | 20 | min | ||
DEFAULT_PVC_IDLE_MARK | Sets the site-configurable subscriber defaults---PVC idle mark. | 0 to 2147483647 | 1000 | PVCs | ||
DEFAULT_CPE_SIGNATURE_VALUE | Sets the site-configurable subscriber defaults--- CPE signature. | 0=disable | 0 |
| ||
DEFAULT_ALLOW_136K_BAUD | Sets the site-configurable subscriber defaults---allow 136 kilobaud. | 1=enable | 2 |
| ||
INBAND_MULTIPLIER_PERCENT | Specifies the percentage multiplier to be used for time-out calculation when communicating over an in-band channel. |
| 1000 |
| ||
CMF_FILE_NAME | Names the system controller Feature Compatibility Matrix file. The default is SCFeatureCompatibility Matrix.svc. |
| (see desc.) |
| ||
SERVER_DB_USER_NAME | Specifies the user name for database access by server applications. |
| vrunnerrw |
| ||
SERVER_DB_PASSWORD | Specifies the password for database access by server applications. |
| vrunnerrw |
| ||
CLIENT_DB_USER_NAME | Specifies the user name for database access by client applications. |
| vrunnerro |
| ||
CLIENT_DB_PASSWORD | Specifies the password for database access by client applications. |
| vrunnerro |
| ||
VR_ORACLE_TNS | Specifies the database connect string. |
| vrunner |
|
| 1CLLI=Common Language Location Identifier |
The following procedure requires you to shut down the servers running ViewRunner applications. You can make changes, however, to the vrconstants.conf file that exists in the client directory without shutting down the servers. Doing so will propagate all changes to new clients.
Step 2 Execute
/OPT/cscoVROVS/BIN/vrStop
Step 3 Go to
/opt/CSCOvrovs/conf
Step 4 Open a UNIX editor such as vi or emacs.
Step 5 Modify values and save.
Step 6 Restart the Viewrunner servers
/opt/CSCOvrovs/bin/vrStart
Posted: Tue Feb 8 14:44:20 PST 2000
Copyright 1989 - 2000©Cisco Systems Inc.
