Chapter 9 Maintaining the Change Manager Topology (Tasks)

This chapter describes the Change Manager topology and procedures for organizing it. If Sun Management Center is configured with more than one administrative domain, then you can create a hierarchy of host groups and managed hosts in these administrative domains. A managed host is a host that is controlled by the Change Manager. A host group is a collection of managed hosts and other host groups.

Like the Change Manager repository, the administrative domain is organized as a file manager. You can use host groups to organize managed hosts into logical units. You can perform actions on individual managed hosts or on host groups.

The following topics are covered in this chapter:

• Change Manager Host Object Types

• Maintaining the Change Manager Topology by Using the Browser Interface (Task Map)

• Maintaining the Change Manager Topology by Using the Browser Interface

• Maintaining the Change Manager Topology by Using the Command-Line Interface (Task Map)

• Maintaining the Change Manager Topology by Using the Command-Line Interface

Change Manager Host Object Types

Change Manager supports three host object types: managed hosts, host groups, and administrative domains. Change Manager can perform operations on managed hosts and host groups.

You can use host groups to create a hierarchy in which to organize managed hosts. Managed hosts can belong to one or more host groups, which enables you to view the same managed hosts from different perspectives.

You can organize the host groups and managed hosts in the following ways:

• Group like host types - For example, store all Netra X1 machines in a single host group. Do the same for other hardware types.

• Group managed hosts related to a particular service - Create a host group to hold all the managed hosts associated with a particular service. For example, a server farm manages web services. Therefore, create a host group named WebServer. In the WebServer host group, store the managed hosts used in the web server farm.

• Group managed hosts by geography - Create a host group to hold all the managed hosts that exist in a city, office suite, building, floor, or rack. For example, your company's Los Angeles office is located on the 6th floor. Therefore, create a host group named 6th floor. In the 6th floor host group, store the managed hosts that are on the 6th floor of your office.

• Group managed hosts by administrator - Create a host group to hold all the managed hosts administered by a system administrator. For example, Pat and Chris administer the managed hosts for your company. Therefore, create host groups named pat and chris. In the pat host group, store the managed hosts that are administered by Pat. Store Chris's managed hosts in the chris host group.

• Group managed hosts by organization - Create a host group to hold all the managed hosts for each organization. For example, group managed hosts for your marketing and engineering organizations. Therefore, create host groups named marketing and engineering.

Host Group

A host group is a container that holds managed hosts and other host groups. Click a host group name to change into that host group and view its contents.

Perform the following actions from a host group:

• Add a host group

• Add a managed host

• Import multiple managed hosts from a file

• Rename a managed host or host group

• Move a managed host or host group to another host group

• Remove a managed host or host group

Managed Host

A managed host is a host that is managed by the Change Manager. You can perform actions and run jobs on managed hosts.

Managed hosts in the Change Manager topology have a standard set of properties associated with them:

Description

User-supplied string that describes the managed host.

AgentPort

Port number the agent uses to communicate with the Change Manager server.

---

Note -

If you change the value of this property after installing a managed host, the Change Manager server will no longer be able to communicate with it. To reestablish communication with the server by using the new agent port, you must re-initialize the managed host by performing an initial installation on it.

---

Owner

Read-only property that names the owner of the managed host.

State

Read-only property that indicates the state of the managed host.

Modify the managed host's configuration by specifying the following:

• Ethernet address

• Platform group of the hardware

• Shared profile to use

• Values for archive-specific parameters

Perform the following actions on this managed host:

• Rename a managed host

• Copy a managed host to another host group

• Move the managed host to another host group

• Remove the managed host

Maintaining the Change Manager Topology by Using the Browser Interface (Task Map)

The following table identifies the procedures you need to add hosts in your administrative domain.

Maintaining the Change Manager Topology by Using the Browser Interface

The following procedures describe some of the tasks to perform from the Hosts section. To initiate deployment jobs, see Chapter 5, Installing Solaris Flash Archives on Managed Hosts (Tasks). To initiate audit jobs, see Chapter 6, Auditing Software Configurations (Tasks).

You can create administrative domains by using the Sun Management Center application. If more than one administrative domain exists, the top-level Hosts page lists the administrative domains available to the Change Manager. Click the name of the domain in which your managed hosts reside. If only the default domain exists, then the top-level page lists the host groups and managed hosts in the default domain. Then, from the Hosts section, initiate jobs on managed hosts.

Perform the actions on the Host Actions drop-down menu while in the appropriate host group. For example, to create a host group inside an existing host group, go to the existing host group before choosing Add Group from the Host Actions menu.

