Do You Need to Install Agents?

Depending on your network management needs, you do not have to install agents on machines in order to make effective use of Site/SunNet/Domain Manager. All platforms that run on TCP/IP networks support protocols that enable the Console machine to obtain useful data from machines without agents.

The Console has the capability to manage agent-less machines through its proxy feature, working in conjunction with the ping and hostperf agents running on the Console machine. The proxy feature allows agents running on one machine--the Console machine or any machine running agents--to respond as if they were running on another machine.

Through use of the hostperf and ping proxy agents you can obtain the following information from a remote machine:

From the hostperf agent:

• number of CPU interrupts
• disk usage
• number of input and output packets
• percentage of CPU usage

All of the above items are expressed per unit of time.

From the ping agent:

• the reachability of a remote host
• round-trip time for a packet sent to a remote host

The information returned by the ping agent is analogous to that returned by the ping -s command.

You can use the hostperf and ping agents to send both data and event requests. You can save, browse, graph, and strip-chart data from a machine without agents in the same way that you manipulate data returned from a machine with host-resident agents.

Good reasons to install agents, rather than relying on the hostperf and ping proxies, are:

• You can obtain a far greater breadth and depth of information on each machine.
• You do not have a single point-of-failure (that is, the machine running the proxy agents).

If you install the SNMP agents, you gain the ability to set, as well as obtain, the values of parameters on a remote machine.

Proxy agents have uses other than obtaining data from machines that are not running agents. For example, they allow you to manage networks that use protocols other than TCP/IP or let you manage remote networks. Their ability to allow you to obtain data from agent-less machines is offered here as a consideration for your decision as to whether to install agents.

Overview of Agent Installation

The platform running the Console (the "manager station") is the focal point for collecting and analyzing information. It gets the information from data collection programs (agents) usually running on remote machines.

Site/SunNet/Domain Manager software provides agents for x86 platforms running Solaris 2.4 systems. You install agents on remote Solaris 2.x systems by running the /usr/sbin/pkgadd program or the getagents script.

Using the pkgadd Program to Install Agents

The following is the recommended procedure (rather than use of getagents) for installing agents on a x86 platform running Solaris 2.4 system.

---

Note - Use this procedure if you are installing agents only and are not installing the software on a system that will be used as a SunNet Manger Console.

---

When you run the /usr/sbin/pkgadd program to install agents, you follow the same instructions as you did to install the Site/SunNet/Domain Manager software, except that you only add the Agents & Libraries (SUNW86nma) and SNMP daemon (SUNW86nmp) packages, if you want to install the SNMP agent.

To install agents using the pkgadd program:

1. Go to the machine you want to install the agents on.

2. Obtain access to the CD-ROM, as described in the section, "Inserting and Accessing the CD-ROM" on page 3-2.

3. Invoke the pkgadd command.

   a. If you want to install the packages in the default directory (/opt) using the local CD-ROM, enter the following command:

hostname# /usr/sbin/pkgadd -d /cdrom/sunnet_manager_x86_2_3

If you are installing the software packages from a remote CD-ROM, the required path is /cd/sunnet_manager_x86_2_3.

If you want to install the packages other than the default directory using the local CD-ROM, enter the following command:

hostname# /usr/sbin/pkgadd -d /cdrom/sunnet_manager_x86_2_3 -a none

With the latter command, pkgadd prompts you for the destination directory prior to installing each package. Be sure to enter the same base directory for both of the packages you will install. If you install in other than /opt, see the section on installing this product in a non-default directory for additional information.

After invoking either of the above commands, you receive a list of packages available for installation:

The following packages are available: 1 SUNWabsnm Site/SunNet/Domain Manager 2.3 AnswerBook 2 SUNWsnmag Site/SunNet/Domain Manager 2.3 Agents & Libraries 3 SUNWsnmct Site/SunNet/Domain Manager 2.3 Core Tools 4 SUNWsnmpd Site/SunNet/Domain Manager 2.3 SNMP daemon 5 SUNWsnmla Site/SunNet/Domain Manager 2.3 Network Layout Asst (Domain Manager sites only) 6 SUNWccfg Cooperative Consoles 1.2 - Configuration Tool (all Site/SunNet/Domain Manager sites) 7 SUNWccrcv Cooperative Consoles 1.2 - Receiver Application (all Site/SunNet/Domain Manager sites) 8 SUNWccsnd Cooperative Consoles 1.2 - Sender Daemon (Domain Manager sites only) Select package(s) you wish to process (or 'all' to process all packages). (default: all) [?,??,q]:

