test

Sun Management Center CA Integration Package User's Guide for Unicenter TNG

Chapter 1 Overview and Installation of Sun Management Center Integration Package for Unicenter TNG

This chapter provides an overview of the individual components for the Sun Management Center Integration package for Unicenter TNGTM and Unicenter NSM. This chapter also provides detailed instructions on how to install and uninstall the components.

Note –

It is implied that any references made to Unicenter TNG throughout this book also apply to Unicenter NSM.

Unicenter TNGTM provides heterogeneous network monitoring functionality. Sun Management Center software provides advanced capabilities and in-depth information for monitoring Sun products. The integration of these two applications provides Unicenter TNG administrators with significant additional functionality for managing heterogeneous environments that contain Sun products.

The integration package sets up a bridge between Sun Management Center software and Unicenter TNG by performing the following functions.

  1. The integration package enables Unicenter TNG to discover Sun Management Center agents and their loaded modules and presents them in the Unicenter TNG WorldView. This is done by using the policy files of the Unicenter TNG Distributed State Machine (DSM) WorldView, and the topology bridge between Sun Management Center and Unicenter TNG.

  2. The integration package retrieves alarms from the Sun Management Center application and performs the following tasks:

    • Forwards them to Unicenter TNG

    • Analyzes the alarms

    • Retrieves the current status of the Sun Management Center agents

    If the status has changed, the integration package performs the following tasks:

    • Sends notification to Unicenter TNG

    • Retrieves module loaded and unloaded notification from Sun Management Center agents

    • Forwards the notification to Unicenter TNG

      Unicenter TNG receives all the above information as traps. Unicenter TNG then processes the traps, and shows the appropriate status in the Unicenter TNG WorldView application and logs the information in Unicenter event logs.

  3. Unicenter TNG views Sun Management Center agent information by launching the Sun Management Center Details window from the Unicenter TNG WorldView.

Sun Management Center Integration Package Overview

The three components available for the Sun Management Center Integration package for Unicenter release are the EventAdaptor component, the TNG server component, and the HostDetails component.

EventAdaptor Component Support

Unicenter TNG Server Component Support

HostDetails Component Support

Sun Management Center Integration Package for Unicenter TNG Documentation

PDF and HTML versions of this document can be viewed online by going to http://docs.sun.com.

Preinstallation Checklist

Before installing the Sun Management Center Integration package, check to make sure the following conditions have been met:

The following suggestions might be helpful in preventing problems with the installation:

Sun Management Center Integration Package Installation

The following three components are needed for the Sun Management Center Integration package for Unicenter release:

SUNWescah – Installed on any machine that has the Sun Management Center console layer and web browser. This should be the machine running Unicenter TNG WorldView, from within which you can view the Sun Management Center console.

To Install the EventAdaptor Component

  1. Become superuser.

  2. Start the Sun Management Center installation process.

  3. Select the console layer for installation. Select the Sun Management Center Integration for Unicenter TNG add-on.

  4. When prompted, choose the Sun Management Center Integration for Unicenter TNG EventAdaptor Component for installation.

    The following files will be installed:

    • setup_sunmctotng, cfg_sunmctotng, and ea-start will be installed in the following directory:

      SunMC_base_directory/SunMC-TNG/sbin.

    • SunMcToTngAdaptorMain.cfg will be installed in the following directory:

      /var/opt/SUNWsymon/SunMC-TNG

  5. After the installation, configure the cfg_sunmctotng default file by typing the following commands:


    # cd SunMC_base_directory/SunMC-TNG/sbin
# ./cfg_sunmctotng

    When prompted, enter the appropriate information for your system for each of the following parameters:

    • Sun Management Center server name

    • Sun Management Center user name

    • Sun Management Center port number

    • Unicenter TNG server name

    • Unicenter TNG server DSM trap port number

    • Synchronizer Polling Interval, in seconds

    • Host Name Format: True Name [0], Short Name [1], IP Address [2]

The synchronizer checks the status of all connected agents. If the synchronizer recognizes a new module or a change in module status, the synchronizer notifies Unicenter TNG of the change. A value of 0 turns off the synchronizer function.

The host name format can be designated in one of the following ways:

A true name is determined by the naming service being used, such as NIS+ or DNS. A true name is a host name that either includes or does not include the domain name, depending on the naming service. A short name is simply the host name without a domain name designation.

To Install the Unicenter TNG Server Component

  1. Become superuser.

  2. Start the Sun Management Center installation process.

  3. Select the console layer for installation. Select the Sun Management Center Integration for Unicenter TNG add-on.

  4. Choose the Sun Management Center Integration for Unicenter TNG Server Component for installation.

To Set Up Unicenter TNG Component

The Unicenter TNG server component of the add-on will be automatically set up when the Sun Management Center setup script is run. Refer to the Sun Management Center Installation and Configuration Guide for more information on the Sun Management Center setup procedure.

  1. If you need to set up or re-set up the Unicenter TNG Component, type the following commands:


    # cd /SunMC_base_directory/SUNWsymon/sbin
# ./es-setup -p TNG
    Note –

    At the end of the setup procedure, the following warning message might be displayed: 


    SunMC_Agent.atp(32) : warning: #VERSION number does not
include revision number (in format M.m.r). Revision will be
ignored, this may lead to errors later.

    This warning message can be safely ignored.

To Install the HostDetails Component
Note –

The HostDetails component should be installed on a machine that is running Unicenter TNG WorldView, from which you can view the Sun Management Center console.

  1. Become superuser.

  2. Start the Sun Management Center installation process.

  3. Select the console layer for installation. Select the Sun Management Center Integration for Unicenter TNG add-on.

  4. Choose the Sun Management Center Integration for Unicenter TNG HostDetails Component for installation.

A file named HDMapping.properties is installed with the SUNWescah package under SunMC_base_directory classes. This file is used to directly map a Unicenter TNG host name to a Sun Management Center host name, when both applications are using the same host. You must edit this file if Unicenter TNG and Sun Management Center use different logical names for the same host, or if you add a new host to Unicenter TNG. For example:


# Property File: HDMapping.properties
# version: 1.2 	2000/04/04		15:52:16
# Copyright (c) Sun Microsystems, Inc. All Rights Reserved.

# Format Name = Aliases (Aliases should be unique for Name)

# HostNameInTng = HostAliasesInSunMC
seagull = hawk
To Uninstall the Unicenter TNG Integration Add-On

To uninstall any of the components that are part of Sun Management Center Unicenter Integration add-on, complete the following steps:

  1. Become superuser.

  2. Change to the /opt/SUNWsymon/sbin directory.


    # cd /opt/SUNWsymon/sbin

  3. Start the Sun Management Center uninstallation process.


    # ./es-uninst

  4. Select the Sun Management Center Integration for Unicenter TNG for uninstallation.

Additional Help

For assistance with Unicenter TNG problems, refer to the Unicenter TNG User's Guide. Information about the Unicenter TNG User's Guide can be found at http://www.ca.com.

The online Sun Management Center release documentation can be found at http://www.sun.com/software/sunmanagementcenter.