Sun Management Center Change Manager 1.0 Administration Guide

- Previous: How to Import Shared Profiles to the Change Manager Repository (Command Line)
- Next: How to Perform an Initial Installation (Command Line)

## How to Add Managed Hosts (Command Line)

To simplify naming of managed hosts, you can make each name match the name of the actual machine.

Note -

If you change the value of the `AgentPort` 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.

Note -

A managed host can be a client of only one Change Manager server. To change control of a managed host to another Change Manager server, see `Internal error: unable to establish probe connection` Appears When Running Jobs on Managed Hosts.

1. Determine where to create the managed host.

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

2. Use one of these `changemgr add` commands to add the managed host.

   - The following command adds a managed host to be controlled by the Change Manager. A managed host can be created in a host group that is part of the Change Manager topology. hostpath is the full path name or relative path name to the managed host, which includes the host group hierarchy.

         $ changemgr add [ -u username ] [ -p file ] [ -d domain ] \
         hostname hostpath

   - The following command adds the specified hosts to the specified host group. The topology names are the same as the host names.

         $ changemgr add [ -u username ] [ -p file ] [ -d domain ] \
         hostname ... 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.

   hostname

     Specifies the network name of a host, for example, `host1.yourcompany.com`.

   hostpath

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

   grouppath

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

### Example-Adding a Managed Host

Chris creates the `host1` managed host in the `web-server/apache` host group.

    $ changemgr add host1 /web-server/apache

### Example-Adding a Managed Host and Changing Its Name

Chris adds the `host1` managed host to the `web-server/apache` host group and changes the host name to `Host1`.

    $ changemgr add host1 /web-server/apache/Host1

### Example-Adding Managed Hosts to a Host Group

Chris adds the `host1` and `host2` managed hosts to the `web-server/apache` host group.

    $ changemgr add host1 host2 /web-server/apache

- Previous: How to Import Shared Profiles to the Change Manager Repository (Command Line)
- Next: How to Perform an Initial Installation (Command Line)

- © 2010, Oracle Corporation and/or its affiliates