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.

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.

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 the following changemgr add commands to add the managed host.

   • This 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

   • This 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