LSI Expander IP Configuration Utility (Xip) ******************************************************************************* REQUIREMENTS: Expanders: LSI SAS2x Switch Optional: LSI SAS2x20 LSI SAS2x24 LSI SAS2x28 LSI SAS2x36 Connectivity: 1. Inband Connection to Inband port Troubleshooting: 1. For Inband, make sure that the SAS addresses flashed in manufacturing pages are consistent. SAS address of expander and the SAS address of SxP should not differ by 6 bits in the LSB position. Otherwise the Host OS will not be able to detect the expander. ******************************************************************************* SOFTWARE SETTINGS 1. On Windows, MegaRAID support requires the ExposeEnclDevicesEnbl be set to "1". Please refer to the MegaRAID documentation for enable procedure. 2. MegaRAID for Solaris is not currently supported due to ExposeEnclDevicesEnbl being unavailable in Solaris. 3. As of these release On Linux, Xtools is not validated with Megaraid on inband interface due to lack of driver support. ******************************************************************************* HARDWARE SETTINGS FOR SAS2x Switch / SAS2x36 EVAL BOARD: 1. For Inband - No Hardware settings required. ******************************************************************************* DESCRIPTION: ******************************************************************************* SYNTAX: xip [OPTIONS] [INTERFACE] [COMMAND] OPTIONS: Multiple OPTIONS may be referenced per invocation. -h, --help Displays complete usage. -h , --help Displays interface or command specific usage. The interface or command should not be prefixed with '-'. -l, --log Creates a log file of internal operations. -q, --quiet Runs in quiet mode minimizing output. -y, --yes Suppresses all user conformation prompts. -f, --force Suppresses all user warning & confirmation prompts. -r, --reset Hard resets the expander after current command completion. -w, --wdreset Resets the watchdog of expander after current command completion. INTERFACE: Xip supports only SAS In band interface and this should only be used per invocation. -i SAS ADDRESS, --inband SAS ADDRESS Utilizes inband port (SAS ADDRESS) to connect to targeted expander. Note: "get avail" is the only command available when SAS ADDRESS is not specified. Note: Typical usage is shown below for get ip config command Here the example SAS Address is of the targetted SAS2x switch connected via in band interface. "xip.exe -i 500605b0000272bf get ipconfig" COMMAND: get - queries data from the targeted switch or expander sending it to STDOUT. ipconfig - display ip config properties of specified switch or expander. NOTE: This command displays following parameters. IP address Subnet mask (only if DHCP is disabled) Gateway address (only if DHCP is disabled) MAC address DHCP Status (enable/disable) avail - list switch or expanders available to inband interface. reset - reset elements of the targeted switch or expander. exp - reset the switch or expander. set - write data from STDIN to the targeted expander. ipaddr IP ADDRESS - writes IP address set by user to config page of switch or expander. NOTE: This facility is available only when DHCP is disabled. subnetmask SUBNET MASK - writes Subnet mask set by user to config page of switch or expander. NOTE: This facility is available only when DHCP is disabled. gateway GATEWAY ADDRESS - writes Gateway address set by user to config page of switch or expander. NOTE: This facility is available only when DHCP is disabled. dhcp MODE - writes dhcp mode set by user to config page of switch or expander. NOTE: MODE = 0 = DISABLE MODE = 1 = ENABLE FACTS: ******************************************************************************* 1) IP configurations made by using "set" commands, shall be effective only after resetting the board. 2) Reset can be achieved by either hard resetting the board or by exectuing the "reset exp" command. 3) Inband functionality of Xip is tested & verified on 8 expanders cascaded setup. It may work on larger topologies but usage is not verified. 4) Xip functionality is validated only on InventecDVT2 boards. 5) Reset command shall apply chip reset to the connected expander, and any ongoing IOs shall be terminated. 6) Xip won't wait for the expander to restart after executing reset command. Running another Xip command immediately after an expander reset may or may not work. So it is suggested to have delay of 1 to 2 seconds before executing another Xip command after reset. 7. In case if user finds that Xip through inband is not working, below settings are required to disable the UAC(User Account Control) on Windows OS 7. Following steps to be followed to disable the UAC 1.Go to Start Menu -> Control Panel -> User Accounts and Family Safety -> User Account. 2.Click on User Account Control settings link. 3.Slide the slider bar to the lowest value (towards Never Notify), with description showing Never notify me. 4.Click OK to make the change effective. 5.Restart the computer to turn off User Access Control. KNOWN ISSUES: ******************************************************************************* # Reset Expander will take some time using inband interface due to restarting all connection establishment with Drivers to Firmware. # If any command gets hung during its execution then hard reset the board & execute the same command. # Xip may throw error "IOCTL (-1) failed I/O error" and/or "IOCTL (-1) failed (Invalid argument)" when user tries to use inband functionality on Solaris SPARC. Functionality will work properly but user will get error message only because it does checking for Bobcat prior to Yeti.