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.
The following section describes the components of the TEC Adapter package.
The TEC Adapter is also referred to as the Tivoli Adapter in some instances throughout this book.
Following, is a list of the Tivoli files:
The rootdir for the Tivoli files is $BINDIR/TME/TEC/adapters.$BINDIR is defined in /etc/Tivoli/setup_env.sh.
tecad_symon.baroc, tecad_symon_conf, and tecad_symon.err are located in rootdir/etc. Files that are typically necessary are the TEC Adapter event class definition file, configuration files, and error files.
The tecad_symon and SMCTaskLib is located in rootdir/bin The adapter file that you need to run is tecad_symon. SMCTaskLib is the task library that contains the Sun Management Center HostDetails launch task for the Tivoli console.
/opt/SUNWsymon/addons/Tivoli/classes file – Contains .jar files
/opt/SUNWsymon/addons/Tivoli/sbin file – Contains the following Bourne shell scripts:
private/LaunchHDBean.sh file – Called from SMCTaskLib to pass required Sun Management Center event parameters to LaunchHDBean.class
SunMC_Tivoli – Bourne shell scripts to start and stop the adapters
si-start.sh – Bourne shell script that sets the appropriate environment variables and starts the SyMONInt application
The Tivoli-related setup script adds the event server's name to the tecad_symon.conf file.
The script creates a Tivoli source group for Sun Management Center software.
The script compiles and adds the Sun Management Center Task Library.
The script creates, compiles, and loads a Sun Management Center rule base. The script then provides you with the option of restarting the event server. Restarting the event server is required for the new rule base to be recognized.
Before you begin the installation process for the Tivoli Integration package for Sun Management Center, complete the following preinstallation tasks.
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:
The TME Framework is installed.
The TEC server is installed.
The TEC console is installed.
The C preprocessor cpp is installed in /usr/ccs/lib.
In Tivoli, that an administrator has been created with the TME Roles admin, senior, and super. See Creating an Administrator.
JDKTM version 1.3.1 or higher is installed on machines that are designated for the Sun Management Center server and console components. You can download the JDK software from http://java.sun.com/.
The $PATH and the $JAVA_HOME environment variables are set.
Ensure that the $DISPLAY and $JAVA_HOME environment variables are set in the root login account and in any account that is used to run the Sun Management Center Web or JavaTM console.
The default location for JDK version 1.3.1 and 1.4 is /usr/j2se.
For specific instructions on how to set the Java environment variables, see “Java Environment Variables and Path” in the Sun Management Center 3.5 Installation and Configuration Guide.
The Sun Management Center server that you want to connect to has been started.
You are running the appropriate version of the Sun Management Center software. The Tivoli Integration package for Sun Management Center is supported only for Sun Management Center versions 2.1 or later.
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.
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.
Start the Sun Management Center processes by typing the following command as superuser:
# cd /opt/SUNWsymon/sbin/ # ./es-start -A |
Start the Tivoli desktop.
# setenv DISPLAY ${hostname}:0.0 # . /etc/Tivoli/setup_env.sh # tivoli & |
Select the Administrators icon. Choose the Create menu in the window that is displayed; select Create Administrator.
Enter the appropriate information in the Administrator Name, User Login Name, and Group Name fields.
Select the Set TMR Roles property.
The Set TMR Roles window is displayed.
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.
In the Create Administrator window, select Set Logins.
The Set Login Names window is displayed.
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.
Select the Set or Set & Close button to validate the Current Login Names.
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.
Once you have completed all of the preinstallation tasks, you are ready to install and configure the Tivoli Integration package for Sun Management Center.
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.
When prompted, enter the source directory for the Tivoli Integration package files.
Please enter the source directory: |
/Tivoli Integration package directory/disk1/image |
To install the Tivoli Integration package, answer yes when prompted.
The es-inst script installs the Tivoli Integration package.
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, choose one of the following options:
If you want to run the setup script for all Sun Management Center components found on the system, answer y when prompted.
If you want to run the setup script for the newly installed add-on only, answer n after the installation.
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.
Running the Sun Management Center setup script automatically invokes the setup script for add-ons.
After you install the Tivoli Adapter package, the setup script prompts you for the following information:
Tivoli Adapter port number – The default is port 2323. However, if port 2323 conflicts with another application that is using that port, you can specify a different port when prompted.
Tivoli Policy Region – The script prompts you for the Tivoli Policy Region in which the Sun Management Center Task Libraries should be created. The policy region must already exist, or the script will fail.
Tivoli Event Server – Prompts you to restart the Tivoli Event Server. Restarting the Tivoli Event Server is required for the new Sun Management Center rule base to be recognized by Tivoli. If you choose not to have the installation script restart the server, you must restart the server manually before the integration will function correctly.
Ensure that the Tivoli Event Server restarts successfully and without errors. If the Event Server doesn't restart successfully, neither the adapter nor the SyMONInt application can be started by using the installation script. You will need to perform these steps manually.
TEC Adapter – If you want the installation script to start the TEC adapter, answer yes. If you answer yes, the adapter will be started by invoking the $BINDIR/TME/TEC/adapters/bin/tecad_symon executable.
If the TEC adapter does not start successfully, the SyMONInt application cannot be started automatically. You will need to perform these steps manually. See Starting the TEC Adapter and SyMONInt Applications Separately
SyMONInt startup application – Prompts you to start the SyMONInt startup application. If you answer yes , the script /opt/SUNWsymon/addons/Tivoli/sbin/si-start.sh is run. This application must be running in order for the integration to work correctly. If you choose to not have the installation script start the application, you must start the application manually.
You will need to restart the SyMONInt startup application in the following instances:
After rebooting the system
If the process dies
If the process is killed by manually running the si-start.sh program
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.
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:
Type the display name.
For example: host name :0.0.
Type the port number.
The default port number is 2323.
Type the region name.
This is the name of an existing Tivoli Policy Region.
Type y at the prompt to restart the Event Server, or n if you do not want to restart the server.
Type y at the prompt to restart the Sun Management Center Adapter, or n if you do not want to restart the adapter.
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:
Copies files from the Tivoli Integration packages to the following directories:
$BINDIR/TME/TEC/adapters
/opt/SUNWsymon/addons/Tivoli
Adds the event server's name to the $BINDIR/TME/TEC/adapters/etc/tecad_symon.conf file.
Creates a Tivoli source group for Sun Management Center software.
Compiles and installs the Sun Management Center Task Library to the Tivoli Policy Region.
Creates, compiles, and loads the Sun Management Center rule base to Tivoli.
If you answered yes to restart the Event Server, restart the SunMC Adapter, or restart the Java Application when setting up the adapter package, the Event Server, the Sun Management Center Adapter, and the Java Application will be restarted.
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.
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.
If Sun Management Center Task Library is not deleted, you can delete it manually from the Tivoli console.
Go to the appropriate Tivoli Policy Region.
Select the SunMC Task Library icon.
Select Edit ⇒ Delete.
If you encounter problems with the installation, verify the following information:
The Tivoli Framework and TEC server have been installed.
The Sun Management Center console and Sun Management Center-supported Java Runtime Environment have been installed.
The Tivoli Event Server is running.
The Sun Management Center server is running.
The Tivoli Policy Region name you specified exists in the Tivoli server.
The C preprocessor cpp exists in the /usr/ccs/lib directory.
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.