Installing and Uninstalling BEA SNMP Agent on a UNIX Platform

 

This chapter explains how to install and uninstall BEA SNMP Agent on a UNIX platform in these sections:

• Installing BEA SNMP Agent on UNIX

• Uninstalling BEA SNMP Agent from UNIX

 

---

Installing BEA SNMP Agent on UNIX

Follow this procedure to install BEA SNMP Agent on your UNIX platform:

1. Make sure your system meets or exceeds the requirements listed in the BEA SNMP Agent Release Notes for BEA Tuxedo and BEA WebLogic Enterprise.

2. Some attributes of Tuxedo resources are accessible globally (no matter which Tuxedo node they are on) while others are accessible only by an SNMP agent local to the same machine. To access managed objects that are only accessible locally, you must install Tuxedo SNMP agents on each machine where these resources reside.

3. To monitor multiple Tuxedo or WLE domains you can run multiple SNMP agents on the same node. Each agent can monitor only one domain. To monitor multiple domains you must have the BEA SNMP Agent Integrator running and the agents must be started as subagents. See the BEA SNMP Agent Administrator's Guide for BEA Tuxedo and BEA WebLogic Enterprise for more information.

4. Obtain a license file.

   Call or email BEA Customer Support to request a license file for BEA SNMP Agent.

   • The contact information for BEA Customer Support in North America is:

     Phone: [phone]

     Email: [e-mail]

   • For contact information for additional locations, go to the following Web address: http://www.bea.com/support/contact_cs.html.

     When you receive your license file, copy it to your hard drive.

5. To enable the product license, have your BEA SNMP license available during installation of the BEA SNMP Agent product.

6. Mount the CD on the UNIX file system.

   To install the BEA SNMP Agent software, you must have either a local CD drive or a drive that is accessible over a network. The procedure for mounting the CD file system on the local UNIX platform may vary depending on the UNIX system being used. For this procedure, refer to your UNIX system documentation for instructions specific to your UNIX platform.

   1. For example, on a Solaris 2.6 or 2.7 platform, volume management is enabled by default. Thus, when you insert the CD into the drive, its file system is automatically mounted.

   2. If you are mounting the CD file system from a remote machine, mount the CD as an NFS file system with the following command:

      mount -F nfs -r machine-name:/cdrom/bea_snmp_agent_2_1 /mount-point

      For example:

      mount -F nfs -r diamond:/cdrom/bea_snmp_agent_2_1/mnt/BEASNMP

   3. To mount the CD on an HP-UX platform, start the PFS daemons if they are not already running, using this command:

      # nohup pfs_mountd &
      # nohup pfsd &

      Then mount the CD using this command:

      # pfs_mount -o -xlat=unix /dev/dsk/device_file /mount_point

      For example:

      # pfs_mount -o -xlat=unix /dev/dsk/c0t2d0 /cdrom

   4. To mount the CD on a Digital UNIX 4.0 system, use this command :

      mount -t cdfs -o noversion /dev/rz4c /cdrom

7. Install the BEA SNMP Agent software by changing to the directory where the CD is mounted.

   For example:

   % cd /cdrom

   Note: Before executing the following command, make sure that the PATH includes access to the uncompress utility.

8. Start the installation program:

   % sh ./install.sh

   Enter all data carefully. If the installation program encounters any errors, it quits and you have to restart again at Step 1.

   You can stop the installation program at any time by issuing an interrupt, typically by pressing Delete, Break, or Ctrl-C.

   The installation program displays the hardware/ software installation options.

   01) alpha/dux40/tux-6.4 02) alpha/tru64/tux-7.1

   03) alpha/tru64/wle-4.2 04) alpha/tru64/wle-5.1

   05) hp/hpux1020/tux-6.4 06) hp/hpux1020/wle-4.2

   07) hp/hpux11/tux-6.4 08) hp/hpux11/tux-7.1

   09) hp/hpux11/wle-4.2 10) hp/hpux11/wle-5.1

   11) ibm/aix414/tux-6.4 12) ibm/aix42/tux-6.4

   13) ibm/aix43/tux-6.4 14) ibm/aix43/tux-7.1

   15) ibm/aix43/wle-4.2 16) ibm/aix43/wle-5.1

   17) sun5x/sol251/tux-6.4 18) sun5x/sol26/tux-6.4

   19) sun5x/sol26/tux-7.1 20) sun5x/sol26/wle-4.2

   21) sun5x/sol26/wle-5.1

   Install which platform's files? [01-21, q to quit, l for list]:

