POWER7 information

The rs_info Utility for the IBM Flash adapter 90 (PCIe2 0.9TB)

Learn how to install and use the rs_info utility to get information about the state and condition of the IBM® Flash Adapter 90 (PCIe2 0.9TB).

The rs_info utility provides information about the state and condition of the IBM Flash adapter.

Choose from the following options that are based on the operating system that controls the adapter:
Parent topic: IBM Flash Adapter 90 (PCIe2 0.9TB) (FC ES09; CCIN 578A)
Parent topic: IBM Flash Adapter 90 (PCIe2 0.9TB) (FC ES09; CCIN 578A)

Verifying whether the rs_info utility is installed in an AIX system or an AIX logical partition

Learn to verify whether the rs_info utility is installed in an AIX system or an AIX logical partition.

  1. Log in as root user.
  2. Run the following command:

    which /usr/lpp/diagnostics/bin/rs_info

    • If the rs_info utility is installed, the following screen is displayed:
      
		# which /usr/lpp/diagnostics/bin/rs_info

		/usr/lpp/diagnostics/bin/rs_info
    • If the rs_info utility is not installed, the following screen is displayed:
      
		# which /usr/lpp/diagnostics/bin/rs_info

		which: 0652-140 Cannot find /usr/lpp/diagnostics/bin/rs_info
Next, you can choose to do one of the following actions:

Verifying whether the rs_info utility is installed in a Linux system or Linux virtual machine

Learn to verify whether the rs_info utility is installed in a Linux virtual machine (VM).

  1. Log in as root user.
  2. On the command line of the Linux session, type which /usr/bin/rs_info, and then press Enter.
    • If the rs_info utility is installed, the following screen is displayed:
      
		## which /usr/bin/rs_info

		/usr/bin/rs_info
    • If the rs_info utility is not installed, the following screen is displayed:
      
		# which /usr/bin/rs_info

		/usr/bin/which: no rs_info in (/usr/bin)
Next, you can choose to do one of the following actions:

Installing the rs_info utility in an AIX system or an AIX logical partition

Learn how to install the rs_info utility in an AIX system or an AIX logical partition.

The rs_info utility is installed by using the Rational® Portfolio Manager (RPM) device driver. For instructions to install the device driver in an AIX system or an AIX logical partition, see Installing the device driver in an AIX system or logical partition.

Installing the rs_info utility in a Linux system or Linux virtual machine

Learn to install the rs_info utility in a Linux virtual machine (VM).

The rs_info is installed by using the rsxx-utils package from the Yum repository.

To install the rsxx-utils package, complete the following steps:

  1. Log in as root user.
  2. On the command line of the Linux session, type yum install rsxx-utils and then press Enter.
    The following screen is displayed:
    		

		Loaded plugins: refresh-packagekit, security

		Setting up Install Process

		Resolving Dependencies

		--> Running transaction check

		 ---> Package rsxx-utils.ppc64 0:4.0.2.2487-1.el6 will be installed

		--> Finished Dependency Resolution



		Dependencies Resolved



		=============================================================================

		Package            Arch       Version             Repository           Size

		=============================================================================

		Installing:

		rsxx-utils         ppc64      4.0.2.2487-1.el6    IBM_Power_Tools      330 k



		Transaction Summary

		=============================================================================

		Install       1 Package(s)



		Total download size: 330 k

		Installed size: 741 k

		Is this ok [y/N]:
  3. Press Y, and then press Enter.
    The following screen is displayed, which indicates that the installation of the rsxx-utils package is complete:
    


		Is this ok [y/N]: y

		Downloading Packages:

		rsxx-utils-4.0.2.2487-1.el6.ppc64.rpm                     | 330 kB     00:00     

		Running rpm_check_debug

		Running Transaction Test

		Transaction Test Succeeded

		Running Transaction

		Installing : rsxx-utils-4.0.2.2487-1.el6.ppc64                             1/1 

		Verifying  : rsxx-utils-4.0.2.2487-1.el6.ppc64                             1/1 



		Installed:

		rsxx-utils.ppc64 0:4.0.2.2487-1.el6                                            



		Complete!

