Configuring an environment with SSH or RSH enabled

  1. Select DB2EEE_SETUP > Configuration > Configure KM Default > DB2 Instance settings.
  2. In the DB2 instance settings for DB2EEE_Instance dialog box, select either of the following options to enable SSH or to enable RSH:
    If SSH is enabled, select only the SSH Enabled check box. If RSH is enabled, do not select any check box (by default RSH is internally selected)
    • RSH enabled - RSH protocol is used to enter the Default Ports for the DB2 instance in the /etc/services file of all the physical nodes where DB2 database is partitioned.
    • SSH enabled - SSH protocol is used to enter the Default Ports for the DB2 instance in the /etc/services file of all the physical nodes where DB2 database is partitioned.
  3. (UNIX only ) For version 9.1, 9.5, or 9.7 configure DB2UDB Install Path by entering the DB2 UDB database installation path. From the DB2EEE_SETUP menu, select Configuration > Configure DB2 UDB Install Path.
     You can enter multiple install paths separated by a semi colon (For example, /data/db2/IBM/v9.1; /opt/ibm/v9.5; /opt/IBM/db/v9.1)
  4. Right-click DB2EEE_SETUP and select KM Commands > Configuration> Configure Default Accounts, select the instance and configure the default account for the DB2 instance.
  5. In the Configure Default Accounts window, do one of the following:
    • select instances that will use the default account
    • (UNIX only ) enter the instance name manually and select the DB2 version
  6. Right-click DB2EEE_SETUP and select KM Commands > Configuration > Configure Default Ports.
  7. In the Configure Default Ports window, select the instance with which the port name will be associated.
  8. Select the Add option.

  9. In the Port service Namebox, type a unique port service name for the specified instance to use.

    Note

    The name specified for the service name must be unique. It cannot be in use by any host defined in the db2nodes.cfg file. To verify if a name is in use for a host computer, view the*/etc/services* file on the host. The port name must not contain more than 20 characters.

  10.  In the Starting port numberbox, type a number that indicates the beginning port number in a series of at least four numbers to use for the specified instance.

    Note

    The number specified must be unique. It cannot currently be in use (that is, it must not exist in the /etc/services file) by any host being monitored.

  11. In the Ending port numberbox, type an ending number for the sequence of numbers in the series that is at least three greater than the Starting Port Number that you entered. In other words, you are specifying a block of port numbers to assign to a named service for PATROL for DB2 UDB.

    Example

    A port service entry will look as follows in the services file, assuming that INSTABC was entered for port name, 5000 was entered for starting port number, and 5003 was entered for the ending port number: DB2EEEKM_INSTABC 5000 / tcp DB2EEEKM_INSTABC_END 5003 / tcp

  12. Click OK to complete the task.

  13. Perform a Force Discovery of the PATROL Agent to discover all application classes and parameters under DB2EEE.

    Note

    • In an AIX environment where an SP system with a control workstation is being used to manage the /etc/services file for all nodes, you must manually create an entry in the*/etc/services* file of the control workstation that is identical to the entry made by the Configure Default Port command on any of the hosts.
    • You can change the service entry by removing the port service name and adding another name and series of ports.

To remove default port settings

Select the Remove option in the Configure Default Ports window.

If a problem occurs

Verify that the port name and numbers entered are not currently being used by any other service, they should not exist in /etc/services or listed in netstat -na on all physical nodes. Check that the file permissions have been set correctly for db2km_services.eee.

The KM uses $PATROL_HOME/bin/db2km_services.eee to add entries in the*/etc/services* file. Ensure that this file is owned by root and has file permissions set as follows:

-rwsr-sr-x

If the file is not owned by root or does not have the correct permissions, you can issue the following UNIX commands to assign root ownership and set permissions:

  • chown root db2km_services.eee
  • chmod u+s db2km_services.eee

Check for the process db2km_server.eee DB2EEEKM_port-name on all the physical nodes by giving command ps -ef|grep db2km. This process should run on each physical node.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*