test

Sun Management Center 3.6.1 Installation and Configuration Guide

Reconfiguring Port Addresses

This section describes how to configure Sun Management Center software when port addresses might conflict. See Table 9–3 for a list of the default ports for each Sun Management Center component.

Note –

The Sun Management Center setup process checks whether each default port is in use. If the port is not in use, the default port is assigned. If a port is in use, you are given the opportunity to specify a separate port. In either case, the port assignments are stored in the configuration files, as described in SNMP Overview.

Default Ports

The default ports used by Sun Management Center components might be used by other processes already installed on the system. If you install Sun Management Center using the default port assignments, you might encounter port conflicts and be unable to start Sun Management Center. The Sun Management Center setup process checks the ports for each component. The process prompts you to either assign an alternate port or use the default port.

The following table lists the Sun Management Center components and the default port for each component. See To Determine Whether a Port Is Used to find out how to check whether a port is in use.

Table 9–3 Sun Management Center Default Port Addresses

Layer 

Component 

Default Port Number 

Agent 

Agent

161 

Server 

Trap handler

162 

Server 

Event manager

163 

Server 

Topology manager

164 

Server 

Configuration manager

165 

Server 

Platform 

166 

Advanced System Monitoring Add-on 

System event and configuration tracking component cstservice

167 

Server 

Agent information caching component Metadata

168 

Server 

Server RMI

2099 

Server 

Database

2521 

Server 

Grouping 

5600 

Tomcat 

Web server 

8006 

Server 

Web server default port

8080 

Server 

Web server secure port

8443 

ProcedureTo Determine Whether a Port Is Used

Step

    In a terminal window, type /bin/netstat -an | grep portnumber where portnumber is the port number that you want to query. For example: 


    # /bin/netstat -an | grep 8443
#

    • If the port is not in use, only the command-line prompt is returned as shown above.

    • If the port is in reserved or in use, the status of the port is returned. For example: 


      # /bin/netstat -an | grep 1161
#       *.1161                                Idle
# /bin/netstat -an | grep 8080
# 172.16.0.0.8080         *.*                0      0 24576      0 LISTEN

      where 172.16.0.0 is the IP address of the machine on which you entered the netstat command.

Reconfiguring Sun Management Center Ports

To reconfigure Sun Management Center ports, use the es-config command.

The following procedures provide examples of how to use the es-config command to reconfigure Sun Management Center port assignments.

ProcedureTo Reconfigure the Agent SNMP Port

Steps

  1. Log in as root on the Sun Management Center server-layer machine.

  2. Locate an unused port.

    See To Determine Whether a Port Is Used.

  3. Type /opt/SUNWsymon/sbin/es-config -p agent.

    es-config stops all Sun Management Center processes. The port numbers currently assigned to the Sun Management Center components are then displayed. The port number assigned to the agent is displayed next, and you are prompted to enter the port number.


    # ./es-config -p agent
Following ports are occupied by Sun Management Center:
161,162,163,164,165,167,168,166,5600,2099,8080,8443.

Sun Management center agent component is presently using port:161
Hit RETURN key to continue with present configuration.
Enter the port number you would like to use for agent component
    [ 1100 to 65535 ]:

  4. Type the port number that you want to assign, or press Return to use the default 161 port assignment.

    You are asked whether you want to start the Sun Management Center components.

  5. Type y to start the Sun Management Center components, or type n if you do not want to start the components.

ProcedureTo Reconfigure the Server RMI Port Address

Steps

  1. Log in as root on the Sun Management Center server-layer machine.

  2. Locate an unused port.

    See To Determine Whether a Port Is Used.

  3. Type /opt/SUNWsymon/sbin/es-config -p rmi.

    es-config stops all Sun Management Center processes. The port numbers currently assigned to the Sun Management Center components are then displayed. The port number assigned to the server is displayed next, and you are prompted to enter the port number. For example:


    # ./es-config -p rmi
Following ports are occupied by Sun Management Center:
161,162,163,164,165,167,168,166,5600,2099,8080,8443.

