Installing and Uninstalling the Linux Client

This section provides instructions for installing and uninstalling the Sun QFS Linux Client software.

The differences in installation between the Oracle Solaris client and the Linux client are:

• The Linux software comes in two folders on the DVD or in the download packages. The installation files can be found in the linux1 directory on that DVD or in the downloaded software package.

• The Linux installation packages are in the form of RPM (Red Hat Package Manager) and SRPM (Source RPM) packages. RPMs typically contain binary commands and loadable modules, whereas SRPMs contain source code RPMs.

• Because so many variations of the Linux kernel exist, the installation program also includes custom kernel capability, which enables the software to work with as many kernel variations as possible.

How to Install the Linux Client

1. Edit the Oracle Solaris metadata server's /etc/opt/SUNWsamfs/hosts.fsname file to add the Linux client's address.run samsharefs to update the information on disk.

   In the following example, hiball-mn is the Oracle Solaris metadata server:

    
   hiball-mn 10.1.170.213 1 0 server 
   linux-mn 10.1.170.210 0 0 
   rollerball-mn 10.1.170.132 0 0 
   sandiego-mn 10.1.170.8 0 0 

   Run samsharefs to update the information on disk.

2. Insert the installation DVD into the Linux system or locate the downloaded software package.
3. Install the software.

   • If you are installing from the DVD, type the following commands as root on the Linux system:

     # mount -o ro -t iso9660 /dev/cdrom /mnt
     # /mnt/linux1/Install 

   • If you are installing from a downloaded software package, type the following commands as root on the Linux system:

     # mount -o ro,loop -t iso9660 StorageTek_QFS_5.3.iso /mnt
     # /mnt/linux1/Install 

     The installation program installs the software.

     If the installation program does not recognize the Linux kernel version, it will display the following message:

      A direct match for your kernel wasn't found. Attempt creating a custom rpm for your kernel  /
     (yes/no)?

     Select yes to enable the installation program to adapt the loadable binary kernel module to the Linux system. If you select no, the installation cannot be completed.

   ---

   Note - The Module.symvers file is required for the Linux client installation and is included in the Linux kernel development package. For example, in Oracle Linux 5.6 the package is kernel-devel-2.6.18-238.el5.x86_64.rpm. You can install the package with the following command:

   # yum install kernel-devel-2.6.18-238.el5.x86_64.rpm

   ---

4. Review the /etc/opt/SUNWsamfs/mcf file to verify that it contains the correct paths for your installation.

   ---

   Note - An mcf file is automatically generated for the Linux client. For more information, see mcf File Differences.

   ---

   For most installations, the mcf file that is created will be correct, but it might have to be edited to reflect your specific environment.

5. Verify that sam-fsd is running and that the expected file systems are mounted on the metadata server.

   For example:

   # ps -ef | grep sam-fsd
   root 22054     1   0   May 09 ?           0:00 /opt/SUNWsamfs/sbin/sam-fsd -D
   
   # mount -v | grep samfs
   sqfs1 on /testqfs1_1488 type samfs \
   read/write/setuid/devices/rstchown/intr/largefiles/onerror=panic \
   /nologging/noxattr/dev=4440064 on Thu May 10 11:22:43 2012
   sqfs2 on /testqfs2_1488 type samfs \
   read/write/setuid/devices/rstchown/intr/largefiles/onerror=panic \
   /nologging/noxattr/dev=44400c8 on Thu May 10 11:23:41 2012

6. Mount the filesystem.

   For example:

   # mount -t samfs -oshared sqfs1 /sqfs1
   Using /etc/fstab:
   sqfs1                   /sqfs1          samfs           shared,noauto   0 0
   
   # mount sqfs1

   ---

   Note - The mount command requires that the shared mount option be set, either on the command line or in the /etc/fstab file. For SuSE Linux Enterprise Server 10, any Sun QFS file system with devices missing that are configured as mount on boot in the /etc/fstab file may cause Linux to hang during the boot process.

   ---

   When you mount the file system, the following message is displayed:

    Warning: loading SUNWqfs will taint the kernel: SMI license 
   See http://www.tux.org/lkml/#export-tainted for information 
   about tainted modules. Module SUNWqfs loaded with warnings 

   This message is a normal result of the installation and can be disregarded.

How to Configure Access to Man Pages

Sun QFS man pages are located in section 1m. In order to ensure access to the man pages from the Linux client:

• Add the man page section to your configuration.
  • On Red Hat Linux clients, add 1m to MANSECT in the /etc/man.config file.
  • On SuSE clients, add 1m to SECTION in the /etc/manpath.config file.

Uninstalling the Linux Client Software

To uninstall the Linux client software, use the Uninstall script in the /var/opt/SUNWsamfs/Uninstall directory.