Sun Management Center Change Manager 1.0 Administration Guide

Installing Solaris Flash Archives on Managed Hosts by Using the Command-Line Interface

The following procedures describe how to perform deployment tasks by using the Change Manager command-line interface. You can use the command-line interface to perform tasks such as importing Solaris Flash archives and performing updates.

To learn how to create folders and perform management tasks in the Change Manager repository, see Chapter 8, Maintaining the Change Manager Repository (Tasks). None of the procedures described in Chapter 8, Maintaining the Change Manager Repository (Tasks) are required to perform deployment tasks, though you might want to create a hierarchy of folders in the repository.

To learn how to create host groups and perform management tasks on the Change Manager topology, see Chapter 9, Maintaining the Change Manager Topology (Tasks). None of the procedures described in Chapter 9, Maintaining the Change Manager Topology (Tasks) are required to perform deployment tasks, though you might want to create a hierarchy of host groups in the topology.

How to Import Solaris Boot Images to the Change Manager Repository (Command Line)

The Solaris boot image is used to deploy software stacks to managed hosts.

The time required to import a file to the Change Manager repository depends on the size of the file and the speed of the network.

For an initial installation, the managed host boots and mounts a small Solaris root. The root is contained in the boot image. Then, the managed host runs the installation program. For an update, the managed host runs the installation program, which is stored on the boot image.

  1. Determine where the boot image exists and where to store it.

    For example, copy the boot image from /net/test1/home/suzi/s9fcs to the / folder.

    The path to the boot image must point to the top directory of the Solaris installation media. The installation media can be on a CD or on another system on the network. The top directory of the Solaris installation media contains the Copyright and installer files, and either the Solaris_8 or Solaris_9 directory. These directories contain the Solaris packages and the Solaris boot image.


    Note -

    If you import the boot image from a CD, point to the directory named something like /cdrom/Solaris version/s0. For example, the directory for a Solaris 9 boot image would be /cdrom/sol_9_sparc/s0.


  2. Import a Solaris boot image to the Change Manager repository by using one of these changemgr import commands.

    • The following command line imports one file at a time. You can also use this command line to rename the file.


      $ changemgr import [ -u username ] [ -p file ] filepath[.type] \
      relfilepath.type
      
    • The following command line imports several files to a folder simultaneously.


      $ changemgr import [ -u username ] [ -p file ] filepath.type ... \
      reldirpath
      
    -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.

    filepath

    Specifies an absolute or relative path to a file. This file path is not within the Change Manager repository.

    relfilepath

    Specifies the path to a file, not including a folder, that is relative to the top of the Change Manager repository.

    reldirpath

    Specifies the path to a folder that is relative to the top of the Change Manager repository.

    .type

    Specifies the file name suffix that represents the file type. A Solaris boot image uses the .miniroot suffix.

    Choose a file name that indicates the versions of the Solaris operating environment the boot image supports. For example, create a boot image named Solaris9.miniroot.

Example-Importing a Solaris Boot Image to the Change Manager Repository

Suzi copies the boot image from the /net/test1/home/suzi/Solaris_9 directory to the / folder. She calls the boot image Solaris_9.miniroot.


$ changemgr import /net/test1/home/suzi/Solaris_9 \
/Solaris_9.miniroot

Example-Importing Solaris Boot Images to the Change Manager Repository

Suzi copies the boot images from the /net/test1/home/suzi/Solaris_9 and /net/test1/home/suzi/Solaris_8.202 directories to the /BootImages folder.


$ changemgr import /net/test1/home/suzi/Solaris_9 \
/net/test1/home/suzi/Solaris_8.202 /BootImages

How to Import Solaris Flash Archives to the Change Manager Repository (Command Line)

Import a Solaris Flash archive from another system, typically the master system on which it was created, on the network. This archive contains a software stack that can be deployed to managed hosts.

The time required to import a file to the Change Manager repository depends on the size of the file and the speed of the network.

  1. Determine where the archive exists and where to store it.

    For example, copy the archive from /net/test1/home/suzi/apache.flar to the web-server folder.

  2. Import a Solaris Flash archive to the Change Manager repository by using one of these changemgr import commands.

    • The following command line imports one file at a time. You can use the command line to rename the file.


      $ changemgr import [ -u username ] [ -p file ] filepath[.type] \
      relfilepath.type
      
    • The following command line imports several files to a folder simultaneously.


      $ changemgr import [ -u username ] [ -p file ] filepath.type ... \
      reldirpath
      
    .type

    Specifies the file name suffix that represents the file type. A shared profile uses the .flar suffix.

    For descriptions of the other options, see How to Import Solaris Boot Images to the Change Manager Repository (Command Line).

    Choose a meaningful name that indicates the type of archive. For example, create an archive named apache.flar.

