Installing the Software Packages

The Sun QFS and Sun Storage Archive Manager (SAM-QFS) software uses the Oracle Solaris packaging utilities to add and remove software. The pkgadd utility prompts you to confirm various actions that are necessary to install the packages. The release packages are:

SUNWqfsr SUNWqfsu

Sun QFS (file system only)

SUNWsamfsr SUNWsamfsu

SAM-QFS (archiving and file system)

How to Add the Packages

1. Become superuser or assume an equivalent role.

   Roles contain authorizations and privileged commands. For more information about roles, see the Configuring RBAC (Task Map) section in System Administration Guide: Security Services .

2. Go to the directory where the software package release files reside.

   See Obtaining the Release Files

   Changing to the appropriate directory differs, depending on your release media, as follows:

   • Download — Go to the directory to which you downloaded the files.

   • Physical Media — Go to the directory on the physical media that corresponds to your operating system version.

   • If you download the software from the Oracle site, the binaries are on an ISO image. For information on how to mount the ISO image, see How to Mount an ISO Image For Adding Packages.
3. Use the pkgadd command to add the appropriate packages.

   For example:

   # pkgadd -d . SUNWsamfsr SUNWsamfsu

   • For archiving to a local or shared file system, install the SUNWsamfsr and SUNWsamfsu packages.

   • For a local or shared file system (no archiving), install the SUNWqfsr and SUNWqfsu packages.

4. Define an administrator group.

   When prompted to define an administrator group, select yes or y to accept the default (no administrator group), or select no or n if you want to define an administrator group.

   You can reset permissions on certain commands later by using the set_admin command. See Adding the Administrator Group in Sun Storage Archive Manager 5.3 Configuration and Administration Guide or set_admin(1M) in Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual.

5. Examine the SAM-QFS installation log file, /tmp/SAM_install.log, to verify that the SAM-QFS software packages and the samst driver are installed.

   If all files installed properly, the following message appears:

   Restarting the sysevent daemon

How to Mount an ISO Image For Adding Packages

After downloading the SAM-QFS ISO image to the /tmp file, follow these steps to mount the ISO image.

1. Create a directory.

   #  mkdir /SAM.5.3

2. Add the StorageTek_QFS_5.3.iso file as a block device.

   #  lofiadm -a /tmp/StorageTek_QFS_5.3.iso /dev/lofi/1

3. Mount the ISO image to the /SAM.5.3 directory.

   #  mount -F hsfs /dev/lofi/1 /SAM.5.3

4. Identify the server hardware, either SPARC or x64.

   #  cd /SAM.5.3/sparc

   This is an example for the SPARC directory. Use the x64 directory, if the system is an x64 server.

5. Locate the correct binaries for installation.

   #  ls
   SUNWqfsr    SUNWqfsu    SUNWsamfsr  SUNWsamfsu

6. Install the appropriate packages for your environment.

   For example:

   # pkgadd -d . SUNWsamfsr SUNWsamfsu

   For more information about the packages, see the table in Before You Begin.

How to Set Up Access to the Commands and Man Pages

To access the Sun QFS and SAM-QFS commands and man pages, modify your PATH and MANPATH environment variables.

1. For users who will need to access the user commands, such as sls, add /opt/SUNWsamfs/bin to the users' PATH variables.
2. Edit your system setup files to include the correct paths to commands and man pages.

   • In the Bourne or Korn shells, change the PATH and MANPATH variables in the .profile file and export the variables.

     The following example shows how your .profile file might look after editing.

     PATH=$PATH:/opt/SUNWsamfs/bin:/opt/SUNWsamfs/sbin
     MANPATH=$MANPATH:/opt/SUNWsamfs/man
     export PATH MANPATH

   • In the C shell, edit the .login and .cshrc files.

     The path statement in your .cshrc file might look like the following example:

     set path = ($path /opt/SUNWsamfs/bin /opt/SUNWsamfs/sbin)

     The MANPATH statement in your .login file might look like the following example:

     setenv MANPATH /usr/local/man:opt/SUNWspro/man:/$OPENWINHOME/share/man:/opt/SUNWsamfs/man