To Prepare to Use the pcli Utility

  1. Open an xterm or a gnome terminal window.

    pcli commands can produce large amounts of detailed output. The xterm and gnome terminal windows provide scroll bar functionality, which helps when viewing such output.

    Note:

    If you do not have access to a terminal window with scroll bars, such as the xterm or gnome windows, you can use the pcli pagination feature. This feature enables you to specify a number of lines to be printed on the screen before pausing, at which time you must hit a key to continue. For example, the following pcli command prints 20 lines at a time to the screen: {0} ok ok cli show page 20
  2. Enter the OBP environment by issuing a break from a remote console.
  3. Use the show-devs command to list the device paths on the system and select the device path for the HBA.
                      {0} ok 
                      show-devs
    <...>
    /pci@1e,600000/pci@0/pci@3/LSI,mrsas@0
     /pci@1e,600000/pci@0/pci@3/LSI,mrsas@0/disk
     /pci@1e,600000/pci@0/pci@3/LSI,mrsas@1
    <...>
    
  4. Use the select-dev command to select the HBA on which the pcli commands that you issue will operate.

    {0} ok “ /pci@1e,600000/pci@0/pci@3/LSI,mrsas@0” select-dev

    You have now selected the HBA upon which all pcli commands will operate. This means you do not need to specify the HBA in any pcli command that you issue, unlike with the storcli utility. For example, if you issue the pcli command, show, the command automatically applies to the selected HBA. However, the equivalent command through the storcli utility would apply only to the card that you specify (the 0 card, as shown here):

    SPARC pcli: {0} ok cli show

    storcli: storcli /c0 show

  5. Review the following table for useful pcli commands.
    pcli Command Description

    cli /c0/eall/sall show

    Lists all physical drives.

    cli add

    Creates a RAID logical drive.

    cli /c0/vX del

    Deletes a logical drive.

    cli /c0/vall show

    Displays information about logical drives.

    cli show

    Displays HBA configuration information.

    cli /c0/vall show

    Lists all logical drives.

    You are now ready to use the pcli commands to create a logical drive, or MegaRAID virtual drive, on the HBA.