A P P E N D I X  A

Using the lsiutil Utility to Save and Restore HBA Persistence Mappings

The procedures in this manual for replacing a Virtualized Multi-Fabric 10GbE NEM requires the use of a program called lsiutil. This appendix provides information how to use the application.



caution icon

Caution - The lsuitil application has many features and capabilities. Executing certain combinations of commands can cause catastrophic damage. When you use this application, be sure you execute the procedures exactly as they are documented here, command by command. Do not skip commands or steps and do not add commands or steps that are not in the documented procedure.



The following topics are covered in this chapter:


Where to Obtain the lsiutil Software

To use lsiutil for the procedure in this appendix, you must have version 1.60 at minimum.

To obtain the latest lsiutil software, go to the disk blade download site:

(http://www.sun.com/servers/blades/downloads.jsp#6000dm)


Installing lsiutil

Download LSIUtilKit_1.60.zip and unzip it in your root directory. It will create a main directory (LSIUtilKit1.60) with subdirectories for DOS, Linux, Solaris, Solaris x86, and Windows. If you are running lsiutil on a SPARC blade, use the Solaris subdirectory. Otherwise, use the Solaris x86 subdirectory.

There is an OS-specific version of lsiutil in each subdirectory.


Using the Interactive lsiutil Menus to Clear Your LSI Host Bus Adapter Non-Present Persistence Mapping

The procedure for clearing your LSI host bus adapter’s non-present persistence mappings requires using the interactive menus of lsiutil.

procedure icon  To Clear Your Non-Present Persistence Mappings

  1. Log in to your server as root.

  2. Change to the directory that contains the appropriate version of lsiutil for your application. For example:

    # cd LSIUtilKit1.60/Linux

  3. Enter the application name in the appropriate context. For example:

    # ./lsiutil

    The opening screen appears.

    Graphic showing the opening screen.

  4. Type 1 and press Enter.

    The main menu appears.

    Graphic showing the main menu.

    You cannot see all the commands in the menu because they are too numerous, but you can enter any option number if you know what it is. In our case we want to open the Persistence menu. This is done with option 15.

  5. Type 15 and press Enter.

    The Persistence menu opens.

    Graphic showing the persistence menu.

  6. Type 11 (Clear all non-present persistence mappings) and press Enter.

    This clears any entries in the host bus adapter‘s persistence map that refer to target objects that are no longer present.

    Graphic showing the entries being cleared.

  7. Type and enter 0 three times to exit the lsiutil application.


Saving a Snapshot of Your Host Bus Adapter Persistence Mappings

procedure icon  To Save a Snapshot of Your Host Bus Adapter Persistence Mappings

  1. Log in to your server as root.

  2. Change to the directory that contains the appropriate version of lsiutil for your OS. For example:

    # cd LSIUtilKit1.60/Linux

  3. Enter the application name in the appropriate context. For example:

    # ./lsiutil

    The opening screen appears.

    Graphic showing the opening screen.

  4. Type 1 and press Enter.

    The main menu appears.

    Graphic showing the main menu.

    You cannot see all the commands in the menu, but you can enter any command number if you know what it is. In our case we want to open the Persistence menu. This is done with command 15.

  5. Type 15 and press Enter.

    The Persistence menu opens.

    Graphic showing the persistence menu.

  6. Type 7 and press Enter.

    You are prompted for the name of the file where you want to store the host bus adapter’s persistent mappings snapshot.

  7. Enter a file name. For example, HBA33_persistence_file.

    Graphic showing entering the persistence mapping
filename.

    The file is saved to the current directory. You get confirmation of this with a statement of the number of persistent entries saved.

  8. Type and Enter 0 three times to exit the lsiutil application.



    caution icon

    Caution - You must save the persistence mappings snapshot to external media as you will not be able to reinstall it from a local disk.