Example-Importing a Solaris Flash Archive to the Change Manager Repository

Suzi copies the archive called /net/test1/home/suzi/apache.flar to the web-server folder. She renames the file to be Apache.flar.


$ changemgr import /net/test1/home/suzi/apache.flar \
/web-server/Apache.flar

Example-Importing Solaris Flash Archives to the Change Manager Repository

Suzi copies the archives called /net/test1/home/suzi/apache.flar and /net/test1/home/suzi/oracle.flar to the / folder.


$ changemgr import /net/test1/home/suzi/apache.flar \
/net/test1/home/suzi/oracle.flar /

How to Import Shared Profiles to the Change Manager Repository (Command Line)

The shared profile describes how the managed hosts should be configured at deployment time. For a description of the shared profile's format, see Shared Profile.

If the shared profile contains a property with an invalid value, for example the value of base_config_flar_archive does not refer to an existing archive, then the import fails. Check the job queue (see How to View the Job Queue (Web Browser)) to determine whether the import failed. If the import failed, correct the property value and reinitiate the import operation.

The time required to import a file to the Change Manager repository depends on the size of the file and the speed of the network.

  1. Determine where the shared profile exists and where to store it.

    For example, copy the shared profile from /net/test1/home/suzi/apache.cmsp to the web-server folder.

  2. Import a shared profile to the Change Manager repository by using one of these changemgr import commands.

    • The following command line imports one file at a time. You can also use this command line to rename the file.


      $ changemgr import [ -u username ] [ -p file ] filepath[.type] \
      relfilepath.type
      
    • The following command line imports several files to a folder simultaneously.


      $ changemgr import [ -u username ] [ -p file ] filepath.type ... \
      reldirpath
      
    .type

    Specifies the file name suffix that represents the file type. A shared profile uses the .cmsp suffix.

    For descriptions of the other options, see How to Import Solaris Boot Images to the Change Manager Repository (Command Line).

    Choose a file name that indicates the unique features specified by the shared profile. For example, create a shared profile named apache.cmsp to configure the managed hosts that run the Apache web server.

Example-Importing a Shared Profile to the Change Manager Repository

Suzi copies the shared profile called /net/test1/home/suzi/apache.cmsp to the web-server folder at the top of the repository. She renames the file to be Apache.cmsp.


$ changemgr import /net/test1/home/suzi/apache.cmsp \
/web-server/Apache.cmsp

Example-Importing Shared Profiles to the Change Manager Repository

Suzi copies the shared profiles called /net/test1/home/suzi/apache.cmsp and /net/test1/home/suzi/oracle.cmsp to the /MyProfiles folder.


$ changemgr import /net/test1/home/suzi/apache.cmsp \
/net/test1/home/suzi/oracle.cmsp MyProfiles

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

How to Perform an Initial Installation (Command Line)

The initial installation must be initiated from each managed host to be installed.

  1. Ensure that the managed hosts you want to install have been added to the Change Manager server.

    See How to Add Managed Hosts (Command Line).

  2. Determine which managed hosts you want to install.

    For example, install the /web-server/host1 and /web-server/host2 managed hosts.

  3. Modify the shared profiles and host properties to reflect the configuration of the managed hosts.

    • To configure the managed hosts for reinstallation operations, configure one boot environment.

    • To configure the managed hosts for updates, configure two boot environments.

  4. Set up the files for installation.


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

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

    For descriptions of the other options, see How to Add Managed Hosts (Command Line).


    Caution - Caution -

    If you modify the associated shared profile or host properties again before you perform the initial installation, you must recreate the JumpStart profiles. To recreate the JumpStart profiles, rerun changemgr setup before performing boot net - install.


  5. Go to the console of each of the managed hosts to be installed and do the following:

    1. Bring each managed host to the ok> prompt.

      If the managed host is running, press Stop-A.

    2. On each console, type boot net - install and press Return.

      Be sure to include the space between the - and install.


      Caution - Caution -

      Make sure that the managed host is only a network boot client of the Change Manager server.

      The network boot of your managed host might fail with an error message such as Panic: unable to mount file systems. If such a message appears, then your managed host is probably being served by more than one network boot server. See Panic: unable to mount file systems Message Appears While Booting From the Network.


