Chapter 3 Solstice AutoClient 2.1 Installation Procedures

This chapter provides the following information for the Solstice AutoClient 2.1 product.

• "Solstice AutoClient 2.1 Installation Overview"

• "Installation Process"

• "Removing Previously Installed AutoClient Software"

• "Becoming a Member of the sysadmin Group"

• "Installing the Solstice AutoClient Software"

• "Setting Up Systems to Use AutoClient"

• "Troubleshooting"

Solstice AutoClient 2.1 Installation Overview

The Solstice AutoClient 2.1 software is installed using the admin_install script, found at the root level directory of the CD-ROM. You can use the installation script to install the software on systems in the network, as well as standalone systems. Help is available when you run the script, and the script is designed for you to easily install the Solstice AutoClient 2.1 product.

The installation script provides the following options:

• Install AdminSuite 2.3 and AutoClient 2.1

• Set up systems to use AdminSuite and AutoClient

The Solstice AutoClient 2.1 product can be installed on a single system and shared with others systems using the NFS distributed file system.

Though the script uses a self-documenting interface, this section describes the major options used by the script during the installation process.

The admin_install installation program cannot be used to install the software on diskless, dataless, or AutoClient system types.

Installation Process

The installation process involves a number of tasks, which are listed in Table 3-1. Some of these tasks may or may not be required to be performed, depending upon your system configuration. Review the tasks listed in Table 3-1 and perform them in the order that they are listed. If one task is not required, simply skip to the next task.

Removing Previously Installed AutoClient Software

Before you can install your new AdminSuiteAutoClient software, you must remove the previously installed AutoClient software using the following procedure.

How to Remove Previously Installed AutoClient Software

1. Log in as root on the client running the old AutoClient software.

2. Change directories to the /cdrom/cdrom0 directory.

3. Remove the AutoClient software using the following command line.

   # ./rm_admin -a -d /opt

   This command is found in the top level of the Solstice CD. In this command,

   -a	Specifies that you wish to remove the AutoClient software
   -d /opt	Specifies the directory in which the AutoClient software is installed

Becoming a Member of the sysadmin Group

To install the Solstice AutoClient 2.1 software, you must be a member of the sysadmin group for each host you specify during installation. The following procedures describe how to become a member of the sysadmin group for each name service the hosts can use. To learn more about the sysadmin group and security in the Solstice AutoClient product, see the Solstice AutoClient 2.1 Administration Guide.

You can now install the Solstice AdminSuite and AutoClient software as root on local systems; however, to install the software remotely, you must be a member of the sysadmin group.

How to Add Users to the sysadmin Group Using NIS+

1. Log in to a system in your NIS+ domain as an authorized user with read and write access rights to the group table.

2. Save the group table to a temporary file.

   $ niscat group.org_dir > /var/tmp/group-file

3. Edit the file, adding the users you want to authorize to install the Solstice AutoClient 2.1 software.

   The following sample shows users added to the sysadmin entry in the group file.

   . . . sysadmin::14:user1,user2,user3

   In this example,

   user1,user2,user3

   Represent the users you are adding to the sysadmin group.

4. Merge the file with the NIS+ group table.

   $ /usr/lib/nis/nisaddent -mv -f /var/tmp/group-file group

   The results of the merge are displayed.

5. Remove the temporary file.

   $ rm /var/tmp/group-file

Verification of Adding Users to the sysadmin Group Using NIS+

Verify that the user is a member of the sysadmin group by entering the following commands. Perform this step for each user you added to the file.

# su - user1
$ groups
staff sysadmin
$ exit

How to Add Users to the sysadmin Group Using NIS

1. Log in to the NIS master server as root.

2. Edit the group file (the default directory location is /etc), adding the users you want to authorize to install the Solstice AutoClient 2.1 software.

   The following sample shows users added to the sysadmin entry in the group file.

   . . . sysadmin::14:user1,user2,user3

   In this example,

   user1,user2,user3

   Represent the users you are adding to the sysadmin group.

   ---

   Note -

   The directory location of the group file is specified in the NIS makefile using the $DIR variable. Consult this file if you are uncertain of the location of the group file.

   ---

