Upgrading the Provisionable Server OS Management Agents

This section provides the procedure for upgrading provisionable server version 1.1 OS management agents to version 1.2.

The agentupgrade command can be used to upgrade the OS management agent on all provisionable servers, a group of servers, provisionable servers running a specific operating system, a specific group of provisionable servers based on the server model, or a specific server.

N1 System Manager 1.1 does not support sun4v servers such as the Sun Fire T1000 and T2000. Therefore, any Solaris s10s-hw2-04 or s10s-hw2-05 distributions that you created using N1 System Manager 1.1 do not contain the files required to support the Sun Fire T1000, T2000, and other sun4v servers.

To support the Sun Fire T1000, T2000, and other sun4v servers in N1 System Manager 1.2, you must recreate the distributions after running agentupgrade and then redeploy the distribution to the provisionable servers.

The agentupgrade syntax is as follows:

Usage: agentupgrade [--debug] [--role <role>]
        (--all|<servers>|--group <group>|[--f_ip <ip>] [--f_runningos <os>]
        [--f_jobcount (0|1)] [--f_model <model>] [--f_name <name>])

        --debug    Show additional status information
        --role     Specify session role for execution

        --all      All healthy, powered on servers
        <servers>  List of space separated servers
        --group    Group name
        --f_*      Filter on property

The following agentupgrade parameters are exclusive. Only one of the parameters can be specified when running agentupgrade.

• --all

  Upgrade the OS management agent on all discovered provisionable servers.

• --servers

  Upgrade the OS management agent on the list of provisionable servers servers where servers is the IP address of the management port of each provisionable server. For example:

  # agentupgrade 10.1.5.10 10.1.5.12 10.1.5.25

• --group

  Upgrade the OS management agent only on the provisionable servers in group group name.

• --f_*

  Upgrade the OS management agent on only those provisionable servers specified where --f_* is one or more of the following filters.

  ---

  Note –

  All filters act as wild-cards. For example, if you type agentupgrade --f_ip 10.1.1.1, the filter matches IP addresses 110.1.1.10, 210.1.1.11, and so on. If you type agentupgrade --f_model 40, the filter matches server models 240, 440, V240, and V440.

  ---

  • agentupgrade --f_ip ip address

    Update the provisionable server at IP address ip address.

  • --f_runningos

    agentupgrade --f_runningos running OS

    Update all provisionable servers that have the operating system running OS installed.

  • --f_jobcount (0|1)

    agentupgrade --f_jobcount 0running OS or agentupgrade --f_jobcount 1running OS where 0 specifies that no remote jobs are running on the provisionable server, and 1 specifies that one remote job is be running on the provisionable server.

  • --f_model

    agentupgrade --f_model model

    Update all provisionable servers that are a machine type of model.

  • --f_name

    agentupgrade --f_name provisionable server name

    Update only the provisionable servers that is named provisionable server name

The following parameters can be used with the above exclusive parameters.

• --debug

  Show additional status information when running agentupgrade.

• --role

  Run agentupgrade using the N1 System Manager using the security role role. For information about N1 System Manager security roles and use, seeManaging Roles in Sun N1 System Manager 1.2 Administration Guide.

The following procedure illustrates an OS monitoring agent upgrade of all healthy provisionable servers.

To Upgrade the Provisionable Server OS Management Agents

Steps

1. Ensure all provisionable servers that are to be updated are online and healthy.

   1. Open a browser window and log in to the N1 System Manager.

   2. Check the status of the provisionable servers and server groups.

   3. Resolve any problems noted before going to the next step.

      See Chapter 4, Managing Servers and Server Groups, in Sun N1 System Manager 1.2 Administration Guide and Chapter 5, Monitoring Your Servers, in Sun N1 System Manager 1.2 Administration Guide.

2. Log in as root to the N1 System Manager management server.

3. Upgrade the provisionable server monitoring agents by typing /opt/sun/n1gc/bin/agentupgrade --all.

   The agent upgrade process is sequential, and can take a long time if you have a large number of provisionable servers. As each provisionable server is updated, a status message is displayed that provides information about whether the agent update succeeded.

   The output generated by the agentupgrade command is sent to stdout. If a provisionable server OS management agent cannot be updated, information about the failure is written to stdout, and the agentupgrade process continues.

   You can also update the OS management agent on provisionable servers using the N1 System Manager browser. For more information, see Adding and Upgrading Base Management and OS Monitoring Features in Sun N1 System Manager 1.2 Administration Guide for procedures for updating provisionable servers. SeeTo Upgrade the OS Monitoring Feature on a Server in Sun N1 System Manager 1.2 Administration Guide for specific procedures for updating the OS management agents on provisionable servers.