Next, you can verify whether the rs_info utility has installed correctly. For instructions, see Verifying whether the rs_info utility is installed in a Linux system or Linux virtual machine.

You can also run the rs_info command to view the details of the IBM Flash adapters that are available in the system. For instructions, see Running the rs_info utility in a Linux system or Linux virtual machine.

Running the rs_info utility in an AIX system or an AIX logical partition

Learn to run the rs_info utility in an AIX system or an AIX logical partition and understand the output.

The rs_info utility can be run on the PCIe Flash Storage adapters that are available in an AIX system or an AIX logical partition, but do not work on defined storage adapters.

To identify the available storage adapters and then run the rs_info utility, complete the following steps:

  1. Run the following command to determine the available storage adapters:

    lsdev -Cc disk | grep "Flash Adapter"

    An output similar to the following screen is displayed, which shows the available disks:
    
		# lsdev -Cc disk | grep "Flash Adapter"

		hdisk1 Defined   07-00-01 IBM Flash Adapter Disk

		hdisk2 Available 07-00-01 IBM Flash Adapter Disk

		hdisk3 Defined   08-00-01 IBM Flash Adapter Disk
    Where, hdisk2 is the only available IBM Flash Adapter.
  2. To run the rs_info utility on the available storage adapter, run the following command:

    /usr/lpp/diagnostics/bin/rs_info

    An output similar to the following screen is displayed, which shows the available disks:
    
		# /opt/freeware/bin/rs_info 

		Please choose from the following or 'all':

		1) /dev/hdisk1

		2) /dev/hdisk2

		3) /dev/hdisk3

		?
    Where, hdisk2 is the only available IBM Flash adapter.
  3. Select the number that is associated with the disk for which you want to run the rs_info utility, or enter all if you want to select all the IBM Flash Adapters that are available to the system. If you select 2 an output similar to the following screen is displayed:
    	

		/dev/rsxx0

		Device File: /dev/rsxx0

		Part Number: 00AF044

		FRU Number: 00AF045

		CCIN: 578A

		EC: H48566L

		Firmware Level: 07_08768

		Serial: YL10WP0R1EE4

		Aux Serial: N/A

		Card State: Good

		Presented Capacity: 901939986432 Bytes

		Physical Capacity: 1374389534720 Bytes

		Board Temperature: 41.5 *C

		Board Current: 01.555A

		Board Voltage: 12.350V

		Board Power: 19.204W

		Capacitor Voltage: 09.229V

		Powerloss Protection: True

		Total Board Runtime: 216:10:11:20

		Flash Type: Toshiba eMLC 256 Gb

		Flash Page Size: 8192 Bytes

		Flash Sector Size: 4096 Bytes

		Flash Health State: Good

		Flash Health %: 98%

		Flash Wear Health: 100%

		Bad Planes FPGA 0: 0

		Bad Planes FPGA 1: 0

		Bad Planes FPGA 2: 0

		Bad Planes FPGA 3: 0

		Factory Bad Blocks: 2222

		Runtime Bad Blocks: 843

		Total Bad Blocks: 3065

		Flash User Writes (4k): 9730409781

		Flash Moves (4k): 4629735275

		Flash Total Writes (4k): 15955716728

For information about the fields that are displayed in the output, see The rs_info utility fields.

Running the rs_info utility in a Linux system or Linux virtual machine

Learn to run the rs_info utility in a Linux system or Linux virtual machine and understand the output.

The rs_info utility can be run on the PCIe Flash Storage adapters that are available in the Linux operating system or Linux logical partition, but do not work on defined storage adapters.

