| Sun StorEdge QFS & Sun StorEdge SAM-FS Software Installation & Configuration Guide |    
|
| Sun StorEdge QFS & Sun StorEdge SAM-FS Software Installation & Configuration Guide |
|
| C H A P T E R 1 |
|
System Requirements and Preinstallation Tasks |
This chapter outlines the system requirements for installing the Sun StorEdge QFS and Sun StorEdge SAM-FS software. This chapter starts with an overview. The remaining sections describe the requirements you must meet or the actions you must take before you begin to install and configure your software. These requirements are as follows:
The Sun StorEdge QFS and Sun StorEdge SAM-FS file systems are similar, but this manual notes differences when necessary. The software products and the file systems they include are as follows:
The Sun StorEdge QFS and Sun StorEdge SAM-FS software must be installed on a Sun server based on UltraSPARC® technology.
If you plan to install the SAM-QFS Manager graphical user interface tool, there are additional requirements for the server that you want to use as the web server host. For more information on these requirements, see Verifying Requirements for the SAM-QFS Manager (Optional).
Sun StorEdge QFS and Sun StorEdge SAM-FS software packages run on many Sun workstations and servers. Before installation, you should verify the applicability of the hardware, the level of the Solaris Operating System (OS), and the patch release installed. To install the Sun StorEdge QFS or Sun StorEdge SAM-FS software, you also must ensure that you have root-level access to your system.
|
1. Verify that your system has a CD-ROM drive or that it can access the release package at the Sun Download Center.
The Sun Download Center is at the following URL:
http://www.sun.com/software/downloads
2. Log in to your system as root.
You must have superuser access to install the software.
3. Verify your system's Solaris OS level.
The software relies on properly configured Solaris sofware at one of the following levels:
Sun Microsystems provides Solaris OS patches to customers with a maintenance contract by means of CD-ROM, anonymous FTP, and the Sun Microsystems SunSolveSM web site (http://sunsolve.sun.com).
To install a patch after you install the Sun StorEdge QFS or Sun StorEdge SAM-FS release packages, load the CD-ROM or transfer the patch software to your system. Follow the instructions outlined in the Patch Installation Instructions and Special Install Instructions in the README file included in the patch or jumbo patch cluster.
|
Note - If you install Solaris patches after you have installed the Sun StorEdge QFS or Sun StorEdge SAM-FS 4.1 software, verify that your /etc/name_to_sysnum file is intact. The procedure for verifying your /etc/name_to_sysnum file is described in Installing Sun Solaris Patches. |
The Sun StorEdge QFS and Sun StorEdge SAM-FS software packages require a certain amount of disk cache in order for them to create and manage data files and directories.
The disk devices or partitions do not require any special formatting, nor do they need to have a UNIX file system created on them. You might see better performance if you configure multiple devices across multiple interfaces (HBAs) and disk controllers.
The disks must be connected to the server using a Fibre Channel or SCSI controller. You can specify individual disk partitions for a disk, or you can use the entire disk as a disk cache. The software supports disk arrays, including those under the control of volume management software, such as Solstice DiskSuiteTM, Solaris Volume Manager (SVM), and other volume management software products.
|
Familiarize yourself with Sun StorEdge QFS and Sun StorEdge SAM-FS file system layout possibilities.
Describing all the aspects of Sun StorEdge QFS and Sun StorEdge SAM-FS file systems is beyond the scope of this manual. For information on volume management, file system layout, and other aspects of file system design, see the Sun StorEdge QFS and Sun StorEdge SAM-FS File System Administration Guide.
|
1. Estimate the disk cache requirements for Sun StorEdge QFS software (ma file systems).
2. Estimate the disk cache requirements for Sun StorEdge SAM-FS software.
3. Estimate the disk cache requirements for Sun SAM-QFS software (ma file systems plus the storage and archive manager).
You can create a Sun SAM-QFS file system when you install both the SUNWsamfsr and SUNWsamfsu packages and you are licensed for both Sun StorEdge QFS and Sun StorEdge SAM-FS software. You install the Sun StorEdge SAM-FS software package, and the license key enables the faster Sun StorEdge QFS file system. Use the following guidelines if you are creating Sun SAM-QFS file systems:
4. Enter the format(1M) command to verify that you have sufficient disk cache space.
Use the format(1M) command if you are installing a Sun StorEdge QFS or Sun StorEdge SAM-FS file system on a single server or if you are installing a Sun StorEdge QFS file system as a local file system on a Sun Cluster node.
Remember to use Ctrl-d to exit the format(1M) command.
CODE EXAMPLE 1-1 shows six disks attached to a server. There are two internal disks connected by means of controller 0 on targets 10 and 11 (c0t10d0 and c0t11d0). The other disks are external.
For the sake of clarity, the format(1M) command output in CODE EXAMPLE 1-1 has been edited.
CODE EXAMPLE 1-2 shows four disks attached to a server. There are two internal disks connected by means of controller 0 on targets 0 (c0t0d0) and 1 (c0t1d0). There are two external disks connected by means of controller 3 on targets 0 (c3t0d0) and 2 (c3t2d0).
The software requires a disk cache consisting of RAID devices, JBOD devices, or both. It also requires a certain amount of disk space in the / (root), /opt, and /var directories. The actual amount needed varies depending on the packages you install. TABLE 1-1 shows the minimum amount of disk space required in these various directories.
Note that the archiver data directory, archiver queue files, and the log files are written to the /var directory, so the sizes shown in TABLE 1-1 should be considered a minimum amount for the /var directory.
|
The following procedure shows how to verify whether or not there is enough disk space on your system to accommodate the SUNWsamfsu and SUNWsamfsr packages.
CODE EXAMPLE 1-3 shows this command and its output.
2. Verify that there are at least 2,000 kilobytes available in the avail column for the / directory.
3. Verify that there are at least 21,000 kilobytes in the avail column for the /opt directory.
4. Verify that there are at least 6000 kilobytes available in the /var directory.
A quantity of 30,000 kilobytes or more is recommended to allow for the growth of log files and other system files.
5. If there is not enough room for the software under each directory, repartition the disk to make more space available to each file system.
To repartition a disk, see your Sun Solaris system administration documentation.
This section applies to the Sun StorEdge SAM-FS software only.
You can write archive copies either to removable media cartridges or to disk space in another file system, as follows:
The Sun StorEdge SAM-FS environment supports a wide variety of removable media devices. You can obtain a list of currently supported drives and libraries from your Sun Microsystems sales or support staff. To make sure that your devices are attached and enumerated in an easily retrieved list, perform one or both of the following procedures:
|
This section describes how to attach removable media devices to a server. These are general guidelines for attaching removable media hardware to a server. For explicit instructions on connecting these peripherals to a server, refer to the hardware installation guide supplied by the vendor with the automated library and drives.
1. Ensure that you are on a console connection to the server.
2. Power off the server before connecting devices.
Typically, you power off central components first and then the peripheral equipment. So, use the init(1M) command to power off the server, as follows:
This command brings down the system to the PROM level. At this point it is safe to power off the server and peripherals. For specific instructions regarding your equipment, see the documentation from the hardware vendor for proper power-on and power-off sequences.
3. Ensure that the removable media devices and the disk(s) to be used for the Sun StorEdge SAM-FS file system are connected and properly addressed.
4. Ensure that the SCSI target IDs are unique for each SCSI initiator (host adapter). (Optional)
Perform this step if you have libraries attached to the host system through a SCSI interface.
Avoid setting SCSI target IDs for peripherals to ID 7 because this ID is typically reserved for the initiator. For example, if you are using a SCSI host adapter with a previously attached disk drive set to use a target ID of 3, any additional peripheral connected to this bus must not have an ID of 3. Typically, the internal disk drive ID is 3 for SPARC® systems and 0 for UltraSPARC systems.
5. Power on the peripherals according to the manufacturer's recommended sequence.
Typically, you power on the outermost peripherals first, working toward more central components in sequence.
At the >ok prompt, enter the following command to disable autobooting:
7. Type reset at the next prompt.
Reenabling autobooting is described later in this procedure.
8. Conduct an inventory of target IDs and LUNs for each device connected to the host system through a SCSI interface. (Optional)
Perform this step if you have libraries attached to the host system through a SCSI interface.
CODE EXAMPLE 1-4 shows the PROM >ok prompt and the output from the probe-scsi-all command.
9. Save the output from the previous step. (Optional)
If you performed the previous step, save the output. You use the information in this output for the next procedure, To Create a List of Devices.
10. Conduct an inventory of target IDs and LUNs for each device connected to the host system through a Fibre Channel interface. (Optional)
Perform this step if you have libraries or tape drives attached to the host system through a Fibre Channel interface.
CODE EXAMPLE 1-5 shows the commands to use to locate the host adapter directory, to select an item, and to display the Fibre Channel host bus adapter (HBA) devices.
If the server does not acknowledge all the known devices (disk drives, tape or optical drives, the automated library, and so on), you should check the cabling. Cabling is often the problem when devices and controllers are not communicating. Do not proceed until all devices appear when probed.
11. Save the output from the previous step. (Optional)
If you performed the previous step, save the output. You use the information in this output for the next procedure, To Create a List of Devices.
At the >ok prompt, enter the following command to enable autobooting:
Due to special driver requirements, no device information appears in /var/adm/messages for magneto-optical devices or libraries until after you install the Sun StorEdge SAM-FS software packages.
15. Disable autocleaning and autoloading.
If your automated library supports autocleaning or autoloading, disable those features when using that library with the Sun StorEdge SAM-FS software. Consult the documentation from your library's manufacturer for information on disabling autocleaning and autoloading.
16. Go to To Create a List of Devices.
|
The device(s) that you intend to use must be attached and recognized by the server upon which you intend to install the Sun StorEdge SAM-FS software. To configure the Sun StorEdge SAM-FS software, you need to know the following about your devices:
For SCSI-attached drives, you need to know each drive's SCSI target ID and LUN.
For Fibre Channel-attached drives, you need to know each drive's LUN and world-wide node name.
Libraries that use SCSI or Fibre Channel attachments are called direct-attached libraries. For SCSI-attached libraries, you need to know each library's SCSI target ID and LUN. For Fibre Channel-attached libraries, you need to know each library's LUN and world-wide node name.
Libraries that use a network attachment are called network-attached libraries. You cannot configure network-attached libraries in the existing system configuration files. You need to create a parameters file for each network-attached library, and this is explained later in the installation process.
1. Make an inventory list of your devices.
Fill in TABLE 1-2 to include the name, manufacturer, model, and connection types for each device that you want to include in your Sun StorEdge SAM-FS environment.
2. Retain TABLE 1-2 for use again later in the configuration procedure.
Make sure that you have a software license key for the Sun StorEdge QFS or Sun StorEdge SAM-FS release that you are installing.
If you do not have a Sun Microsystems license key for the release level that you are installing, contact your authorized service provider (ASP) or Sun. When you contact Sun for a license, you will be asked to provide information regarding your environment.
For Sun StorEdge QFS software, you will need to provide information such as the following:
For a Sun StorEdge SAM-FS license, you will need to provide information such as the following:
The license keys for the Sun StorEdge QFS and Sun StorEdge SAM-FS packages allow the system to run indefinitely unless one of the following conditions is present:
If your license expires, you can mount the file systems, but you cannot archive or stage files in a Sun StorEdge SAM-FS environment.
After your initial installation, if you upgrade your software or if you change your environment's configuration, you might need to change your software license. Changes to the environment that might necessitate upgrading your license include adding a library or changing a host system. If you have questions regarding your existing license, you can enter the samcmd(1M) l command (lowercase l for license). If you need to upgrade your license, contact your Sun sales representative.
Make sure that you have a copy of the release software. You can obtain the Sun StorEdge QFS and Sun StorEdge SAM-FS software from the Sun Download Center or on a CD-ROM. Contact your authorized service provider (ASP) or your Sun sales representative if you have questions on obtaining the software.
After the release, upgrade patches are available from the following URL:
|
1. Enter the following URL in your browser:
http://www.sun.com/software/download/sys_admin.html
2. Click on the Sun StorEdge QFS or Sun StorEdge SAM-FS software package you want to receive.
3. Follow the instructions at the web site for downloading the software.
|
1. Log in as root on your Sun StorEdge QFS or Sun StorEdge SAM-FS server.
The Sun StorEdge QFS and Sun StorEdge SAM-FS software uses the Sun Solaris operating system (OS) packaging utilities for adding and removing software. You must be logged in as superuser (root) to make changes to software packages. The pkgadd(1M) utility prompts you to confirm various actions necessary to install the packages.
2. Insert the CD into the CD-ROM drive.
The system should automatically detect the CD's presence. If it does not, issue the commands shown in CODE EXAMPLE 1-6 to stop and start the Sun Solaris Volume Manager and to change to the directory that contains the Sun StorEdge QFS and Sun StorEdge SAM-FS software packages.
# /etc/init.d/volmgt stop # /etc/init.d/volmgt start # volcheck # cd /cdrom/cdrom0 |
On the CD, the packages reside in the /cdrom/cdrom0 directory organized by Sun Solaris version.
|
If you need to remove the 4.1 software packages in the future, perform the following steps.
1. Remove the SAM-QFS Manager software from the management station and from the Sun StorEdge QFS and Sun StorEdge SAM-FS server. (Optional)
If you have installed the SAM-QFS Manager software, perform the procedure described in Removing the SAM-QFS Manager Software.
2. Use the pkginfo(1) command to determine which Sun StorEdge QFS and Sun StorEdge SAM-FS software packages are installed on your system.
To find the Sun StorEdge QFS 4.1 packages, enter the following command:
To find the Sun StorEdge SAM-FS 4.1 packages, enter the following command:
3. Use the pkgrm(1M) command to remove the existing software.
If you are using any optional packages, make sure you remove them before removing the main SUNWqfsr/SUNWqfsu or SUNWsamfsr/SUNWsamfsu packages. In addition, make sure that you remove the SUNWqfsu and SUNWsamfsu packages before removing the SUNWqfsr and SUNWsamfsr packages.
Example 1. To remove all possible Sun StorEdge QFS packages, enter the following command:
SUNWqfsr must be the last package removed.
Example 2. To remove all possible Sun StorEdge SAM-FS packages, enter the following command:
SUNWsamfsr must be the last package removed.
The Sun StorEdge QFS and Sun StorEdge SAM-FS software interoperates with many different hardware and software products from third-party vendors. Depending on your environment, you might need to upgrade other software or firmware before installing or upgrading the Sun StorEdge QFS or Sun StorEdge SAM-FS packages. Consult the Sun StorEdge QFS and Sun StorEdge SAM-FS 4.1 Release Notes for information pertaining to library model numbers, firmware levels, and other compatibility information.
The SAM-QFS Manager allows you to configure, control, monitor, and reconfigure a Sun StorEdge QFS or Sun StorEdge SAM-FS environment through a web server. You can install the SAM-QFS Manager in one of the following configurations:
After the SAM-QFS Manager software is installed, you can invoke the SAM-QFS Manager from any machine on the network that is allowed access to its web server.
If you plan to use SAM-QFS Manager, the host upon which you are configuring the SAM-QFS Manager software must meet various hardware and software requirements. The server to act as the host for SAM-QFS Manager must meet the requirements described in the following sections:
You must install the SAM-QFS Manager on a SPARC server. Additional minimum hardware requirements are as follows:
Ensure that your installation meets the following browser requirements:
Make sure that one of the following minimum Solaris levels is installed on the web server:
The SAM-QFS Manager installation packages includes revisions of the following software at the minimum levels indicated:
During the installation procedure, you will be asked to answer questions. Based on your answers, the installation software can install the correct revisions for you if the compatible revisions of these software packages are not present.
You can configure the Sun StorEdge QFS and Sun StorEdge SAM-FS software to notify you when potential problems occur in its environment. The Simple Management Network Protocol (SNMP) software manages information exchange between network devices such as servers, automated libraries, and drives. When the Sun StorEdge QFS and Sun StorEdge SAM-FS software detects potential problems in its environment, it sends information to a management station, which allows you to monitor the system remotely.
The management stations you can use include the following:
Management Center (Sun MC)
If you want to enable SNMP traps, make sure that the management station software is installed and operating correctly before installing the Sun StorEdge QFS and Sun StorEdge SAM-FS software. Refer to the documentation that came with your management station software for information on installation and use.
The types of problems, or events, that the Sun StorEdge QFS and Sun StorEdge SAM-FS software can detect are defined in the Sun StorEdge QFS and Sun StorEdge SAM-FS Management Information Base (MIB). The events include errors in configuration, tapealert(1M) events, and other atypical system activity. For complete information on the MIB, see /opt/SUNWsamfs/mibs/SUN-SAM-MIB.mib after the packages are installed.
The Sun StorEdge QFS and Sun StorEdge SAM-FS software supports the TRAP SNMP (V2c) protocol. The software does not support GET-REQUEST, GETNEXT-REQUEST, and SET_REQUEST.
| Sun StorEdge QFS & Sun StorEdge SAM-FS Software Installation & Configuration Guide | 817-4092-10 |
|
Copyright © 2004, Sun Microsystems, Inc. All rights reserved.
To Verify the Environment
