FC HBA Change LUN State Utility for Linux Readme

FC HBA Change LUN State Utility for Linux

This software license applies only to QLogic customers.
QLogic Corporation.
All rights reserved.

Table of Contents
1.	Package Contents
2.	Requirements
3.	OS Support
4.	Supported Features
5.	Using the FC HBA Change LUN State Utility
	5.1 Starting the Utility
	5.2 Command Line Options
	5.3 Menu Options
6.	Application Notes
7.	Known Issues / Workarounds
8.	Contacting Support

1. Package Contents

The following table describes the contents provided in the FC HBA Change LUN State utility package.

Filename	Description
COPYING	GNU General Public License that describes user rights to copy, distribute, and use the open source content in this Linux tool.
ql-lun-state-online.sh	Script file used to change the state of LUNs connected to QLogic HBA from offline to online/running.
README.ql-lun-state-online.txt	Text file version of this readme file.
revision.qllunstateonline.txt	Text file that identifies the changes made between versions of this package.

2. Requirements

The FC HBA Change LUN State utility requires one of the Linux platforms identified in OS Support.

3. OS Support

The FC HBA Change LUN State utility for Linux runs on the OS platforms shown in the following table.

Operating Systems
OS Name	OS Type	Hardware Platform
Red Hat RHEL AS 3.0	32-bit/64-bit	Intel x86, Intel EM64T, AMD64, Intel IA64, and PPC64 platforms
Red Hat RHEL AS 4.0	32-bit/64-bit	Intel x86, Intel EM64T, AMD64, Intel IA64, and PPC64 platforms
Novell SLES 8	32-bit/64-bit	Intel x86, Intel AMD64,Intel IA64, and PPC64 platforms
Novell SLES 9	32-bit/64-bit	32-bit/64-bit on Intel x86, Intel EM64T, AMD64, Intel IA64, and PPC64 platforms
Novell SLES 10	32-bit/64-bit	64-bit on Intel x86, Intel EM64T, AMD64, Intel IA64, and PPC64 platforms

NOTE: For specific OS service packs (SP) and updates, refer to the descriptions where this software version is posted on the QLogic website (http://support.qlogic.com/support/drivers_software.asp).

4. Supported Features

The ql-lun-state-online.sh utility:

Allows you to select a specific host for enabling LUNs.
Provides an interactive menu, which lets you select a specific LUN.
Enables all offline LUNs with a single command.
Lets you select specific targets for every host using a menu.
Supports Fibre Channel driver version 8.xx.xx.

5. Using the FC HBA Change LUN State Utility

This utility allows you to change the state of LUNs connected to a QLogic HBA from offline to online/running. The SCSI mid-layer may change a device's state to offline when it does not receive a response from the device. Once these devices are offline, the SCSI mid-layer ignores them.

For example, if a SCSI command timeouts on a particular device and fails to recover the device, the SCSI mid-layer marks the device as offline.

Later, when the device is online or accessible, you can use the ql-lun-state.sh utility to change the state to running or online.

The following subsections describe how to use this utility:

5.1 Starting the Utility
5.2 Command Line Options
5.3 Menu Options

5.1 Starting the Utility

To start this script, enter one of the following commands:
# ./ql-lun-state-online.sh <HOST NUMBER/S> # ./ql-lun-state-online.sh --all

For example:

For /sys/class/scsi_device/2:0:1:4/
HOST number - > 2

For /sys/class/scsi_device/3:0:2:6/
HOST number - > 3

Command:
# ./ql-lun-state-online.sh 2 3

This changes the state of all the offline LUNs to running.

5.2 Command Line Options

Usage:

./ql-lun-state-online.sh [OPTIONS]

Options	Description
`HOST NUMBERs`	Specify the host numbers to scan them for all offline LUNs to enable them.
`-a, --all`	Use this option to enable all disabled LUNs.
`-i, --interactive`	Use this option to start the menu-driven program.
`-h, --help, ?`	Displays the help message.

Examples:

To enable all LUNs on HOST 2 and 4, enter the following command:
# ./ql-lun-state-online.sh 2 4
To enable all LUNs on all HBAs, enter one of the following commands:
# ./ql-lun-state-online.sh -a # ./ql-lun-state-online.sh --all
To invoke the menu, enter one of the following commands:
# ./ql-lun-state-online.sh -i # ./ql-lun-state-online.sh --interactive
To view help, enter one of the following commands:
# ./ql-lun-state-online.sh -h # ./ql-lun-state-online.sh --help

5.3 Menu Options

The utility provides a menu-driven interface that provides finer control of the operation. To invoke the menu, use the -i or --interactive option with the ql-lun-state utility. For example:
# ./ql-lun-state-online.sh -i

MAIN MENU

1. HOST: 2 TGT: 0 LUN: 4 2. HOST: 3 TGT: 1 LUN: 4 3. MAKE ALL ONLINE 4. QUIT

Please select any one option:
The following table describes the main menu options.

Main Menu Option	Description
`1. HOST: 2 TGT: 0 LUN: 4 / 2. HOST: 3 TGT: 1 LUN: 4`	These options appear if the system has QLogic HBAs installed with targets that have a LUN state of `offline`. Selecting the appropriate option enables the corresponding LUN. The following example shows the screen that appears when selecting option 2: MAIN MENU 1. HOST: 2 TGT: 0 LUN: 4 2. HOST: 3 TGT: 1 LUN: 4 3. MAKE ALL ONLINE 4. QUIT Please select any one option: 2 Modifying to running HOST: 3 TGT: 1 LUN: 4
`3. MAKE ALL ONLINE`	Selecting this option enables all the offline LUNs. The following example shows the screen that appears when selecting option 3: MAIN MENU 1. HOST: 2 TGT: 0 LUN: 4 2. HOST: 3 TGT: 1 LUN: 4 3. MAKE ALL ONLINE 4. QUIT Please select any one option : 3 Found LUN 4 on HOST 2 in offline state Modifying to running Found LUN 4 on HOST 3 in offline state Modifying to running
`4. QUIT \| Q \| X`	Selecting one of these options closes the menu-driven interface.

6. Application Notes

None

7. Known Issues and Workarounds

None

8. Contacting Support

Please feel free to contact your QLogic approved reseller or QLogic Technical Support at any phase of integration for assistance. QLogic Technical Support can be reached by the following methods:

Web: http://support.qlogic.com

North America Contact Information
Email: support@qlogic.com
Phone: (952) 932-4040

Support contact information for other regions of the world is available at the QLogic website:
http://support.qlogic.com

Go to Top

© Copyright 2007. All rights reserved worldwide. QLogic, the QLogic logo, and the Powered by QLogic logo are registered trademarks of QLogic Corporation. All other brand and product names are trademarks or registered trademarks of their respective owners.