To learn how to navigate through the browser interface, see Appendix A, Navigating Through the Change Manager Browser Interface (Reference).

Do not remove the managed host element that represents your Change Manager server. This host is created automatically when the Sun Management Center server software is installed on the Change Manager server.

How to Access the Hosts Section and Appropriate Administrative Domain and Host Group (Web Browser)

1. To go to the Hosts section, click the Hosts tab in the general links area at the top of the page.

   • If more than one administrative domain exists, you go to a page showing a table that lists the available administrative domains. Go to Step 2.

   • If only one administrative domain exists, the page shows a table that lists managed hosts and host groups in the default domain. Go to Step 3.

2. (Optional) Click the name of the administrative domain to use.

   ---

   Note -

   Use Sun Management Center to create a new administrative domain. See "Using Sun Management Center Administrative Domains" in Sun Management Center 3.0 Software User's Guide.

   ---

3. Drill down to the appropriate host group.

   Click a host group name to go into that host group. Then, view the host group's contents. Continue to click host group names until you reach the host group or managed host you want.

How to Create a Host Group (Web Browser)

1. If you are not already in the appropriate host group, see How to Access the Hosts Section and Appropriate Administrative Domain and Host Group (Web Browser).

2. From the Host Actions menu, choose Add Group.

3. Supply a host group name.

   Choose a meaningful name, for example, a name that indicates the types of managed hosts and host groups that the host group contains.

4. Click Add to create the host group.

   Click Cancel to return to the previous page.

How to Rename a Managed Host or Host Group (Web Browser)

Rename only one managed host or host group at a time.

Changing the name of a managed host with the Change Manager only changes how that managed host is labeled in that particular host group.

Changing the name does not change the following:

• How that managed host is labeled in other host groups

• The name by which the managed host is known in the naming service

• The name the managed host calls itself

1. If you are not already in the appropriate host group, see How to Access the Hosts Section and Appropriate Administrative Domain and Host Group (Web Browser).

2. Click the checkbox next to the managed host name or host group name to select it.

3. From the Host Actions menu, choose Rename.

   A page appears that shows the current managed host name or host group name and a field in which to type the new name.

4. Supply a new name.

5. Click Rename to change the name of the managed host or host group in your administrative domain.

   Click Cancel to return to the previous page.

How to Copy Managed Hosts to Another Host Group (Web Browser)

Managed hosts can belong to one or more host groups. To learn why you might want to have managed hosts belong to one or more host groups, see Change Manager Host Object Types.

Managed hosts can only be copied to existing host groups. To create a host group in which to copy a managed host, see How to Create a Host Group (Web Browser).

1. If you are not already in the appropriate host group, see How to Access the Hosts Section and Appropriate Administrative Domain and Host Group (Web Browser).

2. Select the managed hosts to copy.

3. From the Host Actions menu, choose Copy Hosts.

   A page appears that shows the name of the managed host and a field in which to type the other host group.

4. Supply a path name to another host group in your administrative domain.

   Click Browse to launch a chooser window. Use the chooser to locate the other host group.

5. Click Copy to copy the managed host to the other host group.

   Click Cancel to return to the previous page.

How to Move Managed Hosts and Host Groups to Another Host Group (Web Browser)

1. If you are not already in the appropriate host group, see How to Access the Hosts Section and Appropriate Administrative Domain and Host Group (Web Browser).

2. Select the managed hosts and host groups to move.

3. From the Host Actions menu, choose Move.

   A page appears that shows the current managed host name and host group name and a field in which to input the other host group.

4. Supply a path name to another host group in your administrative domain.

   Click Browse to launch a chooser window. Use the chooser to locate the other host group.

5. Click Move to move the managed hosts and host groups to the other host group.

   Click Cancel to return to the previous page.

How to Remove Managed Hosts and Host Groups (Web Browser)

Remove only empty host groups.

1. If you are not already in the appropriate host group, see How to Access the Hosts Section and Appropriate Administrative Domain and Host Group (Web Browser).

2. Select the managed hosts and host groups to remove.

3. From the Host Actions menu, choose Remove.

   A page appears that shows the names of the managed hosts and host groups to remove.

4. Click Remove to remove the managed hosts and host groups.

   Click Cancel to return to the previous page.

How to View the Contents of a Host Group (Web Browser)

1. If you are not already in the appropriate host group, see How to Access the Hosts Section and Appropriate Administrative Domain and Host Group (Web Browser).

