Solstice Enterprise Manager 4.1 Installation Guide

Chapter 2

Preparing for Installation

This chapter describes the installation requirements and other information you need before you install Solstice Enterprise Manager (Solstice EM) software. It also contains a checklist to use if you have a problem installing the software. This checklist outlines the information you need to provide if you call customer support.

This chapter describes the following topics:

• Section 2.1 System Requirements
• Section 2.2 General Questions Asked During Installation
• Section 2.3 Information You Provide

2.1 System Requirements

Your system must meet the following requirements for installing the Solstice EM software. Disk and memory requirements differ according to the components you install:

• Solaris operating environment version 2.8.
• Sun Ultra^TM 2, 450, 3000, 4000, 5000, 6000 or 10000.
• Minimum of 192 Megabyte of RAM.
• Minimum 1 Gigabyte hard disk.
• Local or remote CD-ROM drive on a machine running either Solaris or SunOS^TM software. If the CD-ROM drive is on a remote machine, you must have the superuser password for that machine as well.
• The superuser must have read, write, and execute permissions for the directory where the Solstice EM software is installed.
• Web browser capable of reading HTML files that contain tables for viewing the Solstice EM documentation.
• If you are using the NFS^TM file system, then root NFS access must be granted. For more information, see the sharetab(4) and share(1M) man pages.
• If you are installing on a remote system, you must set the DISPLAY environment variable in order to start the Solstice EM window applications.

  For a C shell, enter:

  setenv DISPLAY hostname:0.0

  
  For a Bourne or Korn shell, enter the following commands:

  DISPLAY=hostname:0.0 export DISPLAY

• If you install the MIS-related packages on a server-type machine, then install the applications on client machines that can communicate with the MIS machine. All runtime data must be local.
• You will need either the Common Desktop Environment (CDE) or OpenWindows window system for running applications.
• Motif Runtime Kit (SUNWmfrun package)

  This is available on the Solaris CD-ROM in the
  /cdrom/solaris_version/s0/Solaris_version directory, where version is the Solaris version number. You must install the SUNWmfrun package from the appropriate directory, then using the pkgadd command as shown below.

  cd /cdrom/solaris_version/s0/Solaris_version pkgadd -d . SUNWmfrun

  
  To see if the Motif Runtime Kit is on your system, type:

  pkginfo -l SUNWmfrun

2.1.1 Shared Memory and Semaphores

Before installing Solstice EM software, shared memory and semaphores (signals used to govern access to shared resources) must be enabled with appropriate settings for running the Solstice EM product. If shared memory and semaphore are not properly enabled for Solstice EM, the setup program enables these features and sets parameters for running Solstice EM software. The setup program then reboots your system. After the system reboots, you can restart the installation.

2.1.2 Configuring Shared Memory and Semaphores

The following table lists the shared memory and semaphore parameters required for your system in order to run the Solstice EM software.

TABLE 2-1   Shared Memory and Semaphore Parameters 

Parameter	Minimum Value	Description
shmsys:shminfo_shmmax	268435456	Maximum size, in bytes, of a single shared memory segment.
shmsys:shminfo_shmmin	100	Minimum size, in bytes, of a single shared memory segment.
shmsys:shminfo_shmmni	100	Number of shared memory identifiers.
shmsys:shminfo_shmseg	100	Maximum number of shared memory segments that can be attached by a process.
semsys:seminfo_semmns	4096	Number of semaphores in the system.
semsys:seminfo_semmni	4096	Number of semaphore set identifiers in the system. This value determines the number of semaphore sets that can be created at any one time.
semsys:seminfo_semmsl	100	Maximum number of semaphores per Id.
semsys:seminfo_semume	64	Maximum number of undo entries per process.
semsys:seminfo_semmnu	4096	Number of undo structures in system.
semsys:seminfo_semmap	64	Number of entries in the semaphore map.

To manually configure shared memory and semaphores on your system, edit the
/etc/system file and append the following lines at the end of the file:

