Troubleshooting Common Agent Container Problems in the Oracle Solaris OS

This section addresses problems that you might encounter with the common agent container shared component. In this Oracle Solaris release, the common agent container Java program is included in the Oracle Solaris OS. The program implements a container for Java management applications. Typically, the container is not visible to the user.

The following are potential problems:

• Port number conflicts

• Compromised security for the superuser password

Port Number Conflicts

The common agent container occupies the following port numbers by default:

• JMX port (TCP) = 11162

• SNMPAdaptor port (UDP) = 11161

• SNMPAdaptor port for traps (UDP) = 11162

• Commandstream Adaptor port (TCP) = 11163

• RMI connector port (TCP) = 11164

If your installation already reserves any of these port numbers, change the port numbers that are occupied by the common agent container, as described in the following procedure.

How to Check Port Numbers

This procedure shows you how to verify the port.

1. Become superuser or assume an equivalent role.

   Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services.

2. Stop the common agent container management daemon.

   # /usr/sbin/cacaoadm stop

3. Change the port numbs by using the following syntax:

   # /usr/sbin/cacaoadm set-param param=value

   For example, to change the port occupied by the SNMPAdaptor from the default of 11161 to 11165, type:

   # /usr/sbin/cacaoadm set-param snmp-adaptor-port=11165 

4. Restart the common agent container management daemon.

   # /usr/sbin/cacaoadm start

Compromised Security for Superuser Password

It might be necessary to regenerate security keys on a host that is running the Java ES. For example, if there is a risk that a superuser password has been exposed or compromised, you should regenerate the security keys. The keys that are used by the common agent container services are stored in /etc/cacao/instances/instance-name/security directory. The following task shows you how to generate security keys for the Oracle Solaris OS.

How to Generate Security Keys for the Oracle Solaris OS

1. Become superuser or assume an equivalent role.

   Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services.

2. Stop the common agent container management daemon.

   # /usr/sbin/cacaoadm stop

3. Regenerate the security keys.

   # /usr/sbin/cacaoadm create-keys --force

4. Restart the common agent container management daemon.

   # /usr/sbin/cacaoadm start

   ---

   Note - For the Oracle Sun Cluster software, you must propagate this change across all nodes in the cluster.

   ---