2. Click the host group name to view that host group.

   A page appears that shows the contents of the host group.

3. To return to the previous host group, click the name of the parent host group in the bread crumbs.

How to View or Modify Managed Host Properties (Web Browser)

1. If you are not already in the appropriate host group, see How to Access the Hosts Section and Appropriate Administrative Domain and Host Group (Web Browser).

2. Click the managed host's name to do either of the following:

   • View the managed host's properties.

     Click Cancel to return to the managed host's parent host group.

   • Modify the property values of the managed host.

     Click Save to save the property value changes and return to the parent host group. Click Cancel to return to the parent host group.

Maintaining the Change Manager Topology by Using the Command-Line Interface (Task Map)

The following table identifies the procedures you need to manage the Change Manager topology. See the changemgr(1MCM) man page.

Maintaining the Change Manager Topology by Using the Command-Line Interface

To initiate deployment jobs, see Chapter 5, Installing Solaris Flash Archives on Managed Hosts (Tasks). To initiate audit jobs, see Chapter 6, Auditing Software Configurations (Tasks).

How to Specify the Administrative Domain in Which to Add Hosts (Command Line)

1. Determine the name of the administrative domain you want to use.

2. Use the -d domain option with the changemgr command to supply the name of the administrative domain.

   $ changemgr subcommand other-options -d domain operands

   For example, specify an administrative domain named web-domain in which to store the topology.

Example-Specifying an Administrative Domain in Which to Add Hosts

Chris views the contents of the web-server/ApacheServer host group, which is in the web-domain administrative domain.

$ changemgr hosts -d web-domain /web-server/ApacheServer

How to Create a Host Group (Command Line)

1. Determine where to create the host group.

   For example, create a host group in the web-server host group.

2. Create a host group.

   $ changemgr mkgroup [ -u username ] [ -p file ] [ -d domain ] \ grouppath ...

   -u username

   Specify the user name to authenticate. If this option is not specified, the user is the current UNIX user.

   -p file

   file consists of a single line, which contains the password. If file is -, then the user can supply the password as standard input.

   If the -p option is not supplied, then the changemgr command prompts the user for his password.

   -d domain

   Specify the administrative domain on which to operate. In the context of a session, the default is the domain specified for the session. If no domain is specified, domain is the user's home domain. By default, domain is the user's home domain.

   grouppath

   Specifies the path to a host group that is relative to the top of the selected administrative domain.

   Choose a host group name that indicates the types of managed hosts the host group contains. For example, create a host group named apache in which to group managed hosts that run the Apache web server.

Example-Creating a Host Group

Chris creates the apache host group in the web-server host group.

$ changemgr mkgroup /web-server/apache

How to Rename a Managed Host or Host Group (Command Line)

You can rename only one managed host or host group at a time.

Changing the name of a managed host with the Change Manager only changes how that managed host is labeled in that particular host group.

Changing the name does not change the following:

• How that managed host is labeled in other host groups

• The name by which the managed host is known in the naming service

• The name the managed host calls itself

1. Determine which managed host or host group to rename.

   For example, rename the web-server/apache host group to be web-server/ApacheServer.

2. Rename the managed host or host group.

   $ changemgr hostmove [ -u username ] [ -p file ] [ -d domain ] \ old_topopath new_topopath

   topopath

   Specifies the path to a managed host or host group that is relative to the top of the selected administrative domain.

   For descriptions of the other options, see How to Create a Host Group (Command Line).

Example-Renaming a Managed Host or Host Group

Chris renames the web-server/apache host group to be web-server/ApacheServer.

$ changemgr hostmove /web-server/apache \
/web-server/ApacheServer

How to Copy Managed Hosts to Another Host Group (Command Line)

To copy a managed host to another host group, you must add a managed host to that group. See How to Add Managed Hosts (Command Line).

Managed hosts can only be copied to an existing host group. To create a host group in which to copy a managed host, see How to Create a Host Group (Command Line).

How to Move Managed Hosts and Host Groups to Another Host Group (Command Line)

1. Determine which managed hosts and host groups to move and the destination host group.

   For example, move /web-server/host1 and /web-server/host2 to the web-server/ApacheServer host group.

2. Move the managed hosts and host groups to the other host group.

   $ changemgr hostmove [ -u username ] [ -p file ] [ -d domain ] \ old_topopath ... new_grouppath

   topopath

   Specifies the path to a managed host or host group that is relative to the top of the selected administrative domain.

   For descriptions of the other options, see How to Create a Host Group (Command Line).