set shmsys:shminfo_shmmax=268435456 set shmsys:shminfo_shmmin=100 set shmsys:shminfo_shmmni=100 set shmsys:shminfo_shmseg=100 set semsys:seminfo_semmns=4096 set semsys:seminfo_semmni=4096 set semsys:seminfo_semmsl=100 set semsys:seminfo_semume=64 set semsys:seminfo_semmnu=4096 set semsys:seminfo_semmap=64

---

Note – After setting the shared memory and semaphore parameters, you must reboot your system before starting the MIS.

---

2.1.3 Optional Software Requirements

The following are software requirements for optional product compatibility features of the Solstice EM software:

• If you are going to create your own applications using the Solstice EM libraries, then use a DevPro^TM (SPARCworks) C++ 5.3 compiler to compile programs that use Solstice EM Portable Management Interface (PMI) or the Nerve Center Interface Library.
• If you plan to develop Motif applications, you must first install Motif 1.2.3, which is part of the Solaris System Developer's Kit.
• If you plan to use Solstice EM to manage with Common Management Information Potocol (CMIP) agents, CMIP 9.0 is automatically installed if you use the setup program or em_install script. Additionally, you can also use the following SunLink products in conjunction with CMIP 9.0:
  
  
  • SunLink OSI 9.0 (CLNP/LLC)
    
  • SunLink OSI 9.0 (CONS/X.25) and X.25 9.0

    ---

    Note – Solstice EM 4.1 software also supports CMIP 8.2.1 and CMIP 8.2.2.

    ---

2.1.4 Space Requirements

The following subsections provide information about the space you will need for packages, the runtime environment, and the Management Information Server (MIS).

2.1.4.1 Essential Space for Packages

You must have 620 MB in the partition where you install all Solstice EM packages. The Solstice EM product is installed under /opt directory by default. You must determine where you want to install the product before you begin the installation.

---

Note – Throughout this book, /opt is referenced. /opt is the default installation directory for the Solstice EM product. If the Solstice EM product is going to be installed in a directory other than /opt, change all references accordingly.

---

The following table lists the packages and their individual disk space requirements.

TABLE 2-2   Required Disk Space for Solstice EM Packages  

Package	Description	Size in Mbytes
SUNWcccfg	Cooperative Consoles Configuration Tool	0.4
SUNWccrcv	Cooperative Consoles Receiver Application	0.2
SUNWemalb	Solstice EM Common Libraries	41.4
SUNWemapp	Client Applications	51.2
SUNWembc	Solstice EM SNM Compatibility	3.2
SUNWemcpa	Solstice EM CMIP Management Protocol Adapter	1.2
SUNWemdev	Solstice EM Development Environment	2.2
SUNWemdmn	Solstice EM Daemons	0.7
SUNWemhtd	Solstice EM Documentation in HTML Format	9.0
SUNWemipa	Solstice EM IP Management Protocol Adapters	3.0
SUNWemjme	JavaTM Management Environment	5.0
SUNWemjmk	JavaTM Dynamic ManagementTM Protocol Adapter (JDMK), JDMK CMIS Event Listener, and the JavaBeanTM-to- GDMO Converter	1.8
SUNWemlog	Solstice EM Export Log Data to Relational Database	1.2
SUNWemmap	Geographical Map Data package	273
SUNWemmis	Solstice EM Management Information Server	44.5
SUNWemobj	Solstice Object Development Tools	1.3
SUNWemrdb	Solstice EM Relational Database	60.0
SUNWemha	Solstice EM High Availability	0.024
SUNWj2dem	JDK 1.2 Demo Programs	4.390
SUNWj2dev	JDK 1.2 Development Tools	6.875
SUNWj2man	JDK 1.2 Man Pages	0.305
SUNWj2rt	JDK 1.2 Runtime Environment	27.099
SUNWlicsw	FlexLM License System	2.6
SUNWlit	STE License Installation Tool	0.5
SUNWmibii	Solstice Enterprise Agents 1.0.3 SNMP daemon	0.19
SUNWomgta	CMIP Network Management Configuration Files	0.04
SUNWomgtb	CMIP Network Management Programs	0.5
SUNWomgte	CMIP Network Management Libraries	0.5
SUNWmgtbx	CMIP Network Management Executables	1.69
SUNWrk6	Solstice RFC1006/TLI Module	0.3
SUNWsnmag	Site/SunNet/Domain Manager Agents and Libraries	15.2
SUNWsnmct	Solstice SunNet Core Tools to Enterprise Manager	0.01
SUNWemrwd	Solstice EM RW DB Libraries	0.45
SUNWemrwt	Solstice EM RW Tool Libraries	0.23
SUNWgdmod	Solstice GDMO/ASN.1 Documents	3.04
SUNWrk6x	64 bits Solstice RFC1006/TLI Module	0.62
SUNW2jddc	JDMK Online Documentation	2.27
SUNW2jdex	JDMK Examples	0.37
SUNW2jdrt	JDMK Runtime	0.73
SUNW2jdtk	JDMK Tool	1.0
SUNWemcgs	Solstice EM CORBA Gateway ToolKit Supplement	2.97
SUNWemcgd	Solstice EM CORBA Gateway Developer Supplement	0.19

