test

Sun N1 System Manager 1.2 Administration Guide

ProcedureTo Add the OS Monitoring Feature

This procedure describes how to add the OS monitoring feature on a server. You can add the OS monitoring feature to a server that already has the base management feature added. Alternatively, you can add the OS monitoring feature to a server with a newly loaded OS and the base management feature is added automatically. The OS monitoring feature is used for OS health monitoring and inventory management. See Chapter 5, Monitoring Your Servers for details.

The add server feature osmonitor command creates an Add OS Monitoring Support job. You can submit multiple, overlapping add server feature osmonitor commands and have them run in parallel. However, you should limit the number of overlapping Add OS Monitoring Support jobs to a maximum of 15.

If you submit add server feature commands by using a script, see Example 5–1 for an example.

Note –

You can add the OS monitoring feature automatically as part of the load server or load group commands. See load server in Sun N1 System Manager 1.2 Command Line Reference Manual or load group in Sun N1 System Manager 1.2 Command Line Reference Manual for details.

Before You Begin
Steps

  1. Log in to the N1 System Manager.

    See To Access the N1 System Manager Command Line for details.

  2. To add the OS monitoring feature, perform one of the following actions:

    • If you have not added the base management feature, type the following command:

      Note –

      The SSH user account that is used in the following command must have root privileges on the remote machine.


      N1-ok> add server server feature osmonitor agentip agentip agentssh username/password

    • If you have already added the base management feature, type the following command:

      Note –

      You cannot specify the agent IP or SSH credentials when adding OS monitoring support to a server that has base management support.


      N1-ok> add server server feature osmonitor

    An Add OS Monitoring Support job starts.

    See add server in Sun N1 System Manager 1.2 Command Line Reference Manual for details about command syntax.

  3. Track the Add OS Monitoring Support job to completion.

    After the job completes successfully, the Servers table on the System Dashboard tab appears with values for OS Usage and OS Resource Health.

    Verify that the OS monitoring feature is supported by issuing the show server command. Output for the server appears with the OS Monitoring Supported value as OK one of the following sets of commands on the provisionable server.

    Note –

    It can take 5-7 minutes before all OS monitoring data is fully initialized. You may see that CPU idle is at 0.0%, which causes a Failed Critical status with OS usage. This should clear up within 5-7 minutes after adding or upgrading the OS monitoring feature.

    If no monitoring data is available for the server, see Resolving Command Failures Related to OS Monitoring.

    If the provisionable server's IP address changes, use the set server command again before enabling or disabling monitoring

Example 5–1 Scripting OS Monitoring Support

The following example script issues multiple add server feature commands on servers that do not have the base management feature support:


n1sh add server 10.0.0.10 feature=osmonitor agentip 10.0.0.110 agentssh root/admin &
n1sh add server 10.0.0.11 feature=osmonitor agentip 10.0.0.111 agentssh root/admin &
n1sh add server 10.0.0.12 feature=osmonitor agentip 10.0.0.112 agentssh root/admin &
Troubleshooting

Adding the OS monitoring feature might fail due to stale SSH entries on the management server. If the add server feature osmonitor agentip command fails and no true security breach has occurred, remove the known_hosts file or the specific entry in the file that corresponds to the provisionable server. Then, retry the add server feature osmonitor agentip command. If the management server is running Linux, the known_hosts file is at /root/.ssh/known_hosts. If the management server is running the Solaris OS, the known_hosts file is at /.ssh/known_hosts.

Adding the OS monitoring feature will fail if you specify the agent IP or the SSH credentials in the add server feature osmonitor command when running it on servers that already have the base management feature support. To solve this problem, issue the add server feature osmonitor command without specifying values for the agent IP or for the SSH credentials.