Solstice Enterprise Manager 4.1 Installation Guide Doc SetContentsPreviousNextIndex

Chapter 4

Setting up Solstice Enterprise Manager

This chapter describes how to set up Solstice Enterprise Manager (Solstice EM) software after installation.

This chapter describes the following topics:

4.1 Enabling Connections to the X Server

The xhost program is used to add and delete host and user names to the list of names that are allowed to make connections to the X server. Before opening the Network Tools window, you must give root (as well as all other users) access to the X server with the following command.

xhost +

If the window system was started by root, and if you are running the applications locally, you do not need to type this command.

4.2 Setting Environment Variables

You need to unset the Solstice EM environment variables before starting the em_services, or during new installation of Solstice EM in a different directory if the variables are already set by a previous installation. The variables that are already set are not modified by the emenv.sh or emenv scripts.

Note – For both commands described in this section, /opt is the default installation directory. If you have installed the Solstice EM software in a different location, substitute your location in place of /opt.

 

To Run the emenv Script in the C-Shell

You can add this command to your .cshrc file to set Solstice EM environment variables automatically each time you start a new shell.

 

To Run the emenv Script in the Korn or Bourne Shell

You can add this command to your .profile file to set Solstice EM environment variables automatically each time you start a new shell.

4.3 Setting up Internationalization and Localization

Internationalization (I18N) is a method of designing and producing software that facilitates easy adaptation to local markets. Solstice EM has been internationalized to support different languages with minimum effort. All Solstice EM applications have been brought to level four compliance with full support of text and code sets, formats, and collation, messages and text presentation, and Asian language support. The internationalization of messages was incorporated using the catopen and catgets functions.

Localization (L10N) is the process of preparing Solstice EM for a specific locale. The localization process includes the translation of the message files, compiling the translated message files, and installing the message catalog.

The L10N and I18N processes are discussed in the Solaris International Developer's Guide, a Prentice Hall/SunSoft Press book (ISBN 0-13-031063-8).

 

To Localize Solstice EM Software

1. Log in as root or become superuser.

2. Change directory to the location of the text files.

For example:

cd /install directory/SUNWconn/em/lib/locale/en_US/LC_MESSAGES

3. Translate the messages contained in the Solstice EM tool message files for the target locale.

One message file exists for each Solstice EM tool, under the name app_name.msg

4. Compile the message files.

For example:

gencat em.cat *.msg

5. Compile the PMI message file.

For example:

gencat pmi.cat pmi.msg

6. Translate the messages contained in app_name.po for the target locale.

7. Create the message file.

For example:

msgfmt -o em.mo *.po

8. Install the message files.

For example:

mkdir ../LANG/LC_MESSAGES

cp em.cat ../LANG/LC_MESSAGES

cp pmi.cat ../LANG/LC_MESSAGES

cp em.mo ../LANG/LC_MESSAGES

 

To Use Localized Solstice EM Software

To use the localized Solstice EM software, you need to set some environment variables.

1. Set the environment variable LANG to your locale.

For example, to set the LANG variable in the C-shell for the locale Japan:

setenv LANG ja

The equivalent command in a Korn or Bourne shell is:

LANG=ja; export LANG

2. If you installed Solstice EM software in a non-default directory, or if the message file is not installed in the default location, set the NLSPATH environment variable to the path of the localized message catalog for internationalized applications.

For example:

setenv NLSPATH path_to_catalog/%N

4.4 Starting the Solstice EM MIS and Tools

This section explains how to start the Solstice EM Management Information Server (MIS), the Security Manager, and other tools. If you configured these components to start after installation, they will start automatically.

4.4.1 Starting the MIS After a New Installation

If you did not choose to have the setup program automatically start the MIS after installation, you must manually start the MIS.

 

To Start the MIS After a New Installation

This command starts the MIS, recreates the entire database, and recompiles all MIBs.

4.4.2 Starting the MIS After Upgrading Solstice EM Software

Upgrading over an existing installation of version 2.01, 2.1, 3.0 or 4.0 exports topography data and alarm data from the existing version, then installs Solstice EM 4.1 software. If you choose to have the setup program automatically start the MIS after installation, the topography and alarm data are automatically imported from the older version to the current version after the installation completes.

If you choose not to have the setup program start the MIS automatically after installation, the setup program exports the existing data, but does not import the data into the MIS. After installation, you must manually start the MIS and then import the data that the setup program exported.

 

To Start the MIS After Upgrading Solstice EM Software

1. Log in as root and type the following command in a shell or command tool:

/opt/SUNWconn/bin/em_services -start

This command starts the MIS, while preserving the existing Solstice EM data.

Note – If you installed the product in a different directory, substitute your partition name for /opt directory.

Note – If the MIS does not start, check that you have a license installed. If the shared memory and semaphore parameters on your system required adjusting, you must reboot your system before the MIS will start.

2. Import the exported alarm log data by typing the following command:

/opt/SUNWconn/bin/em_imex -file /var/tmp/em_alarmlog_data.exp -import

3. Import the exported topology data by typing the following command:

/opt/SUNWconn/bin/em_topoimex -file /var/tmp/em_topo_data.exp -import

For more information on MIS, refer to Chapter 5 in Management Information Server Guide.
 

To Prevent the MIS From Starting After Rebooting

By default, the MIS starts automatically when your machine is rebooted.

The MIS will not start when your machine is rebooted, and you must start the MIS manually as described in Section 4.4.2 Starting the MIS After Upgrading Solstice EM Software."

4.4.3 Starting Network Tools

You can start the Solstice EM tools from Network Tools windows. The command shown below opens the Network Tools window and causes applications to connect to an MIS on the local machine.

/opt/SUNWconn/bin/em &

Note – To start the tools from the command line, you must set the Solstice EM environment variables by using the emenv scripts. See Section 4.2 Setting Environment Variables."

4.4.4 Starting Security

Access to the Solstice EM applications and functions is provided through Password Authentication (the user must provide a password to use the system) and Access Control (the user must be authorized to use Solstice EM applications and their features, and must be given access to the objects in the database). If you installed the Solstice EM software using pkgadd utility, Password Authentication and Access Control are active by default.

 

To Start Security

1. Log in as root.

2. Type the following command:

/opt/SUNWconn/bin/em_accessmgr &

 

To Start Security and Connect to a Remote MIS

1. Log in as root.

2. Type the following command:

/opt/SUNWconn/bin/em_accessmgr -host hostname &

Use the optional -host hostname parameter, where hostname is the name of the machine where the MIS is running.

For more information on using Security or enabling Password Authentication and Access Control, refer to Chapter 6 in Managing Your Network.

4.4.5 Setting up HTML Documentation

If you installed the HTML documentation but chose not to have the installation program add the Documentation icon to the Network Tools window, you can do this manually by using the Configure Applications window. For information on adding a documentation icon to the Network Tools Window, refer to Chapter 3 in Managing Your Network.

4.4.6 Starting the Network Discovery Tool

The Network Discovery tool is used to add managed objects to the MIS database. Shown below is the command to start the Network Discovery tool and connect it to the MIS on the local machine. This command opens the Network Discovery window.

/opt/SUNWconn/bin/em_discover &

4.5 Getting Help

For help with any of the Solstice EM tools, you can invoke Online Help by using the em_help command.

/opt/SUNWconn/bin/em_help &

Also, you can view the HTML online documentation by pointing your browser to the following URL, file:/opt/SUNWconn/em/docs/SEMDOCHP/index.html

Sun Microsystems, Inc.
Copyright information. All rights reserved.
 		Doc Set  |   Contents   |   Previous   |   Next   |   Index