2.1.4.2 Space for Runtime Environment

A disk space of 200 MB are recommended in the partition where you choose to install the runtime environment. The default location is /var. This figure will vary, depending upon the number of objects you store in the MIS.

To check disk space, use the df -k /var command.

In the following example, the output from the df -k command on the /var file system shows that 542,143 kilobytes (542 MB) are available.

kailee% df -k /var Filesystem kbytes used avail capacity Mounted on /dev/dsk/c0t0d0s0 1693838 1100880 542143 68% /

2.1.4.3 Swap Space for MIS

At least 200 MB of swap space are recommended on the machine where the MIS is running.

To check for swap space, use the swap -l command.

In the following example, the output from the swap -l command shows that 426,192 blocks (218 MB) are available.

kailee% swap -l swapfile dev swaplo blocks free /dev/dsk/c0t0d0s1 32,1 16 656624 426192

2.2 General Questions Asked During Installation

You are asked to provide information used by the installation program to set up and configure your Solstice EM software.

Some configuration screens appear only if you have chosen to install using the Custom setup type.

During installation, you are asked to provide the following general information:

• Destination directory (default is /opt)
• Type of setup (Typical, Client, Server, Custom)
• License
• Whether or not you want to enable security access control

2.2.1 Destination Directory

The /opt is the default directory where all Solstice EM components are installed. You can also specify an alternate directory. The runtime components are installed in the directory /var/opt.

2.2.2 Setup Types and Components

You can choose the setup type: Typical, Client, Server, or Custom. The setup type determines which components are installed.

• Typical - Installs the client and server components. This setup type is recommended for most users.
• Client - Installs the client applications, including network tools for tracking, reporting, and correcting network errors.
• Server - Installs the Management Information Server (MIS) and other components necessary for creating and storing object data and serving clients.
• Custom - Allows you to choose which components to install. If you choose Custom, you can select whichever component you want to install. The full complement of components includes:
  
  
  • Management Services
    
  • IP Protocol Adapters (SNMP/RPC)
    
  • CMIP Protocol Adapter (TMNQ3)
    
  • Java Management Services
    
  • Java DMK Protocol Adapter
    
  • Client Applications
    
  • Development Environment
    
  • CORBA Gateway Runtime Supplement
    
  • CORBA Gateway Developer Supplement
    
  • Documentation
    
  • License
    
  • Geographical Map Images
    
  • Cooperative Consoles

The installation program installs the components required for each type of installation. The installation program also takes care of all package dependencies. For more information on Solstice EM components and packages installed, see Appendix A.

2.2.3 License

Some Solstice EM components require licenses to use them. You can obtain and install licenses for these components either before or after installing the Solstice EM software. However, you must install the licenses before you use any of the components that require licenses.

You must contact the license distribution center to obtain your license. But before you do, gather the following information:

• Host ID of the license server (three host IDs if you are using redundant servers). To get the host ID of your system, execute hostid at the prompt.
• Host name of the license server (three host names if you are using redundant servers). To get the name of your server, execute uname -n or hostname at the prompt.
• Serial number from the license certificate. Your Solstice EM product package includes a license certificate with the following information:
  
  
  • Serial Number
    
  • Product
    
  • Version
    
  • Rights to Use