Enter 2 and 4, as shown above, to install the agents and the SNMP daemon. (Enter 2 only if you do not want to install the SNMP daemon.)

You then receive the following display:

Processing package instance <SUNW86nma> from </cd> Site/SunNet/Domain Manager Agents & Libraries (i386) 2.3 <Copyright notice> You will now need to answer a few questions to configure Site/SunNet/Domain Manager for your platform. Some of the daemons create log files which can grow to over 1 Meg each in size (depending on the number of nodes being managed). The directory where they reside should allow for appropriate free space. Please enter the location for the log files [/var/opt/SUNWconn/snm]:

4. Press Return to accept the default location (/var/opt/SUNWconn/snm) for log files or enter an absolute pathname if you do not want the default. The installation script responds:

You have entered the following values: Log File location: /var/opt/SUNWconn/snm (or your own choice) Is this correct (y/n) [y]:

5. Press Return to accept the log file location as displayed by the script or enter n and enter the log file location you want.

   After you accept or enter a log file location, the script proceeds:

## Processing package information. ## Processing system information. 3 package pathnames are already properly installed. ## Verifying disk space requirements. ## Checking for conflicts with packages already installed. The following files are already installed on the system and are being used by another package: /etc/inet/inetd.conf /etc/inet/services /etc/rpc Do you want to install these conflicting files [y,n,?,q] y

6. Enter y to install the specified files.

   To run correctly, the files that are specified by the script need to be modified.

   After you install the "conflicting" files, the script proceeds:

## Checking for setuid/setgid programs. This package contains scripts which will be executed with super-user permission during the process of installing this package. Do you want to continue with the installation of this package [y,n,?] y

7. Enter y to continue with installation.

   The script responds:

Installing Site/SunNet/Domain Manager Agents & Libraries as <SUNW86nma> ## Installing part 1 of 1. <List of files> Modifying /etc/inet/inetd.conf Modifying /etc/inet/services Modifying /etc/rpc [ verifying class <sed> ] ## Executing postinstall script. updating /etc/opt/SUNWconn/snm/snm.conf Updating /etc/inet/inetd.conf to reflect the installation directory /var/opt/SUNWconn/snm created Instructing inetd to re-read config file If you're running NIS/NIS+, you need to update the services map/table. See the Installation Guide, Chapter 3 Installation of <SUNW86nma> was successful.

If you specified the installation of packages 2 and 4 at the first pkgadd prompt (in Step 3), following installation of the SUNW86nma package, the script continues as shown below. If you entered only 2, to install only the SUNW86nma package, skip to Step 12:

Processing package instance <SUNW86nmp> from </cd> Site/SunNet/Domain Manager SNMP daemon (i386) 2.3 <Copyright notice> You will now need to answer a few questions to configure the SNMP agent for your platform. Access to SNMP devices is controlled via community names. The default community names for this SNMP agent installation will be: read: public write: private You should change the write community name to a site specific name to control access to this system via the SNMP agent. You may also modify the read community name if desired. New read community name? [public]:

8. Press Return to accept the default read community name (public), or enter a new read community name.

   The script proceeds:

New write community name? [private]:

9. Press Return to accept the default write community name (private), or enter a new write community name.

   After accepting read/write community name defaults or entering names that you want, you receive:

You should also change the system specific information. The discover tool uses the description information when creating icons. (ex. i86pc, ipx, sun3, sc2000) New system description? [Sun SNMP Agent, i86pc]:

The pkgadd script attempts to find out your machine architecture. Most customers, particularly those running Sun machines, will be able to press Return to accept the default.

The script proceeds:

