test

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

Chapter 2 Using the Applications

This chapter describes how to start, stop, and use the Unicenter TNGTM processes, the TNG Worldview Application, the Sun Management Center Server, the EventAdaptor, and other Sun Management Center application tasks.

Starting the Applications

This section provides information about starting the Unicenter TNG processes and using the unifstat command. Detailed instructions for starting the Unicenter TNG WorldView application, the Sun Management Center Server, and the EventAdaptor are also provided.

To Start the Unicenter TNG Processes

  1. Become superuser.

  2. Start the Unicenter TNG processes.


    # unistart all

  3. Use the unifstat command to verify whether the following processes have been started. 


    # unifstat
# awservices status

For more information about these processes and the unifstat command, refer to the Unicenter TNG User's Guide.

To Start the Unicenter TNG WorldView Application

  1. Before starting the Unicenter TNG WorldView Application, set up the web browser.

    Note –

    The JAVA_HOME environment variable must be set in the environment of the web browser from which Unicenter TNG WorldView is launched. JAVA_HOME must point to a complete installation of JDKTM 1.3.1 or above. This variable is used to launch the Sun Management Center HostDetails bean from the Unicenter TNG WorldView.

    For specific instructions on how to set the JavaTM environment variables, see “Java Environment Variables and Path” in Sun Management Center 3.5 Installation and Configuration Guide.

  2. In a web browser, type the web address for Unicenter TNG.

    For example, type your own address as follows:

    http://TNG_server_name:TNG_server_port/tng/

  3. In the Unicenter TNG Web Page, select the Click Here to launch Unicenter TNG link.

    The Unicenter TNG Explorer Logon dialog box is displayed.

  4. Type your user name and password in the appropriate text fields. Click OK to continue.

    After you log on to Unicenter TNG WorldView, the Unicenter TNG console window is displayed.

To Start the Sun Management Center Server

  1. Become superuser.

  2. Change directories to the SunMC_base_directory.


    # cd SunMC_base_directory/sbin

  3. Type the following command:


    # ./es-start -A

To Start the EventAdaptor

The EventAdaptor is an adapter for agents that share the same Sun Management Center server context. If you want to translate the events of other agents, you must launch another adapter.

Complete the following steps:

  1. Change directories to the SunMC_base_directory.


    # cd SunMC_base_directory/SunMC-TNG/sbin

  2. Set the JAVA_HOME variable to a complete installation of JDK TM 1.3.1 or above.

    For example:


    # JAVA_HOME=/usr/java1.4
# export JAVA_HOME

  3. Type the following command:


    ./ea-start

    All the parameters are optional. If no parameters are specified, the parameters that have been stored in /var/opt/SUNWsymon/SunMC-TNG/SunMCToTngAdaptorMain.cfg will be used.

    Note –

    To change the parameters that are stored in this file, run the cfg_sunmctotng script. See To Install the EventAdaptor Component.

    If you do provide parameters on the command line, those parameters will override the parameters in the property file.

    The following is a checklist of parameters that are available for the ea-start program:

    • -h | -help: for help; display all the following messages

    • -ss HOSTNAME: for the Sun Management Center server name

    • -sp NUMBER: for the Sun Management Center server port; should be a valid port number

    • -ts HOST1,HOST2,...: for the Unicenter TNG server list; multiple servers should be separated by a comma; you must be using the same port if running multiple servers

    • -tp NUMBER: for the Unicenter TNG server port; should be a valid port number

    • -l FILEPATH: for the log file path; can be absolute or relative to current location

    • -i MODPOLLINT: for the synchronizer polling interval; should be a valid number of seconds

    • -u USERNAME: for the Sun Management Center user name

    • -f Property File: specify a property file yourself instead of by default

    To use your own parameters, type the following command:


    ./ea-start  parameters

    After starting the event adapter, the Sun Management Center EventAdaptor is displayed.

  4. Type the following information:

    • Your Unicenter TNG user name and password

    • Your Sun Management Center server name

    • The Unicenter TNG server name

  5. Choose the host name format.

    This name should match the host name format you previously entered for the cfg_sunmctotng script. See To Install the EventAdaptor Component“ for more information.

  6. Type the Sun Management Center server port number and, or the Unicenter TNG server DSM trap port number.

    These parameters are optional.

  7. Select the checkbox of the Alarm State to be ignored.

    These parameters are optional.

  8. Select the checkbox of the Unicenter TNG Alarm Severity to be ignored.

    These parameters are optional. The alarm names map directly with the Sun Management Center alarm names. The following table describes each alarm.

    Table 2–1 Sun Management Center Alarms

    Alarm Name 

    Description 

    Down 

    A service-affecting condition has occurred and an immediate corrective action is required. For example, a module has gone down (exited). 

    Critical 

    A service-affecting condition has developed and an urgent corrective action is required. For example, an object needs to be restored to full capacity. 

    Alert 

    A non-service-affecting condition has developed and a corrective action should be taken to avoid a more serious fault. 

    Caution 

    A potential service-affecting fault has been detected, and action should be taken for further diagnosis to correct the problem, if necessary. 

    Off 

    A resource for a managed object. For example, a module has been disabled.  

  9. Click the Launch button in the Sun Management Center EventAdaptor window to start the event adapter.

Stopping the EventAdaptor

  1. Become superuser.

  2. Change to the SunMC_base_directory. 


    # cd SunMC_base_directory/SunMC-TNG/sbin

  3. Type the following command.


    # ./ea-stop

Using the Application Tasks

When using the Sun Management Center Integration package, you can perform the following tasks:

To Discover Sun Management Center Agents