How to Reinstall Managed Hosts (Command Line)


Note -

First use the Change Manager to perform an initial installation that creates a single boot environment before performing a reinstallation of a managed host.


  1. Determine which managed hosts you want to reinstall.

    For example, reinstall the /web-server/host1 and /web-server/host2 managed hosts.

  2. Modify the shared profiles and host properties to reflect the configuration of the managed hosts to reinstall.

  3. Reinstall the specified managed hosts.


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

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

    For descriptions of the other options, see How to Add Managed Hosts (Command Line).

Example-Reinstalling Managed Hosts

Suzi reinstalls the /web-server/host1 and /web-server/host2 managed hosts.


$ changemgr reinstall /web-server/host1 /web-server/host2

How to Update Managed Hosts (Command Line)


Note -

First use the Change Manager to perform an initial installation before using the Solaris Live Upgrade feature on a managed host. The initial installation creates two boot environments .


  1. Determine which managed hosts you want to update.

    For example, update the /web-server/host1 and /web-server/host2 managed hosts.

  2. Modify the shared profiles and host properties to reflect the configuration of the managed hosts to update.

  3. Update the specified managed hosts.


    $ changemgr update [ -u username ] [ -p file ] [ -d domain ] \
    [ -x operation ] topopath ...
    -x operation

    Specify the action to take after the update completes. If operation is reboot, then activate the newly installed software stack and reboot. If operation is halt, then activate the newly installed software stack and halt. The default operation is to reboot.

    topopath

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

    For descriptions of the other options, see How to Add Managed Hosts (Command Line).

Example-Updating Managed Hosts

Suzi updates the /web-server/host1 and /web-server/host2 managed hosts. When the update completes, the managed hosts are rebooted to run the newly updated boot environment.


$ changemgr update /web-server/host1 /web-server/host2

Example-Updating Managed Hosts and Halting the Managed Hosts When the Update Completes

Suzi updates the /web-server/host1 and /web-server/host2 managed hosts. When the update completes, the managed hosts are set up to run the newly updated boot environment. Then, the managed hosts are halted.


$ changemgr update -x halt /web-server/host1 \
/web-server/host2

How to Fall Back to the Previous Version of the Software Stack (Command Line)

The fallback operation "undoes" the last update attempt of a managed host, whether it finished or did not start.

For example, three managed hosts are updated one at a time. The update completes on the first managed host. Then, the update begins on the second managed host. When the first managed host boots the updated boot environment, you notice that there are problems with the system. You cancel the running update.

Each of the three managed hosts are in a different state. The first managed host completed the update. The second managed host started the update, but did not complete it. The third managed host did not start the update.

The fallback operation ensures that each of these managed hosts reverts to the boot environment running prior to the update attempt.

The fallback feature fails if the system cannot boot. In such cases, see " Solaris Live Upgrade (Overview)" in Solaris 9 Installation Guide.

  1. Determine which managed hosts you want to fall back to the previous active boot environment.

    For example, perform the fallback operation on the /web-server/host1 and /web-server/host2 managed hosts.

  2. Fall back to the previous version of the software stack.


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

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

    For descriptions of the other options, see How to Add Managed Hosts (Command Line).

Example-Getting Managed Hosts to Fall Back to the Previous Active Boot Environment

Suzi wants the /web-server/host1 and /web-server/host2 managed hosts to fall back to the previous active boot environment.


$ changemgr fallback /web-server/host1 /web-server/host2

How to Reboot Managed Hosts (Command Line)

  1. Determine the managed hosts that you want to reboot.

    For example, you can reboot the /web-server/host1 and /web-server/host2 managed hosts.

  2. Reboot the managed hosts.


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

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

    For descriptions of the other options, see How to Add Managed Hosts (Command Line).

Example-Rebooting Managed Hosts

Suzi wants to reboot the /web-server/host1 and /web-server/host2 managed hosts.


$ changemgr reboot /web-server/host1 /web-server/host2

How to Halt Managed Hosts (Command Line)

  1. Determine the managed hosts that you want to halt.

    For example, you can halt the /web-server/host1 and /web-server/host2 managed hosts.

  2. Halt the managed hosts.


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

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

    For descriptions of the other options, see How to Add Managed Hosts (Command Line).

Example-Halting Managed Hosts

Suzi wants to halt the /web-server/host1 and /web-server/host2 managed hosts.


$ changemgr halt /web-server/host1 /web-server/host2