To identify the available storage adapters and then run the rs_info utility, complete the following steps:

  1. Log in as root user.
  2. Run the following command:

    /usr/bin/rs_info

    An output similar to the following screen is displayed:
    		# /usr/bin/rs_info

		Please choose from the following or 'all':

		1) /dev/rsxx0

		2) /dev/rsxx1

		?
  3. Select the number that is associated with the disk for which you want to run the rs_info utility, or enter all if you want to select all the IBM Flash Adapters that are available to the system. An output similar to the following screen is displayed:
    	

		/dev/rsxx0

		Device File: /dev/rsxx0

		Part Number: 00AF044

		FRU Number: 00AF045

		CCIN: 578A

		EC: H48566L

		Firmware Level: 07_08768

		Serial: YL10WP0R1EE4

		Aux Serial: N/A

		Card State: Good

		Presented Capacity: 901939986432 Bytes

		Physical Capacity: 1374389534720 Bytes

		Board Temperature: 41.5 *C

		Board Current: 01.555A

		Board Voltage: 12.350V

		Board Power: 19.204W

		Capacitor Voltage: 09.229V

		Powerloss Protection: True

		Total Board Runtime: 216:10:11:20

		Flash Type: Toshiba eMLC 256 Gb

		Flash Page Size: 8192 Bytes

		Flash Sector Size: 4096 Bytes

		Flash Health State: Good

		Flash Health %: 98%

		Flash Wear Health: 100%

		Bad Planes FPGA 0: 0

		Bad Planes FPGA 1: 0

		Bad Planes FPGA 2: 0

		Bad Planes FPGA 3: 0

		Factory Bad Blocks: 2222

		Runtime Bad Blocks: 843

		Total Bad Blocks: 3065

		Flash User Writes (4k): 9730409781

		Flash Moves (4k): 4629735275

		Flash Total Writes (4k): 15955716728

For information about the fields that are displayed in the output, see The rs_info utility fields.

The rs_info utility fields

Find the description and details about the fields that are displayed in the rs_info output when the rs_info utility is run for the IBM Flash Adapter 90 (PCIe2 0.9TB) installed in the system or virtual machine.

Table 1 provides the description and details of the fields in the rs_info utility output.

Table 1. The rs_info utility fields
Field Description
Device File The device file that is assigned by the operating system in which the IBM Flash Adapter is installed.
Part Number The part number of the IBM Flash Adapters.
FRU Number The FRU number of the IBM Flash Adapters.
CCIN The CCIN number of the IBM Flash Adapters.
EC The EC number of the IBM Flash Adapter.
Firmware Level The current firmware version that is running on the card.
Serial The serial number of the IBM Flash Adapter.
Aux Serial The serial number of the auxiliary boards that are located in the IBM Flash Adapter. There are no auxiliary boards that are located in the IBM Flash Adapter. Therefore, this field is displayed as N/A.
Card State The state of the card. The different states follow:
  • Shutdown
  • Starting
  • Formatting
  • Uninitialized
  • Good
  • Shutting Down
  • Fault
  • Read Only Fault
  • dStroying
  • Unknown
Presented Capacity The capacity as viewed by the operating system.
Physical Capacity The full capacity of the flash on the IBM Flash Adapter, that is 1.2 Terabyte (TB). The extra 300 GB is used by the Flash adapter when bad flash blocks form in the flash storage, or during Redundant Array of Independent Disks (RAID) protection.
Board Temperature The temperature on the card.
Board Current® The current drawn by the card.
Board Voltage The voltage across the card.
Board Power® The amount of power used on the card.
Capacitor Voltage The voltage across the capacitors that are located on the card.
Powerloss Protection Displays True if capacitors are located on the card, and displays as False if capacitors are not located on the card.
Total Board Runtime The total time for which the card is powered on through out the life of the card.
Flash Type The specific type of flash that is used on the IBM Flash Adapter.
Flash Page Size The size of each individual page in the flash.
Flash Sector Size The size of each sector in the flash.
Flash Health State The represents the health of the flash. The states follow:
  • Good
  • Warn
Flash Health % The reported total health, in percentage, of the flash on the card.
Flash Wear Health The health of the flash on the card displayed as a percentage.
Bad Planes FPGA X The number of reported bad planes on field-programmable gate array (FPGA) X.
Factory Bad Blocks The number of bad blocks that are detected during manufacturing.
Runtime Bad Blocks The number of bad blocks that occurred during the use of the card.
Total Bad Blocks The sum of the factory bad blocks and the runtime bad blocks.
Flash User Writes (4k) The number of writes that are issued from the host.
Flash Moves (4k) The number of moves (writes) during flashcard garbage-collection.
Flash Total Writes (4k) The total number of writes to the adapter, including host writes, garbage-collection, moves, and RAID protection.

Send feedback Rate this page

Last updated: Wed, January 17, 2018