You must discover the Sun Management Center agents when you begin the application tasks.

If Unicenter TNG is already monitoring the host, you must first delete the objects in the WorldView console and re-discover them.

  1. Delete the objects of the Sun Management Center agents in the Unicenter TNG WorldView console.

    1. Select the Network Topology icon

      The objects are displayed.

    2. Delete the objects.

  2. Discover the network in the Unicenter TNG WorldView console.

    1. Select the Unicenter TNG Tools icon.

    2. Select the Discovery Wizard to discover the network.

      Note –

      If you encounter problems discovering the Sun Management Center agents, see Cannot Discover a Sun Management Center Agent in Unicenter TNG.

      The Sun Management Center agents and their loaded modules are displayed in the Unicenter TNG WorldView console.

    3. Select the DomainBrowser icon.

      The contents of the DomainBrowser are displayed.

    4. Select a node that is a Sun Management Center agent.

For more information on how to discover Sun Management Center agents, refer to the Unicenter TNG User's Guide.

To Discover a Sun Management Center Agent That Is Running on a Port Other Than the Default Port of 161

  1. Create a pollset.

    A pollset needs to be created in the Unicenter environment for each port on which Sun Management Center could run. For more information on creating pollsets, see the Unicenter TNG User's Guide.

    1. Create a file with the following content.


      ADDOBJECT="SunMC001" PollSet
BEGIN
interval TNGWV_OT_INT 600 0
timeout TNGWV_OT_INT 10 0
retries TNGWV_OT_INT 2 0
port_number TNGWV_OT_INT 1161 0
getCommunityString TNGWV_OT_STRING "public" 0
setCommunityString TNGWV_OT_STRING "admin" 0
retriesInterval TNGWV_OT_INT 0 0
objectFilter TNGWV_OT_STRING "SunMC" 0
hostFilter TNGWV_OT_STRING "*" 0
END

      Through this file, a pollset with the name “SunMC001” and the port 1161 is created.

    2. Run the trix command to load the pollset into Unicenter.


      trix -r  repository-name  -u repository-user  -p  password  -f \
path-to-the-pollset-file-created-in-step1

      Example:


      trix -r HRrepository -u user1 -p pass3 -f /pollset_1161.txt

  2. Discover the host.

    Discover the host by using standard Unicenter TNG discovery mechanisms.

  3. Reclassify the host.

    Reclassify the host to the correct Sun host type, if necessary. Refer to the Unicenter TNG User's Guide for more information on how to perform the reclassify operation.

    Once the reclassify operation has completed, the Sun Management Center agents that are running on that host are automatically discovered in Unicenter.

To View the Status of the Sun Management Center Agents

You can view and monitor the status of the Sun Management Center agents from within the Unicenter TNG WorldView console.

Note –

The alarm severity states/colors for Sun Management Center and Unicenter TNG differ from each other. Each alarm severity state in Sun Management Center has been mapped to the closest counterpart of that severity state in Unicenter TNG. The following table contains the mapping between alarm severity states/colors in Sun Management Center and Unicenter TNG:

Table 2–2 Mapping Between Severity States in Sun Management Center and Unicenter TNG

Sun Management Center Alarm Severity States/Colors 

Unicenter TNG Alarm Severity States/Colors 

Normal (Green)

Normal (Green)

Caution (Blue)

Warning (Yellow)

Alert (Yellow)

Warning (Yellow)

Down (Black)

Critical (Red)

Disabled (Grey)

Critical (Red)

Critical (Red)

Critical (Red)

  1. In the Unicenter TNG WorldView console, select the DomainBrowser. This action expands and displays the contents of the DomainBrowser.

  2. To view and monitor the status of the Sun Management Center agents, select the agent from the expanded list that is displayed in the Unicenter TNG WorldView console window.

To View the Sun Management Center-Generated Events

The Unicenter TNG WorldView hierarchical tree, which can be viewed from the Unicenter TNG window, consists of the following levels:

  1. Enterprise Management

  2. Host names

  3. Calendar, Event, and Station Management

  4. Messages for each event

Sun Management Center-generated events, such as alarms, are displayed in the Unicenter TNG Console Log window. To view the Console Logs, complete the following steps:

  1. In the Unicenter TNG WorldView hierarchical tree, select and expand the Enterprise Managment icon.

    The Enterprise Management contents are displayed.

  2. Select the host that you wish to view.

  3. Double-click the Console Logs icon.

    All alarms from the Sun Management Center application are displayed in the Unicenter TNG Console Log window when you double-click on Console Logs icon.

Using the Details Application

To view or manipulate the attributes and properties associated with the hosts managed by Sun Management Center software, run a Unicenter TNG task to launch the console window that contains the host detail information. From this window you can view and manage the Sun Management Center categories.

To Start the Details Application
Note –

Before you can run the Details application, you must install the package for launching Details locally on the machine from which the Unicenter TNG WorldView console is run. See To Install the HostDetails Component.

  1. Select a node of the installed Sun Management Center agent in the Unicenter TNG WorldView console window.

  2. Press mouse button 3.

    1. In the window that is displayed, select the Sun Management Center Console.

      The JavaTM Security window is displayed.

  3. In the Java Security window, click the Grant button.

    The Sun Management Center Server Name panel is displayed.

  4. Type the Sun Management Center server name or IP address for the server that is monitoring the node. Click OK.

    A scaled-down version of the Sun Management Center login panel is displayed.

  5. Type your login ID and password.

  6. Click the Login button.

    The details window is displayed.

For more information on the Details window, refer to the Sun Management Center Software User's Guide.