3. Change directory to the location of the NIS makefile (the default is /var/yp) and rebuild the NIS map.

   # cd /var/yp # make group

   ---

   Note -

   Depending on the size of the NIS map, it may take several minutes or several hours to update the maps and propagate the changes throughout the network.

   ---

Verification of Adding Users to the sysadmin Group Using NIS

Verify that the user is a member of the sysadmin group by entering the following commands. Perform this step for each user you added to the NIS master.

# su - user1
$ groups
staff sysadmin
$ exit

How to Add Users to the sysadmin Group Using Local /etc files

Perform these steps for each system on which you want to use the Solstice AutoClient 2.1 software.

1. Log in as root to the system.

2. Edit the /etc/group file, adding the users you want to authorize to install the Solstice AutoClient 2.1 software.

   The following sample shows users added to the sysadmin entry in the group file.

   . . . sysadmin::14:user1,user2,user3

   In this example,

   user1,user2,user3

   Represent the users you are adding to the sysadmin group.

Verification of Adding Users to the sysadmin Group Using Local /etc Files

Verify that the user is a member of the sysadmin group by entering the following commands. Perform this step for each user you added to the system.

# su - user1
$ groups
staff sysadmin
$ exit

Installing the Solstice AutoClient Software

The following procedures describe how to install the Solstice AdminSuite and AutoClient software. To learn more about Solstice AutoClient product, see the Solstice AutoClient 2.1 Administration Guide.

How to Install Solstice AutoClient Software

1. Insert the product CD into your CD-ROM drive.

   If your system is not running Volume Management, you must mount the CD with the following commands before accessing it:

   # mkdir /cdrom # mount -F hsfs -o ro /dev/dsk/c0t6d0s0 /cdrom

2. Log in as a member of the sysadmin group for that system (group 14).

   ---

   Note -

   If you are installing the software on a local system, you do not have to be a member of the sysadmin group; you can install the software as root.

   ---

3. Verify that you are a member of the sysadmin group.

   $ groups

   If the sysadmin group is listed in the output, proceed to the next step. If not, follow the instructions in "Becoming a Member of the sysadmin Group".

4. Change directories to the product directory on the CD.

   $ cd /cdrom/solstice_sysmgt_2_3

5. Run the admin_install script in the product directory.

   Help is available during the installation. The main installation window shown below appears.

   $ ./admin_install

   Welcome to the Solstice Installation Program ... To exit the installation process at any time, type 0 and press the Return key. 1. Install AdminSuite 2.3 and AutoClient 2.1 2. Install SunSoft Print Client (Solaris 2.3 - 2.5.1 only) 3. Install Software Usage Monitoring Toolkit 4. Set up systems to use AdminSuite and AutoClient 5. Installation Help Enter the number for one or more choices, separated by a space and then press the Return key. [default: 1]>>>

6. Enter option number 1 - Install AdminSuite 2.3 and AutoClient 2.1.

   The AdminSuite Software Location window shown below appears.

   AdminSuite Software Location 1. /opt Choose this option if you intend to support only one architecture of the software. 2. /export/opt Choose this option if you need to support multiple architectures and if you will set up other systems that will NFS mount AdminSuite. 3. Specify location Choose this option if you intend to set up other systems to NFS mount AdminSuite but you do not want to install the software in /export/opt. 4. Installation Help Type 1, 2, 3, or 4 and press the Return key. [default: 1]>>>