9. Enter the value for a hardware/ software installation option. Optionally, you can enter l to list the options again, or enter q to quit the installation. See the BEA SNMP Agent Release Notes for BEA Tuxedo and BEA WebLogic Enterprise for a description of supported platforms.

   The installation program repeats your selection, identifies the product family to be installed, and asks you to confirm your selection.

   For example:

   ** You have chosen to install from sun5x/sol251 **

   SNMP Agent

   This directory contains the SNMP Agent product(s) for
   SunOS 5.5.1 (Solaris 2.5.1) on SPARC.

   Is this correct? [y,n,q]:

10. Enter Y to confirm, N to make another selection, or Q to quit the installation.

    The installation program asks you which platform's files to install.

    Install which platform's files? [01-21, q to quit, l for list]: 19

    To terminate the installation at any time

    press the interrupt key,

    typically <del>, <break>, or <ctrl+c>.

    The following packages are available:

    1 snmp BEA SNMP Agent 2.1

    Select the package(s) you wish to install.

    Separate multiple packages with a space.

    (type 'all' to install all packages) (default: all) [?,??,q]: 1

    Enter the number associated with the product you want to install:

    • Two or more numbers separated by spaces to install multiple packages

    • all to install all packages

    • ? for an explanation of your possible entries

    • ?? to list the options again.

      Then press Enter to continue.

      The installation program displays product information and prompts you for a directory location in which to install the product.

11. Enter the installation location.

    The following instructions use an installation directory named /usr/SNMP Agent. If the specified directory does not exist, the installation program creates it and starts installing the product.

    Base directory for the BEA SNMP Agent files [?,q]: /usr/tux71

    Determining if sufficient space is available ...

    5736 blocks are required

    1310272 blocks are available to /usr/tux71

    Using /usr/tux71 as the BEA SNMP Agent base directory

    The installation script then displays a list of the files being installed.

    Unloading /cdrom/bea_snmp_agent_2_1/snmp/sun5x/sol26/tux-7.1/snmp/snmp.Z ...

    bin/evt2trapd

    bin/tux_snmpd

    bin/snmp_integrator

    bin/snmpget

    bin/snmpgetnext

    ...

    etc/bea2tiv.cds

    etc/bea2tiv.oid

    etc/beamgr.conf

    etc/beamgr_snmpd.conf

    11480 blocks

    ... finished

    Modifying configuration files to show installation date/time...

    ... finished

    Changing file permissions...

    ... finished

12. If you did not select all as your original installation choice, the installation program redisplays the list of options after it finishes installing the packages that you selected for installation:

    To terminate the installation at any time

    press the interrupt key,

    typically <del>, <break>, or <ctrl+c>.

    The following packages are available:

    1 snmp BEA SNMP Agent 2.1

    Select the package(s) you wish to install.

    Separate multiple packages with a space.

    (type 'all' to install all packages) (default: all) [?,??,q]: all

    After you install all desired products, type q and press Enter to quit.

13. The installation program prompts you for the location of the BEA SNMP Agent License file:

    Do you wish to install the BEA SNMP Agent 2.1 License [y/n]:

    Enter Y.

    The installation program displays the next question:

    Path for BEA SNMP Agent 2.1 License file [?,q]:

    Enter the name of the directory that contains the license file that you obtained at the beginning of this procedure.

    Note: The following instructions use a license directory named /BEASNMP/etc.

    The installation program installs the license file and completes the installation of the BEA SNMP Agent software. For example:

    Determining if sufficient space is available ...
    7357 blocks are required
    2347636 blocks are available to /BEASNMP/etc
    
    Using /BEASNMP/etc as the BEA SNMP Agent 2.1 License directory
    
    Installation of BEA SNMP Agent 2.1 was successful
    
    Please don't forget to fill out and send in your registration card

14. The BEA SNMP Agent CD includes online documentation in the doc directory. You can copy this directory to your hard drive.

    To view the online documentation in a Web browser, open doc/html/index.htm.

15. If your UNIX platform does not provide a Web browser, you can view the PDF files, which are located in doc/pdf.

    To view the PDF files, you need Adobe Acrobat Reader. If you do not have this program, you can get it for free from the Adobe Web site at http://www.adobe.com or call your local Adobe sales office.

16. See the BEA SNMP Agent Administrator's Guide for BEA Tuxedo and BEA WebLogic Enterprise for information on configuration, and on starting the BEA SNMP Agent and the optional BEA SNMP Agent Integrator.

 

---

Uninstalling BEA SNMP Agent from UNIX

Follow this procedure to uninstall BEA SNMP Agent from your UNIX platform:

1. If desired, save some of the BEA SNMP Agent files, particularly configuration files, to another directory.

   For example:

   install_dir/etc/beamgr.conf

   install_dir/etc/beamgr_snmpd.conf

   In the preceding example, install_dir is the directory in which you installed the BEA SNMP Agent software.

2. Remove the BEA SNMP Agent installation directory.