Skip Navigation Links | |
Exit Print View | |
Using Sun QFS and Sun Storage Archive Manager on Linux Clients Sun QFS and Sun Storage Archive Manager 5.3 Information Library |
1. Using Sun QFS and Sun Storage Archive Manager on Linux Clients
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.
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.
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
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.
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
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.
Sun QFS man pages are located in section 1m. In order to ensure access to the man pages from the Linux client:
To uninstall the Linux client software, use the Uninstall script in the /var/opt/SUNWsamfs/Uninstall directory.
Note - Do not use other processes, such as rpm -e, to uninstall the software. They can cause unexpected results and problems with uninstalling or reinstalling the software.