New system contact? [System administrator]: New system location? [System administrator's office]:

10. Enter a name and location for the preceding two prompts.

    The values you specify here are for your own use and for the use of other network administrators. Enter names and locations according to the conventions followed in your network. If you have no conventions, enter information that will be meaningful on your network.

    After entering a contact and location, you receive:

You have entered the following values: SNMP read community name: public SNMP write community name: private SNMP system description: Sun SNMP Agent, i86pc SNMP system contact: System administrator SNMP system location: System administrator's office Is this correct (y/n) [y]:

11. Enter y to continue with installation.

    Following your y input, the script proceeds:

Installing Site/SunNet/Domain Manager SNMP daemon as <SUNW86nmp> ## Installing part 1 of 1. /etc/init.d/init.snmpd /etc/opt/SUNWconn/snm/snmpd.conf /opt/SUNWconn/snm/agents/snmpd /opt/SUNWconn/snm/agents/snmpd.conf /opt/SUNWconn/snm/agents/snmpv2d /opt/SUNWconn/snm/agents/snmpv2d.conf.t /opt/SUNWconn/snm/agents/sun.mib [ verifying class <none> ] /etc/rc2.d/K25snmpd <linked pathname> /etc/rc3.d/S25snmpd <linked pathname> ## Executing postinstall script. Updating /etc/opt/SUNWconn/snm/snmpd.conf with community name information... Updating /etc/init.d/init.snmpd with snmpd agent location... Starting snmpd. Installation of <SUNW86nmp> was successful.

12. Exit the pkgadd program.

    When pkgadd is finished, it returns to its initial display of packages. You Enter q to exit the command.

    If you are running NIS/NIS+, you must manually add the agent entries to /etc/rpc and /etc/services on the NIS/NIS+ master. To update the rpc.bynumber and services maps on both the master and the server, see the "Updating NIS Maps or NIS+ Tables" on page 3-20 for instructions.

    You have installed the agents, and they are ready to be run and managed on this system.

Using the getagents Script to Install Agents

This section contains an overview of the getagents script, information on copying scenarios, and the following procedures:

---

Caution - Agents from an earlier release of Site/SunNet/Domain Manager can not be installed on a x86 platform.

---

• Running the getagents script using an NFS mount on Solaris 2.x systems
• Running the getagents script using an NFS mount on SunOS 4.x systems
• Running the getagents script using rcp on Solaris 2.x systems
• Running the getagents script using rcp on SunOS 4.x systems

---

Note - Use of pkgadd, is the recommended way of installing agents on Solaris 2.x machines, rather than the use of getagents, as described here.

---

Overview of the getagents Script

The getagents script allows a platform to run Site/SunNet/Domain Manager agents and proxy agents by editing system files (similar to what the installation script does) and copying agents, libraries, and the SNMP proxy agent schema from the manager station to another machine. The script makes backups of all system files that are modified.

Specifically, the getagents script:

• Copies the agents, schema files, libraries, and native SNMP agent files from the manager station.
• On a machine running Solaris 2.x, creates the /var/opt/SUNWconn/snm directory for Site/SunNet/Domain Manager log files. On a machine running SunOS 4.x, creates the /var/adm/snm directory for Site/SunNet/Domain Manager log files. (For a description of these log files, see the snm.conf(5) man page.)
• Under SunOS 4.x only, creates symbolic links from the libnetmgt.sa.2.0 and libnetmgt.so.2.0 shared library files to /usr/lib. These files are used by Site/SunNet/Domain Manager agent and manager applications.

  If the link creation fails, an error message is printed, and you'll need to make the links yourself.

---

Note - Shared library files (or links to them) should be placed in /usr/lib. If you put them somewhere else, run ldconfig(8) with the library path names.

---

• On a machine running Solaris 2.x, creates a /etc/opt/SUNWconn/snm/snm.conf file if none exists, or updates the old one. On a machine running SunOS 4.x, creates a /etc/snm.conf file if none exists, or updates the old one. For a description of the snm.conf file, see snm.conf(5).
• Adds Site/SunNet/Domain Manager agent entries to /etc/rpc--see rpc(5).
• Adds SNMP definitions to the /etc/inet/services file for Solaris 2.x systems, or to the /etc/services file for SunOS 4.x systems.

  If you are running NIS/NIS+, you must manually add the agent entries to /etc/rpc and /etc/services on the NIS/NIS+ master. To update the rpc.bynumber and services maps on both the master and the server, see the "Updating NIS Maps or NIS+ Tables" on page 3-20 for instructions.

• Updates /etc/inet/inetd.conf under Solaris 2.x, or /etc/inetd.conf under SunOS 4.x and asks inetd(8C) to re-read its configuration file. See the inetd.conf(5) man page.
• Creates a sample database file you can add to your management database on the manager station.
• On a machine running Solaris 2.x, creates the

/var/opt/SUNWconn/snm/snmp.hosts and
/var/opt/SUNWconn/snm/snmp.traps files for use by the SNMP proxy
agent.  On a machine running SunOS 4.x, creates the
/var/adm/snm/snmp.hosts and the /var/adm/snm/snmp.traps files
for use by the SNMP proxy agent.

Copying Scenarios

There are various ways the manager station can make files available to other machines. Two common approaches are NFS and rcp(1). NFS is the recommended method, but not an option at every site. If rcp is used, the /.rhosts file on the manager station must contain the name of the remote

(agent) machine, allowing the agent machine root access to the manager machine. Once you have installed the agents, you may remove the agent machine name from the manager's /.rhosts file to restore security.

Since the getagents script copies files across the network, it needs to know what access method is going to be used for the copy. The three basic scenarios are:

• The system has the Site/SunNet/Domain Manager distribution NFS mounted from the manager station. You don't want to copy the agents because you're going to run the agents over the mount.
• The system has the Site/SunNet/Domain Manager distribution NFS mounted from the manager station. You want to copy the agents because you're going to run the agents from a different file system.
• The Site/SunNet/Domain Manager distribution is not NFS mounted, so rcp is needed to copy the agents.

The programs do not use copy methods such as tftp(1).

Running the getagents Script Using an NFS Mount for Solaris 2.x Systems

In the following procedure, the local machine (agenthost) has the Site/SunNet/Domain Manager distribution files NFS mounted from the manager (mgrhost) station.

To run the getagents script using an NFS mount:

1. Log in as root on the manager station. Enter the following commands to export the filesystem and start the NFS daemons, if they are not already running:

mgrhost# share -F nfs -o ro /opt/SUNWconn/snm mgrhost# /usr/lib/nfs/nfsd 8 mgrhost# /usr/lib/nfs/mountd

2. Log in as root to the machine that will run the agents (this machine will be referred to as the "local machine").

3. Create a mountpoint on the local machine.

4. Mount the software on your local machine from the manager station (by default, in /opt/SUNWconn/snm):

agenthost# mount <mgrhost>:/opt/SUNWconn/snm <mountpoint>

5. Run the getagents script from the bin directory under the mountpoint you created on the local machine.

   The getagents script starts and asks for the name of the directory where the agents will be installed.

# <mountpoint>/bin/getagents -- Site/SunNet/Domain Manager 2.3 agent installation -- Copyright (c) 1990-1995 by Sun Microsystems, Inc. What is the name of the root directory where agents will be installed? Agents will be installed into the 'agents' subdirectory of the directory you specify. Type 'NFS' if you intend to run the agents via an NFS mount. [/opt/SUNWconn/snm]

6. To run the agents over an NFS mount, enter NFS; to install the agents on the local system, press Return to accept the default, /opt/SUNWconn/snm, or enter another path name.

---

Note - If you enter NFS, the getagents script asks for the name of the root directory under which the agents and libraries are located. Go to Step 9.

---

The getagents script asks if you want to create the agents directory.

/opt/SUNWconn/snm/agents doesn't exist, should I create it? [y]

7. Press Return to accept the default, y.

   The getagents script asks for the name of the host where the agents are located.

OK, /opt/SUNWconn/snm/agents was made. What is the name of the host where the agents are? Type Return if you have the directory NFS mounted: [localhost]

8. Press Return to accept the default, localhost.

   The getagents script asks for the name of the root directory under which the agents and libraries are located.

What is the name of the root directory under which the Site/SunNet/Domain Manager agents and libraries are located? []

9. Enter the name of the mountpoint you created in Step 3.

   The getagents script creates library links, then asks if you want to install the Sun SNMP agent.

Would you like to install the Sun SNMP agent? [y]

10. Press Return to accept the default, y, to install the Sun SNMP agent, or enter n for no, if you do not want to install the Sun SNMP agent.

    Note - If you enter n, the getagents script creates the /etc/opt/SUNWconn/snm/snm.conf file, then asks for the location of the database files. Go to Step 13.

    The getagents script displays several messages and information about community names, and then asks for the read community name.

Access to SNMP devices is controlled via community names. The default community names for this SNMP agent installation will be: read: public write: private You should change the write community name to a site specific name to control access to this system via the SNMP agent. You may also modify the read community name if desired. New read community name? [public]

11. Press Return to accept the default read community name, public, or enter a new read community name.

    The getagents script asks if you want to change the default write community name.

New write community name? [private]

12. Press Return to accept the default, y, or enter n for no. If you enter n, be sure to manually add the script after the installation; see the snmpd man page for instructions on how to add the script.

    The getagents script creates the /etc/opt/SUNWconn/snm/snm.conf file, then asks for the location of the database files.

Creating /etc/opt/SUNWconn/snm/snm.conf ... done. By default, Site/SunNet/Domain Manager database and log files are placed under the directory /var/opt/SUNWconn/snm which will be created during this installation. A minimum of 10Mb to 15Mb of free space in the default database location is recommended. If you would like to put the databases in an alternate directory by default, a link will be created from /var/opt/SUNWconn/snm to the new location. The current usage for /var/opt/SUNWconn/snm is: Filesystem kbytes used avail capacity Mounted on /dev/dsk/c0t3d0s0 20570 1139 17373 6% /var Would you like the databases to be written to a new default directory? [n]

13. Press Return to accept the default location for the database files,

    /var/opt/SUNWconn/snm, or enter y to specify a different location. If you enter y, you will be prompted for the location for the database files. The getagents script asks for the location of the log files.

Some of the Site/SunNet/Domain Manager daemons create log files that can grow over 1 Mb each in size, depending on the number of nodes you are managing. The default directory for these log files is /var/opt/snm. Here is the current usage for /var/opt/SUNWconn/snm: Filesystem kbytes used avail capacity Mounted on /dev/dsk/c0t3d0s0 20570 1139 17373 6% /var Would you like the log files to be written somewhere else (like /usr/snm/logs)? [n]

14. Press Return to accept the default location for the log files,

    /var/opt/SUNWconn/snm, or enter y to specify a different location. If you enter y, you will be prompted for the location for the log files. The getagents script creates snmp files, updates other files, and displays a message that it has finished.

You have installed the agents, and they are ready to be run and managed on this system.

Running the getagents Script Using an NFS Mount from SunOS 4.x Systems

---

Note - This getagents script is not available for Site/SunNet/Domain Manager 2.3/x86 platforms.

---

In the following procedure, the local machine (agenthost) has the Site/SunNet/Domain Manager distribution files NFS mounted from the manager (mgrhost) station.

To run the getagents script using an NFS mount:

1. Log in as root on the SunOS 4.x manager station.

2. Using an editor of your choice, edit the /etc/exports file by adding the following:

. . /usr/snm -ro or <enter the default location of snm>

3. At your prompt enter the following:

mgrhost# exportfs -a

4. Log in as root on the Solaris 2.4/x86 platform that will run the agents (this machine will be referred to as the "local machine").

5. Create a mountpoint on the local machine.

6. Mount the software on your local machine from the manager station (by default, in /usr/snm):

agenthost# mount mgrhost:/usr/snm mountpoint

7. Run the getagents script from the bin directory under the mountpoint you created on the local machine.

   The getagents script starts and asks for the name of the directory where the agents will be installed.

# mountpoint/bin/getagents -- Site/SunNet/Domain Manager 2.3/x86 agent installation -- Copyright (c) 1990-1995 by Sun Microsystems, Inc. What is the name of the root directory where agents will be installed? Agents will be installed into the 'agents' subdirectory of the directory you specify. Type 'NFS' if you intend to run the agents via an NFS mount. [/usr/snm]

8. To run the agents over an NFS mount, enter NFS; to install the agents on the local system, press Return to accept the default, /usr/snm, or enter another path name.

---

Note - If you enter NFS, the getagents script asks for the name of the root directory under which the agents and libraries are located. Go to Step 11.

---

The getagents script asks if you want to create the agents directory.

/usr/snm/agents doesn't exist, should I create it? [y]

9. Press Return to accept the default, y.

   The getagents script asks for the name of the host where the agents are located.

OK, /usr/snm/agents was made. What is the name of the host where the agents are? Type Return if you have the directory NFS mounted: [localhost]

10. Press Return to accept the default, localhost.

    The getagents script asks for the name of the root directory under which the agents and libraries are located.

What is the name of the root directory under which the Site/SunNet/Domain Manager agents and libraries are located? []

11. Enter the name of the mountpoint you created in Step 3.

    The getagents script creates library links, then asks if you want to install the Sun SNMP agent.

Backing up old library links in /usr/lib ... done. Creating library links into /usr/lib ... done. Would you like to install the Sun SNMP agent? [y]

12. Press Return to accept the default, y, to install the Sun SNMP agent, or enter n for no, if you do not want to install the Sun SNMP agent.

---

Note - If you enter n, the getagents script creates the /etc/snm.conf file, then asks for the location of the database files. Go to Step 16.

---

The getagents script displays several messages and information about community names, and then asks for the read community name.

Access to SNMP devices is controlled via community names. The default community names for this SNMP agent installation will be: read: public write: private You should change the write community name to a site specific name to control access to this system via the SNMP agent. You may also modify the read community name if desired. New read community name? [public]

13. Press Return to accept the default read community name, public, or enter a new read community name.

    The getagents script asks if you want to change the default write community name.

New write community name? [private]

14. Press Return to accept the default write community name, private, or enter a new write community name.

    The getagents script displays lines that must be added to the /etc/rc.local file, and asks if you want them to be added now.

To run the Sun SNMP agent at each reboot, the following lines need to be added to the end of /etc/rc.local: if [ -f /etc/snmpd.conf -a -x /usr/etc/snmpd ]; then /usr/etc/snmpd -c /etc/snmpd.conf && echo 'Starting snmpd.' fi Would you like me to do this? [y]

15. Press Return to accept the default, y, or enter n for no. If you enter n, be sure to manually update the file after the installation. The getagents script creates the /etc/snm.conf file, then asks for the location of the database files.

Creating /etc/snm.conf ... done. By default, Site/SunNet/Domain Manager database and log files are placed under the directory /var/adm/snm which will be created during this installation. A minimum of 10Mb to 15Mb of free space in the default database location is recommended. If you would like to put the databases in an alternate directory by default, a link will be created from /var/adm/snm to the new location. The current usage for /var/adm/snm is: Filesystem kbytes used avail capacity Mounted on /dev/dsk/c0t3d0s0 20570 1139 17373 6% /var Would you like the databases to be written to a new default directory? [n]

16. Press Return to accept the default location for the database files,

    /var/adm/snm, or enter y to specify a different location. If you enter y, you will be prompted for the location for the database files. The getagents script asks for the location of the log files.

Some of the Site/SunNet/Domain Manager daemons create log files that can grow over 1 Mb each in size, depending on the number of nodes you are managing. The default directory for these log files is /var/adm/snm. Here is the current usage for /var/adm/snm: Filesystem kbytes used avail capacity Mounted on /dev/dsk/c0t3d0s0 20570 1139 17373 6% /var Would you like the log files to be written somewhere else (like /usr/snm/logs)? [n]

17. Press Return to accept the default location for the log files,

    /var/adm/snm, or enter y to specify a different location. If you enter y, you will be prompted for the location for the log files. The getagents script creates snmp files, updates other files, and displays a message that it has finished.

You have installed the agents, and they are ready to be run and managed on this system.

Running the getagents Script using rcp for Solaris 2.x Systems

The following procedure uses rcp to copy agents from mgrhost (the manager station) to agenthost (the "local host").

To run the getagents script using rcp:

1. Set up the manager station to allow root access across the network for the host(s) that will be running getagents (add "agenthost" to list of trusted hosts).

mgrhost# cat >>/.rhosts agenthost ^D

2. Copy getagents from the manager station to the local machine.

mgrhost# rlogin agenthost Password: SunOS Release 5.1 (AGENTHOST): December 1992 agenthost# rcp mgrhost:/opt/SUNWconn/snm/bin/getagents /tmp

3. Run the getagents script. (The following instructions assume that you have copied getagents to /tmp on the local host, although you may copy it to any directory.)

   The getagents script starts and asks for the name of the directory where the agents will be installed.

agenthost# /tmp/getagents -- Site/SunNet/Domain Manager 2.3 agent installation -- Copyright (c) 1990-1995 by Sun Microsystems, Inc. What is the name of the root directory where agents will be installed? Agents will be installed into the 'agents' subdirectory of the directory you specify. Type 'NFS' if you intend to run the agents via an NFS mount. [/opt/SUNWconn/snm]

4. Press Return to accept the default, /opt/SUNWconn/snm. The getagents script asks if you want to create this directory.

5. Press Return to accept the default, y (for yes, create the directory). The getagents script asks for the name of the host where the agents are located.

OK, /opt/SUNWconn/snm/agents was made. What is the name of the host where the agents are? Type Return if you have the directory NFS mounted: [localhost]

6. Enter the name of the manager station.

   The getagents script asks for the name of the root directory on the manager station under which the agents and libraries are located.

What is the name of the root directory on mgrhost under which the Site/SunNet/Domain Manager agents and libraries are located? [opt/SUNWconn/snm]

7. Press Return to accept the default, /opt/SUNWconn/snm. The getagents script continues and installs the agents. The getagents script then asks if you want to install the Sun SNMP agent.

Getting the agents ... done. Here are the agents now in agenthost:/opt/SUNWconn/snm/agents - na.activity na.hostif na.ippath na.lpstat na.snmp-trap na.diskinfo na.hostmem2 na.iproutes na.ping na.sync na.etherif2 na.hostperf na.layers2 na.rpcnfs na.traffic na.event na.iostat2 na.logger na.snmp Getting the libraries. Would you like to install the Sun SNMP agent? [y]

8. Press Return to accept the default, y, to install the Sun SNMP agent, or enter n for no, if you do not want to install the Sun SNMP agent.

---

Note - If you enter n, the getagents script creates the /etc/opt/SUNWconn/snm/snm.conf file, then asks for the location of the database files. Go to Step 14.

---

The getagents script displays several messages and information about community names, and then asks for the read community name.

Access to SNMP devices is controlled via community names. The default community names for this SNMP agent installation will be: read: public write: private You should change the write community name to a site specific name to control access to this system via the SNMP agent. You may also modify the read community name if desired. New read community name? [public]

9. Press Return to accept the default read community name, public, or enter a new read community name.

   The getagents script asks if you want to change the default write community name.

New write community name? [private]

10. Press Return to accept the default write community name, private, or enter a new write community name.

    The getagents script displays information about the init.snmpd script, and asks if you want the script to be added to the /etc/init.d directory now.

To run the Sun SNMP agent at each reboot, the init.snmpd startup/shutdown script needs to be added to the /etc/init.d directory. Would you like to add this script? [y]?

11. Press Return to accept the default, y, or enter n for no. If you enter n, be sure to manually add the script after the installation; see the snmpd man page for instructions on how to add the script.

    The getagents script creates the /etc/opt/SUNWconn/snm/snm.conf file, then asks for the location of the database files.

Creating /etc/opt/SUNWconn/snm/snm.conf ... done. By default, Site/SunNet/Domain Manager database and log files are placed under the directory /var/opt/SUNWconn/snm which will be created during this installation. A minimum of 10Mb to 15Mb of free space in the default database location is recommended. If you would like to put the databases in an alternate directory by default, a link will be created from /var/opt/SUNWconn/snm to the new location. The current usage for /var/opt/SUNWconn/snm is: Filesystem kbytes used avail capacity Mounted on /dev/dsk/c0t3d0s0 20570 1139 17373 6% /var Would you like the databases to be written to a new default directory? [n]

12. Press Return to accept the default location for the database files,

    /var/opt/SUNWconn/snm, or enter y to specify a different location. If you enter y, you will be prompted for the location for the database files. The getagents script asks for the location of the log files.

Creating /var/opt/SUNWconn/snm ... done. Some of the Site/SunNet/Domain Manager daemons create log files that can grow over 1 Mb each in size, depending on the number of nodes you are managing. The default directory for these log files is /var/opt/SUNWconn/snm. Here is the current usage for /var/opt/SUNWconn/snm: Filesystem kbytes used avail capacity Mounted on /dev/dsk/c0t3d0s0 20570 1139 17373 6% /var Would you like the log files to be written somewhere else (like /usr/snm/logs)? [n]

13. Press Return to accept the default location for the log files,

    /var/opt/SUNWconn/snm, or enter y to specify a different location. If you enter y, you will be prompted for the location for the log files. The getagents script creates snmp files, updates other files, and displays a message that it has finished.

    You have installed the agents, and they are ready to be run and managed on this system.

    Note - If you previously modified the /.rhosts file on the manager station to temporarily allow root access to other hosts, you should now remove the entries to prevent future security breaches.

Running the getagents Script using rcp for SunOS 4.x Systems

The following procedure uses rcp to copy agents from mgrhost (the manager station) to agenthost (the "local host").

To run the getagents script using rcp:

1. Set up the manager station to allow root access across the network for the host(s) that will be running getagents (add "agenthost" to list of trusted hosts).

mgrhost# cat >>/.rhosts agenthost ^D

If /.rhosts does not exist, enter touch /.rhosts prior to the preceding command.

2. Copy getagents from the manager station to the local machine.

mgrhost# rlogin agenthost Password: SunOS Release 4.1.1 (AGENTHOST) #1: Wed May 6 12:30:46 PDT 1992 agenthost# rcp mgrhost:/opt/SUNWconn/snm/bin/getagents /tmp

3. Run the getagents script. (The following instructions assume that you have copied getagents to /tmp on the local host, although you may copy it to any directory.)

   The getagents script starts and asks for the name of the directory where the agents will be installed.

agenthost# /tmp/getagents -- Site/SunNet/Domain Manager 2.3 agent installation -- Copyright (c) 1990-1995 by Sun Microsystems, Inc. What is the name of the root directory where agents will be installed? Agents will be installed into the 'agents' subdirectory of the directory you specify. Type 'NFS' if you intend to run the agents via an NFS mount. [/usr/snm]

4. Press Return to accept the default, /usr/snm. The getagents script asks if you want to create this directory.

5. Press Return to accept the default, y (for yes, create the directory). The getagents script asks for the name of the host where the agents are located.

OK, /usr/snm/agents was made. What is the name of the host where the agents are? Type Return if you have the directory NFS mounted: [localhost]

6. Enter the name of the manager station.

   The getagents script asks for the name of the root directory on the manager station under which the agents and libraries are located.

What is the name of the root directory on mgrhost under which the Site/SunNet/Domain Manager agents and libraries are located? [opt/SUNWconn/snm]

7. Press Return to accept the default, /opt/SUNWconn/snm. The getagents script continues and installs the agents. The getagents script then asks if you want to install the Sun SNMP agent.

Getting the agents ... done. Here are the agents now in agenthost:/usr/snm/agents - na.activity na.hostif na.ippath na.lpstat na.snmp na.diskinfo na.hostmem na.iproutes na.ping na.snmp-trap na.etherif na.hostperf na.layers na.rpcnfs na.sync na.event na.iostat na.logger na.sample na.traffic Getting the libraries ... done. Creating library links into /usr/lib ... done. Would you like to install the Sun SNMP agent? [y]

8. Press Return to accept the default, y, to install the Sun SNMP agent, or enter n for no, if you do not want to install the Sun SNMP agent.

---

Note - If you enter n, the getagents script creates the /etc/snm.conf file, then asks for the location of the database files. Go to Step 12.

---

The getagents script displays several messages and information about community names, and then asks for the read community name.

Access to SNMP devices is controlled via community names. The default community names for this SNMP agent installation will be: read: public write: private You should change the write community name to a site specific name to control access to this system via the SNMP agent. You may also modify the read community name if desired. New read community name? [public]

9. Press Return to accept the default read community name, public, or enter a new read community name.

   The getagents script asks if you want to change the default write community name.

New write community name? [private]

10. Press Return to accept the default write community name, private, or enter a new write community name.

    The getagents script displays lines that must be added to the /etc/rc.local file, and asks if you want them to be added now.

To run the Sun SNMP agent at each reboot, the following lines need to be added to the end of /etc/rc.local: if [ -f /etc/snmpd.conf -a -x /usr/etc/snmpd ]; then /usr/etc/snmpd -c /etc/snmpd.conf && echo 'Starting snmpd.' fi Would you like me to do this? [y]

11. Press Return to accept the default, y, or enter n for no. If you enter n, be sure to manually update the file after the installation. The getagents script creates the /etc/snm.conf file, then asks for the location of the database files.

Creating /etc/snm.conf ... done. By default, Site/SunNet/Domain Manager database and log files are placed under the directory /var/adm/snm which will be created during this installation. A minimum of 10Mb to 15Mb of free space in the default database location is recommended. If you would like to put the databases in an alternate directory by default, a link will be created from /var/adm/snm to the new location. The current usage for /var/adm/snm is: Filesystem kbytes used avail capacity Mounted on /dev/dsk/c0t3d0s0 20570 1139 17373 6% /var Would you like the databases to be written to a new default directory? [n]

12. Press Return to accept the default location for the database files,

    /var/adm/snm, or enter y to specify a different location. If you enter y, you will be prompted for the location for the database files. The getagents script asks for the location of the log files.

Creating /var/adm/snm ... done. Some of the Site/SunNet/Domain Manager daemons create log files that can grow over 1 Mb each in size, depending on the number of nodes you are managing. The default directory for these log files is /var/adm/snm. Here is the current usage for /var/adm/snm: Filesystem kbytes used avail capacity Mounted on /dev/dsk/c0t3d0s0 20570 1139 17373 6% /var Would you like the log files to be written somewhere else (like /usr/snm/logs)? [n]

13. Press Return to accept the default location for the log files,

    /var/adm/snm, or enter y to specify a different location. If you enter y, you will be prompted for the location for the log files. The getagents script creates snmp files, updates other files, and displays a message that it has finished.

    You have installed the agents, and they are ready to be run and managed on this system.

    Note - If you previously modified the /.rhosts file on the manager station to temporarily allow root access to other hosts, you should now remove the entries to prevent future security breaches.

The Next Step...

After you have installed the agents, the next step is to start the Console and create a management database of network elements that you intend to manage.