Académique Documents
Professionnel Documents
Culture Documents
Customer Order Number: ONS-DOC-CCG-2200, Rev B1 Text Part Number: 690-0018-0001, B1 Cover Number: 695-0018-0001, B1
ONStor, Inc. 254 East Hacienda Ave. Campbell, CA 95008 (408) 963-2400
Copyright 2005-2007 ONStor, Incorporated. All rights reserved. This document exists for use with the products of ONStor, Inc. and is intended for use by employees, representatives, assigns, and clientele of ONStor, Inc. This document cannot be copied, reproduced, transmitted, or stored electronically, in part or in whole, without first obtaining the express consent and agreement of ONStor, Inc. This document can contain the names of products and services of other companies. Such products and services are the property of their owners, and ONStor, Inc. makes no implications or claims, express or implicit, to the ownership of such products and services. ONStor, Inc. has, in good faith, made efforts to represent trademarked and copyrighted products and services as the property of their respective owners .
Contents
Foreword ........................................................................................................ 5
Audience................................................................................................................................ ii-6 Scope ..................................................................................................................................... ii-7 Related Documentation ......................................................................................................... ii-8 Revision Trail........................................................................................................................ ii-9 Syntax Usage....................................................................................................................... ii-10
Displaying Current Settings in the OCT ............................................................................. 3-15 Committing Parameters ................................................................................................ 3-15 Exiting the OCT............................................................................................................ 3-16 Cluster Cables ..................................................................................................................... 3-19 Management Port Pinouts............................................................................................. 3-19 Cabling the Cluster.............................................................................................................. 3-20 Cabling Redundant SSC Paths...................................................................................... 3-21 Cable Dressing Guidelines ........................................................................................... 3-21
Setting Port Topology..................................................................................................... 5-4 Setting Port Interconnect Settings............................................................................ 5-6 Adding Disk Shelves in an Optimal Manner ........................................................................ 5-9 Creating and Configuring a VDisk...................................................................................... 5-11 Installing and Initializing a VDisk................................................................................ 5-11 Selecting Drives for the VDisk..................................................................................... 5-13 Configuring Volumes on the VDisk ............................................................................. 5-15 Manually Assigning VDisk Ownership........................................................................ 5-17 Managing LUN Ownership................................................................................................. 5-18 Moving VDisks and LUNs ........................................................................................... 5-18 Changing LUN Identifiers ............................................................................................ 5-20
Serial Port Settings for Initial Configuration ........................................................................ 8-2 Prerequisites of Configuration .............................................................................................. 8-3 Cluster Creation Procedure ................................................................................................... 8-5 Connecting Multiple Nodes............................................................................................ 8-8
ii-5
Preface
This preface contains the front matter for the Installation and Configuration Guide for the ONStor Bobcat 2200 Series NAS Gateway family of products. This foreword contains the following sections: Audience. Scope. Related Documentation. Revision Trail. Syntax Usage
690-0018-0001B1
ii-6
Audience
This guide is for IT professionals and storage administrators of varying levels who administer the ONStor family of 2200 NAS Gateway products and their companys storage area network (SAN).
690-0018-0001B1
ii-7
Scope
The High Availability Deployment Guide is helps to you install and configure the ONStor Bobcat 2200 Series NAS Gateway hardware, firmware, and software, and to set up the NAS Gateway in a cluster configuration.
690-0018-0001B1
ii-8
Related Documentation
This document is part of a set of product documentation for the NAS Gateway. Table F-ii-1 shows the related documentation.
Table ii-1 : ONStor Product Documentation Document Name
ONStor Bobcat 2200 Series NAS Gateway Command Reference ONStor Bobcat 2200 Series NAS Gateway Manager Administrators and Users Guide ONStor Bobcat 2200 Series NAS Cluster Manager Administrators and Users Guide ONStor Bobcat NAS Gateway System Administrators Guide
Part Number
ONS-DOC-CR-2200 ONS-DOC-GMGR D1 E1
Revision Level
ONS-DOC-CMA
B1
ONS-DOC-SAG-2200
E1
If you are managing the NAS Gateway through the ONStor NAS Gateway Manager GUI product, you can also the HTML version of the ONStor NAS Gateway Manager Administrators and Users Guide, which is built into the NAS Gateway Manager GUI. Release notes are available with every release of software. The release notes contain additional information about bugs and fixes in the product, documentation errata or omissions, and new features or enhancements.
690-0018-0001B1
ii-9
Revision Trail
This document is regularly reviewed and revised. Table F-3 shows the history of revision for this document. We recommend obtaining the latest information whenever possible.
Table F-3 : Product Documentation Revision History Document Name
ONStor Bobcat 2200 Series System Administrators Guide ONStor Bobcat 2200 Series System Administrators Guide ONStor Bobcat 2200 Series System Administrators Guide ONStor Bobcat 2200 Series NAS Gateway High Availability Deployment Guide ONStor Bobcat 2200 Series NAS Gateway High Availability Deployment Guide ONStor Bobcat 2200 Series NAS Gateway Cluster Configuration Guide ONStor Bobcat NAS Gateway Installation and Cluster Configuration
Part Number
ONS-DOC-SAG2200 ONS-DOC-SAG2200 ONS-DOC-SAG2200 ONS-DOC-HAD2200 ONS-DOC-HAD2200 ONS-DOC-HAD2200 ONS-DOC-CCG2200
Revision Level
A1 B1 C1 A1
Revision Date
01/18/05 03/16/06 05/08/06 01/18/05
B1
03/15/06
C1
08/17/06
B1
01/23/07
690-0018-0001B1
ii-10
Syntax Usage
The NAS Gateways command-line interpreter uses different syntax markers to indicate specific conditions of usage in the command line. Table F-4 shows the different syntax markers used in the command-line interpreter, and explains what each marker means.
Table F-4 : Syntax Markers Syntax Marker - (dash) blank space bold text bold italic text [ ] (squared brackets) Means... You are specifying an option You are delimiting words, arguments, or options in a command Command syntax A mandatory variable. You need to enter some input for italicized arguments. Input is optional. The command will complete with or without the optional argument. A logical or operation. Select one of the choices for the command to complete A choice is contained within the braces. The open brace ({) indicates the beginning of the choice list, and the closed brace (}) indicates the end of the choice list. Choice lists use pipes (described above) to delimit each element in the choice list. Enter one of the elements in the choice list exactly as it occurs in the list.
-a arp show
Example
list ipaddr
[-c CONTROLLER]
| (pipe) { } (braces)
disk|tape|all
{enable|disable}
690-0018-0001B1
690-0018-0001B1
1-2
Figure 1-1
Step 2: Attach the two IEC 320 power cables to the NAS Gateway. Plug each cable into the IEC 320 plugs, which are located on the rear
690-0018-0001B1
1-3
of the NAS Gateway, one plug on the left side and the other plug on the right side as shown in Figure 1-2.
Figure 1-2
Note! A redundant network configuration is the preferred setup. It is recommended that you always have redundant network connections so that a single failure does not shut down the management network, which makes recovery difficult. For a two-node cluster, you should have one connection to the main network and another connection with a crossover cable. For a cluster larger than two nodes, you should have one connection to the main network and another connection with a second switch (a setup described as a hybrid network).
Step 3: After plugging the two IEC 3320 power cables into the NAS Gateway, plug each power cord cable into a separate power outlet. The NAS Gateway contains load-sharing power supplies and for this reason requires two power outlets. To ensure failover, you must plug the power supplies into outlets that are on different AC circuits as shown in Figure 1-3.
690-0018-0001B1
1-4
Figure 1-3
Step 4: After verifying that both connections to the power facilities are correct, switch on the power supplies. The power supply activation switches, located on the rear of the NAS Gateway, are marked with an I (In) for on and O (Out) for off as shown in Figure 1-4. Press the I marker to turn on the power supply (the switch should rock upwards). Conversely, press the O marker to turn off the power supply (the switch should rock downwards). You should hear the power supplies activate when you turn them on. Also, the built-in fans start to operate at maximum speed, then slow to an operational speed. This behavior is normal.
Step 5: Check the LED lights on the front of the NAS Gateway after it completes its boot up phase. After power-up, the FLT LED will be red and then will turn off when the system is fully booted. At this point, the OK LED will then become green. The PS and FAN LEDs should also be green. The LEDs for GigE and FC ports behave as follows:
690-0018-0001B1
1-5
Green: port enabled, valid link Amber: port enabled, no link Off: port disabled
Note! If a cable is not plugged into a port, the corresponding LED will be amber assuming the ports have been enabled (which they are, by default, at the first installation). Once a cable is plugged in and a link is established, the LED will turn green.
Figure 1-4
690-0018-0001B1
1-6
690-0018-0001B1
690-0018-0001B1
2-2
Preinstallation covers planning and preparing the SAN network, storage subsystem, IP network, client environment, and backup/tape information. It consists of the following tasks: Physical site preparation: Site preparation includes ensuring: System environment has adequate rack space Redundant power available HVAC requirements are met Fiber raceway is in place for the new equipment Cable lengths are appropriate for the host locations Provide SAN configuration documentation, including: Switch port connections Host/LUN table Any switch zoning requirements if tape is required
Installation planning:
Provide a network diagram that includes details of the LAN/SAN switch and IP configuration pertaining to the environment Schedule a downtime window to configure and install ONStors configuration.
690-0018-0001B1
2-3
LUN allocation: All LUNs must be pre-allocated/zeroed available in a common zone Performance: To deliver the requested performance, adequate resources (such as spindle count), and appropriate policies, (such as read ahead), need to be used to create LUNs. Oversubscription: If the array is a shared resource, take steps to ensure that the array will not be oversubscribed by other applications. (ONStor access to the SAN administrator is highly recommended.) SAN: Two FC cables per node from the SAN in the same zone. (WWN can be provided by ONStor as needed.) For each node, up to four network ports are needed on the switch that connects the ONStor NAS Gateway. For each switch, provide the appropriate VLANs and configure its ether channel. Ensure that all Layer 3 network addresses, netmasks, and default routes are identified and allocated to the NAS Gateway. Provide the IP addresses for network servers (e.g. DNS, AD, NIS, and so forth). Set up access to the following servers as required: FTP server, NTP server, NIS server, SMTP server, and domain controllers. Have available at least one Windows client to run ONStor management software. Provide two high-performance clients to test the performance for each protocol. Provide the names of the users or groups who will have cluster administrative privileges.
Network setup: -
Security setup: -
690-0018-0001B1
2-4
Provide access to a domain administrator who has the capability to add a machine account to the domain.
690-0018-0001B1
2-5
System Configuration
System configuration consists of the following tasks and operations: Node installation: Physically installing one or more systems on the rack. Performing operating system (OS) upgrades, if needed. Laying out LUNs in a best practices manner. Checking supported array settings. Checking for pre-allocated LUNs. Creating or integrating the ONStor NAS Gateway into the current network. Use NTP for this operation. Connecting into the LAN switch. Setting up ether channel, if required. Connecting into the SAN switch, if required. Setting up IP addresses, default routes, and joining the ONStor NAS Gateway to the NIS/AD domain. Creating up to five virtual servers. For each virtual server volume, set up the snapshot utility as per each customers policy. Creating up to five file systems/shares and export each share according to each customers policy.
LUN integration:
Network integration:
690-0018-0001B1
2-6
Additional licensed products: Enabling all purchased software products. Clients: Validating that client operating system versions are supports. Installing NGM management software on any Windows systems.
Testing redundancy and high-availability features: Includes testing dual power, vserver failover, ether channel, and FC multi-pathing features. Testing client access: Checking that a file can be create from a client for each protocol, and the permissions should be appropriately set. For a multi-protocol environment, checking that the same file operations (create, read, and change permissions) can be performed via both protocols on the same file by users allowed file access by the default mapping. Recovering a file from the snapshot utility.
Establishing a performance baseline: Documenting the streaming performance of read and write operations for one to two clients per protocol. Documenting install: Collect support.sh.
690-0018-0001B1
2-7
Customer Orientation
Customer orientation involves transferring information to the customer, or customer education. It includes the following: Providing a system architecture overview Reviewing the basic system configuration, operation, and monitoring commands, including: Tour of the graphical user interface Instructions to create virtual servers, file systems, and shares Management of snapshots and file recovery from snapshots Explanation of how to create mirrors for a volume Product road map
Providing an overview of the customer support services: Includes creating an ASSIST account, opening a case, and downloading software.
690-0018-0001B1
2-8
690-0018-0001B1
690-0018-0001B1
3-2
Preconfiguration Considerations
Before configuring a cluster, you need to determine the following: The network on which you will support the cluster. All NAS Gateways in the cluster need to be configured on the same subnet. However, since SC1 and SC2 have to be on two different subnets, the SSC ports, FibreChannel ports and Gigabit Ethernet interfaces could be on different subnets. The number of NAS Gateway groups that each cluster will support. The number of NAS Gateways that each NAS Gateway group will support. The virtual servers you want to create in protected mode and the ones you want unprotected. The number of virtual servers that will be configured on each NAS Gateway. ONStor recommends that you balance the system usage between the NAS Gateways in the cluster.
690-0018-0001B1
3-3
From the terminal window, connect to the NAS Gateway. You are now ready to use the ONStor Configuration Tool (OCT), which is the firmware configuration tool. If you are just now booting (powering on) the NAS Gateway, the OCT runs automatically. If the NAS Gateway was booted prior to connecting to the device, then you need to start the tool: Enter OCT in the terminal window to start the tool.
690-0018-0001B1
3-4
For a comprehensive list of information elements required to configure the NAS Gateway, please see the ONStor Pre Configuration Checklist.
690-0018-0001B1
3-5
Select the Display Current Settings on the main menu to check your progress. Table 3-1 displays each task and explains its part in the configuration.
Note! The cluster network is configured on the management IP port on the SSC. Therefore, the management IPs are set using the OCT prior to the NAS Gateway joining the cluster. The management ports are labeled SC1 and SC2 for the left and right ports, respectively.
690-0018-0001B1
3-6
Controls
Setting parameters that you use to facilitate managing the NAS Gateway. For example, the system date and time are configured through this menu. Setting network parameters that enable the NAS Gateway to connect to IP clients. For example, default and specific routes are configured through this menu. Displaying sections of the OCT to determine which are configured. Applying parameters to the NAS Gateway as a batch. Before committing changes, it is a good practice to review parameters. Exiting the OCT. If you exit before committing changes, the NAS Gateway is not configured with any of the information that you entered, and the OCT will run the next time you log in.
See...
Completing the OCT on page 3-6
Network settings
Exiting the OCT on page 3-16 Committing Pending Parameters on page 3-15.
Exit
690-0018-0001B1
3-7
Welcome to the ONStor NAS Gateway Initial Configuration Tool The ONStor Configuration Tool (OCT) guides you through the initial setup of the ONStor NAS Gateway. Please refer to the Hardware Installation Guide and complete the hardware installation prior to configuring the NAS Gateway. To configure the NAS Gateway, you need to give the machine a unique name and provide IP addresses for the management network ports. Collect this information prior to continuing with the installation. The initial user name for this machine is 'admin'. The initial password is 'password'. Press 'Enter' to proceed to the main menu... Gathering system info, please wait...
690-0018-0001B1
3-8
To configure the cluster using the OCT, perform the following procedures: Step 1: Press Enter to begin the OCT and display the main menu. Information about each task is listed on the main menu, as displayed in Figure 3-2.
ONStor NAS Gateway Initial Configuration Tool 1. Configure Administrative Settings 2. Configure Network Settings 3. Display Current Settings 4. Commit Changes 5. Help 6. Exit Enter Selection:
690-0018-0001B1
3-9
Current time and date: Wed Jan 1. Set Time Zone 2. Set Time & Date 3. Help 4. Return to previous menu Enter Selection:
The following steps pertain to the functions available from the Administrative Settings submenu. Step 1: Enter 1, Set Time Zone, to set the time zone. If the Administrative Settings submenu displays the correct time zone, then skip this step. Step 2: Enter the number corresponding to the appropriate time zone from the list of time zones. It is important to set the time zone correctly since you later (during the software configuration phase) synchronize the management virtual server to the NAS Gateway. Press Enter to see additional time zones. (See Figure 34.)
690-0018-0001B1
3-10
Step 3: Press 1 to configure the time zone where the NAS Gateway is installed. When you press 1, a list of time zones is displayed, as shown in Figure 3-4.
Select a time zone from the list 1 US/Eastern 2 US/Central 3 US/Mountain 4 US/Pacific 5 Japan 6 Hongkong 7 Europe/London 8 Europe/Paris 9 Africa/Abidjan 10 Africa/Accra 11 Africa/Addis_Ababa 12 Africa/Algiers 13 Africa/Asmera 14 Africa/Bamako 15 Africa/Bangui Enter selection or press Enter to continue list (q to quit):
You can page through the list of time zones by pressing Enter, or you can quit the time zone list by pressing Q. Enter the number associated with the time zone you require, and the time zone is automatically programmed into the NAS Gateway. After the time zone is programmed, the OCT returns to the Date and Time menu.
690-0018-0001B1
3-11
Step 4: Enter 2 from the Administrative Settings submenu to set the current date and time. (See Figure 3-5.) Skip this step if the current time and date display is correct..
Current time and date: Sun Jan 9 11:20:25 PST 2006 Enter day, month, year (format: DD/MM/YY) Press 'Enter' to retain current date: Current time and date: Sun Jan 9 11:27:48 PST 2006 Enter time (format HH:MM:SS) Press 'Enter' to retain current time settings):
Enter the date in the following format: DD/MM/YY for the day, month, and year. For example, 03/07/06 is July 3, 2006. DD is a two-digit indicator from 01 to 31 that determines the day of the month. An invalid date can negatively affect the date stamp that the NAS Gateway uses. MM is a two-digit indicator from 01 to 12 that determines the current month. YY is a two-digit indicator from 00 to 99 where 00 is the first year of the century, and 99 is the last year of the century.
Note! If the currently programmed date is correct, press Enter to accept it.
Step 5: Similarly, set the time .Enter the current time in the following format: HH:MM:SS for hours, minutes, and seconds values. Use 24-hour time. For example, 20:30:13 is 8:30:13 PM whereas 08:30:13 is 8:30:13 AM. It is critical when later doing the software configuration that the time be set correctly This completes the administrative settings configuration. Enter 4 in the Administrative Settings submenu to return to the OCT main menu.
3-12
Set a node name for the NAS Gateway Configure the management network ports (referred to as the SC ports) Set a default route
Enter 2, Configure Network Settings, from the OCT main menu to open the Network Configuration submenu as shown in Figure 3-6.
Network Configuration 1. Set Node Name [ NOT_CONFIGURED ] 2. Configure Management Network Ports [ NOT_CONFIGURED ] 3. Set Default Route [ NOT_SET ] 4. Help 5. Return to Previous Menu Enter Selection:
The following steps pertain to the functions available from the Network Configuration submenu. Step 1: Set a node name that uniquely identifies this NAS Gateway within a cluster. Enter 1 at the Network Configuration submenu to bring up the prompt for setting the user-determined node name for the NAS Gateway. Step 2: The OCT prompts for a node name, as shown in Figure 3-7. Enter an identifying name, such as onstor1_lab. The name should be an alphanumeric string of up to 16 characters.
Note! Do not use the special characters *~? in a node name.
690-0018-0001B1
3-13
Node name must be unique to the cluster this node will join Enter Node Name:
Press Enter to return to the Network Configuration submenu. Step 3: Enter 2 to configure the management network ports. The Configure Management Network Ports screen displays. (See Figure 3-8.)
Configure Management Network Ports 1. Configure Port 1 [ IP: NOT_CONFIGURED netmask: NOT_CONFIGURED ] 2. Configure Port 2 [ IP: NOT_CONFIGURED netmask: NOT_CONFIGURED ] 3. Help 4. Return to Previous Menu Enter Selection:
You configure two management network ports, SC1 and SC2. Port 1 is the ethernet port for client access. Port 2 is used for clustering. Configure each port by entering its respective Internet Protocol (IP) address and subnet mask. This information is supplied by the customer. Step 4: Enter 1 to configure port 1. Enter the port IP address and subnet mask to the following prompts (see Figure 3-9):
690-0018-0001B1
3-14
Configure Management Network Ports Enter port 1's IP address: Enter port 1's address mask: Enter Selection:
Step 5: Enter 2 to configure port 2. The same prompts appear for port 2, to which you enter its IP address and subnet mask. Press Enter to return to the Network Configuration submenu. Step 6: Enter 3 at the Network Configuration submenu to set a default route. The following prompt appears (see Figure 3-10), to which you enter the IP address of the default route. The IP address for the default route is supplied by the customer.
Enter Default Route (n.n.n.n):
After you set the default route, the tool returns you to the Network Configuration submenu. Enter 4 to return to the OCT main menu.
Note! The default route must be on the same subnet as an SSC IP port to be displayed in the route table. After the NAS Gateway comes online, you can modify the default route by deleting and re-adding the default route by using the route delete default -g and the route add default -g commands, respectively.
Step 7: Verify that the current configuration settings are correct. From the OCT main menu, enter 3, Display Current Settings, to view the current configuration settings. The tool displays the Current Settings Report. Figure 3-11 shows an example of this report.
690-0018-0001B1
3-15
Step 2: After reviewing the Current Settings report, press Enter to close the report and return to the main menu. Step 3: Use the appropriate option on the main menu to make changes.
Note! If you need help to configure the OCT, use the Task Help, which is in the menu of each OCT task. To learn more about the concepts and operation of OCT, read the General Help text on the main menu.
Committing Parameters
After reviewing parameters, return to the main menu and press 4. The parameters are written to the NAS Gateways configuration file. When you commit parameters to the
690-0018-0001B1
3-16
NAS Gateway, they are written as a batch file. The NAS Gateway goes only online after you commit parameters. Before committing the configuration, verify all settings and correct any errors using the appropriate OCT function. Step 4: Commit the configuration. Enter 4, Commit Changes, on the OCT main menu to commit the configuration and build the configuration table. You configure each NAS Gateway device only once. Also, be sure to commit the configuration before exiting, since the configuration setup is lost if you exit without performing the commit. Step 5: Exit the OCT configuration tool. Enter 6, Exit, on the OCT main menu. You are asked to confirm that you are exiting the tool. (See Figure 3-12.)
Please answer 'yes' or 'no' Are you sure you wish to exit setup now? (Yes or No) Enter Selection:
Since all configuration data is discarded if you exit the OCT before committing the configuration, the tool warns you if you attempt to exit without committing the configuration setup. (See Figure 3-13.)
Changes have not been committed. Are you sure you wish to exit setup now? (Yes or No) Enter Selection:
3-17
changes have been made, or if they have been made but not yet committed, the OCT will inform you and ask you for confirmation. When changes have been made, and committed, the OCT exits without confirmation. When no changes have been made, follow the procedure as displayed in Figure 3-14.
The following must be configured prior to exiting the setup tool: The NAS Gateway name has not been set. It is recommended you configure the following prior to exiting the setup tool: Management Port 1 has not been configured Management Port 2 has not been configured You must configure mandatory settings prior to exiting. Press 'Enter' to continue...
690-0018-0001B1
3-18
When changes have been made, but not committed, follow the procedure as displayed in Figure 3-15.
Changes have not been committed. Are you sure you wish to exit setup now? (Yes or No) If answer is Yes, the bootup process continues but all changes are discarded If answer is No, returns to main menu
Figure 3-15 Exit OCT Confirmation Prompt: Changes Made but Not Committed
When changes have been made and they have been committed, no confirmation is required before exit. Follow the procedure as displayed in Figure 3-16.
Enter Selection: 6 Value Entered is 6 Starting network Add net default: gateway 10.2.0.1
690-0018-0001B1
3-19
Cluster Cables
The NAS Gateway contains a cluster accessory kit that contains crossover cluster cables to connect the NAS Gateways in a direct configuration that only works for twonode clusters. When you add multiple nodes in direct or hybrid configuration, use CAT-5 Ethernet cables. The following cables are used: Management cable for the CONSOLE port. This cable is provided with the SF4400 NAS Gateway. Pinouts are included in case you need to use additional cables. Management port cables for the NAS Gateways 10/100 RJ-45 ports.
690-0018-0001B1
3-20
Figure 3-17 shows the location of the two SSC management ports.
SSC Management port 1 and 2
Caution! ESD Sensitive Components! This product contains electronic components that are sensitive to electrostatic discharge (ESD). To avoid damage to the product or its components, ensure that you are wearing an ESD wrist strap, or are using an appropriate method of ESD protection prior to handling the product or any of its components.
690-0018-0001B1
3-21
Arrange cables through the cable hook and attach to the rack, as shown in Figure 3-18. Ensure that the screw that holds the unit in the rack is not obstructed. .
690-0018-0001B1
3-22
690-0018-0001B1
690-0018-0001B1
4-2
690-0018-0001B1
4-3
Verify the virtual servers configured on the NAS Gateway. You should check that the device has a management virtual server, which should have been created automatically and physically linked to the NAS Gateway, and which exists solely for management purposes. You will also be creating at least one virtual server, which enables client access to the file storage. This command shows all virtual servers configured on the NAS Gateway:
vsvr show
Verify the IP interfaces that exist and are up. The IP interface provides the means to connect the NAS Gateway to the clients IP network and every NAS Gateway must have at least one such I interface.
interface show interface
Verify the system version. This command shows the full configuration of the NAS Gateway, including all CPUs, PROMs, compact flash cards, and SC ports.
system show version
Verify all configured ports and check that their statuses are UP. This command displays the ports as SC1, SC2, and so forth.
port show all
Verify the virtual storage LUNs. LUNs, which represent virtual chunks of storage on the physical hard disks of the Storage Area Network (SAN), are configured and added to the storage pool by the customer. The NAS Gateway addresses a LUN via an IP address through a fiber channel switch, which converts the IP address to the addressing scheme used in the SAN network. This command displays a table of all LUNs, state, and the name of the NAS Gateway to which the LUN belongs:
690-0018-0001B1
For example, this command may produce a report similar to the following
All devices known to PCC. ========================= Device Name NEXSAN_5000402001 ec0590_6DCABA41 NEXSAN_5000402001 ec0590_6DCABAA6 NEXSAN_5000402001 ec0590_6D7791C0 NEXSAN_5000402001 ec0590_6D49C4D7 vol_mgt_495 NEXSAN_5000402001 ec0590_6D49C46B Model Disk Disk Disk Disk Raid Raid-5 Raid-5 Raid-5 Raid-5 Size(MB) State 9536.62 9536.62 9536.62 9536.62 free free Cluster onstor1_lab onstor1_lab diff Volume
Disk
Raid-5
9536.62
outCluster onstor2
core2
The PCC is the Primary Cluster Controller. The Device Name column identifies each LUN. The Cluster column indicates that NAS Gateway to which the LUN belongs, such as onstor1_lab or onstor2. A LUN can be in one of four states: - Out of clusterThis LUN is currently not in the cluster and not available to the cluster. It needs to be added to the cluster before it can be used. UsedThis LUN is assigned to a NAS Gateway and is unavailable to other devices. ForeignThe LUN has just been discovered and nothing is known about it. FreeThe LUN is available and free to use with a NAS Gateway.
690-0018-0001B1
4-5
You can verify that the time is properly synchronized using this command:
system time show -v
Next, add the NAS Gateway to a cluster. The following steps show how to join the NAS Gateway to cluster. Step 1: Add the NAS Gateway to the cluster. Specify the name of the NAS Gateway and its IP address.
cluster add nasgateway NASGATEWAYNAME -a IP address
Step 3: The NAS Gateway that you just added will reboot and join the cluster.
690-0018-0001B1
4-6
For example, to add the NAS Gateway to a Windows domain named effigy whose domain controller is at the IP address 10.2.128.141, and use the admin login name onstor, enter the command as follow
domain add windows effigy onstor 10.2.128.141
Step 2: Add the IP address for the NAS Gateway to the DNS server. This enables a client to access the NAS Gateway by name rather than having to use the IP address. Step 3: You add the IP address for the NAS Gateway to the DNS server by editing the DNS resolver configuration file. (The DNS resolver configuration file contains keyword/value pairs, and you need to add the DNS servers IP address value for the nameserver keyword. In addition, you can add domain and search information.) Use the following command to edit the configuration file:
system dnsconfigure resolver
Enter the nameserver keyword and the IP address value into the file that opens, along with domain and search information.
690-0018-0001B1
4-7
For example, if the IP address of the NAS Gateway is 10.3.35.1, you add the following to the file:
nameserver 10.3.35.1
The NAS Gateway is now added to the domain and can be located by the DNS name server. This also completes the configuration of the global domain context. The next set of configuration tasks apply to the management virtual server domain context.
690-0018-0001B1
4-8
You reference the management virtual server by name, which always begins with the name string VS_MGMT followed by a numerical ID. For example, if the management virtual server on the NAS Gateway is named VS_MGMT_512, the command looks as follows:
vsvr set VS_MGMT_512
After you change to the management virtual server domain, the terminal prompt, assuming the NAS Gateway is called onstor1_lab, is as follows:
onstor1_lab VS_MGMT_512 diag>
690-0018-0001B1
4-9
Since you are working in the context of the management virtual server, you create the volumes specifying the available LUNs to which they should be connected. If need be, before creating these volumes use the command lun show all to see the available (free) LUNs. Keep in mind the following information before creating these two volumes: Management volumeA management volume is used for Network Data Management Protocol (NDMP) buffering and for backup purposes. This volume is mounted by default. The management volume also holds all system logs, including output from the system get all script, which tracks configuration and troubleshooting information. The management volume size should be at least ten (10) gigabytes and preferably should be twenty (20) gigabytes. While the management volume must use at least one LUN, the number of LUNs it uses does not matter. Management volume use is not performance critical. Thus, if your storage configuration includes multiple types of storage, consider using your slowest storage for the management volume. Management volume availability is important. The management volume, although accessible through NFS and CIFS, should never be used to store your own data files. Because it uses the management volume for administrative purposes, the NAS Gateway may fill, delete, and overwrite files on the volume without notice.
Core volumeThe core volumes sole purpose is as a repository for the system to dump its raw memory in the event of a panic, thus preserving the raw memory for later analysis. Such core dumps are automatically generated if the NAS Gateway fails for some reason. The core volume does not contain a readable file system and does not appear as mounted. The amount of memory in the core volumes NAS Gateway owner dictates the volumes minimum size. If you attempt to create a core
690-0018-0001B1
4-10
volume too small for the NAS Gateway, the system prints an error and does not create the core volume. Step 1: Create the management volume. The command to create the management volume is:
system create mgmtVolume LUN
For example, if you are working in the management virtual server domain context and there is a free LUN device called NEXSAN_5000402001ec0590_6DCABA41, you create the management volume as follows:
system create mgmtVolume NEXSAN_5000402001ec0590_6DCABA41
Step 2: Create the core volume. The command to create the core volume is as follows:
system create corevolume core volume name LUN
For example, to create a core volume called core1 connected to the free LUN called NEXSAN_5000402001ec0590_6DCABAA6, you use this command:
system create corevolume core1 NEXSAN_5000402001ec0590_6DCABAA6
Step 3: You may want to verify that the two volumes were created correctly. Use the following command to see the volumes created on the management virtual server:
volume show
This command displays the following report for the VS_MGMT_512 management virtual server:
Name
Status
Type
Curre nt (MiB)
Hard Quot a
Use d
Avail
Usag e
VirtualServer
690-0018-0001B1
4-11
Standar d Core
9408. 62 0.00
No Limit No Limit
34.6 2 0.00
9374.0 1 0.00
0.37 % 0.00 %
VS_MGMT_51 2 VS_MGMT_51 2
You may also want to verify that the two volumes are associated to the LUNs you designated. Use the command lun show all. For example, the lun show all command displays the following information for the NAS Gateway onstor1_lab:
All devices known to PCC. ========================= Device Name NEXSAN_5000402001 ec0590_6DCABAB2 NEXSAN_5000402001 ec0590_6DCABA41 NEXSAN_5000402001 ec0590_6DCABAA6 Model Disk Disk Disk Raid Raid-5 Raid-5 Raid-5 Size(MB) State 9536.62 9536.62 9536.62 free used used Cluster onstor1_lab onstor1_lab onstor1_lab vol_mgmt_512 core1 Volume
690-0018-0001B1
4-12
Admin UP UP UP
IPCnt 0 0 0
Step 2: Create an interface to the management virtual server. When you create the interface, you provide a name for the interface, associate it to a logical port, and assign the interface an IP address. Use the following command (the -l option lets you specify the logical port for the interface, the -s option lets you indicate whether the interface is enabled or disabled, and the -a option lets you specify the IP address):
interface create interface name -l logical port -s enable|disable -a IP address
For example, the following command creates an interface called mgmt using the logical port fp1.0 and assigns it the IP address 10.3.35.52/16. The interface is enabled.
int create mgmt -l fp1.0 -s enable -a 10.3.35.52/16
Step 3: Add a route. A route is associated to an interface and is the means to access the interface. Use the following command to add a route:
route add default -g IP address
For example, the following command adds a route for an interface whose IP address is 10.3.30.1:
route add default -g 10.3.30.1
Step 4: Exit the management virtual server domain context. This completes the installation steps that involve the management virtual server. Use the following command to exit the management virtual server domain and return to the global domain context:
vsvr clear
690-0018-0001B1
4-13
To indicate that you are in the global domain, the terminal prompt displays only the NAS Gateway and no longer displays the management virtual server name. Step 5: Edit the DNS resolver configuration file using the command system dnsconfigure resolver. Enter the nameserver keyword and the IP address value into the file that opens, along with domain and search information.
nameserver IP address Domain domain name Search list_of_domains
After you complete the management virtual server installation and return to the global domain context, you can create the data storage servers.
690-0018-0001B1
4-14
Note that only the management virtual server, VM_MGMT_512, is defined for the NAS Gateway onstor1_lab. Step 2: Create a logical virtual server within the NAS Gateway and change to that servers domain context. Use the following command:
vsvr create virtual server name
For example, this command creates a logical virtual server called training on the NAS Gateway onstor1_lab and sets the context to that server:
690-0018-0001B1
4-15
The steps that follow pertain to this particular virtual server and commands are given from within its domain context. Step 3: Create an interface for a virtual server. Use the following command (the -l option lets you specify the logical port for the interface, the -s option lets you indicate the interface status either enabled or disabledand the -a option lets you specify the IP address):
interface create virtual server name -l logical port -s enable|disable -a IP address
For example, this command creates an interface to the logical virtual server training. In addition, it assigns the server the logical port fp1.0, enables the server, and gives it the IP address 10.4.43.35.53/16.
int create training -l fp1.0 -s enable -a 10.4.4 3.35.53/16 Note! You can use the same logical port for more than one server.
Step 4: Add a route to the virtual server interface to give clients access to the interface. Use this command:
route add default -g IP address
For example, the following command adds a route to the training virtual server interface at the IP address 10.3.35.1:
route add default -g 10.3.35.1
Step 5: Edit the DNS resolver configuration file using the command system dnsconfigure resolver. Enter the nameserver keyword and the IP address value into the file that opens, along with domain and search information.
nameserver IP address Domain domain name Search list_of_domains
690-0018-0001B1
4-16
For example, if the IP address is 10.3.35.1, you add the following to the file:
nameserver 10.3.35.1
For example, this command sets a Windows domain called cslab whose administrator user name is administrator. (You are prompted for the administrator password after entering this command.)
vsvr set domain windows cslab administrator Note! For this command to work, you must previously have defined a Windows and/ or a NIS domain using the command domain add windows|nis.
After the command completes, you can view the results using the command vsvr show all, which produces a report of the virtual servers on the NAS Gateway. Notice
690-0018-0001B1
4-17
that, in addition to the management virtual server VS_MGMT_512 on the onstor1_lab NAS Gateway, there is now a TRAINING virtual server.:
Virtual servers on nas gateway onstor1_lab ID State Name
Step 2: Enable the virtual server within the domain. When you configure a virtual server, you do so while it is disabled. By default, when a virtual server is added to a domain, it is disabled. At this point, you need to enable the virtual server. Use this command:
vsvr enable
Step 3: Create a storage areaa data storage volumefor the virtual server. Use the following command, specifying a name for the data storage volume and a LUN for the volume. (Use the lun show all command to see the list of free LUNs.)
volume create volumename LUN
For example, this command creates a volume called training connected to the LUN NEXSAN_5000402001ec0590_6DCABAB2:
volume create training NEXSAN_5000402001ec0590_6DCABAB2
4-18
You need to specify the volume name, a sharename for the volume, and the path to the volume. The sharename is the name that is visible to clients. Use the following CIFS command:
cifs share add volumename sharename pathname
For example, this command creates a share point for the training storage volume, gives it the name techpub, and specifies that the path to techpub is the root directory, represented by the back slash (\):
cifs share add training techpub \
Step 2: Set the security permissions for the share point. Add the necessary access privileges and security permissions to the share point so that clients can access it. ONStor follows the Windows security model for the NAS Gateway: it grants a user deemed to be an administrator all privileges (admin privileges) and all other users read only privileges (exec privileges). Use this command to grant security privileges, designating either a user or a group and setting the scope of the granted privileges to the entire cluster or the virtual server: (On a UNIX system, the default security permissions for a file system are encoded as 755. That is, a root user has read, write, and edit permissions and all other users have read only permissions.)
privilege add allow user|group cluster|vsvr privilege
For example, the following command grants administrator security privileges to the user cslab. Furthermore, the users privileges span the entire cluster:
privilege add allow user cslab\administrator CLUSTER cluster
Step 3: At this point, the NAS Gateway is operational and can be accessed by Windows clients. You can verify this using the following command:
cifs show
This command displays the storage volumes available on CIFS. For example, you might see the following output:
ONStor Bobcat NAS Gateway Installation and Cluster Configuration 690-0018-0001B1
4-19
For example, use the following command to see more information on the techpub volume, which produces a report showing the volumes share name, the volume name, and the path to the volume:
cifs show techpub Share name: techpub Volume: training Path: \
If your setup includes providing client access to the NAS Gateway from a UNIX system, you must also create a Network File System (NFS) share point for the data storage volume. Follow these steps on a UNIX system: Step 1: Create and add the share point for the volume. Use the NFS command:
nfs share add directory path
For example, to create a NFS share point for the training volume and set up some access privileges, you might use the following command:
nfs share add /training -o rw=*;no_root_squash=*
690-0018-0001B1
4-20
You reference the management virtual server by name, which always begins with the name string VS_MGMT followed by a numerical ID. For example, if the management virtual server on the NAS Gateway is named VS_MGMT_512, the command looks as follows:
vsvr set VS_MGMT_512
After you change to the management virtual server domain, the terminal prompt, assuming the NAS Gateway is called onstor1_lab, is as follows:
onstor1_lab VS_MGMT_512 diag>
690-0018-0001B1
4-21
Since you are working in the context of the management virtual server, you create the volumes specifying the available LUNs to which they should be connected. If need be, before creating these volumes use the command lun show all to see the available (free) LUNs. Keep in mind the following information before creating these two volumes: Management volumeA management volume is used for Network Data Management Protocol (NDMP) buffering and for backup purposes. This volume is mounted by default. The management volume also holds all system logs, including output from the system get all script, which tracks configuration and troubleshooting information. The management volume size should be at least ten (10) gigabytes and preferably should be twenty (20) gigabytes. While the management volume must use at least one LUN, the number of LUNs it uses does not matter. Management volume use is not performance critical. Thus, if your storage configuration includes multiple types of storage, consider using your slowest storage for the management volume. Management volume availability is important. The management volume, although accessible through NFS and CIFS, should never be used to store your own data files. Because it uses the management volume for administrative purposes, the NAS Gateway may fill, delete, and overwrite files on the volume without notice.
Core volumeThe core volumes sole purpose is as a repository for the system to dump its raw memory in the event of a panic, thus preserving the raw memory for later analysis. Such core dumps are automatically generated if the NAS Gateway fails for some reason. The core volume does not contain a readable file system and does not appear as mounted. The amount of memory in the core volumes NAS Gateway owner dictates the volumes minimum size. If you attempt to create a core
690-0018-0001B1
4-22
volume too small for the NAS Gateway, the system prints an error and does not create the core volume. Step 1: Create the management volume. The command to create the management volume is:
system create mgmtVolume LUN
For example, if you are working in the management virtual server domain context and there is a free LUN device called NEXSAN_5000402001ec0590_6DCABA41, you create the management volume as follows:
system create mgmtVolume NEXSAN_5000402001ec0590_6DCABA41
Step 2: Create the core volume. The command to create the core volume is as follows:
system create corevolume core volume name LUN
For example, to create a core volume called core1 connected to the free LUN called NEXSAN_5000402001ec0590_6DCABAA6, you use this command:
system create corevolume core1 NEXSAN_5000402001ec0590_6DCABAA6
Step 3: You may want to verify that the two volumes were created correctly. Use the following command to see the volumes created on the management virtual server:
volume show
This command displays the following report for the VS_MGMT_512 management virtual server:
Name vol_mg mt_512 core1 Status Mounted Not Mounted Type Standard Core Current (MiB) 9408.6 2 0.00 Hard Quota No Limit No Limit Used 34.62 0.00 Avail 9374.01 0.00 Usage 0.37 % 0.00 % VirtualServer VS_MGMT_512 VS_MGMT_512
690-0018-0001B1
4-23
You may also want to verify that the two volumes are associated to the LUNs you designated. Use the command lun show all. For example, the lun show all command displays the following information for the NAS Gateway onstor1_lab::
All devices known to PCC. ========================= Device Name NEXSAN_5000402001 ec0590_6DCABAB2 NEXSAN_5000402001 ec0590_6DCABA41 NEXSAN_5000402001 ec0590_6DCABAA6 Model Disk Disk Disk Raid Raid-5 Raid-5 Raid-5 Size(MB) State 9536.62 9536.62 9536.62 free used used Cluster onstor1_lab onstor1_lab onstor1_lab vol_mgmt_512 core1 Volume
690-0018-0001B1
4-24
When using the autosupport command to setup EMRS, you can enable or disable EMRS, configure EMRS for a proxy server, and enable or disable the automatic
690-0018-0001B1
4-25
sending of EMRS data. Use the command autosupport emrs show to see the current EMRS configuration on a NAS Gateway. It produces a report such as the following::
Virtual servers on nas gateway onstor1_lab ID State Name
Autogrow
The autogrow utility, which is an optional utility, allows you to specify parameters to automatically grow a volumes storage. You typically specify a volume to grow by some number of gigabytes. You set up this utility using the autogrow command followed by one or more options and parameters. Some of the options you can specify with autogrow are:
hardquotaSets a softquotaSends
hard maximum size limit for the volume. a message when the volume grows to this size. the minimum size amount to autogrow the volume.
min autogrowIndicates
the volume.
min/max lunsizeSpecifies
a minimum and/or maximum LUN size, usually between 400 and 600 gigabytes.
Note! There is no support for shrinking a volume.
Snapshots
Snapshots is a utility that is useful for recovering data that is mistakenly deleted. The utility takes an initial picture of the entire data storage volume. Then, every so many hours according to a schedule you define, the utility takes another picture of the entire data storage volume and saves the delta between the two pictures. Thus, it keeps a
690-0018-0001B1
4-26
running track of data storage changes to file systems made between successive snapshots of the volume. By default, snapshots are enabled on a new volume, but can be disabled. The snapshots schedule is approximately every four hours, but this, too, can be modified. Use the snapshot command to setup this utility. To see how the utility is currently defined for a volume, use this command:
snapshot show volumename
For example, the command snapshot show vol_mgmt_512 schedule displays the following report:
** snapshot scheduling currently disabled for this volume ** schedule ======== 0 2 8 @8 12 16 20
690-0018-0001B1
4-27
For upgrade, the log file is called sys_upgrade.log. Whenever you upgrade the EverON software on a NAS Gateway, you issue the system upgrade command. This command triggers the logging so that upgrade messages are logged during the entire upgrade process. During the upgrade, console messages are stored in file / var/log/sys_upgrade.log on the compact flash. When you have completed the upgrade, you can copy the sys_upgrade.log file from the default location (/var/ log) to a target volume and virtual server, where the log file can be viewed or sent to ONStor support if needed.
Note! As part of supporting logging of upgrades, a new command called system compare has been added to help validate the distribution software that you are upgrading to. For more information about system compare, see Comparing Contents of the Current Software on page 4-28.
690-0018-0001B1
4-28
LOCATION is where the distribution software is. For upgrading from an NFS or FTP server, enter the IP address of the server and the download directory location separated by a colon (:). For example, to specify the new distribution software in the directory /home/upgrade/R1.3.0-022806.tar.gz on an FTP server with IP address 168.192.3.4, you would issue the command as follows
system compare ftp://user:password@168.192.3.4/home/ upgrade/R1.3.0-022806.tar.gz
-s is an optional argument that specifies the standby flash module that contains the system software that you want to compare to the software on the NFS or FTP server.
690-0018-0001B1
4-29
Step 3: When the NAS Gateway is up and running, copy the log files to a target volume by issuing the system get logs command and specifying the virtual server and the volume where you want the log file to be copied. For example, to copy the log files to the virtual server eng and the volume temp, you would issue the command as follows:
system get logs -V eng -v temp
Step 4: When the log files are on the target volume, they can be viewed or sent to ONStor Technical Support engineers.
690-0018-0001B1
4-30
This example output from sys_upgrade.log shows: the beginning of the system upgrade procedure. some standard status messages as the upgrade continues. the end of the system upgrade when the NAS Gateway is rebooted.
For a sample procedure for using the upgrade and install logging, see Sample Procedure for Install or Upgrade Logging on page 4-28.
690-0018-0001B1
4-31
690-0018-0001B1
4-32
690-0018-0001B1
690-0018-0001B1
5-2
690-0018-0001B1
5-3
Figure 5-1 Direct Connect Cabling Between NAS Gateway and Array Controllers
690-0018-0001B1
5-4
For more information on setting the default IP address, see the Getting Started Guide for the storage array.
Note! You can find the user interface selection options, shown as a series of options separated by arrows (->) such as Manage -> General Conf -> host port configuration, on the left-hand frame in the browser window.
690-0018-0001B1
5-5
Step 2: Select Change Host Port Topology (under Advanced Options, for Fibre Channel Topology), as shown in Figure 5-2. Step 3: Set Topology to Loop mode for all ports for both direct and fabric connect modes. Click Save and Continue. (See Figure 5-3.) Fabric connect requires that the array be run in Loop mode so that multipathing for failover works.
690-0018-0001B1
5-6
Setting Port Interconnect Settings Ports must be interconnected after the storage array is directly connected to the NAS Gateway to allow for failover due to link failures. Interconnect mode links Port 0 of the storage array controller A to Port 1 of controller B. By interconnecting these two ports on the two different controllers, all LUNs on controller B are available on controller A, and vice versa. Interconnect the ports through the user interface as follows: Step 1: Select Manage -> General Config -> host port configuration. Step 2: Select Change FC Port Interconnect Settings as shown in See Figure 5-4.
690-0018-0001B1
5-7
Step 3: If you are using direct connect mode, select Interconnected. Then click Save and Continue as shown in Figure 5-5. If you are using fabric connect mode, select Straight-through.
690-0018-0001B1
5-8
690-0018-0001B1
5-9
RAID Controller
JBOD Controller
690-0018-0001B1
5-10 a middle controller unit without affecting IO to the other units. The cabling configuration pattern is as follows: Connect RAID controller A to the first JBOD controller A. Connect RAID controller B to the last JBOD controller B. Connect the first JBOD controller A to the second JBOD controller A until you reach the last JBOD controller. Connect the last JBOD controller B to the next to last JBOD controller B until you reach the first JBOD controller.
690-0018-0001B1
5-11
Step 3: Enter the virtual disk name and select the virtual disk RAID level. Step 4: Select whether you want the installation initialization to be online or offline. Click Advanced Options, then select either Offline or Online for Initialization Type. When deciding between offline and online initialization, you should keep the following points in mind: The larger the virtual disk (whether SAS or SATA), the longer the initialization process takes. SAS disks initialize in less time than SATA disks. For example, a sizeable SATA disk may initialize overnight with offline initialization, but online
690-0018-0001B1
5-12
initialization of the same disk may take several days. Offline initialization is always faster than online initialization. Although offline initialization always completes in less time than online initialization, your LUNs are not available during offline initialization until the entire initialization completes. With online initialization, although it takes considerably longer than offline initialization, your LUNs are available during the initialization process. If you want to have immediate access to the LUNs on the virtual disk and you are not concerned about performance, then you should consider choosing the online installation initialization type. When performance is an issue, use offline initialization. Performance is degraded during online initialization, but you can access and use the LUNs. Storage should stay online during the initialization process.
Note!
When you use automatic VDisk creation, the system alternates the assignment of VDisks to controllers. That is, it assigns the first VDisk to controller A, then it assigns the second VDisk to controller B, then the third VDisk to controller A, and so on. If you prefer, you can manually assign VDisk ownership to specific controllers when you do the initial VDisk configuration. See Manually Assigning VDisk Ownership on page 5-17 for more information. Step 5: Click Create New Virtual Disk when you have completed the above steps.
690-0018-0001B1
5-13
1 2
4 5
Figure 5-7 Creating a VDisk
690-0018-0001B1
5-14
690-0018-0001B1
5-15
Step 2: Click Continue after selecting the drives for this virtual disk. The user interface displays the screen for configuring the volumes of the virtual disk. See Figure 5-9 in Configuring Volumes on the VDisk on page 5-15. If you want to dedicate spare drives, use the Manage -> Virtual Disk Config -> add vdisk spares function after you configure the disk volumes.
Step 1: Enter the number of volumes you want to create on the disk. The example in Figure 5-9 creates one volume. Creating one volume defaults to the assumption of volumes of equal sizes. This example also has the LUN IDs automatically assigned. For failover to properly work, it is also recommended that you expose the volume to all hosts.
690-0018-0001B1
5-16
Step 2: Click Advanced Options, and in the pop-up screen that displays, you can override the automatic settings. (See Figure 5-10 in Manually Assigning VDisk Ownership on page 5-17.) Step 3: Click Create Virtual Disk to complete the virtual disk creation process.
Note! The VDisk must be initialized before disk performance can be demonstrated.
690-0018-0001B1
5-17
Step 2: If you wish, you can select a virtual disk block size other than the default block size of 64K. However, note that our testing shows that 64K has the best performance. Step 3: Select the preferred owner for the virtual disk.
690-0018-0001B1
5-18
690-0018-0001B1
5-19
Step 3: The user interface displays a warning message alerting you to reassign the LUN IDs and to issue a rescan operation from the host. See Figure 5-12.
Note! Keep in mind that the LUN IDs you assign must be unique across the controller.
690-0018-0001B1
5-20
690-0018-0001B1
5-21
Step 2: Select the VDisks on the target controller and record all the LUN identifiers in use. For example, if you moved the VDisk to
690-0018-0001B1
5-22
controller B, then you must record all LUN identifiers used for all VDisks on controller B. Step 3: Select Manage -> Volume Management -> volume mapping -> map hosts to volume. Repeat the following steps for each volume in the virtual disk (see Figure 5-14): Step 1: Select a volume. Step 2: Set the Host WWN to default. Step 3: Leave Host Name blank. Step 4: Add an unused LUN ID. Step 5: Select Map Host.
690-0018-0001B1
5-23
2 5
690-0018-0001B1
5-24
690-0018-0001B1
690-0018-0001B1
6-2
690-0018-0001B1
6-3
Clusters are configured in any of the following ways: Network configuration: In this configuration, the SC1 ports of each NAS Gateway are connected to one management network, and the SC2 ports to a different management network. Both networks use different subnets. This configuration can be used for either a two-node cluster or a multiple-node cluster. Direct configuration: In this configuration, two nodes are directly connected to each other through crossover cables that are provided in ONStor accessory kit. The cables allow the NAS Gateways to support synchronization and heartbeat in the cluster. This configuration is used only for a two-node cluster. Hybrid configuration: In this configuration, nodes are connected to each other through a combination of methods on the SSCs management ports. One SSC port on each NAS Gateway connects into a management network, and the other SSC port on each NAS Gateway connects the nodes directly using crossover cables. Both connections support synchronization and heartbeat in the cluster. This configuration is used only for a two-node cluster.
Note! Regardless of which configuration you use, to ensure full redundancy both NAS Gateways in the cluster must have the same connectivity to the IP data network and SAN resources.
690-0018-0001B1
6-4
Figure 6-1 shows the cluster topology of a two-node cluster. The NAS Gateways connect into the SAN through FibreChannel ports. Each NAS Gateway has two connections to a FibreChannel switch. The cluster of NAS Gateways is indicated by the dark grey rounded rectangle. This cluster contains the NAS Gateways Gateway 1 and Gateway2 that are connected to the management network through their 10/ 100 management ports. The management network supports the synchronization and heartbeat signal between all NAS Gateways in the cluster.
Windows Client
IBM Compatible
Linux Client
W orkstation
UNIX Client
W orkstation
Disk a rr ay
Disk a rr ay
Disk a rr ay
Disk a rr ay
690-0018-0001B1
6-5
The clients on the Gigabit Ethernet data network are connected to Gigabit Ethernet switches. These switches are connected to both NAS Gateways to enable redundancy. In the example, the management port connections enable cluster configuration for: Heartbeat signal between the two NAS Gateways. Arbitration between the NAS Gateways for the role of a new PCC if an event takes the previous PCC offline. State change notification. Convergence on an Network Time Protocol (NTP) server and synchronization of the NTP time signal between the NAS Gateways. An external NTP server is supported if your cluster is in a hybrid or management network.
690-0018-0001B1
6-6
Only one Primary Cluster Controller exists at a time in each cluster. When the NAS Gateway reboots, or goes offline, an election process starts to find the NAS Gateway that will assume the Primary Cluster Controller role. If a new Primary Cluster Controller is established, the second Primary Cluster Controller does not relinquish its responsibilities when the previous Primary Cluster Controller comes back online. When a Primary Cluster Controller drops offline, it reboots as a cluster node and can be elected as the Primary Cluster Controller again if an event causes a failure of the current Primary Cluster Controller.
690-0018-0001B1
6-7
In a multinode cluster, nodes negotiate for the role of the PCC when the PCC becomes unavailable.
When the PCC is elected, the other NAS Gateways synchronize their cluster database with the PCC so that each node in the cluster contains an identical cluster configuration. After this synchronization is complete, the cluster is online and available to provide high availability of file services.
690-0018-0001B1
6-8
690-0018-0001B1
6-9
690-0018-0001B1
6-10
690-0018-0001B1
690-0018-0001B1
7-2
To add individual NAS Gateways to a cluster, follow this procedure: Step 1: Issue this command:
cluster add nasgateway NASGATEWAY1 -a IPADDAR
where:
NASGATEWAY1 is the unique node name of the NAS Gateway that you are adding to the cluster. -a IPADDR is an argument that specifies the IP address of the
NAS Gateway. This is usually the interface associated to the interface SC1.
ONStor 2200 NAS Gateway Cluster Configuration GuideONStor Bobcat NAS Gateway
7-3
Note! The cluster add nasgateway command needs to be run on a node in the cluster to which other NAS Gateways are being added. Suppose you are adding Gateway2 to the cluster in which Gateway1 is. You need to run the cluster add nasgateway command on Gateway1, and name Gateway2 in the arguments to the command. Issue the cluster add nasgateway and cluster delete nasgateway commands from the same NAS Gateway.
Step 2: After adding all NAS Gateways to the cluster, run the commit command.
690-0018-0001B1
7-4
After you have moved the virtual server, issue the following command to delete the NAS Gateway from the cluster:
cluster delete nasgateway NASGATEWAY1 -a IPADDR
where:
NASGATEWAY1
-a IPADDR is an argument that specifies the IP address of the NAS Gateway that you are deleting
Commit Requirement
To commit cluster changes to the cluster database, issue the following command:
cluster commit
ONStor 2200 NAS Gateway Cluster Configuration GuideONStor Bobcat NAS Gateway
7-5
Requires Uncommit?
To remove parameters that have not been committed to the cluster database, issue the following command:
cluster uncommit Note! The cluster uncommit command does not remove changes that have already been committed to the cluster database.
690-0018-0001B1
7-6
Node name of each NAS Gateway in the cluster. IP address of the NAS Gateways that form the cluster. The IP addresses listed are the same as the SSC management IP network of each NAS Gateway. The operational state of each NAS Gateway in the cluster. Valid values are UP or DOWN. The role that each NAS Gateway has as cluster controller. Valid values are YES if the NAS Gateway listed is the cluster controller, or NO if the NAS Gateway listed is just a node in the cluster.
cluster show cluster
NAS Gateway group boundaries do not apply to control messages, cluster heartbeat signals, and NTP time signals. Each NAS Gateway group can contain one or more NAS Gateways. When the NAS Gateway starts up, it is configured as part of the default NAS Gateway group, but you can create a different NAS Gateway group. For a two-node cluster, both NAS Gateways must be in the same NAS Gateway group otherwise redundancy and failover are not supported.
Note! Each cluster can support a maximum of four Gateway groups, excluding the default NAS Gateway group, regardless of how many NAS Gateways are in the cluster.
To add or create NAS Gateway groups in a cluster, follow this procedure: Step 1: Issue this command:
cluster add group GROUP1
ONStor 2200 NAS Gateway Cluster Configuration GuideONStor Bobcat NAS Gateway
7-7
Step 2: Repeat Step 1 for more filer groups that you want to create.
You can move a NAS Gateway in and out of a group by issuing the cluster move nasgateway command. You can move one NAS Gateway at a time out of a NAS Gateway group. The NAS Gateway group itself remains configured even if no NAS Gateways remain in the NAS Gateway group. To manually move a NAS Gateway from a NAS Gateway group, run the following command:
cluster move nasgateway NASGATEWAY1 -g GROUP1 [-a]
is the name of the target NAS Gateway group to which you are moving the NAS Gateway NASGATEWAY1.
-g GROUP1
You use the-a argument to move all virtual servers with the NAS Gateway. If you do not specify -a, the NAS Gateway is
ONStor 2200 NAS Gateway Cluster Configuration GuideONStor Bobcat
690-0018-0001B1
7-8
moved to a new NAS Gateway group, but the virtual servers that are assigned to the NAS Gateway are not moved to the new NAS Gateway group.
Step 2: Repeat Step 1 for all the NAS Gateways in the NAS Gateway group that you want to delete. Step 3: After all NAS Gateways have been moved out of the NAS Gateway group you are deleting, issue this command to delete the empty NAS Gateway group:
cluster delete group GROUP1
ONStor 2200 NAS Gateway Cluster Configuration GuideONStor Bobcat NAS Gateway
7-9
Note! Management virtual servers always stay with theirs NAS Gateway. Therefore, a management virtual server will appear in the same NAS Gateway group that holds its NAS Gateway.
To display the NAS Gateway group configuration, issue the following command:
cluster show group
Deleting a Cluster
Deleting a cluster consists of moving all virtual servers to the NAS Gateway that gave its name to the cluster, then removing all the other NAS Gateways one by one from the cluster. All cluster commands should be run from the original NAS Gateway.
Note! To find which NAS Gateway is the original gateway, issue the cluster show cluster command and check the cluster name.
To delete a cluster, follow this procedure: Step 1: From the NAS Gateway you want to delete, move all virtual servers, to the original NAS Gateway. You can move virtual servers by issuing the vsvr move command. For information about this command, see the Virtual Servers chapter in the ONStor 2200 NAS Gateway System Administrators Guide. Step 2: On the NAS Gateway you want to delete, issue the system time ntp server -d ip command to remove the NTP servers address. To find out about the IP address of the NTP server, run the system time show -v command. Ignore the default entry 127.127.1.0.
Note! To find which is the original NAS Gateway, run the cluster show cluster command.
Step 3: When all virtual servers have been moved, issue the cluster delete nasgateway command from the original NAS Gateway to remove the NAS Gateway you want to delete. For example, to delete Gateway3 from the cluster:
cluster delete nasgateway Gateway3 -a sscip
690-0018-0001B1
7-10
sscip is the IP that associated with the NAS Gateway that is displayed as the result of cluster show cluster command.
Step 4: To commit this change, run the following command from the original NAS Gateway:
cluster commit
When the command completes, the deleted NAS Gateway will no longer be in the cluster. When a NAS Gateway is deleted from a cluster, it will reboot and come back online in standalone mode with its own cluster database. When the deleted NAS Gateway reboots, its cluster database will contain the following information: Node name. SSCs management port IP address. Management virtual server. NTP configuration if not removed as described in Step 2. Default management route.
Note! If you are uninstalling the NAS Gateway, at this point it is safe to power off the deleted NAS Gateway and remove its cabling.
Step 5: Repeat Steps 1-4 if other NAS Gateways need to be deleted from the cluster. Step 6: On the NAS Gateway that will remain configured, you can delete empty groups by issuing the cluster delete group command. For example, to delete the NAS Gateway group GROUP1 issue the command as shown:
cluster delete group GROUP1
ONStor 2200 NAS Gateway Cluster Configuration GuideONStor Bobcat NAS Gateway
690-0018-0001B1
8-2
ONStor 2200 NAS Gateway Cluster Configuration GuideONStor Bobcat NAS Gateway
8-3
Prerequisites of Configuration
Before you start with the cluster configuration, ensure that the following conditions are met: The cluster configuration commands are run from the same node. Each node is running the same version of software. Each NAS Gateway has redundant paths to the same IP clients and storage area network (SAN) resources. The NAS Gateways Gigabit Ethernet interfaces are on the same subnet to support client connectivity. The NAS Gateways management IP interfaces are on the same subnet (SC1s on one subnet and SC2s on another subnet) to support NAS Gateway-to-NAS Gateway connectivity and synchronization. The subnet can be the same as, or different than, the Gigabit Ethernet interfaces. All LUNs in the cluster are labeled by the NAS Gateway on which you are creating the cluster. Network configuration: In a network configuration, all NAS Gateways in the cluster are configured on the same subnet. The cluster network is configured on the management IP ports on the SSC. You can configure two external NTP servers. Direct configuration: Since external NTP server cannot be reached from the network configuration, one NAS Gateway can serve as the NTP server. Configure the NTP server on the NAS Gateways that will join the cluster, providing one of the management IP addresses (associated with interfaces SC1 or SC2) of the NAS Gateway that is designated as that internal NTP server. You can also set up a secondary NTP server using the IP address associated with the second interface. Hybrid configuration: In a hybrid configuration, you can configure an external NTP server that can be reached through the management port connected to the network, and an internal NTP server (IP address of the NAS Gateway designated to serve as the server) that can be reached through the management port that is directly connected to the other Gateway.
Based on the configuration you have, ensure that the following exist:
690-0018-0001B1
8-4
For illustrative purposes, we will use the following details in our example: The NAS Gateways are named Gateway1 and Gateway2. Gateway1 has 192.168.172.1 and 192.168.173.1 as its SC1 and SC2 management port IP addresses. Similarly, Gateway2 has 192.168.172.2 and 192.168.173.2 as its SC1 and SC2 management port IP addresses. The cluster will be configured on Gateway1. The NTP server addresses for the cluster are 192.168.172.3 and 192.168.173.3.
Note! Once the NAS Gateway is running in cluster mode, the management IP addresses on the SC1 and SC2 interface cannot be changed. Management IP address on the SC1 or SC2 interface can be changed only when the NAS Gateway is in standalone mode.
ONStor 2200 NAS Gateway Cluster Configuration GuideONStor Bobcat NAS Gateway
8-5
Step 2: On Gateway1, use one of the following methods, depending on the configuration you are in: If you are in a network or hybrid configuration, add the external NTP server using the system time ntp server command for all NAS Gateways. For example, to configure the NAS Gateways NTP client to use the time signal from the time source at 192.168.172.3 (SC1 subnet), and 192.168.173.3 (SC2 subnet) issue the following commands on both:
system time ntp server -a 192.168.172.3 system time ntp server -a 192.168.173.3
If you are in a direct configuration, issue the system time ntp disable command to disable the NTP client and use the system's hardware clock.
Step 3: On Gateway2, add Gateway1 as the NTP server using the system time ntp server command. For example, issue the following command from Gateway1.
system time ntp server -a 192.168.173.1
Step 4: Verify the configuration on all NAS Gateways using the system time show -v command.
690-0018-0001B1
8-6
127.127.1.0 is the hardware clock, and it is normal for it to appear there. After a few minutes, an asterisk will appear by the IP address of the external NTP server (Gateway1) or Gateway1's IP address (Gateway 2, etc.), and the system clocks will begin drifting to an accurate setting.
Note! The system times will not immediately correct themselves; NTP will adjust the hardware clocks over a short period of time (typically fifteen minutes) until they are all synchronized.
Step 5: After synchronizing the time, from Gateway1, add Gateway2 to the cluster by running the cluster add nasgateway command. For example, issue the following command from Gateway1:
cluster add nasgateway Gateway2 -a 192.168.172.2
Step 6: From Gateway1, run the cluster commit command to activate the cluster configuration. The cluster then elects a Primary Cluster Controller between Gateway1 and Gateway2.
Note! At this point, Gateway2 reboots. When it comes back online, it will be in the cluster.
Step 7: To verify that NAS Gateways have been added to the cluster, issue the cluster show cluster command to view the cluster configuration. Step 8: To conclude the cluster configuration process, ensure the following: One NAS Gateway is labeled as the PCC to indicate that it is assuming the Cluster Controller role. All NAS Gateways in the cluster are listed by node name and IP address. All NAS Gateways should be in the UP state.
ONStor 2200 NAS Gateway Cluster Configuration GuideONStor Bobcat NAS Gateway
8-7
Note! At this point the cluster has been created with all NAS Gateways in the same cluster and in the default NAS Gateway group. However, file services have not been configured within the cluster.
Windows Client
IBM Compatible
Linux Client
W orkstation
UNIX Client
W orkstation
Management IP Networks
Disk a rr ay
Dis k ar ray
Disk a rr ay
Disk a rr ay
690-0018-0001B1
8-8
ONStor 2200 NAS Gateway Cluster Configuration GuideONStor Bobcat NAS Gateway
A-1
690-0018-0001B1
A-2
Signal
690-0018-0001B1
A-3
690-0018-0001B1
A-4
690-0018-0001B1
B-1
690-0018-0001B1
B-2
Safety Considerations
We recommend that you read and follow the safety considerations listed in these sections while working with the ONStor 2200 NAS Gateway (NAS Gateway). Warning! Failure to follow the information in the following sections can result in damage to the product, personal injury, or loss of life.
Heat Considerations
To reduce the risk of personal injury from hot surfaces, whenever you are working inside the chassis or with components that have removed from the chassis, allow sufficient time for the components to cool before touching them.
690-0018-0001B1
B-3
Electrical Considerations
To reduce the risk of loss of life, personal injury, or damage to the product, follow these considerations when working with the NAS Gateways electrical components. Power Supplies This product contains multiple power supplies. The product can operate effectively on one power supply. When operating in a non-error condition, the units Fault LED (FLT) LED has a continuous a green light. Error conditions are indicated by a continuous red FLT LED. Caution! This product contains multiple power supplies. If you fail to activate all power supplies, the product will operate correctly, but you will lose redundancy in the unlikely event that a power supply fails. Whenever you are powering on the NAS Gateway, we recommend that you activate all power supplies to keep redundancy. Power Cords Warning! This product might have multiple power supply cords. To reduce the risk of electrical shock, disconnect all power supply cords before servicing the unit. Grounding This equipment is designed for connection to a grounded outlet. The power cords are terminated with an IEC 320 plug for insertion into the wall socket (facility power). The grounding type plug is an important safety feature. To avoid the risk of electrical shock or damage to the product, do not disable or alter the power cord or plug.
690-0018-0001B1
B-4
Lithium Battery Warning! This product contains one or more lithium batteries. If the battery is misused damaged, or incorrectly installed or replaced, the danger of explosion exists. To avoid personal injury or damage to the product, do not attempt to recharge the battery, disassemble it, or dispose of it in a fire. Ensure that you dispose of the battery properly.
Optical Considerations
This product has four fiber optic connections on the Gigabit Ethernet File Processing module and four fiber optic connections on the FibreChannel Storage Processing module. The optical transceivers support a Class 1 laser to drive signals on the links. The laser operates at the following specifications: output power: < 1.0 mW wavelength: 830 nm (minimum), 850 nm (nominal), 860 nm (maximum) pulse duration: 800 pS (minimum), 4nS (maximum) frequency: 125 MHz (minimum), 625 MHz (maximum)
Class 1 laser devices are supported for connection to other Class 1 Laser devices only.
Eye Safety
To reduce the risk of personal injury, always try to avoid pointing the NAS Gateways laser signal directly into your eye. However, casual laser contact with the human eye poses no threat. Warning! Laser Radiation To reduce the risk of personal injury, avoid pointing the NAS Gateways laser directly into your eye. The laser signal supported on the NAS Gateways optical transceivers have been categorized as a Class 1 laser. Per the IEC 825-1: 1993 and CDRH, 21 CFR Laser Safety Requirements the NAS Gateways laser is considered safe for casual contact with the human eye.
690-0018-0001B1
B-5
Always operate the laser components in a manner compliant with the IEC 825-1: 1993 and CDRH, 21 CFR Laser Safety Requirements. Misuse of the laser or prolonged exposure to the human has the possibility of causing personal injury.
690-0018-0001B1
B-6
690-0018-0001B1
C-1
690-0018-0001B1
C-2
Compliances
ONStor 2200 NAS Gateway products comply with the standards of: European Union Evaluation ETL/cETL Listing for North America FCC Declaration of Conformity, United States Voluntary Control Council for Interference (VCCI), Japan Australian Communications Authority (ACA) Compliance
Standard
Limits and Methods of Measurement of Radio Interference Characteristics of Information Technology Equipment. Information Technology Equipment - Immunity Characteristics Limits and Methods of Measurement CISPR 24:1997, Modified. Safety of Information Technology Equipment, Including Electrical Business Equipment. Electromagnetic compatibility (EMC). Limits for harmonic current emissions (equipment input current up to and including 16 A per phase) Electromagnetic compatibility (EMC). Limits for harmonic current emissions (equipment input current up to and including 16 A per phase)
690-0018-0001B1
C-3
The Commonwealth of Europe (CE) mark affixed to each model of ONStor 2200 NAS Gateway indicates its compliance with the listed standards and the EMC Directive and the Low Voltage Directive of the European Union. Figure C-1 shows the CE mark.
Caution! The ONStor 2200 NAS Gateway is a Class A product and might cause radio interference in a domestic environment. If such interference occurs, the user may be required to take adequate measures.
Standard
UL Standard for Safety for Information Technology Equipment, Part 1 Safety of Information Technology Equipment, Including: Electrical Business Equipment First Edition.
The Edison Test Laboratories (ETL/cETL) mark affixed to each ONStor 2200 NAS Gateway unit indicates its compliance with the listed standards. Figure C-2 shows the ETL/cETL mark.
690-0018-0001B1
C-4
Standard
Radio Frequency Devices: 15.107 Conducted Limits 15.109 Radiated Emissions Limits
690-0018-0001B1
C-5
This device complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions: This device may not cause harmful interference, and This device must accept any interference received, including interference that may cause undesired operation. Warning! Changes or modifications to this unit not expressly approved by the party responsible for compliance could void the users authority to operate the equipment. This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to Part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference when the equipment is operated in a commercial environment. This equipment generates, uses, and can radiate radio frequency energy, and, if not installed and used in accordance with the instruction manual, may cause harmful interference to radio communications. Operation of this equipment in a residential area is likely to cause harmful interference in which case the user will be required to correct the interference at his own expense. The Federal Communications Commissions (FCC) mark affixed to each ONStor 2200 NAS Gateway unit indicates its compliance with the listed standards. Figure C-3 shows the FCC mark.
690-0018-0001B1
C-6
Standard
Emission limits and methods for ITE-Class A.
Standard
Limits and Methods of Radio Disturbance Characteristics of Information Technology Equipment.
690-0018-0001B1
C-7
Standard
Approval and Test Specification - Safety of Information Technology Equipment, including: Electrical business equipment, incorporating
The C-tick or RCM Mark affixed to each ONStor 2200 NAS Gateway unit indicates its compliance with the listed standards. Figure C-5 shows the C-tick mark.
690-0018-0001B1
C-8
CB Scheme Certificate
The ONStor 2200 family of NAS Gateway products complies with the applicable requirements of the International Standards shown in Table C-6.
Standard
Information Technology Equipment, Part 1
690-0018-0001B1