test

Sun Management Center - Tivoli TEC Adapter Installation Guide

Chapter 1 Tivoli Integration Package Installation

The Tivoli Integration package is installed as an add-on to the Sun Management Center software. The software runs on the Solaris 2.6, Solaris 7, Solaris 8, and Solaris 9 operating environments. The integration supports Tivoli versions 3.6, 3.7, and 3.7.1

The Tivoli Management Environment (TME) provides general network monitoring capabilities. The Sun Management Center product provides advanced and in-depth information for monitoring Sun products. The integration of these two applications provides Tivoli administrators with a significant additional range of operations for managing networks that contain Sun products. The TME performs two functions. The first function of the product is to pass alarms from the Sun Management Center software to Tivoli Enterprise Console (TEC), after appropriate filtering and formatting. The second function of the TME is to provide access to the Sun Management Center HostDetails Task Library, thereby enabling Tivoli administrators to display the Sun Management Center HostDetails screen for the host name that is selected in the Tivoli Event Console.

This chapter provides an overview of the individual installation components for this product, as well as detailed instructions on how to install, configure, and uninstall the components.

TEC Adapter Package Overview

The following section describes the components of the TEC Adapter package.

Note –

The TEC Adapter is also referred to as the Tivoli Adapter in some instances throughout this book.

Tivoli Files

Following, is a list of the Tivoli files:

Java Runtime Support Files

Other Actions of the Tivoli-Related Setup Script

Preliminary Preparations

Before you begin the installation process for the Tivoli Integration package for Sun Management Center, complete the following preinstallation tasks.

Preinstallation Checklist

Installation of the Tivoli Integration package follows the standard Sun Management Center 3.5 add-on installation procedures. Sun Management Center 3.5 supports graphical user interface (GUI-based) installation and command-line installation. This document explains the installation of the Tivoli Integration package when using the command-line installation method. For more information about add-on installation, refer to the Sun Management Center 3.5 Installation and Configuration Guide.

Before beginning the installation, ensure that the following conditions have been met:

Limitations of the Tivoli Adapter

The physical host must be a Sun system. The Sun Management Center server layer runs only under the Solaris operating environment. You must size, configure, and balance your system appropriately to satisfy performance and overall operation requirements of both server layers. Consult the appropriate Sun Management Center and Tivoli documentation for further assistance.

Creating an Administrator

Before you install the Tivoli Integration package, you must create an administrator. The admin role is used for log in purposes when you use the $tec_console & command. This role is also used to view events from Sun Management Center.

To Create an Administrator

  1. Start the Sun Management Center processes by typing the following command as superuser:


    # cd /opt/SUNWsymon/sbin/
# ./es-start -A

  2. Start the Tivoli desktop.


    # setenv DISPLAY ${hostname}:0.0
# . /etc/Tivoli/setup_env.sh
# tivoli &

  3. Select the Administrators icon. Choose the Create menu in the window that is displayed; select Create Administrator.

  4. Enter the appropriate information in the Administrator Name, User Login Name, and Group Name fields.

  5. Select the Set TMR Roles property.

    The Set TMR Roles window is displayed.

  6. Select admin, senior, and super from the Available Roles window. Click the left arrow to move these roles to the Current Roles window. Click Set or Set & Close to validate the settings.

  7. In the Create Administrator window, select Set Logins.

    The Set Login Names window is displayed.

  8. Type the login name and press Return.

    The login name will be displayed in the Current Login Names window. You can also select the Remove button to remove the login names that are displayed.

  9. Select the Set or Set & Close button to validate the Current Login Names.

  10. In the Create Administrator window, select the Set Resource Rules and Set Notice Groups buttons to set corresponding parameters.

    For more information on creating an administrator with admin, senior, and super TMR roles, refer to Tivoli Framework User's Guide.

Tivoli Integration Package for Sun Management Center Installation

Once you have completed all of the preinstallation tasks, you are ready to install and configure the Tivoli Integration package for Sun Management Center.

To Run the Installation Script

  1. As superuser, type the following command to run the installation script:


    # /opt/SUNWsymon/sbin/es-inst

    The /opt directory is where Sun Management Center is installed. If the installation directory for your system is different, substitute the correct directory for your system when typing the command.

  2. When prompted, enter the source directory for the Tivoli Integration package files.


    Please enter the source directory:


    /Tivoli Integration package directory/disk1/image

  3. To install the Tivoli Integration package, answer yes when prompted.

    The es-inst script installs the Tivoli Integration package.

Tivoli Integration Setup

After the installation has completed, you need to run the Tivoli Integration setup script for Sun Management Center. You can run this script for all Sun Management Center components found on the system or for only the newly installed add–on.

To Set Up the Tivoli Integration

To set up the Tivoli Integration, choose one of the following options:

  1. As superuser, run the Tivoli Integration setup script.


    # /opt/SUNWsymon/sbin/es-setup -p Tivoli

    where /opt is the directory where Sun Management Center is installed. If this directory is different on your system, substitute the name of the correct directory when you run the command.

    Note –

    Running the Sun Management Center setup script automatically invokes the setup script for add-ons.

Parameters Checklist Setup

After you install the Tivoli Adapter package, the setup script prompts you for the following information:

TEC Adapter Package Setup

When setting up the TEC Adapter package, watch for error messages, particularly failures of Tivoli commands. Most errors are likely to be permission-related. There is also the possibility of encountering Tivoli-generated errors when compiling the task library or creating and compiling the rule base.

To set Up the TEC Adapter Package

During the setup process, you will be prompted to enter configuration information. Enter the information that is appropriate for your system in response to the following prompts:

  1. Type the display name.

    For example: host name :0.0.

  2. Type the port number.

    The default port number is 2323.

  3. Type the region name.

    This is the name of an existing Tivoli Policy Region.

  4. Type y at the prompt to restart the Event Server, or n if you do not want to restart the server.

  5. Type y at the prompt to restart the Sun Management Center Adapter, or n if you do not want to restart the adapter.

  6. Type y at the prompt to restart the Java Application, or n if you do not want to restart the application.

During the setup process, the script performs the following actions:

Uninstalling the TEC Adapter Package

To Uninstall the TEC Adapter

  1. To uninstall the TEC Adapter package, run the following command as superuser:


    # /opt/SUNWsymon/sbin/es-uninst

    where /opt is the directory where Sun Management Center is installed. If this is not the installation directory for your system, substitute the name of the correct directory when you run the command.

  2. From the list of products that are displayed, choose Sun Management Center Tivoli Integration.

    The script removes any relevant files and stops any active processes.

To Delete the Sun Management Center Task Library

If Sun Management Center Task Library is not deleted, you can delete it manually from the Tivoli console.

  1. Go to the appropriate Tivoli Policy Region.

  2. Select the SunMC Task Library icon.

  3. Select Edit ⇒ Delete.

Troubleshooting the Tivoli Integration for Sun Management Center Installation

If you encounter problems with the installation, verify the following information:

Additional Help

Further assistance with Tivoli problems can be found at http://www/support/tivoli.com.

Online Sun Management Center documentation may be found at http://www.sun.com/sunmanagementcenter.