Table of Contents List of Figures...xi List of Tables ...xv Chapter 1: Notices ...1 ADIC Limited Product Warranty ...1 Safety Notices ...6 Safety Inspection ...6 Remove AC Power ...6 External Machine Check...6 Internal Machine Check ...7 Safety Label Check...7 Fusing Requirements...9 AC Grounding ...10 Environmental Notices and Statements ...10 Electronic Emission Statements ...11...
Page 4
Supported Devices ...20 Operating Specifications...21 Installation Options ...21 Physical Dimensions...21 Operating Environment...21 Power Consumption ...22 AC Power Requirement ...22 Agency Approvals...22 Introduction to the ADIC Management Console ...22 Client/Server Model ...23 Agent ...23 Server ...23 Client...24 Features ...24 SNMP ...24 SNMP Community Support...25 Security...25 SAN Access Control ...25...
Page 5
Other Installation Issues ...44 Host Adapter Setup ...44 Installing the SAN Explorer and Host Registration Service ..44 Power-Up and Boot Sequence Guidelines ...45 Install the ADIC Management Console Software ...46 Installation Requirements ...46 Installing the Software on Windows NT/Windows 2000 ...47 Startup and Configuration...47 ADIC Gateway Network Setup ...49 Chapter 4: Understanding SAN Configurations ...53...
Page 6
If You Lose the Password...78 Tools Menu Group ...79 Discover Net ...79 Connect SAN Gateway...80 Disconnect SAN Gateway ...81 Health Check ...82 Events...85 Save SAN Gateway Configuration...90 Load SAN Gateway Configuration...91 Controls Menu Group ...94 Feature Enable ...94 Feature Enable: Virtual Private SAN ...95 Feature Enable: Virtual Private Map...96 Feature Enable: Data Mover...97 Access Options...97...
Page 7
Introduction to Virtual Private Map ...147 Enabling Virtual Private Map ...148 Mapping Devices With VPM ...148 Map Devices on a Fibre Channel to a SCSI Host...148 Map Devices on a SCSI Channel to a SCSI Host ...152 Removing Devices From VPM ...155 Chapter 8: Maintenance Action Plans ...157 Start MAP ...157 Event Code or Obvious Symptom ...157...
Page 9
Replacing the DDF Board...204 Fuse Removal ...205 Removing the Fuses...205 Replacing the Fuses ...205 Base Unit ...206 Prepare the New Base Unit ...206 Removing and Replacing the FRUs ...206 Bulkhead Panel ...207 Removing a Bulkhead Panel ...207 Replacing a Bulkhead Panel...207 Final Diagnostic Tests ...208 Final Test Preparation ...208 Fibre Channel Tests ...208...
Page 10
Appendix D: Remote Event Notification ...307 Event Logging and Viewing ...307 Events and Traps ...308 Heartbeats ...309 Health Check ...310 Health Check Level Control ...311 Health Check Interval ...313 Performance Impact of Health Checks ...313 Appendix E: Startup Message Reference ...315 POST Messages ...315 Boot Rom Messages ...315 LIC Initialization Messages ...317...
Chapter 1: Notices This manual is intended for use with the ADIC Gateway and ADIC Storage Networking Controller (ADIC SNC). Where the text states “ADIC Gateway,” the user may read both “ADIC Gateway” and “ADIC Storage Networking Controller.” ADIC Limited Product Warranty 1.
4. ADIC will indemnify Buyer for any damages and costs finally awarded against Buyer on the grounds that the Products, in the form and condition delivered by ADIC to Buyer hereunder, infringe on any valid United States patents or copy- rights of any third party, provided that Buyer notifies ADIC in writing of any such claim within 10 days after learning thereof and that Buyer gives ADIC full control over the defense and settlement of the claim and fully cooperates with...
Page 19
a.) License. In consideration of Licensee's payment of the License fees and subject to the terms of this License, ADIC grants to Licensee a personal, non-exclusive, non-transferable license to use the Software (Software is defined as the current version of the software products accompanying this license agreement in object code form only).
Page 20
Documentation; (iii) modify, merge with other programs or translate any portion of the Software into any other assembly or language; and (v) reverse-assemble, reverse-compile or attempt to derive a source code equivalent of the Software. c.) Protections. Licensee agrees to secure and protect the Software, the Documentation and copies thereof in a manner consistent with ADIC's rights therein and to take appropriate action to satisfy its obligations in this Agreement by instruction or agreement with its employees, agents,...
Page 21
EXPRESS OR IMPLIED, FOR THE SOFTWARE, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. 4. Term and Termination. This License commences on the Effective Date and will continue in perpetuity unless Licensee fails to comply with any conditions of this License.
Licensee agrees that this is the complete and exclusive statement of the agreement between the parties and supersedes all proposals or prior agreements, oral or written and all other communications between the parties relating to the subject matter of this License. Any variance from the terms and conditions of this License or any supplement in any Licensee purchase order or other written notification or agreement will be of no effect.
3. If the ADIC Gateway is not installed in a rack cabinet, check for loose or broken feet. 4. Check the power cord for damage. 5. Check the external signal cable for damage. 6. Check the cover for sharp edges, damage, or alterations that expose the inter- nal parts of the device.
Figure 1-1: Safety Label 3. Check the voltage label on the bottom of the device to ensure it matches the voltage at the power source. 4. Check the voltage level at the power source. 5. Check for proper grounding. See Figure 1-2. Figure 1-2: Ground Test Note: Always use an analog meter, never a digital meter, to perform the ground check of the outlet.
6. With the power cord connected to the ADIC Gateway, verify that there is 1.0 ohm or less resistance between the ground lug on the power cord plug and the metal frame. 7. If the ADIC Gateway passes the test in the previous steps, connect the power cord to the power source.
AC Grounding Figure 1-4 shows AC grounding on the ADIC Gateway. Figure 1-4: AC Grounding Environmental Notices and Statements Product Recycling This unit contains recyclable materials. These materials should be recycled where processing sites are available and according to local regulations. Lithium Battery ISK OF FIRE EXPLOSION...
General Restrictions The classification is valid only if the module is operated within the specified temperature and voltage limits. The system using the module must provide power supply protection that guarantees that the system power source will cease to provide power if the maximum recommended operation limit or more is detected on the +3.3 V/+5 V at the power source.
Avis de conformité à la réglementation d’Industrie Canada: Cet appareil numérique de la classe A est conform à la norme NMB-003 du Canada. European Community Compliance Statement This product is in conformity with the protection requirements of EC Council Directive 89/336/EEC on the approximation of the laws of the Member States relating to electromagnetic compatibility.
Agency Approvals • Features Overview The ADIC Gateway is the interface between storage and Open System Host interfaces and provides Fibre Channel to SCSI connectivity. Configuration Support The ADIC Gateway is a self-configuring product with Fibre Channel and SCSI interface options. The ADIC Gateway can have up to four on-board UltraSCSI channels and up to six SAN interfaces, which are configurable using plug-in cards.
VPS is a Virtual Private connection or channel between a storage element and the user of that element in a Storage Area Network. Virtual Private SAN is created by a method of Access Security that manages the access between an Initiator (user, host, system, ..) to Target/LUN (Device, Disk or Tape, ...) and also protects and...
Channel Zoning is a means of managing the access security between SAN connections and SCSI channels on a channel by channel basis. Channel Zoning can be used to secure access between a server and its storage, segregating them, for example, from other servers and their respective storage.
standard 60 nanosecond FPM SIMMs for command, control, and code execution • Non-volatile FLASH memory for operational firmware, power on self-test code, diagnostic functions, system utilities, persistent configuration tables, and event log. The default configuration is 2 • VxWorks Fibre Channel Interfaces Interfaces for host and device attachment can be configured for up to three plug-in PCI Mezzanine Cards (PMCs).
Ultra2 SCSI I/O Interfaces • Any or all of the three PCI Mezzanine Card (PMC) interfaces can be configured to use a dual-ported Ultra2/3 SCSI PMC board instead of a Fibre PMC. • Ultra2/3 SCSI PMCs are available as Single-Ended/Low Voltage Differential (SE/LVD) or High Voltage Differential (HVD).
Ethernet The 10/100 Base-T Ethernet port has an RJ-45 connector for out-of-band management. It can be connected to a network hub using an unshielded twisted- pair Ethernet cable. The Ethernet port complies with the IEEE 802.3 specification. Service Port The service port is an RS-232 connection with a 9-pin D-shell connector (DTE). It is compatible with serial ports on personal computers.
It has the highest reliability and mean time between failure (MTBF) numbers and is manufactured by a leading power supply company with excellent field reliability results in the industry. It has a standard integrated power entry, on/off switch, and fuse holder. It uses two 250 V 4A time lag fuses.
nels. A flashing Activity LED indicates activity on a SCSI Channel. • Ethernet A group of three LEDs (two green, one amber) indicate the Link, Transmit, and Collision statuses of the Ethernet Port network con- nection. • Temperature A group of two amber LEDs indicate Temperature Warning and Tem- perature Alarm.
For a current list of supported devices, see the Web site and technical support contact information, visit “Service and Support” at www.adic.com, or call the ADIC Technical Assistance Center at 1-800-827-3822. Operating Specifications This section contains the physical, electrical, and environmental specifications for the product.
TORAGE • Temperature: 0°C to 60°C (32° F to 140° F) • Relative Humidity: 8% to 80% • Wet Bulb: 29°C (84.2°F) Power Consumption The power consumption of this product depends on the number and type of installed interface options. The following numbers are line power consumption values for a fully configured product.
Client/Server Model Figure 2-2: ADIC Management Console Application Model Agent Each ADIC Gateway is a stand-alone, SNMP-manageable host. The ADIC Management Console uses SNMP as the primary method of communication with the agents. This allows you to set and retrieve information that controls the operation of the agent.
The Server is written to be both transportable and efficient. Multiple Clients can share data the Server already knows about rather than having to request the data again. In addition, the Server receives all traps from the agents and forwards them to the Clients that have registered to receive them.
The VPS option requires a software license key to enable the Initiator-Target/LUN access control feature. VPS manages access permission between any host attached to a SAN connection and any storage element attached to the ADIC Gateway. This includes storage devices attached to any SCSI Channel and storage devices attached to any other SAN Connection on the ADIC Gateway.
Host Registration Service The Host Registration Service is software that installs on the host from the CD- ROM or it can be downloaded from the website. It simplifies VPS configuration for the system administrator. It removes the burden of physically tracing each connection to correlate the Fibre Channel HBA World Wide Name (WWN) with a specific host.
Event Logging You can retrieve and view the ADIC Gateway event logs in a table. Filtering based upon the significance of events simplifies fault isolation. Health Checks Instantaneous and periodic health checks allow monitoring of each SAN Gateway and devices attached to it. The level and interval of the health check is selectable to obtain greater confidence or minimize the impact on system performance.
Chapter 3: Installation This section covers installation of the ADIC Gateway, SCSI devices, and the host adapter. Before you or your service representative installs the ADIC Gateway you must perform the steps in the Pre-installation checklist. Note: Ensure SCSI device interfaces match the interfaces of the attached SCSI devices (SE/LVD or HVD).
Page 46
Table 3-1: Pre-Installation Steps Step User Action or Decision Verify host platform OS, required Service Pack installed For example: Windows NT 4.0, Service Pack 6a (or later) Verify required Fibre Channel Host Bus Adapter, HBA BIOS and device driver procured, installed If you will be connecting more than one host to the ADIC Gateway and you...
Page 47
Table 3-1: Pre-Installation Steps Step User Action or Decision Ensure that SCSI disk or tape system installation has been completed. • For tape attach, tape device driver installed or updated • Mark both ends of each SCSI cable with -Target ID and channel number -ADIC Gateway ID and channel number...
Installation Checklist The installation checklist has instructions on how to install the ADIC Gateway with SCSI attached storage and FC attached hosts. You may have the option of having a service representative perform this portion of the installation for you.
Page 49
Table 3-2: Installation Steps Connect the service terminal to the Service Port and start up a terminal emulation session Step User Action or Decision Turn on the ADIC Gateway and observe the startup messages on the service terminal Issue the initializeBox command from the service terminal.
Page 50
Table 3-2: Installation Steps The SCSI disk or tape subsystems must be installed and verified before the ADIC Gateway installation can continue Connect the SCSI cables from the target devices to the ADIC Gateway. Turn on the SCSI target devices Step User Action or Decision Turn on the ADIC...
Page 51
Table 3-2: Installation Steps Power down the FC host(s). Connect the FC cables from the FC HBA(s) to the ADIC Gateway. Power up the FC host(s) Step User Action or Decision Issue fcShow command from the service terminal to show the status of each FC interface that is installed and connected.
Post-installation Checklist Perform the actions listed in Table 3 after you or your service representative have completed the installation steps. Table 3-3: Post-Installation Steps Step Customer Actions Install the ADIC Management Console software. For an updated list of supported systems, visit “Service and Support”...
Become familiar with using the ADIC Management Console You must use the ADIC Management Console to monitor and maintain your Storage Area Network. If a trap/event is reported by the ADIC Management Console, check the reported event code, then see and perform the...
through the box. The ventilation holes in each side of the unit must never be blocked. There are no spacing requirements above or below the unit. Desktop Configuration The ADIC Gateway is shipped with four rubber feet that should be used when the ADIC Gateway is placed on a desktop or other flat surface.
2. Attach a bracket (D) to each side of the ADIC Gateway using the small screws (A) provided with the brackets. 3. Place a washer on each screw (C). Hold the ADIC Gateway in the rack and secure with four screws. Figure 3-2: Installation Into a Rack When mounted in an enclosed rack, provision must be made to exchange 24 CFM of air between the interior of the rack and the room environment for each ADIC...
Maximum Number of LUNS The ADIC Gateway supports up to 255 LUNS. Attention: Do not attach more than 255 LUNS to the ADIC Gateway. Exceeding the 255 LUN limit will result in unreliable behavior. Transfer Rates: Ultra, Fast, and Asynchronous The SCSI protocol defines two methods of data transfer: synchronous and asynchronous.
The SCSI protocol also defines a priority-based arbitration method, based on the target ID of the device attaching to the bus. The SCSI ID priority order is, from highest to lowest, 7, 6, 5, 4, 3, 2, 1, 0, 15, 14, 13, 12, 11, 10, 9, 8. Table of SCSI Terminology and Limitations The following table (look for updates at http://www.scsita.org/) defines the number of devices supported, based on the negotiated transfer type.
Notes: 1. The listed maximum bus lengths may be exceeded in Point-to-Point and engi- neered applications. 2. Use of the word "Narrow", preceding SCSI, Ultra SCSI, or Ultra2 SCSI is optional. 3. Low Voltage Differential (LVD) was not defined in the original SCSI standards for this speed.
devices have termination disabled. • Multiple devices at the same ID: If two or more devices are configured at the same SCSI ID, only one of those devices will be seen by the ADIC Gateway, and data transfers to that device will be unreliable.
Other Installation Issues Host Adapter Setup Hosts are connected to the ADIC Gateway through specific Host Bus Adapters (HBAs). The installation procedure varies slightly, depending on which adapter you will be using. The procedure involves these steps: 1. Install the adapter in the host system, following the manufacturer’s recommendations.
The default period is set to send host status every 15 minutes. If you want, you can change the period to any value between 1 and 255 minutes. See the readme file on the CD-ROM in the HOSTSW folder for the specific host platform you are using.
If you update ADIC Gateway firmware you must reboot in order to use the new firmware. To ensure compatibility between the firmware features or functions and the host, reboot the host. If you update SCSI device firmware, the SAN Explorer application does not display the new firmware version until the ADIC Gateway has issued a SCSI Inquiry.
Installing the Software on Windows NT/Windows 2000 Server System Requirements • Windows NT 4.0 Server or Workstation, Service Pack 6a or Win- dows 2000 • Minimum memory: 64MB • Free hard disk space: 40MB • Ethernet with TCP/IP protocol installed Client System Requirements •...
3. Connect to the Server (automatic if Server and Client are running on same system) 4. Log on to the Server. See Figure 3-3. Figure 3-3: Logon to Server 5. Add a new user account with administrator privileges. See Figure 3-4. Figure 3-4: Add An Administrative User Account To log on, use the pre-defined Admin account, see “Startup and Configuration”...
To add a new administrator account (pull down the menu and click on Admin ). See Figure 3-5. User Figure 3-5: Adding A User Account Remember that user names and passwords are case sensitive. After you add a new administrator account, the pre-defined Admin account is deactivated. Attention: Save your administrator account information in a secure location.
Page 66
Set the host name: The host name is set using the hostNameSet command. In the example shown, the host name of the ADIC Gateway was “Gateway” and is now being set to “foster.” The shell prompt will change to reflect the new name. Gateway >...
Page 67
8 or more characters. For further information, see the user commands in “Service Port Command Reference” on page 223. foster > userAdd “username”,”password” value = 0 = 0x0 foster > Reboot the ADIC Gateway: The ADIC Gateway must be rebooted to activate the Ethernet port, using the reboot command.
Fibre Channel or SCSl, to devices with different interfaces, either Fibre Channel or SCSI. In a typical configuration, each ADIC Gateway Storage Area Network interface is connected to either a single host or multiple hosts using Fibre Channel hubs or switches.
This configuration has a device map (from the device point of view) that looks like this: Table 4-1: Target Device Map Target ID Disk (Target 0) Disk (Target 1) Host System If a product such as an ADIC Gateway or a RAID controller is placed between the system and the target devices, the addressing will have another layer.
mapping, or LUNs. The device map might now look like this from the host point of view: Table 4-2: Host Device Map Target ID For simplification, hard IDs were chosen for the Fibre Channel devices in the mapping scheme. A hard ID is a number from 0 to 125 used in place of the World Wide Name assigned to each Fibre Channel device.
accounted for. With a SCSI-type mapping, there are 16 target IDs available per bus, but one must be reserved for the host adapter. This allows for 15 targets with 8 LUNs each, or 120 total devices. Different operating systems have different limits on the number of LUNs supported.
sharing the device and the device is busy doing I/O, it could take several minutes for the device to respond. In a standard queuing model, the command sent by the second host starting-up would be blocked behind the I/O command and could timeout, preventing the host from finding the device.
command from the terminal or system connected to the service port or the ADIC Management Console to request a SCSI rescan. Attention: Do not attach more than 255 LUNs to the ADIC Gateway. Exceeding the 255 LUN limit will result in unreliable behavior. Replacing an Existing SCSI Device If you have to replace a SCSI target device, remove the old device, set the new device to the same SCSI ID as the old device and attach it to the same SCSI...
Fibre Channel Port Modes and Connection Options The Fibre Channel ports support Private and Public Fibre Channel Fabric Loop attachments. Both Loop and Point-to-Point connection options are available. The default Port Mode setting is Public Target and the default connection setting is Loop.
Connection Type Options With this connection option, the port operates with attached loop-capable devices. If a point-to-point device is attached, the ADIC Gateway will not be able to communicate with it. OINT OINT With this connection option, the port supports point-to-point fabric connection (F_Port Login).
Use the ADIC Management Console to save or load the configuration. See “Save SAN Gateway Configuration” on page 90. You must save the configuration so that it can be reloaded in case you or the service representative must replace the ADIC Gateway base.
Chapter 5: Using the ADIC Management Console Menus allow you to select views of one or more ADIC Gateway s and the devices connected to them, and to perform various actions. From the main screen, six major menu groups are available: •...
Starting the ADIC Management Console Before a Client can manage any ADIC Gateways ("Agents"), it must establish a connection to the Server. If the Server and Client are running on the same system, a connection is automatically made when the Client starts. If the Server is on a different system the dialog in Figure 5-1 is displayed.
Figure 5-3: Initial Tree View The ADIC Management Console's main screen is made up of two panels, the Tree View panel on the left and the Data panel on the right. The Tree View in Figure 5- 3 is an unexpanded Tree View for a single ADIC Gateway. For an expanded view, see Figure 5-9.
If you did not perform a view of the three ADIC Gateways managing Marketing, Hardware, and Web Service storage is still valid for the next time that view is loaded. Save Current View as Save Current View As Gateways on the server.
Figure 5-5: Save Current View As Open a Previous View Figure 5-6 is an example list of views previously saved by a user. From this list you can select a view by clicking on the name, and then selecting an action option.
Exit Figure 5-7: Exit stops the ADIC Management Console Client application and closes its Exit window. See Figure 5-7. Attention: If you exit without selecting a save option after making changes to a view, the changes you made are lost. View Menu Group The “View Menu Group”...
element, its tree collapses. Figure 5-9 shows the Tree View of an ADIC Gateway with two tree elements expanded Figure 5-9: Expanded Tree View View Menu Group...
The icons used in the Tree View carry specific meaning, both in their design and in their color. See See Figure 5-10. Figure 5-10: Icons for Channel Modes and Channel Types In Figure 5-9, Fibre Channels 2, 4, and 5 are blue, SCSI Channels 1-4 and Ultra2 SCSI Channels 3 and 6 are green, and Fibre Channel 1 is purple.
variety of information, including the unit's WWN, IP Address, Firmware Revision, Serial Number, and Ethernet Speed. Figure 5-11: Information About a Channel When a Channel is selected, the lower part of the Data panel display includes the WWN, port mode, connection type, and maximum speed. See Figure 5-11.The firmware revision level of the HBA attached to the selected Channel is presented as distinct from the firmware revision level of the ADIC Gateway.
Information About a Selected Channel When a device is selected, information about its capacity, status, width, and speed is all included in the lower portion of the Data panel. See Figure 5-13. For a list of the different icons used in Tree View, see Figure 5-12. Figure 5-12: Icons used in Tree View Figure 5-13: Information About a Selected Device View Menu Group...
When a host is selected, information about its WWN, Network Name, Operating System and HBA attachment is all included in the lower portion of the Data panel. No matter what component in Tree View is selected--host, channel, device, or the ADIC Gateway itself--the top "paragraph"...
SAN Gateway Front Panel Choosing the option shows you a front-panel view of the SAN Gateway Front Panel selected ADIC Gateway. You can see the status of the lights on the front panel of the ADIC Gateway. The lights are refreshed automatically, about five times per second.The ADIC Gateways product data is displayed below the front panel.
Refresh SAN Gateway When you select the option, the ADIC Management Console Refresh SAN Gateway Client requests the Server to contact the selected ADIC Gateway and update all data. This refreshes the data for the ADIC Gateway and all attached devices. The option can also be accessed by right-clicking on the ADIC Refresh SAN Gateway Gateway in the Tree View display.
Connect to Server To connect to the server, you are prompted to enter the name or IP address of the ADIC Management Console Server system. See Figure 5-18. Figure 5-18: Connect To Server The status/message line at the bottom of the screen shows whether your connection was successful or unsuccessful.
If you do not want to change your password, press for your old password to Cancel remain unchanged. Figure 5-20: Change Password Add New User You can add a new user if you successfully logged on with administrator privileges. See Figure 5-21. You must enter a valid administrator name and password and then enter the new user name and password.
Remove User You can remove a user if you successfully logged on with administrator privileges. You must enter a valid administrator name and password and then select the name of the user you want to remove. See Figure 5-22. Press to remove Remove the user.
Tools Menu Group provides options for finding and connecting to ADIC Tools Menu Group Gateways and controlling ADIC Gateway status reports. Figure 5-23: Tools Menu Discover Net With Discover Net, you can discover all ADIC Gateways on the network. When you select this option, you are prompted to enter the and the Network Address...
You must enter a response from each IP address that is checked. You may set the considerably lower than the default (1000 milliseconds) in order to speed discovery. Before starting the discovery process, you are given an estimate of how long the discovery will take and you have an opportunity to abort the process or continue.
Figure 5-26: Right Click Menu for Connecting To Gateway Disconnect SAN Gateway menu choice ends your connection to the selected Disconnect SAN Gateway ADIC Gateway and removes it from the display. ADIC Management Console asks you to confirm that you want to break the connection. See Figure 5-27. If you have changed your mind, press .
dialog box by right-clicking the ADIC Gateway in the Tree View display. The option is the third choice in the right-click menu. Disconnect SAN Gateway Figure 5-28: Disconnect Via Right-Click Health Check The Health submenus allow you to determine the status of the selected ADIC Gateway.
can also be selected from the right-click menu. In Tree View, Perform Health Check select the ADIC Gateway, and then scroll down to the fourth option, Perform Health Check. Figure 5-30: Perform Health Check Via Right-Click This check is performed regardless of the Health Check Interval setting. Setting displays the control panel shown in Figure 5-31.
allows you to choose how thorough the health check will be when it is Level performed. Each level is defined as follows: Table 5-1: Health Check Levels Level # None Basic Function Interface Test Device Test Device Ready allows you to enter, in minutes, the amount of time that elapses between Interval automatic health checks on the selected ADIC Gateway.
Events Submenus under allow you to control the way the event log is displayed Events and how traps are generated. Figure 5-32: Events Submenu displays a list of entries in the event log for the selected ADIC View Event Log Gateway.
are displayed at the top of the list. Selecting will display Warning Warning events. Notice Figure 5-33: Event Viewing Levels Selecting will display events. Figure 5- Information Information Warning Notice 34 contains the contents of a typical Event Log. Figure 5-34: Typical Event Log If the log is lengthy, you can navigate through it by using the scroll bar.
enter a name for the file and the location where you want to save it. Figure 5-35 shows the browser dialog. Figure 5-35: Save Event Log Dialog Box After saving the log, you have an option that clears the whole Event Log on the selected ADIC Gateway.
Attention: Do not change trap thresholds unless recommended by your service representative. Figure 5-37: Set Event Threshold A threshold level of zero disables traps for that event. A threshold level of one means that a trap is sent each time the event occurs. Any other value (up to 255) specifies how many times the event can occur in a ten-minute period;...
specified number of events must occur within a ten-minute period or no trap will be issued. Figure 5-38: Change Event Threshold Dialog Box is the last option on the Events submenu. It controls whether Receive Event Traps your ADIC Management Console client receives trap notifications for the ADIC Gateways you are monitoring in your current view.
close it. You can double-click on an event in the window to display more detailed information. Figure 5-39: Received Event Trap Window In Figure 5-39 the Event Trap window contains some typical Health Check events. You can also see, for example, that the ADIC Gateway at IP address 192.168.30.200 went down (“failed heartbeat occurred”) at 4:46 p.m.
Figure 5-41: Save Configuration Dialog Enter a Name for the ADIC Gateway configuration you wish to save or select one from the list of configurations already on the server. You can save the configuration to a local file ( ) or to a file on the server ( Save Locally Save on Server or both.
Before you choose the file, however, the ADIC Gateway sends you a warning. Figure 5-43: Warning Before Loading a Configuration See Figure 5-43. If you decide not to replace the configuration, press Otherwise, press You have the option to load a configuration from a file that Yes.
Figure 5-45: Load a File From the Server Attention: If you replace the ADIC Gateway and do not load the saved configuration, you might not be able to use the storage devices attached to the ADIC Gateway or data may be lost.
Controls Menu Group allows you to control how the selected ADIC Gateway Controls Menu Group and attached devices perform. To access a specific channel control, select the channel in Tree View before pulling down the Controls menu. Figure 5-46: Controls Menu Feature Enable Use this menu if you want to enable the optional, licensed features Virtual Private ®...
Feature Enable: Virtual Private SAN Virtual Private SAN allows you to control access permission between FC hosts (HBAs) and storage devices (Target LUNs) attached to the ADIC Gateway. If you need to enable this feature, you must have the License Key that corresponds to the serial number of your ADIC Gateway.
Virtual Private Map allows you to control access permissions between SCSI hosts and storage devices (Target LUNs) attached to the ADIC Gateway. If you need to enable this feature, you must have the License Key that corresponds to the serial number of your ADIC Gateway.
Data Mover allows you to use Server-Free tape backup applications that support SNIA Extended SCSI Copy. Enabling this feature allows the ADIC Gateway to move blocks of data directly between storage devices attached to the ADIC Gateway. When you select , you are presented with the Controls >...
. If a feature has not been enabled it will be grayed out on the Virtual Private Map menu. See Figure 5-51. Figure 5-51: Selecting An Access Control Option The Access Control option settings are also available from the right-click menu. See Figures 5-52, 5-54, and 5-56.
using the right-click menu. It does not need to be first. Enabled Channel Zoning the fifth option on the right-click menu. See Figure 5-52. Figure 5-52: Access Options: Channel Zoning Channel Zoning allows you to configure zones to restrict access between SAN connections and SCSI Channels.
Access Options: Virtual Private SAN Virtual Private SAN provides you with a finer degree of access control between host bus adapters in individual systems and Target LUNS on storage devices. VPS can be used to allow multiple Fibre Channel hosts connected directly or via switches and hubs to be able to share the same SCSI or Fibre Channels while restricting their access to selected LUNs.
Once you have Virtual Private SAN, you can open the Virtual Private SAN Enabled settings box by selecting the ADIC Gateway in Tree View, and then going to . You may also choose to use the Controls > Access Options > Virtual Private SAN right-click menu.
Figure 5-55 shows the Virtual Private SAN Access Settings window. For a full explanation of Virtual Private SAN, see “Installing and Using Virtual Private SAN” on page 121. Figure 5-55: VPS Access Settings Access Options: Virtual Private Map VPM is a software feature of the ADIC Gateway that allows any SAN device to map to any desired ID/LUN on a SCSI attached host.
right-click menu. is the seventh option on the right-click menu. Virtual Private Map See Figure 5-56. Figure 5-56: Right-Click Menu: VPM Controls Menu Group...
The VPM settings dialog box consists of two panels. See Figure 5-57. Figure 5-57: SCSI Devices Available For Mapping With VPM Drag devices from the Available LUN column and drop them in the Assigned LUN column next to the desired ID and LUN to make them available on the selected SCSI channel.
SNMP Community Strings This menu option will display a dialog (Figure 5-58) that allows you to modify the SNMP community strings for the ADIC Management Console. They are stored on the Server. Figure 5-58: SNMP Community Strings SNMP community strings serve to group network devices into logical collections for management purposes.
is the eighth option in the list. See Figure 5-59. Unless you have selected Channel a SCSI channel in Tree View, the option will be grayed out. SCSI Channel Figure 5-59: SCSI Channel Parameters Via the Right-Click Menu Figure 5-60 shows you the parameters for a selected SCSI channel. Figure 5-60: SCSI Channel Controls Attention: If you change any of the SCSI Channel Parameter settings, you have to reset the SCSI Channel or reboot the ADIC Gateway to use the new settings.
Page 123
is typically assigned as 7. Host ID You can press the button to rescan the SCSI bus so the ADIC Rescan SCSI Bus Gateway can discover devices that have been added or removed. It also refreshes the data for the devices on the SCSI channel and updates the display. is typically enabled.
to keep your changes and return to the main screen. If you press , two warnings about the SCSI reset are issued. See Figures 5-61 and 5-62. Figure 5-61: First SCSI Reset Warning Figure 5-62: Second SCSI Reset Warning Fibre Channel Fibre Channel shows you parameters for the selected Fibre Channel interface.
Figure 5-63. Unless you have selected the Channel, the Fibre Channel option will be grayed out on the menu. Figure 5-63: Fibre Channel Parameters Via the Right-Click Menu Attention: If you change any of the Fibre Channel Parameter settings, you have to reset the Fibre Channel or reboot the ADIC Gateway to use the new settings.
node. The frame size should typically be set to 2048. (It may be appropriate to use another frame size if required by a particular software application.) Figure 5-64: Fibre Channel Default Settings Figure 5-64 shows the default Port Mode setting, which is “Target.” The default connection option is “Loop.”...
Mapping dialog box via the right-click menu. See Figure 5-65. Device Mapping the fourth choice from the bottom. Figure 5-65: Device Mapping on the Right-Click Menu Attention: Making changes to LUN assignments in the persistent address map database can affect Virtual Private SAN and Virtual Private Map access settings. If you assign different LUNs to devices that were under VPS or VPM access control, the same LUN could become associated with different devices and data would be lost.
After you have finished editing the device map, you must reboot the ADIC Gateway for any changes to take effect. Figure 5-66: Devices Available for Mapping In Figure 5-66, several SCSI and Fibre devices are displayed all of which are available for mapping.
For more information on Channel Numbering, see Appendix F: Channel Number Reference. Figure 5-67: Device Mapping Window As shown in Figure 5-67, devices that have already been entered into the persistent device map appear in black type on the left. The Device Mapping Window uses the format 'Channel [Target ID:Device LUN] after the text string “SCSI”...
SCSI devices. When you are satisfied with the assignments that have been made, press . If you decide not to make any changes, press Cancel Figure 5-68: Devices That Have Been Remapped From the ADIC Management Console, select the Gateway, then from the Controls menu, choose Reboot the host, or use some other method to Restart SAN Gateway.
The default device type is SCSI, see Figure 5-69. Fill in the desired Channel Number, Target ID and LUN Number for a SCSI device. Figure 5-69: Add New SCSI Device If the device to be added is a Fibre Channel device, use the pull-down to select Fibre, and then fill in the desired LUN and the WWN of the device, if known.
LUN of 1. It appears in the right-hand column of the Device mapping screen. See Figure 5-71. Figure 5-71: New SCSI Channel Device Make sure that each device in the right-hand column is mapped to a LUN in the left-hand column, or the window will not close.
Update Firmware With the ADIC Gateway selected in Tree View, you can use the Controls > Update option to update ADIC Gateway operational firmware or you can use it to Firmware send micro-code to SCSI target devices as a means to update their firmware. You can also access the file browser by using the right-click menu.
Attention: You must stop all activity from all of the attached hosts before you update ADIC Gateway firmware. After you update ADIC Gateway firmware, you must reboot the ADIC Gateway to use the new firmware. Figure 5-74: Update Firmware Restart SAN Gateway After you select an ADIC Gateway in Tree View, you can use the Controls >...
Attention: Restart stop sending commands to devices attached to the ADIC Gateway or it will cause timeouts or other failures to be reported on the host system. When you select Restart SAN Gateway Figure 5-76: Warning Before Restarting an ADIC Gateway Identify ADIC Gateway Identify SAN Gateway Pressing the...
It has no interface dependencies and supports Fibre Channel, SCSI or any other SAN interface. It is also indepen- dent of the storage elements and requires no change in legacy or new storage devices.
7. When VPS is enabled for the first time, it takes a “snapshot” of the existing configuration. VPS automatically assigns access between HBAs and the storage elements that they currently have access to so that an existing configuration will not be affected. This means that online hosts attached to an ADIC Gateway will continue to retain their current access permissions to storage elements.
using the ADIC Management Console to manually enter the “unknown” host information and assign access privileges to LUNs. Installing the Host Registration Service If there are multiple hosts connected to the SAN, the system administrator cannot easily tell which host is associated with each WWN. Unless it receives a periodic status indication from the host, VPS cannot determine whether a host stays online (connected and running) or goes offline (disconnected or shutdown);...
As a convenience to you, VPS will inherit host access privileges to storage elements on an existing ADIC Gateway configuration. VPS will automatically assign host access to the same storage elements that the hosts have been using. If you want VPS to inherit host access permissions, go to the section “Installation Steps for an Existing SAN Gateway”...
If the ADIC Management Console Server and Client are already running and you are already logged in with administrative privileges and connected to the ADIC Gateway, go to step 4. If not, start the Server and Client, login as the administrator and connect to the ADIC Gateway.
In the Tree View panel of Figure 6-1, you can see that the host is connected to ADIC Gateway Fibre Channel port 1. In the text string after the host icon in Tree View, you can read the WWN of the HBA and the beginning of the network name of the computer.
10. Repeat steps 8 and 9 until all hosts are displayed. Figure 6-3 is an example that shows how two registered hosts are displayed. Figure 6-3: Confirming That Two Registered Hosts are Online Installing Virtual Private SAN...
11. Expand the tree to display storage devices and determine their assigned LUNs. Figure 6-4 shows the Assigned LUN for the selected SCSI device on SCSI Channel 3. Figure 6-4: Determining the Assigned LUN The Assigned LUN for the selected device is displayed in the first line of the Disk Device description area.
13. From the ADIC Management Console, select the ADIC Gateway. From the menu, select Controls Virtual Private SAN window that does not yet have any access settings. Figure 6-5: Initial VPS Window before Access Assignments Registered hosts are shown in the column on the left. When a host is online, its name is in black.
the mouse over the other host’s name. A pop-up with host parameters will appear. See Figure 6-6. Figure 6-6: VPS Host Parameters Pop-Up 14. Use the scroll bar below the squares to scroll right or left and locate the desired LUN. Assign host access to a LUN by pointing the mouse to a square in the Assigned LUNs area and clicking.
be removed. Figure 6-7 is an example of the VPS Access Settings window after access settings have been made. Figure 6-7: Assigning Host Access Permissions For more information about the device at a specific LUN, you can hover the mouse over the Assigned LUN number in the header row. See Figure 6-8. The pop-up will state the Channel Number, Target ID and Device LUN vendor ID, and serial number of the device.
90. Installation Steps for an Existing SAN Gateway Note: This procedure assumes that the storage devices, ADIC Gateway and hosts are turned on and the ADIC Management Console software has already been installed. The hosts need to be online to inherit their current access privileges when you enable VPS.
Page 149
1. The default Channel Zoning settings allow any-to-any access. If you did not change the default settings, go to step 2. Otherwise, if you have changed Channel Zoning settings to create restricted access zones, confirm that you want to keep those settings and restrictions. If you want to keep those settings, go to step 2.
hosts are displayed. Figure 6-8 is an example that shows how registered hosts are displayed. Figure 6-8: Two Hosts Online In the Tree View panel of Figure 6-8, you can see that hosts are connected to the ADIC Gateway Fibre Channel ports 1 and 2. In the text string after the host icons in Tree View, you can read the WWN of the HBAs and the beginning of the network names of the computers.
patch level, and other host connection information (SCSI map from the host point of view) for a selected host from the Data panel. Figure 6-9: Detail of Tree View Panel Installing Virtual Private SAN...
Gateway channel that each LUN is on and see how the ADIC Gateway has made LUN assignments by pressing the main screen. 10. Expand the tree to display SCSI or Fibre Channel storage devices and determine their assigned LUNs. Figure 6-11 shows the Assigned LUN for the Access Options > Virtual Private SAN...
selected SCSI device on SCSI Channel3. The Assigned LUN for the selected device is displayed in the first line of the Disk Device description area. In this example, the assigned LUN for the selected disk device is 1. Figure 6-11: Checking the Assigned LUN 11.
WWN of the host in the VPS Access Settings window and the other fields are shown as “unknown” you can change them to meaningful parameters. The WWN is acquired automatically and it does not need to be changed. You can also enter the WWN for a host that is not yet attached to the SAN (see “Adding and Removing Hosts”...
Page 155
Host Name: Host Type: Host Connection: Indicates the way the host has mapped its connection to the Host WWN: Entering Host Parameters Usually the name of the computer on the Local Area Network (LAN). System administrators use this name to refer to the host.
Figure 6-13: Entering Parameters for a Fibre Channel Switch Figure 6-13 shows the Host Type pop-up list and an example of parameters that were entered for the Fibre Channel switch. Changing Access Permissions Attention: Ensure that the host is not accessing the device LUN if you intend to remove its access privileges.
From the ADIC Management Console, select the ADIC Gateway. From the menu, select to display the VPS Controls Access Options > Virtual Private SAN Access Settings window as shown in Figure 6-14. Figure 6-14: Changing Access Permissions You can use the scroll bar below the squares to scroll right or left and locate the desired LUN.
Determining LUN Assignments You can expand the tree to display SCSI Channel storage devices and determine their assigned LUNs. Figure 6-15 shows the Assigned LUN for the selected SCSI device on SCSI Channel 3.
Adding and Removing Hosts After VPS is already enabled, you may want to add a Host (or Initiator) to the SAN configuration or remove it from the SAN configuration. This section describes how to add and remove hosts. Adding a Host to the SAN Configuration You can connect a new host to the SAN at any time.
Adding a Host Before Attaching it to the SAN You can add a host that has not yet been attached to the SAN and configure its access permissions beforehand. You add the host by pressing the New Host button in the VPS Access Settings window and manually entering the WWN and other parameters as shown in Figure 6-16.
Follow these steps to finish configuring VPS: 1. If you need to determine LUN assignments for the devices you want to assign to the new host, refer to the section “Determining LUN Assignments” on page 142. 2. Refer to the section “Changing Access Permissions” on page 140 to assign access permissions for the new host.
Page 162
that you edit the zones to permit all SAN Connections to have access to all SCSI channels, or you may end up with inaccessible devices that you had intended to be accessible. Combining VPS with Channel Zoning...
VPM expands the usefulness of legacy SCSI hosts in the new SAN infrastructure. It allows for the creation of independent pri- vate maps. • VPM technology enables Storage Area Networks to create a daisy-chain of virtual, multiple SCSI devices connected to a sin- gle SCSI host. •...
Enabling Virtual Private Map By default, VPM is not enabled. Virtual Private Map is an optional feature that requires you to enter a software license key to activate it. You may need to obtain the key where you purchased the ADIC Gateway. Use the Feature Enable option of the Controls menu to enable VPM.
2. After the VPM feature is enabled, select the SCSI channel where the host attaches and check the channel mode display in the right-hand panel to be sure it is set to Target. See Figure 4. Figure 7-1:SCSI Channel Set to Target If it is not, select the SCSI Channel, go to radio button.
displayed in the Virtual Private Mapping window. The Fibre Channel devices on Fibre Channel 3 in Figure 7-1 are displayed in Figure 7-2. Figure 7-2:Initial VPM Mapping Window (Fibre Devices) 5. In Figure 7-2 you can see how these devices look to the ADIC Gateway before they have been assigned to a SCSI host channel.
The Assigned LUN column of the VPM display provides map space for IDs 0- 15 associated with the selected SCSI channel, LUNs 0-7 associated with each ID, and a box into which a device from the Available LUN column can be dragged and dropped in order to occupy a particular ID and LUN on the SCSI host channel.
Map Devices on a SCSI Channel to a SCSI Host 1. With the ADIC Gateway selected, choose (see instructions on page 96). If this feature is unavailable or is already enabled, it will be grayed out on the menu. 2. After the VPM feature is enabled, select the SCSI channel where the host attaches and check the channel mode display in the right-hand panel to be sure it is set to Target.
displayed in the Virtual Private Mapping window. The SCSI devices shown in Tree View in Figure 7-4 are shown in the VPM window in Figure 7-5. 5. In Figure 7-5 you can see how these devices look to the ADIC Gateway before they have been assigned to a SCSI host channel.
LUN in the Assigned LUN column. When a target device has been mapped, it appears gray in the Available LUN column (see Figure 7-6). Figure 7-6:VPM Mapping Changes Made (SCSI Devices) 6. The ADIC Gateway’s persistent device map contains the product ID, Vendor ID and Serial Number of SCSI devices it knows about.
9. Reboot the host, or use some other method to ensure the host rescans for devices. Removing Devices From VPM 1. With the SCSI channel that is set to Target selected, go to Options > Virtual Private Map. its view of all available and mapped devices. 2.
Chapter 8: Maintenance Action Plans This section describes the maintenance action plan for the ADIC Gateway Start MAP Always start problem determination here and review the following steps. Gather as much information as possible before performing a repair action. When gathering information, you may need to connect the service terminal to the service port.
Check for Problems on Attached SCSI Devices Check the following on the SCSI devices to determine whether they are the source of the problem: • LEDs • Display panels • Firmware levels • Operability Check FC Host Versions For an updated list of supported ADIC Gateway host platforms and Fibre Channel Host Bus Adapters, visit “Service and Support”...
3. Hardware version information is viewed by using the sysVpdShow command from the service terminal. If your service representative determines that the hardware version is at issue in your situation, you may need to use the "sysVpdShow or sysVpdShowAll" command on page 277. Check Event Log For information on accessing the Event Log, see “Events”...
4. Go to Tools > Health Check > Setting Health Check > Perform Health Check 5. Write down the event codes reported by the Health Check procedure. 6. If Health Check cannot be performed using the client application, use the hlthChkNow command from the service terminal.
Page 178
Table 8-2: Service Reference Table Event Viewing Code Level Default Trap Description Threshold Generic Event Descriptions Sense data recorded following a check condition NOTE: Normally, the host system will request and process send data and then perform error recovery LUN reports a “unit attention” condition on a non-removable media device ADIC Gateway reports a...
Page 179
Table 8-2: Service Reference Table Event Viewing Code Level Start MAP Default Trap Description Threshold ADIC Gateway processor memory fault detected Fibre Channel interface detected a LIP Fibre Channel interface reports a loop up Fibre Channel interface reports a loop down ADIC Gateway PCI bus parity error detected ADIC Gateway PCI interface...
Page 180
Table 8-2: Service Reference Table Event Viewing Code Level Default Trap Description Threshold An interface has detected a device fault (event message indicates the specific interface) A SCSI interface reported an unexpected disconnect by a device A parity error was detected on a SCSI bus Fibre Channel Port Database change detected...
Page 181
Table 8-2: Service Reference Table Event Viewing Code Level Start MAP Default Trap Description Threshold Power has entered Alarm Range Inlet Air, Outlet Air, or I/O Processor temperatures have entered Nominal Range from a Warning or Alarm Range Inlet Air Temperature has entered Warning Range from Nominal Range (heating up) or Alarm Range (cooling...
Page 182
Table 8-2: Service Reference Table Event Viewing Code Level Default Trap Description Threshold Maximum number of initiators has been exceeded The event log is about to overwrite the earliest events Health Check Event Descriptions Power supply is out of specification Temperature change detected since the last report (event message indicates the change...
Table 8-2: Service Reference Table Event Viewing Code Level N.A. N.A. N.A. N.A. Check the Event Log to find out which interface (FCAL or SCSI) caused this event. Then use the appropriate action number. This trap signals a change in state. A string sent with the trap will indicate the nature of the previous state.
Table 8-3: Action Reference Table Action Number Go to “Fibre Channel MAP” on page 178 Go to “ADIC Gateway MAP” on page 182 Go to “Temperature MAP” on page 184 Go to “Power MAP” on page 184 Go to “DDF Board MAP” on page 185 Go to “Ethernet MAP”...
1. Connect the service terminal to the Service Port (see “Connecting to the Service Port” on page 217). 2. Press the Enter key on the service terminal. If the prompt is not displayed, go to “Service Port MAP” on page 191 to determine whether the RS-232 cable and service terminal are working properly.
3. If the host attached to a SAN connection is not able to access a Fibre Channel device on another SAN connection, then go to “Check Fibre Channel Initiator Port Mode” on page 170. Check SCSI Channel Devices 1. Enter the scsiShow command from the service terminal. If all of the attached SCSI devices are not displayed, go to “SCSI MAP”...
5. Enter the vpsInactiveSet command from the service terminal. 6. Startup one of the hosts. 7. If the host can access all of the target devices, shut down the host and repeat steps 6 and 7 for each of the other hosts. 8.
service terminal are working properly. Otherwise, look for the last status message “Done executing startup script”. 4. Enter the showBox command from the service terminal (see See “Service Port Command Reference” on page 223) 5. Write down the information for each SCSI channel (e.g., “SCSI -1 requires Low Voltage Differential cable”).
2. If the attached SCSI devices are all supported devices, go to “SCSI Loop Back Test” on page 175. Check SCSI Bus Termination Attention: If in this procedure you determine that you need to remove a SCSI cable or terminator, all I/O to the ADIC Gateway must be stopped and the ADIC Gateway must be turned off.
2. Check that only one device is set to each ID for each SCSI channel. 3. If a target device is set to the same ID as the ADIC Gateway (ID 7), the bus will be unstable and data corruption may result. 4.
1. Look for damaged cables. Check for breaks in the cable jacket, exposed or frayed cable shield, exposed or broken wires. Replace any damaged cables. 2. Look for inadequate cables. Older SCSI cables may not be suitable for running at Ultra2/3 speeds. Be sure all cables are rated for Ultra2/3. Replace any that are not.
must be disconnected from the ADIC Gateway. Before changing any SCSI cables, all I/O to the ADIC Gateway must be stopped and the ADIC Gateway must be turned off. Do not perform SCSI loop back tests on SCSI channels that are attached to SCSI target devices.
3. If the ADIC Gateway’s command prompt on the terminal is not diagmode > place the ADIC Gateway in diagnostic mode (see “Diagnostic Command Reference” on page 295). 4. Turn off the ADIC Gateway. 5. Draw a diagram of the devices and their connections to the SCSI channels. 6.
10. Review the host event log (see “Check the Host Event Log” on page 160). 11. If SCSI errors are found, then inform the system administrator that the connected device appears to be bad. Replace or remove any bad devices. 12.
or response • The Fibre Channel interface reports an excess of 10 LIPs in a 10- minute interval • Other Fibre Channel errors reported • FC connection LED is off Verify Fibre Channel Connections 1. Connect the service terminal to the Service Port (see “Connecting to the Service Port”...
1. Write down the core/cladding diameter printed on the cable jacket. Also write what Fibre Channel port it was plugged into. 2. For each Fibre Channel that is listed as FCOLW, check the core/cladding diameter on the jacket. Only cables with 9/125 diameter are acceptable. Replace any 50/125 or 62.5/125 cables with the 9/125 rating, then retest (see “Perform Health Check”...
Testing Fibre Channel Optical Cable Note: If the Fibre Channel cable is extremely long, it may be more practical to replace the Fibre Channel device first; then if the problem is not resolved, replace the cable. 1. Turn the ADIC Gateway off. Mark and remove optical cables from both the ADIC Gateway and their attachments.
ADIC Gateway MAP These steps are performed if - • You were directed here from the “Power MAP” on page 184 because all of the LEDs are off. • You were directed here from the “Power MAP” on page 184 because the Power LED is on but the Ready LED is not blinking once per second.
Page 199
8. Wait at least one minute. Then check to see whether the Ready LED is blinking. If the Ready LED is not blinking once per second, replace the ADIC Gateway Base. Go to “Prepare the New Base Unit” on page 206. 9.
Temperature MAP Perform these steps if: • The ADIC Gateway reports a temperature warning or alarm. • The Temp Warn or Temp Alarm LEDs are on. Check Environmental Conditions The ADIC Gateway is specified over an operational temperature of 10 C - 40 C (50 F -104 F).
source. • Verify the operation of other equipment connected to the same AC power source. • If the power source is good, then go to “Check Fuses.” • Connect the ADIC Gateway into an active AC power source; turn on the ADIC Gateway, verifying the status of the Power LED. If the LED lights, obtain a new power source for the ADIC Gate- way.
Page 202
1. If Event Code 69 is repeatedly reported, replace the DDF Board. See“Removing and Installing the DDF Board” on page 204. If there is a single occurrence of Event Code 69, proceed with this MAP. 2. Connect the terminal to the Service Port (see “Connecting the Service Terminal”...
Testing DDF with PMC Cards Removed 1. Open the ADIC Gateway by performing the following: • “Handling Electro Static Discharge-Sensitive Parts” on page 197 • “Preparing for Removal and Replacement” on page 198 • “Removing the ADIC Gateway” on page 199 •...
Page 204
2. Verify that the Ethernet Link LED, which is the green LED on the left, is on. If the LED is on, go to step 3. If it is not on, go to “Final Diagnostic Tests” on page 208 and return it with your unit. Exit this MAP. 3.
Page 205
11. From the service terminal, enter the ifShow command (see “Service Port Command Reference” on page 223). Gateway > ifShow lnPci (unit number 0): Flags: (0x63) UP BROADCAST ARP RUNNING Internet address: 192.168.1.56 Broadcast address: 192.168.1.255 Netmask 0xffffff00 Subnetmask 0xffffff00 Ethernet address is 00:60:45:0d:00:c1 Metric is 0 Maximum Transfer Unit size is 1500...
Page 206
Display of successful PING test: Gateway > ping “192.168.1.1”, 10 PING 192.168.1.1: 56 data bytes 64 bytes from 192.168.1.1: icmp_seq=0. time=0. ms 64 bytes from 192.168.1.1: icmp_seq=0. time=0. ms 64 bytes from 192.168.1.1: icmp_seq=0. time=0. ms 64 bytes from 192.168.1.1: icmp_seq=0. time=0. ms 64 bytes from 192.168.1.1: icmp_seq=0.
one provided by the network administrator. If both addresses are the same, go to step 25. Gateway > gateAddrGet Gateway Address set to 192.168.1.1 value = 0 = 0x0 22. If the network gateway address is incorrect, set it to the value provided by the network administrator using the gateAddrSet command.
5. If the cable is good, remove it from the other computer 6. Go to “Check Connection with Boot Messages” below. Check Connection with Boot Messages 1. Reconnect the terminal to the ADIC Gateway with the RS-232 null modem cable. 2.
Page 209
5. Use the p command to display the contents of the bootline. [VxWorks Boot]: p boot device processor number file name inet on ethernet (e) : 10.0.0.41:fffffc00 gateway inet (g) flags (f) target name (tn) startup script (s) other (o) 6.
Page 210
9. Wait for Gateway to finish booting. diagInit ============================== Diagnostics Version 2.04 ============================== value = 0 = 0x0 SRS Disabled, License is Invalid Done executing startup script ffs0:/mt/diagnstk.rc - Service Port Reflected Signal Test Starting shell Gateway > 10. Start the DDF test. Diagmode>...
Page 211
7 Passed Burst PCI-0 Passed Burst PCI-1 Passed MemSize PCI-0 is 64 Mbytes MemSize PCI-1 is 64 Mbytes Burst Address PCI-0 ...Passed Burst Address PCI-1 ...Passed RP DMA PCI-0 Passed RP DMA PCI-1 Passed Data Sharing Passed Page Xing PCI-0 ...Passed Page Xing PCI-1 ...Passed DDF Test PASSED value = 0 = 0x0...
Page 212
12. Reboot and wait for firmware to start. Gateway > reboot 13. Manually invoke repeated data path tests. Use the repeat command to iterate the ddfc command. In this example ddfc will be run 200 times. If an error occurs then the Gateway will be rebooted and re-enter the Bus_Fault_Detected state.
Chapter 9: Removal and Replacement Procedures This section describes the ADIC Gateway removal and replacement procedures. Handling ESD-Sensitive Parts Attention: Always wear an electrostatic discharge (ESD) wrist strap properly connected to the ESD ground bracket when you service this machine. How to Attach the ESD Wrist Strap Before you touch any ESD-sensitive part, place the ESD wrist strap on either wrist.
Parts. • Keep the ESD-sensitive part in a static-protective bag until you are ready to install the part into the machine. • Make the fewest possible movements with your body to prevent an increase of static electricity from clothing, fibers, carpets, and furniture.
sent you here. Figure 9-2: Key to Back Panel ADIC Gateway Attention: Follow all ESD-sensitive parts procedures while performing this procedure. For ESD information, see “Handling Electro Static Discharge-Sensitive Parts” on page 197. This procedure describes how to remove and replace the ADIC Gateway in a rack. This procedure must be followed whenever an FRU is to be replaced.
5. Remove the rackmount ears (D) Figure 9-3: Removing the Unit from a Rack Cabinet Replacing the ADIC Gateway 1. If replacing a desktop ADIC Gateway, install the rubber feet on the new unit (see “Desktop Configuration” on page 18). After installing the feet, go to step 2.
tive Parts” on page 197. This procedure describes how to remove and replace the cover. Refer to See Figure 9-4 while performing this repair action. Removing the Cover 1. Mark and remove the ADIC Gateway cables (see “Preparing for Removal and Replacement”...
4. Install the four retaining screws (A). PCI Mezzanine Cards (PMCs) Attention: Follow all ESD-sensitive parts procedures while perform- ing this procedure. For ESD information, see See “Handling ESD- Sensitive Parts” on page 197 This procedure describes how to remove and replace the Fibre Channel PMC card.
10. Pull the PMC out of the ADIC Gateway and place it in a static-protective bag (D). Figure 9-5: Removing PMC Option Card Replacing the PMC 1. Hold the PMC at a 45 angle from the ADIC Gateway base, with the external connector facing down.
DDF Board Attention: Follow all ESD-sensitive parts procedures while perform- ing this procedure. For ESD information, see “Handling ESD-Sensi- tive Parts” on page 197. This procedure describes how to remove and replace the DDF board. Refer to See Figure 9-6 while performing this repair action. Removing and Installing the DDF Board 1.
4. Install the five retaining screws securing the DDF board to the motherboard (A). 5. Replace the cover (see See “Replacing the Cover” on page 201) Go to See “Final Diagnostic Tests” on page 208 Fuse Removal This procedure describes how to remove and replace the fuses. Refer to See Figure 9-7 when performing this repair action.
3. Make sure the latch engages (B). 4. Connect the power cord to the power source. 5. Turn on the ADIC Gateway. Base Unit Attention: Follow all ESD-sensitive parts procedures while perform- ing this procedure. For ESD information, see “Handling ESD-Sensi- tive Parts”...
Bulkhead Panel Attention: Follow all ESD-sensitive parts procedures while performing this procedure. For ESD information, see “Handling ESD-Sensitive Parts” on page 197. This procedure describes how to remove and replace a bulkhead panel. The bulkhead panel covers unused PMC slots. Refer to Figure 9-8 while performing this procedure.
3. Insert and tighten the retaining screws (A). Final Diagnostic Tests After a FRU has been replaced, a complete diagnostic check must be performed to verify the new FRU and to ensure that no new problems have been introduced. For further information about the procedures and commands used in this section, see: •...
Page 225
7. If the test passed, go to Step 8. If not, go to “Start MAP” on page 157. 8. Attach the Fibre Channel loop back plug to slot 4. 9. From the service terminal, enter the fcSlotTest 4 command. 10. If the test passed, remove the loop back plug and go to Test Fibre PMC Slot 2. If not, go to “Start MAP”...
9. From the service terminal, enter the fcSlotTest 6 command. 10. If the test passed, remove the loop back plug and go to Ultra SCSI Tests. If not, go to “Start MAP” on page 157. Ultra 2/3 SCSI PMC Tests 2/3 SCSI PMC S LTRA 1.
Ultra SCSI Tests SCSI P 1. Attach the appropriate VHDCI loop back cable between slots 1 and 2. 2. From the service terminal, enter the scsiChannelTest 1,2 command. 3. If the test passed, remove the loop back cable and go to Ethernet Test. If not, go to “Start MAP”...
Updating the ADIC Gateway 1. From the service terminal, enter the hardwareConfig command to update the ADIC Gateway’s Vital Product Data (VPD). 2. From the service terminal, enter the normalBoot command. 3. Wait until the ADIC Gateway has finished booting. 4.
Page 229
Table 9-1: Post-Repair Checklist Step Ensure that the FC hosts are turned off. if not, disconnect the FC cables now. Attach the service terminal to the ADIC Gateway Turn on the ADIC Gateway. Wait for the ADIC Gateway to finish booting.
Page 230
Table 9-1: Post-Repair Checklist Step Perform the following: 1. Start the ADIC Management Console server and client, logon with administrator privileges and connect to the ADIC Gateway 2. If you downloaded new firmware in Step 5 of “Updating the ADIC Gateway”...
Page 231
Table 9-1: Post-Repair Checklist Step 1. If you discon- nected the FC cables in Step 2 above, reconnect them now. 2. Turn on (or reboot) the FC hosts. 1. From the service terminal, enter the fcShow command to show the status of each FC inter- face that is installed and con-...
Page 232
Table 9-1: Post-Repair Checklist Step Disconnect the RS-232 cable from the ADIC Gateway and from the service terminal. return it, the SCSI loop back cable, FC loop back plug, and Ethernet loop back plug to the Service Tool Kit. End of repair. Actions Comments and References None.
Appendix A: Connecting to the Service Port The service port is an RS-232C Data Terminal Equipment (DTE) port, configured at 19200 Baud, with 8 data bits, no parity and hardware flow control. The 9-pin connector is compatible with serial ports on PCs. A PC may be used to connect to the service port, using a 9-pin to 9-pin null modem cable.
Table A-1: DB-9 RS-232 Connector Pin Assignments Ring Indicator Table 2 lists the null modem cable connections. Table A-2: Null Modem Cable Connections Service Port Pin Number Carrier detect (not used) Receive data <-> Transmit data Transmit data <-> Receive data Data terminal ready <->...
Initial Setup of HyperTerminal This section shows the steps to setup using the HyperTerminal program. Other terminal emulation programs operate in a similar fashion. 1. Connect the null modem cable (and the 9- to 25-pin adapter if applicable) between the computer serial (COM) port and the ADIC Gateway Service Port. 2.
transfer files. Other terminal emulation programs operate in a similar fashion. The Zmodem send and receive functions in some terminal emulation programs automatically issue the command string “rz” before sending a file and the command string “sz” before receiving a file. However, even if the program you are using automatically sends the “rz”...
Loading a Configuration File 1. From the Hyper Terminal window, at the Gateway > command prompt, type rz and then press the 2. From the HyperTerminal window select 3. From the Send File is located or click the select Zmodem If HyperTerminal reports an error, try to send the file again.
Page 238
Table A-3: Zmodem Status Codes Status Description Code File size error - file size is different than it was supposed to be Invalid file type Too many retries - degraded link Position Error - file data has been lost Zmodem Status Code Table...
Appendix B: Service Port Command Reference A “shell” interface provides access to management and configuration commands. The shell is accessible by connecting a terminal or computer with terminal emulation software to the ADIC Gateway’s Service Port. The ADIC Management Console application should be used for managing the ADIC Gateway.
Page 240
Table B-1: Commands Grouped By Function Group gateAddrSet host “add” host “ delete “ ” host list hostNameSet icmpstatShow ifShow inetstatShow ipstatShow macShow mbufShow route route “ ” route “ delete route “ list ” snmpCommunitiesShow snmpReadCommunityAdd snmpReadCommunityRemove snmpTrapCommunitySet snmpWriteCommunityAdd Set network gateway address Add host table entries Delete network host table entries...
Page 241
Table B-1: Commands Grouped By Function Group snmpWriteCommunityRemove tcpstatShow trapDestAdd trapDestRemove trapDestShow udpstatShow userAdd userDelete userList Event Logging cleShow cleShowAll loggerDump loggerDumpCurrent supportDump Fibre Channel fcConnTypeGet fcConnTypeSet snmpWriteCommunityRemove Description Remove Community name Write permission Display statistics for TCP Add recipient IP address to trap destination table Remove recipient IP address from trap destination table...
Page 242
Table B-1: Commands Grouped By Function Group fcPortModeGet fcPortModeSet fcRestart fcShow fcShowDevs fcShowNames setFcFrameSize setFcHardId setHost targets Flash File System Description Display the mode for the specified Fibre Channel port Set the mode for the specified Fibre Channel port Restart the specified Fibre Channel port Display Fibre Channel interface status...
Page 243
Table B-1: Commands Grouped By Function Group Health Check hlthChkIntervalGet hlthChkIntervalSet hlthChkLevelGet hlthChkLevelSet hlthChkNow Help clehelp diagHelp help hlthChkhelp mapHelp netHelp snmpHelp userHelp Product Data and Maintenance clearReservation dataScrubberDisable dataScrubberEnable hardwareConfig hlthChkIntervalGet Description Display Health Check Interval Set Health Check Interval Display Health Check Level Set Health Check Level Perform a Health Check Now...
Page 244
Table B-1: Commands Grouped By Function Group initializeBox licenseShow mapCompressDatabase mapRebuildDatabase mapShowDatabase mapShowDevs mapWinnowDatabase shellLock showBox sysConfigShow sysVpdShow sysVpdShowAll ridTag version uptime Description Restore factory defaults by deleting all configuration files including persistent address map and VPS databases and then reboot Display information about installed software license keys...
Page 245
Table B-1: Commands Grouped By Function Group SAN Access Security vpsAccessApply vpsAccessClear vpsAccessSet vpsActiveSet vpsConnectionSet vpsFeatureEnable vpsHostShow vpsInactiveSet vpsNameSet vpsShow vpsSparseAccessSet vpsTypeSet SCSI fcShowDevs scsiAltIdGet scsiAltIdSet vpsAccessApply Description Apply access settings and save in Virtual Private SAN database Disable Virtual Private SAN access to all LUNs for all hosts Set Virtual Private SAN access permission for a specific host and...
Page 246
Table B-1: Commands Grouped By Function Group scsiHostChanGet scsiHostChanSet scsiHostIdGet scsiHostIdSet scsiRescan scsiResetDisableGet scsiResetDisableSet scsiShow scsiTermGet scsiTermSet targets xscsiAltIdGet xscsiAltIdSet xscsiHostChanGet xscsiHostChanSet xscsiHostIdGet xscsiHostIdSet Description Display SCSI Host Channel Modes Set SCSI Host Channel Modes Display SCSI Host ID numbers Set SCSI Host ID numbers Rescan for devices on one or all SCSI Channels...
Page 247
Table B-1: Commands Grouped By Function Group xscsiRescan xscsiResetDisableGet xscsiResetDisableSet xscsiTermGet xscsiTermSet Startup diagBoot normalBoot reset reboot Virtual Private Map copyScsiAssign deleteScsiAssign setScsiAssign showScsiAssign vpmFeatureEnable xscsiRescan Description Rescan for devices on one or all Ultra 2/3 SCSI Channels Display SCSI Bus Reset on Power Up Settings for Ultra 2/3 SCSI Channels Set the SCSI Bus Reset on Power...
Page 248
Commands This section describes the commands that are available to control, manage, and service the ADIC Gateway. The commands are listed in alphabetical order for easier reference. Each command displays a status “value” in decimal and hexadecimal after execution and before a new prompt is displayed. Usually a value of 0 indicates success, but some commands may return a different value.
Page 249
The above example shows the clearReservation command being used to clear a reservation on a target device at LUN 4. cleHelp The cleHelp command displays a list of the Command Log Event facility commands. Gateway > cleHelp CLE - Command Log Event facility cleShow <lun>...
Page 250
dataScrubberEnable Issue this command to enable the Memory Scrubber, an independent low-priority task that checks the full data buffer space, approximately once per hour. Gateway > dataScrubberDisable value = 1 = 0x1 Gateway > deleteScsiAssign [dev ID],[channel], [id],[lun] Deletes an assignment previously created diagBoot This command is used only to transition the ADIC Gateway from normal operation to the special diagnostic mode.
Page 251
cable See User’s Guide for more information value = 0 = 0x0 Gateway > disableCC [option number] Disable the command and control interface (LUN 0) using the disableCC command. Specify one of two option parameters as follows. Option number The ADIC Gateway is addressable as a SCSI target device, for command and control support.
Page 252
enableCC To restore the capability to send commands to the command and control interface (LUN 0), use the enableCC command. The command is typically used to re- enable the interface after it was disabled by the disableCC command. Gateway > enableCC value = 0 = 0x0 ethAddrSet The ethAddrSet command changes the IP address of the ADIC Gateway.
Page 253
The following example shows how the connection type is displayed when Fibre Channel port 1 is specified and its connection type is loop. MyGateway > fcConnTypeGet 1 value = 0 = 0x0 MyGateway > fcConnTypeGet 2 value = 0 = 0x0 MyGateway >...
Page 254
Attention: You must issue the fcRestart command or reboot the ADIC Gateway for the new setting to take affect. See the fcRestart command for further information. fcPortModeGet [port] The fcPortModeGet command displays the mode for the specified Fibre Channel port. The default port mode is Public Target. See also the fcPortModeSet command Parameter Port...
Page 255
The port must be in Initiator mode if you want the ADIC Gateway to scan for target devices on the port. When the port is in Private Initiator mode, ADIC Gateway only scans for devices on the local loop. If the port mode is in Public Initiator mode, the ADIC Gateway also scans for devices attached to a Fabric.
Page 256
fcShow [level] The fcShow command displays the channel status for each Fibre Channel interface. Level 0 or sets the verbosity level to the display in the example below <blank> displays the information displayed below, and appends a break- out for each channel that includes Node Type, Node Name, Port Name and Port ID displays the information included at levels 0 and 1, and appends loop ID link stats...
Page 257
• Ready • Sync Lost • Error • Nonparticipating • Failed Firmware Version Loop ID Fabric Attached Port Mode fcShowDevs The fcShowDevs command displays information about the devices that are accessible from each Fibre Channel interface. The display shows the LUN that the ADIC Gateway has assigned to each device, the SCSI Channel that the device is fcShowDevs and process logins with all...
Page 258
attached to, the actual SCSI ID and LUN of the device, the vendor, product, revision and serial number of the device. MyGateway > fcShowDevs FC 1: LUN Chan ----------------------------------------------------- FC 4: LUN Chan ----------------------------------------------------- value = 6 = 0x6 MyGateway > fcShowNames The fcShowNames command displays the node and port names (addresses) of the Fibre Channels.
Page 259
PCI Addr ISPType Node Name Port Name gateAddrGet The gateAddrGet command displays the default network gateway address if one has been set. This address is used when connections are made to a different subnet and there are no explicit routes defined for that subnet. Consult your network administrator for more information on the default gateway (sometimes referred to as default router) address.
Page 260
card types. The service representative enters the hardwareConfig command after replacing any FRUs. This causes the ADIC Gateway to update the VPD. Gateway > hardwareConfig ==== Recording Hardware Configuration ==== Scanning PMC option slots... Scanning SCSI IO Modules... Checking memory sizes... MemSize PCI-0 is 64 Mbytes ...Done value = 0 = 0x0 Gateway >...
Page 261
See User’s Guide for more information value = 0 = 0x0 Gateway > hlthChkHelp The hlthChkHelp command displays a list of the Health Check commands. Gateway > hlthChkHelp hlthChkHelp Control Interface option 1 - Report as Invalid (AIX mode) option 2 - Fully disabled enableCC Enable Command and Control Interface...
Page 262
hlthChkIntervalGet - Show Check Interval hlthChkIntervalSet <interval> - Set Check Interval hlthChkLevelGet - Show Check Level hlthChkLevelSet <level> - Set Check Level hlthChkNow - Run Health Check Now See User’s Guide for more information value = 0 = 0x0 Gateway > hlthChkIntervalGet The current Health Check interval can be viewed using the hlthChkIntervalGet command.
Page 263
Gateway > hlthChkNow The hlthChkNow function causes the ADIC Gateway to execute an immediate, level 4 Health Check. Results are displayed that will indicate which devices or subsystems failed the check. Gateway > hlthChkNow Health Check: Starting level 4 check Health Check: Step 1 -- Checking System Health Check: Step 2 -- Checking Interfaces Health Check: Step 3 -- Checking Devices...
Page 264
200.0.0.42 socrates 200.0.0.45 plato 200.0.0.47 fred Note: The host file does not exist until you enter the host “ add ” command. Gateway > host “add”,"plato","200.0.0.45" Gateway > host delete “ The host “ delete ” command deletes the named host from the hosts table and hosts file.
Page 265
The host utilities maintain a host file, ffs:/mgnt/hosts, which is used at system startup to initialize the network hosts table. This table associates network names with IP addresses. Use of the hosts table is entirely optional, but might facilitate frequently needed connections. Each host entry is a single line of the format: IP-address where...
Page 266
value = 0 = 0x0 Gateway > icmpstatShow The icmpstatShow command displays ICMP statistics for the Ethernet network. Interpreting these statistics requires detailed knowledge of Internet networking protocols. This information may be useful to the LAN administrator. Gateway > icmpstatShow ICMP: 0 call to icmp_error 0 error not generated because old message was icmp...
Page 267
0 input errors; 0 output errors 0 collisions value = 18 = 0x12 Gateway > inetstatShow The inetstatShow command displays statistics about Internet protocol sockets for the Ethernet network. Interpreting these statistics requires detailed knowledge of Internet networking protocols. This information may be useful to the LAN administrator.
Page 268
badhlen badlen fragments fragdropped fragtimeout forward cantforward redirectsent value = 1 = 0x1 Gateway > licenseShow The licenseShow command displays information about software license keys that are installed and the corresponding features that are available. The following example shows an ADIC Gateway that contains a license key for the VPS and Data Mover features.
loggerDumpCurrent [level] Dump records from the system event log to the console with the loggerDumpCurrent command. Only records logged since the system was booted are dumped. Level specifies the event log level for the events as follows Table B-2: Event Log Levels Level Name Notice...
Page 270
VXWORKST.Z SNA.RC MGMT value = 0 = 0x0 Gateway > To obtain detailed information about the file, use the ll command instead. macShow The macShow command displays the Media Access Control (MAC) address for the Ethernet interface. Gateway > macShow Enet MAC Address: 0.60.45.d.0.80 value = 33 = 0x21 = '!' Gateway >...
Page 271
should be cleared because LUN assignments may change! Do you want to compress the Device Map? (y or n) y 0xc1689ac0 (tShell): Wrote 23 device maps to file 'ffs:config/ device.map' Device Map Compressed - Do you want to clear VPS Access Settings? (y or n) y VPS Access Cleared value = 23 = 0x17 Gateway >...
Page 272
This may be required when a host system has a limited number of logical units that may be supported, and changing devices on the ADIC Gateway has caused the logical unit numbers to increase beyond the host’s supported level. Gateway > mapRebuildDatabase This command will clear the Persistent Device Map.
Page 273
Chan TLun mapShowDevs The ADIC Gateway maintains a cross-reference map of device addresses. Information about the presently attached and available devices in the map can be displayed using the mapShowDevs command. Gateway > mapShowDevs devId Type Chan iId iLun UID -------------------------------------------------------------- 00000000h SCSI 002...
Page 274
tLun Handle mapWinnowDatabase Occasionally, you may want to eliminate inactive entries from the database. The mapWinnowDatabase command reduces the database to only the devices presently attached. The address mapping of the current devices will not be altered. Gateway > mapWinnowDatabase 0xc0ac8340 (tShell): Wrote 4 device maps to file 'ffs:config/ device.map' value = 4 = 0x4...
Page 275
SONAME : ZOMBIE : SOOPTS : FTABLE : RIGHTS : IFADDR : TOTAL number of mbufs: 40 number of clusters: 4 number of interface pages: 0 number of free clusters: 4 number of times failed to find space: 0 number of times waited for space: 0 number of times drained protocols for space: 0 value = 47 = 0x2f = '/' Gateway >...
Page 276
normalBoot Certain commands and tests are only available in diagnostic mode. Switching to diagnostic mode saves all configuration parameters so that they are restored before returning to normal operation. Use the normalBoot command to restore the ADIC Gateway to normal operating conditions. This command is used only to transition an ADIC Gateway from the special diagnostic mode to normal operations.
Page 277
If the ridtag command is entered with a string, that string becomes the RID tag recorded for the unit. Gateway > ridtag “12D345677” *** value = 0 = 0x0 If a string is not entered, the existing RID tag is displayed. Gateway >...
Page 278
subnet 10.0.0 (implied netmask is 255.255.255.0) is sent to the host “bruno” for forwarding. By default, no routes are defined in the route file. The route command is invoked to add, remove, and list the route table. route “ ” The route “...
Page 279
has completed, the ADIC Gateway copies the firmware modules to nonvolatile flash memory. The ADIC Gateway must be rebooted to use the updated firmware. Gateway > rz **B000000023be50 Firmware Update in Progress... Found Image File BOOTROM.IMG – loading ...Found Image File IPOST.IMG – loading ...Found Image File SPOST.IMG –...
Page 280
For information about Ultra2/3 SCSI channels, see the xscsiAltIdGet com- mand. scsiAltIdSet [channel],[id] The scsiAltIdSet command sets the Alternate Id for the specified SCSI Channel. Gateway > scsiAltIdSet 2,6 Alternate Id set to 6 for SCSI 2 will take effect upon reboot value = 0 = 0x0 Gateway >...
Page 281
scsiHostChanSet [channel],[mode] The scsiHostChanSet command sets the Channel Mode to Target or Initiator for the specified SCSI Channel. SCSI Channel number Mode Gateway > scsiHostChanSet 2,1 Host Chan set to TRUE for SCSI 2 will take effect upon reboot value = 0 = 0x0 Gateway >...
Page 282
For information about Ultra2/3 SCSI channels, see the xscsiHostIdGet com- mand. scsiHostIdSet [channel],[id] The scsiHostIdSet command sets the Host ID for a specified SCSI Channel. Gateway > scsiHostIdSet 2,7 Host Id set to 7 for SCSI 2 will take effect upon reboot value = 0 = 0x0 Gateway >...
Page 283
is returned on completion. When a device is discovered, there may be further device specific initialization that continues after the scan has completed in which case the device may not show up immediately when you issue the fcShowDevs command. An example of this is a disk that requires a SCSI Start Unit command to become ready.
Page 284
will take effect upon reboot value = 0 = 0x0 Gateway > To specify Bus Reset Settings for Ultra2/3 SCSI channels only, see the xsc- siResetDisableSet command scsiShow The scsiShow command displays all SCSI channels and information about the devices attached to each channel. The following example shows the display for two disk devices attached to SCSI Channel 1 and a tape library attached to SCSI Channel 2: Gateway >...
Page 285
Width scsiTermGet [channel] The scsiTermGet command displays termination status information for the specified channel. If no channel is specified, status information is displayed for all SCSI channels. Gateway > scsiTermGet SCSIbus Termination ------- SCSI 1 Enabled – default SCSI 2 Enabled value = 0 = 0x0 Gateway >...
Page 286
setFcFrameSize [channel],[size] Set the frame size for a channel using the setFcFrameSize command. If an invalid size is set, then the fame size of 2048 will be used. Attention: You must reboot the ADIC Gateway after executing this command for the new setting to take effect. Gateway >...
Page 287
presented to the particular operating system. If [port] is 0, the change applies to all SAN connections; otherwise the host type is applied. Parameter Port Attention: You must reboot the ADIC Gateway after executing this command for the new setting to take effect. setScsiAssign [devID], [channel], [id], [lun] Assigns a target device to a SCSI channel [channel] with SCSI Target ID [id] and Logical Unit Number of [lun].
Page 288
If the new LUN is not currently in use, a new entry is added in the device map and database. A trap will be generated indicating the new device was added. If the new LUN is already in use, the Command and Control LUN will be disabled. It will remain disabled until the device mapped at the requested LUN is removed and deleted from the database.
Page 289
showBox The showbox command displays components of the ADIC Gateway using characters to form a picture of the unit, as viewed from the back of unit: SAN Gateway login : admin Password: Gateway3010 > showBox NOTICE: On-board SCSI-1 changed Front //| // /----/ // / // /...
Page 290
showScsiAssign Lists the current assigned addresses for the indicated channel. If channel is omitted, or is 0 (zero) then all assignments are shown for all Target channels. sncFeatureEnable "licensekeystring" The sncFeatureEnable command enables the optional Data Mover feature. You enable the feature by entering the unique license key. Gateway >...
Page 291
------------------------------ private value = 9 = 0x9 Gateway > snmpHelp The snmpHelp command displays a list of the snmp commands. Gateway > snmpHelp snmpCommunitiesShow snmpReadCommunityAdd "string" snmpReadCommunityRemove "string" snmpTrapCommunitySet "string" snmpWriteCommunityAdd "string" snmpWriteCommunityRemove "string" trapDestAdd "ipaddress" trapDestRemove "ipaddress" trapDestShow See User’s Guide for more information value = 0 = 0x0 Gateway >...
Page 292
snmpTrapCommunitySet string “ ” The snmpTrapCommunitySet command sets the community string passed with all SNMP traps. Gateway > snmpTrapCommunitySet “DISC Inc.” Success value = 8 = 0x8 Gateway > snmpWriteCommunityAdd string “ ” The snmpWriteCommunityAdd command adds the specified string to the list of accepted strings for SNMP Write operations (Set).
Page 293
sysVpdShow or sysVpdShowAll The sysVpdShow command displays Vital Product data information. The Vital Product Data for the ADIC Gateway includes such items as serial numbers and installed memory sizes, as shown below. Gateway > sysVpdShow ====== VPD ====== name SAN Gateway 00:60:45:16:01:04 100111 DISC, Inc.
Page 294
The sysVpdShowAll shows a little more information and includes product data for the Fibre Channel GBIC. Gateway > sysVpdShowAll ===[ Vital Product Data ]=== -=[ Base Assembly ]------- Name Gateway ADIC 00:60:45:16:01:04 100111 Assy HCO OTA08000H Board OntarioII 1.1 " S/N 08357659 Flash 2 Mbyte...
Page 295
targets The ADIC Gateway maintains a list of target devices that are attached to the I/O channels. The targets command will list each device currently attached, providing descriptions of the devices. Gateway > targets Idx Tdev Vendor ----------------------------------------------|---------------- ------------------- 0 0xc194a400 DISC, Inc. SAN Gateway Local 0252 | Cmd/Cntrl Status 0h 2 0xc1ffc390 IBM flags 7h...
Page 296
0 window probe packet 0 window update packet 0 control packet 516 packets received 272 acks (for 18372 bytes) 1 duplicate ack 0 ack for unsent data 276 packets (322 bytes) received in-sequence 0 completely duplicate packet (0 byte) 0 packet with some dup. data (0 byte duped) 0 out-of-order packet (0 byte) 0 packet (0 byte) of data after window 0 window probe...
Page 297
ADIC Gateway. When the ADIC Management Console is running, it inserts its address into the table automatically. The broadcast address for the Ethernet port is also automatically included in the table. Gateway > trapDestRemove “10.0.0.2” value = 0 = 0x0 Gateway >...
Page 298
uptime The uptime command displays the elapsed time since the last boot of the ADIC Gateway. Gateway > uptime Elapsed time since reset 4d:23h:12m:46s:10t value = 10 = 0xa Gateway > The example indicates that 4 days, 23 hours, 12 minutes, 46 seconds and 10 clock ticks have elapsed since the ADIC Gateway was last booted.
Page 299
userList The userList command displays the contents of the password file (passwords are encrypted). Gateway > userList Name : Password nancy : SyecycRz fred : b9dczebQbd martha : RQQdRedb9d admin : cScQRSQzzz value = 0 = 0x0 Gateway > userHelp The userHelp command displays a list of the user commands.
Page 300
key was factory installed, VPM is already enabled. See also the licenseShow command. Router> vpmFeatureEnable “H822F-KCRV2” value = 0 = 0x0 Router > vpsAccessApply The vpsAccessApply command causes the settings that have been changed and stored in memory to take effect immediately and also saves them to the VPS database.
Page 301
vpsActiveSet The vpsActiveSet command places VPS in the active state. The means that all of the current access settings are put into effect. You would typically only use this command after making VPS inactive. See the vpsInactiveSet command. Gateway > vpsActiveSet value = 0 = 0x0 Gateway >...
Page 302
vpsInactiveSet vpsNameSet [host index],"name string" vpsShow [host index] vpsSparseAccessSet [host index],"LUN string"<access> vpsTypeSet [host index]"OS type string" See User’s Guide for more information value = 0 = 0x0 Gateway > vpsHostShow [hostIndex] The vpsHostShow command displays all known Virtual Private SAN information for the specified host connection index.
Page 304
Hostindex Full display of all known host connections, and if online displays a list of all LUNs available to that connection N (1-48) Display the full information for the host N only The following command example shows VPS information for the hosts that have been registered by VPS.
Page 305
vpsTypeSet [hostIndex], The vpsTypeSet command sets the Operating System type for the specified host connection index. Existing hostindex values can be determined by looking at the “Id” column in the output of the vpsShow -1 command. OS can be “nt” “aix” “solaris”...
Page 306
xscsiHostChanGet [channel] The xscsiHostChanGet command displays Host Channel mode for a specified Ultra2/3 SCSI Channel. Gateway > xscsiHostChanGet 5 SCSIbus HostChan XSCSI Channel is Initiator value = -1 = 0xffffffff Gateway > For information about Host Channel modes for Ultra SCSI channels, see the scsiHostChanGet command.
Page 307
xscsiHostIdSet [channel], [id] The xscsiHostIdSet command sets the Host ID for a specified Ultra 2/3 SCSI Channel. Channel numbers 1 - 6 (Ultra2/3 SCSI) Id numbers can be0-15 Gateway > xscsiHostIdSet 5,9 Host Id set to 9 for XSCSI 5 will take effect upon reboot value = 0 = 0x0 Gateway >...
Page 308
device should be available to host systems with the same LUN as the old device. To rescan Ultra SCSI channels, see the scsiRescan command. xscsiResetDisableGet [channel] The xscsiResetDisableGet command displays the SCSI Bus Reset On Power Up setting for a specified Ultra 2/3 SCSI Channel. False means that SCSI Bus Reset On Power Up is enabled.
Page 309
value = 0 = 0x0 Gateway > For termination status Information for Ultra SCSI channels, see the scsiTermGet command. xscsiTermSet [channel], [termination] The xscsiTermSet command enables or disables the termination for an Ultra 2/3 SCSI Channel . Channel numbers termination 0 termination 1 Gateway >...
Appendix C: Diagnostic Command Reference This section is a reference for the procedures used when diagnostics are required. Boot Modes The ADIC Gateway has two modes of operation: normal mode and diagmode. Two commands are available from the service terminal to reboot the ADIC Gateway to the desired mode.
9. At the diagmode > prompt, proceed with the appropriate diagnostic tests. Restoring Normal Mode normalBoot is performed if the ADIC Gateway was placed in diagnostic mode and needs to be restored to normal operation. See "normalBoot" on page 298. 1.
3. Connect the terminal to the Service Port. 4. From the service terminal, type the hlthChkNow command. 5. Check the results displayed on the service terminal to determine the status of the interfaces and attached devices. If a failure is indicated, perform the appropriate MAP.
2. Press the Enter to “Service Port MAP” on page 191 to determine whether the RS-232 cable and service terminal are working properly. 3. From the service terminal, navigate to the “DUMP” directory by entering the cd “ /ffs/dump ” command. 4.
4. It reboots the ADIC Gateway. Diagnostic Commands This section is a reference for the commands that are available when the ADIC Gateway is booted in diagmode. 1. The command set is limited while in diagmode. You will need to use the showBox command and commands (with the suffix Test) when testing the DDFm Board, the Ethernet, Fibre Channel, and SCSI interfaces.
Page 316
7 Passed Burst PCI-0 Passed Burst PCI-1 Passed MemSize PCI-0 is 64 Mbytes MemSize PCI-1 is 64 Mbytes Burst Address PCI-0 ...Passed Burst Address PCI-1 ...Passed RP DMA PCI-0 Passed RP DMA PCI-1 Passed Data Sharing Passed DDF Test PASSED value = 0 = 0x0 ESCRIPTION OF This tests basic access to each “word lane”...
Page 317
Then the burst address test is run. This checks for errors in the memory array’s address logic. The dots represent a test progress display. Each dot represents 1/ 16 of the test complete. Burst Address PCI-0 ...Passed Burst Address PCI-1 ...Passed The next test is the deep burst test.
Page 318
If errors are detected, the test displays the number of bad test iterations as shown below. If your test was not successful, return to the MAP that sent you here. diagmode > elTest ==== Testing Ethernet ==== Init complete. Ethernet timeout error Ethernet timeout error Ethernet timeout error Ethernet timeout error...
Page 319
NSUCCESSFUL IBRE diagmode > fcSlotTest 2 FC 1 [##########] Iterations 37 Errors 37 - FAILED Fibre Channel Port 1 returns FAILED value = -1 = 0xffffffff = pNullDmaDesc + 0xfe4ea9f7 scsiChannelTest (x,y) The ADIC Gateway must be in diagnostic mode to use this command and a SCSI cable must be connected between two SCSI channels.
Page 320
showBox showbox command displays components of the ADIC Gateway using characters to form a picture of the unit, as viewed from the back of unit: SAN Gateway login : disc Password: Gateway3010 > showBox NOTICE: On-board SCSI-1 changed Front //| // /----/ // / // /...
Page 321
supportDump The supportDump command outputs the result of a number of Service Port commands in a standard way and in a specific order. The resulting file is used for troubleshooting. The individual commands called by supportDump are: envShow version showBox sysVpdShowAll sysConfigShow licenseShow...
Appendix D: Remote Event Notification Several features of the ADIC Management Console were designed to assist with the maintenance and service of the ADIC Gateway. These are described in the following sections. Event Logging and Viewing The ADIC Management Console allows you to retrieve and view event log information that is stored in the non-volatile memory of the ADIC Gateway.
displays level 2 and level 1 events. Level 0 events are displayed by the Client only when the viewing level is set to All Events. See Table 8-1. Figure D-1: Viewing Events in the Event Log Events and Traps Events are recorded in the ADIC Gateway event log. For each event, an assigned Viewing Level corresponds with the event log facility available to the Client application (all events are recorded in the ADIC Gateway log regardless of the assigned level).
This is an indication that a trap has been received and a message has been written to the Event Trap window Figure D-2 is an example of event trap messages in the Event Trap window. Figure D-2: Event Traps Displayed By Client The IP address of the ADIC Gateway, a date/timestamp (provided by the server) the Event Code and a brief description of the event are displayed.
heartbeat. However, it does attempt to notify a Client when a ADIC Gateway fails to respond. Heartbeat failures are assigned event codes and notifications are sent to the Client where possible. Heartbeat events are not logged in the event log because SNMP traps are not issued (traps can only come from a ADIC Gateway).
Health Check failure events are recorded in the event log and the trap is always sent on each occurrence. Figure D-3: Successful Health Check Health Check is enabled when the level is set to a value greater than 0. This can be set from the Client application or from the service terminal.
1 — Basic Function When set to the “Basic Function” level, the ADIC Gateway periodically scans the system resources to locate problems. Health Check status will be set if either of the following conditions is true: Temperature Sensors detect WARNING or ALARM status Power Supply sensors detect a change in status since the last report.
Health Check Interval The Health Check interval controls how often the Health Check process runs. The interval may range from 1 to 65,535 minutes. The default setting is 60 minutes. In Figure D-4, the interval has been reset to 1 minute. Figure D-4: Health Check Interval Performance Impact of Health Checks At higher levels (3 or 4), the Health Check process may interfere with high...
LIC Initialization Messages After the BootLoader finds and loads the license internal code (LIC), the Bootloader will transfer control and start ADIC Gateway operations. See the sample code on the next page. LIC Initialization Messages...
Page 334
Initializing Flash Initializing ffs0: Mounting ffs0: AutoSync disabled succeeded. ffs0: already initialized Adding 6687 symbols for standalone. Attached TCP/IP interface to lnPci unit 0 Attaching network interface lo0... done. NFS client support not included. ------------------------------------------- | SAN Gateway Firmware Version 0342 | Copyright Pathlight Technology, Inc, 1997-1999 | VxWorks version: 5.3.1 | KERNEL: WIND version 2.5...
Final Startup Messages In the final stage of the boot process, information is displayed about the firmware version, ADIC Gateway name, optional features that are enabled or disabled, SCSI Channels, and the IP address. In the example below, after the ADIC Gateway command prompt, a message is displayed as a result of a response from a host that is running the Host Registration Service for Virtual Private SAN access control.
This reference describes the convention used for channel numbers (also called port numbers) and PMC option card slots. Labels on the rear panel and LEDs on the front panel of the ADIC Gateway identify the channels, PMC slots and Storage Area Network connections. The ADIC Management Console software and service port commands associate these numbers to specific hardware connections.
Dual Port Fibre Channel PMC Option Card Numbering When three dual-port Fibre Channel PMCs are installed, the Fibre Channels are numbered from right to left as shown in Table F-3. Table F-3: PMC Dual Port Fibre Channel Assignments Ultra SCSI Channels SCSI SCSI...
skipped as shown in Table F-5, which shows an empty PMC slot and a mix of single and dual channel PMCs installed. Table F-5: Assignments for Single and Dual Port PMCs Ultra SCSI Channels SCSI SCSI SCSI SCSI Dual Channel Ultra2/3 SCSI PMC Numbers in Device Maps If you need to add or change a LUN assignment for a device attached to an Ultra2/ 3 SCSI channel, or you need to use the optional Virtual Private Map feature to...
Gateway rear panel graphic, the ADIC Management Console again refers to this channel as “1” Figure F-1: Dual Channel Ultra2/3 SCSI PMC Number in Tree View Display In the tabular information below the rear panel graphic, the ADIC Management Console displays a different number shown in Figure F-1 as SCSI Channel “5”. This is how the channel number is represented in the ADIC Gateway device map and in Virtual Private Map.
Appendix G: POST Error Codes The power-on self-test (POST) indicates DRAM test progress by flashing the front-panel SAN Connection and SCSI Channel LEDs in specific patterns. Figure G-1 shows the LED designation used for the decoding scheme. Progress messages are also sent to the Service Port and can be viewed on the service terminal.
Appendix H:Glossary Acronym BIOS DRAM HTTP JMAPI MTBF Glossary Meaning Basic Input/Output System Differential Ended Dynamic Random Access memory Data Terminal Equipment Electrostatic Discharge Electromagnetic Interference Field Replaceable Unit Graphical User Interface Host Bus Adapter Hypertext Transfer Protocol High Voltage Differential Input/Output Internet Protocol Java Management Application Programming...
Page 346
Point-to-Point Protocol Radio Frequency Interference Replacement Identification Remote Method Invocation Remote Procedure Call Real Time Operating System Storage Area Network Small Computer System Interface Synchronous Dynamic Random Access Memory Single-Ended Simple Network Management Protocol SAN Replication Services Transmission Control Protocol...
Need help?
Do you have a question about the Scalar 100 and is the answer not in the manual?
Questions and answers