7. Choose one of the following options that will install the software in the appropriate directory.

   Option 1: /opt

   This installation directory is the recommended directory; with this option, only one architecture can be used with the software. Once this option has been chosen, the following Installation Summary window appears.

   ==== Installation Summary ==== Product(s): AdminSuite/AutoClient Install Directory: /opt Host(s): your_host_name Start Installation ------------------ Do you want to start the installation? 1. Start installation 2. Cancel installation >>>

   After confirming that the directory and host are correct, enter 1 to continue with the installation. You will see a scrolling list of the log activities. If the installation is successful, the following message will display in your installation window: Successfully installed product: AdminSuite/AutoClient

   Option 2: /export/opt

   This option enables you to support multiple architectures and enables you to set up other systems that use NFS to mount AdminSuite. Once this option is chosen, you have to specify how clients will mount the AdminSuite software. The following window appears.

   How will clients mount this software? 1. Systems will use the automounter Choose this option if you will be configuring the automounter for clients to access the software. 2. Systems will mount via /etc/vfstab file Choose this option if you will be setting up clients to use the /etc/vfstab to mount the software. A symlink will be made on the file server in /opt to point to the installation directory. 3. Installation Help Type 1, 2 or 3 and press the Return key. [default: 1]>>>

   1. Choose the desired mount method.

      ---

      Note -

      If you choose Option 1: Systems will use the automounter, this option enables clients to access the AdminSuite software using the automounter mount method. If you choose this method, you will need to add entries indicating the location of the Solstice AdminSuite software to the automounter maps. Refer to Chapter 5, Adding Solstice AutoClient 2.1 Support to the Automounter, for information about how to configure your automounter maps. A note appears reminding you that you will have to add entries to your automounter map indicating where AdminSuite is installed. Press the Return key to continue.

      ---

      The following AdminSuite Supported Platforms window appears.

      AdminSuite Supported Platforms 1. sparc Choose this option if you intend to manage systems based on the SPARC platform. 2. i386 Choose this option if you intend to manage systems based on the Intel x86 or Pentium platform. Enter one or more choices separated by a space and then press the Return key. [default: 1]>>>

   2. Choose the appropriate platform or platforms.

      An Installation Summary window appears that looks similar to the following window.

      ==== Installation Summary ==== Product(s): AdminSuite/AutoClient Install Directory: /export/opt Architecture(s) sparc i386 Mount method Edit client vfstab or User configured automounter Host(s): your_host_name Start Installation ------------------ Do you want to start the installation? 1. Start installation 2. Cancel installation >>>

   3. After confirming the information provided in the Installation Summary window, type 1 and press Return to continue with the installation.

      You will see a scrolling list of the log activities. If the installation is successful, the following message will display in your installation window: Successfully installed product: AdminSuite/AutoClient

      Option 3: Specify location

      This option enables you to specify the location of the AutoClient software. If you chose this option, you must enter the path where you wish to have the AutoClient software installed.

      ---

      Note -

      If you install additional software, you must use the location that you specified in this step.

      ---

1. Enter the full pathname to the directory where you wish to install AutoClient and then Press Return.

   The following window appears.

   How will clients mount this software? 1. Systems will use the automounter Choose this option if you will be configuring the automounter for clients to access the software. 2. Systems will mount via /etc/vfstab file Choose this option if you will be setting up clients to use the /etc/vfstab to mount the software. A symlink will be made on the file server in /opt to point to the installation directory. 3. Installation Help Type 1, 2 or 3 and press the Return key. [default: 1]>>>

2. Choose the desired mount method.

   ---

   Note -

   If you choose option 1: Systems will use the automounter, this option enables clients to access the AutoClient software using the automounter mount method. If you choose this method, you will need to add entries indicating the location of the Solstice AutoClient software to the automounter maps. Refer to Chapter 5, Adding Solstice AutoClient 2.1 Support to the Automounter, for information about how to configure your automounter maps. A note appears reminding you that you will have to add entries to your automounter map indicating where AdminSuite is installed. Press the Return key to continue.

   ---

   The following AutoClient Supported Platforms window appears.

   AdminSuite Supported Platforms 1. sparc Choose this option if you intend to manage systems based on the SPARC platform. 2. i386 Choose this option if you intend to manage systems based on the Intel x86 or Pentium platform. Enter one or more choices separated by a space and then press the Return key. [default: 1]>>>

3. Choose the appropriate platform or platforms.

   An Installation Summary window appears that looks similar to the following window.

   ==== Installation Summary ==== Product(s): AdminSuite/AutoClient Install Directory: /export Architecture(s) sparc i386 Mount method Edit client vfstab or User configured automounter Host(s): your_host_name Start Installation ------------------ Do you want to start the installation? 1. Start installation 2. Cancel installation >>>

4. Verify the information provided in the Installation Summary window; type 1 and press Return to continue with the installation.

   You will see a scrolling list of the log activities. If the installation is successful, the following message will display in your installation window: Successfully installed product: AdminSuite/AutoClient