Sun Management center agent component is presently using port:2099
Hit RETURN key to continue with present configuration.
Enter the port number you would like to use for rmi component 
   [ 1100 to 65535 ]:

  4. Type the port number that you want to assign, or press Return to use the default port assignment.

    You are asked whether you want to start the Sun Management Center components.

  5. Type y to start the Sun Management Center components, or type n if you do not want to start the components.

Using es-config

The syntax for the es-config command is:

es-config [-Adhmnq] [-p sunmc_component] [-c sunmc_component:channel] [-r | -o | -u usmuser] [-f filename] [-a option] [-P component:MinPort:MaxPort] [-W webuser] [-M module[-k lauser| -l lauser| -s]]

The following table describes the es-config parameters.

Table 9–4 es-config Options

Option 

Modifying Options 

Description 

-A

 

Configure all ports 

-a

option

Setup database in archive log mode or no archive log mode.  

-o 

 

Reconfigure oracle memory. 

-P

component:MinPort:MaxPort

Configure the probe mechanism port range where MinPort is the starting port number and MaxPort is the ending port number. The range of ports must be at least 20 for example, 1024:1044. The minimum specified ports for -P is 20. The ports are used by the probe mechanism to execute ad hoc commands for communication between the Sun Management Center server and agent or between server and console. Valid port numbers are 1100-65535.

Valid values for <component> are server and console.

This option can be used in one of the following three ways: 

-P MinPort:MaxPort: Configures port range for communication between server and agent

-P server:MinPort:MaxPort: Configures server port range for communication between server and console

-P console:MinPort:MaxPort: Configures console port range for communication between server and console

Note –

You must configure the port range to support communication between the Sun Management Center server and agent or between server and console through a firewall.

-d

 

Restore all ports to the 3.6.1 default value. See Table 9–3.

-c

sunmc_component:channel

Enable or disable the component channels being logged. Valid Sun Management Center components for which channels can be controlled are topology, cfgserver, event, cstservice, trap, metadata, agent, platform, and platform_instances. Valid channels are debug, info, error, status, and history.

-f

file-name

Used only with the -r, -u, and -o options. Reads the seed and community string from the specified file and seeds the esd component. The file has the format:


ES_SECURITY_SEED=seed
ES_SNMPV1_STRING=string

where seed is the seed you want to reseed with and string is the community string. The file should be owned by root and have read/write permissions for root only; otherwise the seed could be readable by unauthorized users.

-h

 

List the es-config options.

-m

 

Configure module configuration propagation by adding a list of user names to the es-mcp-users configuration file.

-n

 

Enable Network Address Translation support. 

-p

sunmc_component

Configure port to be used by the Sun Management Center component component-name. Valid components are topology, cfgserver, event, cstservice, trap, metadata, rmi, agent, grouping, HTTP, HTTPS, platform, and platform_instances.

-q

 

Exit from script without starting the esd component. By default, the script tries to start the esd component before exiting.

-r

 

Re-seed product components. If SUNWcry or SUNWcsl package is installed, this option prompts you whether to enable SNMP encryption (privacy). For more information, see SNMP Encryption (Privacy) in Sun Management Center 3.6.1 User’s Guide

-u

username

Add users to the User Security Model (USM) table locally on an SNMPv3 agent. <username> is the name of the SNMPv3 user to be added to the USM table. After entering the user name and pressing Return, you will be prompted to enter the passphrase (minimum of eight characters) and confirm it. This passphrase is used to generate the keys needed for performing SNMPv3 communication.

-W

webuser

Configure/change the specified user to start/stop the Web Server. Sun Management Center server uses noaccess as the default user to start/stop the Tomcat Web Server.

-M

module

Module name for local access user. Used in conjunction with -k, -l, -s.

-k

lauser

Delete the specified local access user. This is applicable for Service Management Facility (SMF), Module Configuration Propagation, and Solaris Container Manager modules. 

-l

lauser

Add the specified local access user. This is applicable for Service Management Facility (SMF), Module Configuration Propagation, and Solaris Container Manager modules. 

-s

 

Show all the local access users. This is applicable for Service Management Facility (SMF), Module Configuration Propagation, and Solaris Container Manager modules.