Environment variable definition file (SnmpHpunix)

Format

SNMP_HPUNIX_OPTIONS="[-aperror] [-apwarn] [-apconfig] [-appacket]
                     [-aptrap] [-apaccess] [-apemanate] [-apverbose]
                     [-apuser] [-retry N]"
 
SR_SNMP_TEST_PORT=SNMP-reception-port-number
 
SNMP_HTC_SOLARIS_SWAP_RESERVED={Y | value-other-than-Y}(in Solaris)
 
SNMP_HTC_AIX_EXCEPT_FILECACHE={Y | value-other-than-Y}(in AIX)
 
SNMP_HTC_LINUX_INACTIVE_MEM={Y | value-other-than-Y}(in Linux)

To Page Top

Overview

The environment variable definition file (SnmpHpunix) defines the following environment variables:

To Page Top

Location

• Solaris: /etc/rc.config.d/SnmpHpunix

• AIX: /usr/CM2/ESA/opt/SnmpHpunix

• Linux: /opt/CM2/ESA/opt/SnmpHpunix

To Page Top

Detailed description

SNMP_HPUNIX_OPTIONS

This environment variable specifies startup options for the hp_unixagt process.

• -aperror: Specify this option if you want to collect error logs.

• --apwarn: Specify this option if you want to collect error and warning logs.

• -apconfig: Specify this option if you want to collect logs related to the configuration file.

• -appacket: Specify this option if you want to collect logs related to packet assembly and analysis.

• -aptrap: Specify this option if you want to collect logs related to trap messages.

• -apaccess: Specify this option if you want to collect logs related to agent processing.

• -apemanate: Specify this option if you want to collect logs related to the master agent and subagents.

• -apverbose: Specify this option if you want to collect verbose logs.

• -apuser: Specify this option if you want to collect user logs.

• -retry N: Specify this option if you want the subagent to attempt to establish a connection with the master agent at N-second intervals.

SR_SNMP_TEST_PORT

This environment variable sets the master agent's SNMP reception port. Normally, you do not need to specify this environment variable since it is specified in the environment variable definition file SnmpMaster.

For details about how to change the SNMP reception port, see 3.4.1 Changing the SNMP reception port on SNMP Agent.

SNMP_HTC_SOLARIS_SWAP_RESERVED={Y | value-other-than-Y}(in Solaris)

This environment variable specifies whether the size of the reserved space is included as part of the device swap space size.

• Y: The size of the reserved space is included.

• Value other than Y: The size of the reserved space is not included. The default is a value other than Y.

Details follow about how to acquire the swap space size.

By default, the Solaris device swap space size acquired by SNMP Agent does not include the reserved value. To acquire the device swap space size including the reserved value, specify Y in the SNMP_HTC_SOLARIS_SWAP_RESERVED environment variable in the SnmpHpunix file.

The reserved value means the amount of swap space that is not currently allocated but that will be obtained in memory for later use.

SNMP_HTC_AIX_EXCEPT_FILECACHE={Y | value-other-than-Y}(in AIX)

This environment variable specifies whether the file cache is excluded from the amount of physical memory currently in use.

• Y: The file cache is excluded from the amount of the physical memory currently in use.

• Value other than Y: The file cache is not excluded from the amount of physical memory currently in use. The default is a value other than Y.

Details follow about how to specify the amount of free space in physical memory in AIX.

In AIX, file access speed is improved by using the physical memory as a file cache. The file cache is therefore included in the amount of physical memory in use, and the amount of free space in physical memory obtained by SNMP Agent is the actual amount of free memory that is available.

If you want to determine the amount of free memory capacity while excluding the file cache from the amount of physical memory in use, set the environment variable SNMP_HTC_AIX_EXCEPT_FILECACHE to Y in the environment variable definition file SnmpHpunix. Then, the amount of free space in physical memory obtained by SNMP Agent is the sum of the free memory capacity and the file cache value.

SNMP_HTC_LINUX_INACTIVE_MEM={Y | value-other-than-Y}(in Linux)

This environment variable specifies how to calculate the MIB value for the amount of free memory.

• Y: The sum of the amount of free memory, inactive buffer memory, and inactive cache memory

• Value other than Y: The sum of the amount of free memory, buffer memory, and cache memory. The default is a value other than Y.

Details follow about the amount of free space in physical memory in Linux.

Linux actively allocates memory to buffer memory and cache memory. If a memory allocation request is issued from an application, buffer memory and cache memory are freed as necessary, and memory is allocated to the application. Therefore, the amount of free memory in the physical memory acquired by SNMP Agent is the sum of the amount of free memory, buffer memory, and cache memory.

You can acquire the sum of the amount of free memory, inactive buffer memory, and inactive cache memory as the amount of free memory in the physical memory by SNMP Agent if you specify Y for the SNMP_HTC_LINUX_INACTIVE_MEM environment variable in the SnmpHpunix environment variable definition file.

To Page Top

Definition examples

• This example edits SNMP_HPUNIX_OPTIONS of the SnmpHpunix file used in the hp_unixagt process:

  SNMP_HPUNIX_OPTIONS="-aperror -apwarn -apverbose"
  export SNMP_HPUNIX_OPTIONS

• This example specifies how to acquire the swap space size in Solaris:

  SNMP_HTC_SOLARIS_SWAP_RESERVED=Y
  export SNMP_HTC_SOLARIS_SWAP_RESERVED

• This example specifies the amount of free space in physical memory in AIX:

  SNMP_HTC_AIX_EXCEPT_FILECACHE=Y
  export SNMP_HTC_AIX_EXCEPT_FILECACHE

• This example specifies the amount of free space in physical memory in Linux:

  SNMP_HTC_LINUX_INACTIVE_MEM=Y
  exort SNMP_HTC_LINUX_INACTIVE_MEM

To Page Top