5. Update your shell search path to include the location of the Solstice AutoClient commands.

   If you use the C shell, type:

   % set path = ( $path /opt/SUNWadm/bin ) % set MANPATH = ( $MANPATH /opt/SUNWadm/man )

   To permanently affect these changes to your shell search path, edit your .cshrc or .login startup file.

   If you use the Bourne or Korn shell, type:

   $ PATH = $PATH:/opt/SUNWadm/bin $ MANPATH = $MANPATH:/opt/SUNWadm/man

   To permanently affect these changes to your shell search path, edit your .profile startup file.

6. Start the Solstice Launcher (which now contains the Solstice AutoClient application).

   $ /usr/bin/solstice &

Setting Up Systems to Use AutoClient

If you wish to run AutoClient software on a system or wish to administer systems using AutoClient software, you must initially set these up. You can set up these systems using the installation script you used to install AutoClient. The following procedure describes how to set up these systems.

How to Set Up Systems to Use AutoClient

1. Insert the product CD into your CD-ROM drive.

   If your system is not running Volume Management, you must mount the CD with the following commands before accessing it:

   # mkdir /cdrom # mount -F hsfs -o ro /dev/dsk/c0t6d0s0 /cdrom

2. Log in as a member of the sysadmin group for that system (group 14).

   ---

   Note -

   If you are running the installation script on a local system, you do not have to be a member of the sysadmin group; you can run the installation script as root.

   ---

3. Verify that you are a member of the sysadmin group.

   $ groups

   If the sysadmin group is listed in the output, proceed to the next step. If not, follow the instructions in "Becoming a Member of the sysadmin Group".

4. Change directories to the product directory on the CD, for example:

   $ cd /cdrom/solstice_sysmgt_2_3

5. Run the admin_install script in the product directory.

   Help is available during the installation. The main installation window shown below appears.

   $ ./admin_install

   Welcome to the Solstice Installation Program ... To exit the installation process at any time, type 0 and press the Return key. 1. Install AdminSuite 2.3 and AutoClient 2.1 2. Install SunSoft Print Client (Solaris 2.3 - 2.5.1 only) 3. Install Software Usage Monitoring Toolkit 4. Set up systems to use AdminSuite and AutoClient 5. Installation Help Enter the number for one or more choices, separated by a space and then press the Return key. [default: 1]>>>

6. Select Option 4 - Set up systems to use AdminSuite and AutoClient.

   The following menu appears.

   Set up systems to use AdminSuite and AutoClient 1. Set up systems to run AdminSuite Configure systems to NFS mount AdminSuite from a file server so that they can run the AdminSuite applications. 2. Set up systems to be managed Configure systems to NFS mount AdminSuite from a file server so that they can be managed by the administration applications. 3. Installation Help Type 1 or 2 and press the Return key. [default: 1]>>>

7. Choose one of the following options that will either allow systems to run AdminSuite or be managed by AdminSuite.

   Option 1: Set up systems to run AdminSuite

   This option enables you to specify the systems you wish to be able to run AdminSuite from the server. The following menu appears when you choose this option.

   How should clients mount AdminSuite? 1. Software access will be via the automounter Choose this option if you want to configure the automounter for systems to access the software. 2. Systems will mount via /etc/vfstab file Choose this option to have this program update each systems /etc/vfstab file to access the software. 3. Installation Help Type 1, 2 or 3 and press the Return key. [default: 1]>>>

   1. Choose the method in which the clients will mount the AdminSuite software from the server.

      Option 1: Software access will be via the automounter

      This option enables clients to access the AdminSuite software using the automounter mount method. If you choose this method, you will need to add entries indicating the location of the Solstice AdminSuite software to the automounter maps. Refer to Chapter 5, Adding Solstice AutoClient 2.1 Support to the Automounter, for information about how to configure your automounter maps. A note appears reminding you that you will have to add entries to your automounter map indicating where AdminSuite is installed. Press the Return key to continue. Option 2: Systems will mount via /etc/vfstab file

      This option enables clients to access the AdminSuite software using the /etc/vfstab file on the server where AdminSuite is installed. If you choose this method, the following window appears. Type the name of the file server that has AdminSuite installed and then press the Return key.

      File Server Name The File Server is the system already installed with AdminSuite software that systems will access. Type the host name of the File Server and press the Return key. >>>

   2. The Systems for Installation menu is now in your window (see the following menu); enter the systems you wish to be able to remotely run AdminSuite.

      Systems for Installation Type the host names of the systems for installation. List hosts separated by a single space (for example, hosta hostb hostc) and press the Return key. You can also specify the path to a file that contains a list of host names (for example, /path/to/file). [default: your_host_name]>>>

      An Installation Summary screen appears.

      ==== Installation Summary ==== Product(s): Set up systems to run AdminSuite Host(s): lorna Start Installation ------------------ Do you want to start the installation? 1. Start installation 2. Cancel installation >>>

   3. Verify the information on the screen and, if it is correct, enter 1 to start the installation.

      Option 2: Set up systems to be managed

      This option enables you to specify the systems you wish to be able to manage using AdminSuite. The following menu appears when you choose this option.

      How should clients mount AdminSuite? 1. Software access will be via the automounter Choose this option if you want to configure the automounter for systems to access the software. 2. Systems will mount via /etc/vfstab file Choose this option to have this program update each systems /etc/vfstab file to access the software. 3. Installation Help Type 1, 2 or 3 and press the Return key. [default: 1]>>>