Example-Moving Managed Hosts to Another Host Group

Chris moves the /web-server/host1 and /web-server/host2 managed hosts to the web-server/ApacheServer host group.

$ changemgr hostmove /web-server/host1 /web-server/host2 \
/web-server/ApacheServer

Example-Moving Host Groups to Another Host Group

Chris moves the ApacheServer and NewServer host groups to the web-server host group.

$ changemgr hostmove ApacheServer NewServer /web-server

How to Remove Managed Hosts and Host Groups (Command Line)

You can only remove a host group that is empty.

1. Determine which managed hosts and host groups to remove.

   For example, remove the /web-server/host1 and /web-server/host2 managed hosts and the /web-server host group.

2. Remove the managed hosts and host groups.

   $ changemgr remove [ -u username ] [ -p file ] [ -d domain ] \ topopath ...

   topopath

   Specifies the path to a managed host or host group that is relative to the top of the selected administrative domain.

   For descriptions of the other options, see How to Create a Host Group (Command Line).

Example-Removing Managed Hosts and Host Groups

Chris removes the /web-server/host1 and /web-server/host2 managed hosts and the /web-server host group.

$ changemgr remove /web-server/host1 /web-server/host2 \
/web-server

How to View the Contents of a Host Group (Command Line)

A host group can contain managed hosts and other host groups.

To view host group properties, see How to View Host Group Properties (Command Line). To modify host group properties, see How to Modify Host Group Properties (Command Line).

1. Determine which host group to view.

   For example, view the contents of the web-server host group.

2. View the host group.

   $ changemgr hosts [ -u username ] [ -p file ] [ -d domain ] \ [ -l ] [ -g ] [ -R ] [ -o format ] [ topopath ... ]

   -l

   Present detailed information about the specified managed hosts and host groups in tabular form.

   -g

   Present information about the host group itself, rather than about the host group's contents.

   -R

   Describe all the host group's descendents.

   -o format

   format is a blank-separated list or comma-separated list of property names. If you separate the property names with spaces, make sure that you surround the list of property names with quotes. The specified property values are displayed in a name-value format. If format is specified as all, then all properties are displayed. The output is suitable for programmatic parsing.

   topopath

   Specifies the path to a managed host or host group that is relative to the top of the selected administrative domain.

   For descriptions of the other options, see How to Create a Host Group (Command Line).

Example-Viewing the Contents of the Current Host Group

Chris views the contents of the host group at the root of the administrative domain.

$ changemgr hosts

Example-Viewing Host Group Contents

Chris views the contents of the web-server/ApacheServer host group.

$ changemgr hosts /web-server/ApacheServer

Example-Viewing Information About the Host Group

Chris views the information about the web-server/ApacheServer host group.

$ changemgr hosts -g /web-server/ApacheServer

Example-Viewing Host Group Contents in Table Form

Chris views the contents of the web-server/ApacheServer host group in table form.

$ changemgr hosts -l /web-server/ApacheServer

Example-Viewing Host Group Contents and Contents of the Host Group's Descendents

Chris views the contents of the web-server/ApacheServer host group and its descendents.

$ changemgr hosts -R /web-server/ApacheServer

Example-Viewing Host Group Contents and Specific Properties

Chris views the contents of the web-server/ApacheServer host group. Chris wants to see the values of the Description property and the base_config_templateName property for each of the managed hosts in /web-server/ApacheServer. Note that you can use either format shown.

$ changemgr hosts -o Description,base_config_templateName \
/web-server/ApacheServer

$ changemgr hosts -o "Description base_config_templateName" \
/web-server/ApacheServer

Example-Viewing Host Group Contents and All Properties

Chris views the contents of the web-server/ApacheServer host group and wants to see the values of all the properties for each managed host and host group.

$ changemgr hosts -o all /web-server/ApacheServer

How to View Managed Host Properties (Command Line)

To modify managed host properties, see How to Modify Managed Host Properties (Command Line).

1. Determine which managed host's properties to view.

   For example, view the properties of web-server/ApacheServer/host1.

2. View the properties of the managed host.

   $ changemgr hosts [ -u username ] [ -p file ] [ -d domain ] \ [ -l ] [ -g ] [ -R ] [ -o format ] [ topopath ... ]

   -l

   Present detailed information about the specified managed hosts and host groups in tabular form.

   -g

   Present information about the host group itself, rather than about the host group's contents.

   -R

   Describe all the host group's descendents.

   -o format

   format is a blank-separated list or comma-separated list of property names. If you separate the property names with spaces, make sure that you surround the list of property names with quotes. The specified property values are displayed in a name-value format. If format is specified as all, then all properties are displayed. The output is suitable for programmatic parsing.

   topopath

   Specifies the path to a managed host or host group that is relative to the top of the selected administrative domain.

   For descriptions of the other options, see How to Create a Host Group (Command Line).

