2 Installation

This chapter describes the installation procedure for the ACSLS SNMP Agent on Solaris 11 or Linux 6. ACSNMP 2.4 is available for SPARC and X86 Solaris or Linux platforms running ACSLS Release 8.4. Version 2.4 of the SNMP Agent is available for download from Oracle's edelivery website.

Note:

SNMP 2.4 is certified for ACSLS Release 8.4 only.

Prerequisites

Install the following prerequisite packages:

On Linux

yum install rpmlibs.i686
yum install net-snmp.i686
yum install net-snmp-libs.i686
yum install net-snmp-utils.i686

On Solaris 11
```
 pkg install net-snmp
```

Installing the ACSLS SNMP Agent

Download the ACSLS SNMP Agent.

Login to the ACSLS server as root.
Download the appropriate package and transfer it to the /opt directory on your ACSLS server. Navigate to the ACSLS Software directory in the Oracle edelivery site and look for the following packages:
```
ACSNMP for SPARC Solaris 11      STKacsnmp_2.4.0.SPARC.zip
ACSNMP for X86 Solaris 11        STKacsnmp_2.4.0.X86.zip
ACSNMP for Linux 6.x             STKacsnmp_2.4.0.i686.rpm
```

Extract the package:

# cd /opt
# unzip STKacsnmp_2.4.0.<platform>.zip

Install the Agent:
- On Solaris package installation is handled by the Solaris pkgadd command:
```
# pkgadd -d .
```
  Select the STKacsnmp package.
  
  The package installation script on Solaris automatically locates the proper installation directory in the same file system with ACSLS. The installation script creates a new acsnmp service under the Solaris Service Management Facility (SMF). Once the package is installed, configure various operational properties and run the Agent.
- On Linux
  
  It is important to install the ACSLS SNMP Agent under the same file system where ACSLS is installed. To identify the correct install directory, you can source the ACSLS environment and display the installation directory
```
# .  /var/tmp/acsls/.acsls_env
# echo $installDir
```
  If ACSLS is installed under /export/home, then use the following method to install the ACSLS Agent.
```
# rpm -ivh STKacsnmp.2.4.0.i686.rpm
```
  If ACSLS is installed under a different file system than /export/home, you must specify the installation directory using the following RPM command:
```
# rpm -Uvh --prefix $installDir STKacsnmp_2.4.0.i686.rpm
```
  The package installation script on Linux will create a new acsnmp service under /etc/init.d. Once the package is installed, configure various operational properties and run the Agent.

The Installed Package

Once the package is installed, you can find it in the $installDir/ACSNMP directory. Hereafter any reference in this document to $ACSNMP_HOME equates to that directory path. In cases where the factory default directory was chosen, this translates to /export/home/ACSNMP.

Along with the ACSLS Agent daemon binary AcslsAgt, the AcslsMib.mib file is found in the ACSNMP top-level directory. You may want to copy this file for use on any SNMP client machine that listens for SNMP traps. The MIB is useful for translating numeric object identifiers (OIDs) into meaningful text-based objects.

In addition to the Agent software and the ACSLS MIB, several utilities are in the $ACSNMP_HOME/utils directory to assist you as you configure and test the Agent. These include:

agent reveals detailed startup and status information.
walker quickly scans the status of the entire ACSLS MIB.
translate walks the ACSLS MIB, listing objects in English text.
set_system_trap_test sends a test trap from net-snmp master to a listener.

For details, see "Troubleshooting Tools".

Uninstalling the ACSNMP Software Package

To uninstall the ACSLS SNMP Agent:

On Solaris:
1. Stop the ACSLS SNMP Agent:
```
# svcadm disable acsnmp
```
2. Remove the package:
```
# pkgrm STKacsnmp
```
  Any residual files created since the initial packag install may remain in the ACSNMP directory.
On Linux:
1. Stop the ACSLS SNMP Agent:
```
# service acsnmp stop
```
2. Remove the package:
```
# rpm -e STKacsnmp
```