1. Choose the method in which the clients will mount the AdminSuite software from the server.

   Option 1: Software access will be via the automounter

   This option enables clients to access the AdminSuite software using the automounter mount method. If you choose this method, you will need to add entries indicating the location of the Solstice AdminSuite software to the automounter maps. Refer to Chapter 5, Adding Solstice AutoClient 2.1 Support to the Automounter, for information about how to configure your automounter maps. A note appears reminding you that you will have to add entries to your automounter map indicating where AdminSuite is installed. Press the Return key to continue. Option 2: Systems will mount via /etc/vfstab file

   This option enables clients to access the AdminSuite software using the /etc/vfstab file on the server where AdminSuite is installed. If you choose this method, the following window appears. Type the name of the file server that has AdminSuite installed and then press the Return key.

   File Server Name The File Server is the system already installed with AdminSuite software that systems will access. Type the host name of the File Server and press the Return key. >>>

2. The Systems for Installation menu is now in your window (see the following menu); enter the systems you wish to be able to remotely run AdminSuite.

   Systems for Installation Type the host names of the systems for installation. List hosts separated by a single space (for example, hosta hostb hostc) and press the Return key. You can also specify the path to a file that contains a list of host names (for example, /path/to/file). [default: your_host_name]>>>

   An Installation Summary screen appears.

   ==== Installation Summary ==== Product(s): Set up systems to run AdminSuite Host(s): lorna Start Installation ------------------ Do you want to start the installation? 1. Start installation 2. Cancel installation >>>

3. Verify the information on the screen and, if it is correct, enter 1 to start the installation.

Troubleshooting

This section describes problems that you may encounter when you use the Solstice AutoClient product. If you run into any of these problems, follow the advice that is provided.

Running the admin_install Script

• If the admin_install script hangs, try re-running the script after waiting a few minutes. If the script continues to hang, try running it using another UID in the sysadmin group. If this fails, try adding yourself to the sysadmin entry in the /etc/group file on the system you wish to install.

• If the admin_install script (running on system installed with Solaris 2.3 or 2.4 release) hangs after the following message is displayed:

  Installing Solstice enabling packages ...

You can recover by becoming root and using the following commands.

# /usr/lib/nfs/mountd
# umount /usr/snadm/classes/tmp_system.2.1

Launching Solstice AutoClient

• If you logged in as root and used the su command to become a member of group 14, the Solstice AutoClient software may reject your requests. Log in as a user who is a member of group 14 rather than as root.

• If you attempt to launch the Solstice AutoClient software on a station manager using the solstice command and receive the following error message:

  Solstice Registry Error [-14]: unable to locate registry

There are two possible conditions that can cause this error to arise.

• The administration system was not installed with the software supporting its native platform. Reinstall the Solstice AutoClient 2.1 software using the admin_install script, and add the software for the administration system's platform (for example, SPARC or x86).

• The administration system was inadvertently installed using the automounter managed host mount method, when the /etc/vfstab file option should have been selected. Create the following links:

  # ln -s /basedir/platform/SUNWadm /opt/SUNWadm # ln -s /basedir/all/SUNWadmd /opt/SUNWadmd

In these commands,