Once you have contacted the license distribution center, you will receive one of the following:

• E-mail - You will receive a license file for the licensed features. The entire file can be read into the license database using the License Installation Tool (lit).
• Fax or phone - You will receive the following information that you can enter into the database using the lit program:
  
  
  • Rights To Use (RTU)
    
  • Password
    
  • Data checksum that will be verified
    
  • Password checksum that will be verified

During installation, you can install licences only from a file. After installation, you can use the lit program to install licenses by typing the license number or specifying a license file.

For detailed information on licensing, see Chapter 5.

2.2.4 Security Preferences

Solstice EM provides security features that restrict access to the management data based on user ID or group ID. You can allow full, limited, or read-only access to data. By default, security is disabled. You have the option of enabling security features during the installation. The default security configuration only allows a user logged in as root to perform the following:

• Start Solstice EM tools and connect to the MIS
• Use all network tools
• Access all the objects in the database

All non-root users must be granted permissions by using the Security tool. Turning off security means that any user can use the Solstice EM tools and their features, as well as access the objects in the database. You can also turn off security at any time after installation.

2.3 Information You Provide

The following table lists information you need before installing Solstice EM software.

TABLE 2-3   Installation Information Checklist 

EM Component	Default Value	Your Entry
Management Services
Name of the MIS host	localhost	__________________________
Database Administrator Password	Null	__________________________
Port number on which the CMIP MPA listens for incoming messages from the MIS	5557	__________________________
Location of runtime environment (topology and log files)	/var/opt/SUNWconn/em	__________________________
Location of the SNM log files	/var/opt/SUNWconn/snm	__________________________
Java Management Services
Path to the root directory of an HTTP server	/var/http/demo/public	__________________________
CMIP Protocol Adapter and Utilities
Name of the host where the CMIP MPA is installed	localhost	__________________________
Port number on which the MIS sends messages to the CMIP MPA	5555	__________________________
IP Protocol Adapters (SNMP/RPC)
Name of the MIS host for the RPC MPA	localhost	__________________________
Port number on which the RPC MPA listens for incoming messages from the MIS	5577	__________________________
Number of seconds for the RPC MPA request time-out value	15 seconds	__________________________
Number of retries for the RPC MPA	0 retries	__________________________
Name of the MIS host for the SNMP MPA	localhost	__________________________
Port number on which the MIS sends messages to the SNMP MPA	5555	__________________________
Port number on which the SNMP MPA listens for incoming messages from the MIS	5575	__________________________
Number of seconds for the SNMP MPA request time-out value	20 seconds	__________________________
Number of retries for the SNMP MPA	3 retries	__________________________
Name of the MIS host(s) to receive notifications from SNMP traps	localhost	__________________________
Additional MIS hosts to receive notifications from SNMP traps	None	__________________________
Name of the SNMP Management host(s) to which SNMP traps are forwarded	No forwarding	__________________________
Port number of the SNMP Management host to which SNMP traps are forwarded	162	__________________________

You must be able to answer yes or have the appropriate information for the following questions asked during the installation. If you have problems with your installation, you will need this information when you call customer support.

TABLE 2-4   Installation Questions Checklist 

Question	Answer
Do you have access to a local or remote CD-ROM drive?	__________
If remote, what is the host name of the machine to which the CD-ROM drive is attached?	__________
Is your installation machine running Solaris 8?	__________
Is your installation machine a Sun SPARC machine?	__________
Do you have a browser to read the documentation set?	__________
Does your machine have the Motif Runtime Kit?	__________
Is your machine running either the CDE or OpenWindows window system?	__________
Is the installation medium a CD-ROM?	__________
In which directory are you installing the Solstice EM software? (The default directory is /opt.)	__________
Is enough free disk space available in your installation directory or directories?	__________
Do you have the superuser password for both the machines where the Solstice EM software is to be installed and the machine with the CD drive, if different?	__________
Does the superuser have read, write, and execute access to the installation directory where the Solstice EM software is being installed?	__________
Do you have your license password from the License Distribution Center?	__________