Example-Viewing Managed Host Properties

Chris views the properties of web-server/ApacheServer/host1.

$ changemgr hosts -o all /web-server/ApacheServer/host1

How to Modify Managed Host Properties (Command Line)

For the list of properties, see Chapter 10, Creating Shared Profiles and Host Properties (Reference).

1. Determine the managed host's properties that you want to modify.

   For example, modify the properties of the web-server/ApacheServer/host2 managed host.

2. Modify the property values of the managed host.

   $ changemgr hostset [ -u username ] [ -p file ] [ -d domain ] \ [ -s name=value ] ... [ -s name ] ... topopath ...

   -s name=value

   Specify one or more name-value pairs. name is the property name, and value is the property value. Supply this option for each property value you want to set. If value is blank, then the property is assigned an empty value.

   -s name

   Specify one or more property names to delete, where name is the property name. Supply this option for each property you want to delete.

   topopath

   Specifies the path to a managed host or host group that is relative to the top of the selected administrative domain.

   For descriptions of the other options, see How to Create a Host Group (Command Line).

Example-Modifying a Managed Host Property

Chris modifies the Description property of the web-server/ApacheServer/host2 managed host.

$ changemgr hostset -s Description="Apache Web Server: host2" \
/web-server/ApacheServer/host2

Example-Modifying Managed Host Properties

Chris modifies the Description and base_config_target_arch properties for web-server/ApacheServer/host2.

$ changemgr hostset -s Description="Apache Web Server: host2" \
-s base_config_target_arch=sun4u /web-server/ApacheServer/host2

Example-Deleting a Managed Host Property

Chris deletes the Description property of the web-server/ApacheServer/host2 managed host.

$ changemgr hostset -s Description /web-server/ApacheServer/host2

Example-Recursively Setting Host Group Properties

Chris recursively sets the Description property of the contents of the web-server host group.

$ changemgr hostset -R -s Description="Web Server managed host" /web-server

How to View Host Group Properties (Command Line)

To modify host group properties, see How to Modify Host Group Properties (Command Line).

1. Determine which host group's properties to view.

   For example, view the properties of the web-server/ApacheServer host group.

2. View host group properties.

   $ changemgr hosts [ -u username ] [ -p file ] [ -d domain ] \ [ -l ] [ -g ] [ -R ] [ -o format ] [ topopath ... ]

   -l

   Present detailed information about the specified managed hosts and host groups in tabular form.

   -g

   Present information about the host group itself, rather than about the host group's contents.

   -R

   Describe all the host group's descendents.

   -o format

   format is a blank-separated list or comma-separated list of property names. If you separate the property names with spaces, make sure that you surround the list of property names with quotes. The specified property values are displayed in a name-value format. If format is specified as all, then all properties are displayed. The output is suitable for programmatic parsing.

   topopath

   Specifies the path to a managed host or host group that is relative to the top of the selected administrative domain.

   For descriptions of the other options, see How to Create a Host Group (Command Line).

Example-Viewing Host Group Properties

Chris views the contents of the web-server/ApacheServer host group.

$ changemgr hosts -g -o all /web-server/ApacheServer

How to Modify Host Group Properties (Command Line)

For the list of properties, see Chapter 10, Creating Shared Profiles and Host Properties (Reference).

1. Determine the host group's properties that you want to modify.

   For example, modify the properties of the web-server/ApacheServer host group.

2. Modify host group properties.

   $ changemgr hostset [ -u username ] [ -p file ] \ [ -s name=value ] ... [ -s name ] ... topopath ...

   -s name=value

   Specify one or more name-value pairs. name is the property name, and value is the property value. Supply this option for each property value you want to set. If value is blank, then the property is assigned an empty value.

   -s name

   Specify one or more property names to delete, where name is the property name. Supply this option for each property you want to delete.

   topopath

   Specifies the path to a managed host or host group that is relative to the top of the selected administrative domain.

   For descriptions of the other options, see How to Create a Host Group (Command Line).

Example-Modifying Host Group Properties

Chris modifies the Description property of the web-server/ApacheServer host group.

$ changemgr hostset \
-s Description="Host group to hold Apache Web Server hosts" \
/web-server/ApacheServer