Setting up each storage node

For the storage nodes or spare nodes on which the installation of the storage software is complete, set them up one by one. Use the BMC remote console to perform operations of this procedure.

Note:

Procedures in this section are performed in specific cases. The following show those cases and physical servers to be installed.

Initial installation: Perform this operation for the storage nodes to be initially installed.
Storage node addition or storage node replacement: Perform this operation for the storage nodes to be added or replaced.
Spare node preparation: Perform this operation for spare nodes.

Installation of the storage software must be complete on all the physical servers used as storage nodes or spare nodes.
Connection to the management network must have finished for each storage node or each spare node.
Editing of the VSSB configuration file (SystemConfigurationFile.csv) must have been completed.

Note:

If you are performing this procedure as a part of storage node addition, use the VSSB configuration file that was exported from the storage cluster and to which the storage node configuration information for the storage node to be added was added.
If you are performing this procedure as a part of storage node replacement, in the following procedure, the same settings as those on the old nodes must be specified on the new nodes. Do not specify different settings.

The settings to be specified in this procedure can be confirmed in the VSSB configuration file. You can obtain the file by using the following REST API function or CLI command, or by referencing Exporting the configuration file (Bare metal) in the VSP One SDS Block and SDS Cloud System Administration.
- REST APIs and CLIs used for determining the values to be set during storage node replacement
  - Items to be set in step 5 (storage node name):
    
    REST API: GET /v1/objects/storage-nodes
    
    CLI: storage_node_list
  - Items to be set in step 8 (network settings of the control port):
    - IP address, subnet mask, and MTU
      
      REST API: GET /v1/objects/control-ports
      
      CLI: control_port_list
    - Routing settings (only if configured)
      
      REST API: GET /v1/objects/storage-node-network-settings
      
      CLI: storage_node_network_setting_list
      
      (The one whose interface is "eth0" is the routing setting of the control port)
When performing this procedure as part of preparing a spare node, you must enter the configuration values for the spare node in the subsequent steps for each configuration item. Therefore, prepare the configuration values for the following items in advance:
- Spare node name
- Control port IP address
- Control port subnet mask
- Control port MTU
- Control port routing settings (if configured)

Notes on the procedure

Perform this procedure for the storage nodes and spare nodes one by one.
When performing this procedure on a storage node, follow the operation steps shown below according to the configuration values listed per storage node (per line) within the [Nodes] section of the VSSB configuration file.
You can perform operations for multiple storage nodes or spare nodes in parallel by opening other tabs or windows on the web browser and logging in to multiple BMC web interface windows.
For details about how to operate BMC (such as the procedure for displaying or operating the BMC web interface window, or operating the BMC remote console), see the BMC user guide provided by physical server vendors.

About the console interface screen

For details about the items that are displayed on the console interface screen and how to use the screen, see Items displayed on the console interface screen and how to use the screen.

CAUTION:

If an event that should be notified to the user occurs, a message and message ID are shown in the console interface.

For details about action to be taken when this message appears, see [Solution] of the corresponding message description in the VSP One SDS Block and SDS Cloud Message Reference.

For Hitachi Advanced Server HA800 series, HA800 G2 series, HA800 G3 series, or HA800 G6 series, log in to the iLO web interface window from the controller node.

For HITACHI iLO7, click the iLO remote console thumbnail and select Launch from the displayed menu.

The iLO Remote Console will open in a separate browser tab.

For iLO6 or earlier versions, click the iLO remote console thumbnail and select HTML5 Console from the menu that appears.

The Keyboard layout configuration screen appears.

Note:
If the server is powered off, turn it on.

For HITACHI iLO7, click the fourth option from the right in the upper-right menu of the remote console, select Power On.

For iLO6 and earlier versions, click the power switch icon, and then, from the menu that opens, select Momentary Press.

After the server is started, when the Keyboard layout configuration screen appears on the iLO remote console (HTML5 Console), go to step 2.

For physical servers other than Hitachi Advanced Server HA800 series, HA800 G2 series, HA800 G3 series, and HA800 G6 series, log in to the BMC web interface window from the controller node, and then start the BMC remote console. For details about specific procedures, see the respective server vendor documentation.
If necessary, change the keyboard layout settings of the console interface.

The keyboard layout that is currently set is displayed at Current keyboard layout.

The keyboard layout that is initially set when storage software has just been installed is "English (US)." If you do not want to change the keyboard layout, use the up arrow (↑) and down arrow (↓) keys to position the cursor at Login, press the Enter key, and then go to step 3.

If you want to change the keyboard layout, perform the following procedure:
1. In the Keyboard layout configuration screen, select Select keyboard layout.
  
  The Select keyboard layout screen, which lists the supported keyboard layouts, appears.
2. In the Select keyboard layout screen, select the keyboard layout that is appropriate for the keyboard you are using.
  
  The Select keyboard layout (Keyboard test) screen appears.
  
  Tip:
  If [...] is displayed on the last line of the displayed keyboard layout list, there are other list items on the next page. You can view them by selecting [...].
  
  If [...] is displayed on the first line of the displayed keyboard layout list, there are other list items on the previous page. You can view them by selecting [...].
  
  Note:
  When you select a keyboard layout and press the Enter key, the screen color changes to blue for a moment. However, this phenomenon is not a problem.
  
  If you do not want to change the keyboard layout, you can go back to the Keyboard layout configuration screen by selecting Cancel.
3. In Keyboard test, you can verify whether the selected keyboard layout works as expected.
  
  After verification is complete, select OK.
  
  The Keyboard layout configuration screen appears.
  
  Note:
  If you want to reselect the keyboard layout in the Select keyboard layout screen, select Select keyboard layout.
4. Confirm that the selected keyboard layout is displayed at Current keyboard layout.
  
  After confirmation is complete, select Login.
When you log in, authenticate you as the user to be used when you perform initial installation of VSP One SDS Block (hereinafter referred to as "setup user").

When you log in for the first time or after initializing the setup user password, you must set a new setup user password.

When the setup user login screen of the console interface appears, perform the following procedure:
1. In the login screen, after Password, enter the default setup user password, and then press the Enter key.
  Then, after Current password, reenter the default setup user password, and then press the Enter key.
  - Default setup user password: hsds-setup
2. After New password, enter a new setup user password, and then press the Enter key.
  Then, after Retype new password, reenter the same password that you entered after New password, and then press the Enter key.
  
  The setup user password must meet the following requirements:
  - Length: 8 to 256 characters
  - Types of characters that can be used: Numbers (0-9), uppercase letters (A-Z), lowercase letters (a-z), and the following symbols: ! " # $ % & ' ( ) * + , - . / : ; < = > ? @ [ ¥ ] ^ _ ` { | } ~
  - The password includes at least one number (0-9).
  - The password includes at least one lowercase letter (a-z).
  - A string consisting of five or more different characters
  - Difference from the old password: At least five characters
  - The user name is not included.
  - Words in a dictionary are not used.
  - Not being a palindrome (such as "passwordrowssap")
  - Not being an obvious string (such as "12345678" or "abcdefgh")
  When you are performing this procedure for initial installation, specify the same password for all the storage nodes in the storage cluster.
  Note:
  - If you are performing this procedure as a part of storage node addition or replacement, specify the same password for all the storage nodes to be added or replaced (this password does not have to be the same password as the one specified during the initial installation).
  - When you are performing this procedure for preparing spare nodes, the password does not need to be the same for all the storage nodes in the storage cluster.
  When login is successful, the Top menu screen appears.
  
  Note:
  If you fail to log in to the setup user login screen four consecutive times, the Keyboard layout configuration screen returns.
In the Top menu screen, select Set setting.

Note:
Before selecting Set setting, you can verify the storage software version for the storage node or spare node by selecting Show setting and checking Software version. Confirm that the storage software version matches the version installed in Installing Storage Software.

The Set node name screen appears.

In the Set node name screen, set the storage node name.

Enter the value specified in the VSSB configuration file as it is for the item shown in the following table. See the value of the item described in the [Nodes] category (see VSSB configuration file format). When you finish the input, select OK.

Note:

When you are performing this procedure for preparing spare nodes, enter the setting values that were determined for spare nodes. Values specified here will be displayed in the storage node name area in the console interface. Specify a distinguishable name as a spare node. This name must differ from HostName of the storage node.

Item name in the Set node name screen	Item name or information in the corresponding VSSB configuration file	Input rule
Storage node name	HostName	The character string must be no longer than 63 characters, consisting of alphanumerics and "-." The first character must be alphabetical.

The Select network port configuration mode screen or Network port configuration screen appears.

If the Select network port configuration mode screen appears, go to step 6.

If the Network port configuration screen appears, go to step 7.

Note:

If the value you entered does not meet the input rules, an error message appears at the bottom of the screen. If the error message appears, verify the contents, and then enter the correct value.
If any of the items on the screen does not meet the input rules, selecting OK will not show the next screen.
To return to the Top menu screen, select Back to top, and then select OK. In this case, the settings entered in the Set node name screen will not be saved.

Tip:

Items that have an asterisk (*) are mandatory. Verify that you configure the settings for those items.

To configure network port settings, select Custom. If you do not configure network port settings, select Default.
Note:
- Select Custom in the following cases.
  - When a configuration described in the VSP One SDS Block Bare Metal Hardware Compatibility Reference is applied and FC is used for compute ports.
  - When a configuration other than those described in the VSP One SDS Block Bare Metal Hardware Compatibility Reference is applied.
- Default is available only when a configuration described in the VSP One SDS Block Bare Metal Hardware Compatibility Reference is applied and iSCSI or NVMe/TCP is used for compute ports.
  
  Selecting Default sets network ports automatically.
If you selected Custom, the Network port configuration screen appears. Go to step 7.

If you selected Default, the Set control port setting screen appears. Go to step 8.
Note:
- To return to the Top menu screen, select Back to top, and then select OK. In this case, the settings entered in the Set node name screen will not be saved.
- To return to the Set node name screen, select Previous. In this case, the settings entered in the Set control port setting screen will not be saved.

Configure settings of ports to be allocated to a control port, internode port, and compute port.

To configure network port settings, perform the following procedures.

Select the network port for which you want to configure settings in the Network port configuration screen, and then select OK.

Item name in the Network port configuration		Description
Control port	port#0	Settings of control ports Setting port#1 is optional. If you set port#1, teaming configuration is applied in port#0 and port#1 If teaming configuration is applied, port#0 becomes a primary port and port#1 becomes a secondary port.^*
Control port	port#1
Internode port	port#0	Settings of internode ports Teaming configuration is applied in port#0 and port#1 Port#0 becomes a primary port and port#1 becomes a secondary port.^*
Internode port	port#1
Compute1 port	port#0	Settings of compute ports For iSCSI or NVMe/TCP, select the MAC address and PCI address. For FC, select the WWN (WWPN) and PCI address.
Compute2 port	port#0	Settings of compute ports For iSCSI or NVMe/TCP, select the MAC address and PCI address. For FC, select the WWN (WWPN) and PCI address.
* Each port in teaming configuration is active or standby, and only one port is used for communication at any given time. The port that is active when no link-down occurs is the primary port. The port that becomes active by failover when the primary port experiences a link-down is the secondary port.

CAUTION:

It is possible to mount only one FCHBA in a storage node. If you mount multiple FCHBAs in a storage node and attempt port setting for each FCHBA, set up of VSP One SDS Block becomes unsuccessful.
The number of compute ports must match that of compute ports of a VSSB configuration file. If the number of compute ports is fewer than the number specified in the VSSB configuration file, the storage cluster configuration will not succeed.

The Select port screen appears.

Select a port to be used as a network port in the Select port screen.
Ports are displayed in either of the following formats: "MAC address / PCI address" or "WWN (WWPN) / PCI address."
- Select port screen except for a compute port
- Select port screen for a compute port (for iSCSI or NVMe/TCP)
- Select port screen for a compute port (for FC)
Note:
- A title of the Select port screen differs depending on the port you selected in the Network port configuration screen.
  
  Example: Title displayed when you select port#0 of Control port in the Network port configuration screen
- The port that is displayed as (current setting) on the right of the list is the currently set network port. If you do not change a network port, select (current setting) or Cancel.
  
  To clear the current network port settings, select (current setting).
Tip:
- If [...] is displayed on the last line of the displayed port list, there are other list items on the next page. You can view them by selecting [...].
- If [...] is displayed on the first line of the displayed port list, there are other list items on the previous page. You can view them by selecting [...].
- If (FC) or (iSCSI, NVMe/TCP) is displayed after [...], this (FC) or (iSCSI, NVMe/TCP) indicates the protocol of the port that is displayed by selecting [...].
Tip:
You can confirm the MAC address, WWN (WWPN), and PCI address of the port in the BMC web interface window.

The following shows confirmation procedures for Hitachi Advanced Server HA800 series, HA800 G2 series, HA800 G3 series, and HA800 G6 series. For confirmation procedures for other physical servers, see the respective server vendor documentation.
- How to confirm the MAC address or WWN (WWPN)
  
  For HITACHI iLO7, select Host > Host / Hardware > Network, then select each network adapter to view network details. You can confirm the MAC address under Ports.
  
  For iLO6 and earlier versions, in the navigation tree of the iLO web interface window you can confirm the MAC address or WWN (WWPN) by selecting System Information and then selecting the Network tab.
- How to confirm the PCI address
  
  For HITACHI iLO7, select each slot from Host > Host / Hardware > Device Inventory.
  
  For iLO6 or earlier versions, select System Information in the navigation tree on the iLO web interface window, then select the Device Inventory tab. Select the product name for which you want to confirm the PCI address under Product Name. The PCI address can be confirmed on the Slot Details screen.
Verify that the port you set in step 7-b is displayed in the Network port configuration screen.
- When an iSCSI or NVMe/TCP port is set for a compute port
- When an FC port is set for a compute port
Note:
- To return to the Top menu screen, select Back to top, and then select OK. In this case, the settings entered in the Set node name screen, Select network port configuration mode screen, Select port screen, and Network port configuration screen will not be saved.
- Selecting Previous changes the screen back to the Set node name screen (the screen does not change back to the Select network port configuration mode screen.) In this case, the settings entered in the Select network port configuration mode screen, Select port screen, and Network port configuration screen will not be saved.
Perform steps 7-a to 7-c for all the network ports for which you need to make settings.
After the network port setting is completed, select OK in the Network port configuration screen.

Note:
If any setting item is omitted or the selected ports are duplicated, an error message is output at the bottom of the screen. If an error message is output, confirm the contents to correct the problem.

In the Set control port setting screen, specify the network settings of the control port.

See the VSSB configuration file and enter the values of the items according to the following table. Specifically, see the values of the items in Category: [Nodes] in VSSB configuration file format. When you finish the input, select OK.

Note:

Before you perform this step, run the ping command from the controller node to the IP address to be entered in IP address to confirm that the IP address is not used for another machine.
When you are performing this procedure for preparing spare nodes, enter the setting values that were determined for spare nodes. Values to be specified must meet descriptions of Compute network requirements.

Item name in the Set control port setting screen	Item name or information in the corresponding VSSB configuration file	Input rule
IP address	ControlNWIPv4	Must be in the IP address (IPv4) format.
Subnet mask	ControlNWIPv4Subnet	Must be in the subnet mask (IPv4) format. However, neither 255.255.255.255 nor 0.0.0.0 can be specified.
MTU	ControlNWMTUSize	Must be a value in the range from 1500 to 9000 (bytes).
Teaming¹	Setting to enable or disable teaming of control ports.	Enable or Disable²
Routing table	When a set of routing settings consists of ControlInterNodeNWIPv4RouteDestination`X`, ControlInterNodeNWIPv4RouteGateway`X`, and ControlInterNodeNWIPv4RouteInterface`X`, the number of sets in which the ControlInterNodeNWIPv4RouteInterface`X` value is "control"	Must be a value in the range from 0 to 16.
1. If you made network port settings in step 7, Teaming is not displayed. 2. Teaming is set to Disable by default. Selecting Teaming switches Enable and Disable.

If you set Routing table to a value of 1 or greater, the Set routing table screen will appear after you select OK. Go to step 9.

If you set Routing table to 0, the Check setting screen will appear after you select OK.

Go to step 10.

Note:

If the value you entered does not meet the input rules, an error message appears at the bottom of the screen. If you see the error message, verify the contents and then enter the correct value.
If any of the items on the screen does not meet the input rules, selecting OK will not show the next screen.
To return to the Top menu screen, select Back to top, and then select OK. In this case, the settings entered in the Set node name screen, Select network port configuration mode screen, Select port screen, Network port configuration screen, and Set control port setting screen will not be saved.
If you have performed step 7, selecting Previous changes the screen back to the Network port configuration screen. In this case, the settings entered in the Set control port setting screens will not be saved.

If you have not performed step 7, selecting Previous changes the screen back to the Set node name screen (the screen does not change back to the Select network port configuration mode screen.) In this case, the settings entered in the Select network port configuration mode and Set control port setting screens will not be saved.

In the Set routing table screen, specify the RoutingTable of the control port.

Enter the values specified in the VSSB configuration file as they are for the items shown in the following table.

See the values of the items described in the [Nodes] category (see VSSB configuration file format).

Note:

When you are performing this procedure for preparing spare nodes, enter the setting values that were determined for spare nodes. Values to be specified must meet descriptions of Compute network requirements.

Item name in the Set routing table screen	Item name in the corresponding VSSB configuration file	Input rule
Destination	ControlInterNodeNWIPv4RouteDestinationX¹	One of the following must be specified: Network address (CIDR notation) format IP address (IPv4) format² "default"
Gateway	ControlInterNodeNWIPv4RouteGatewayX¹	The IP address (IPv4) format must be specified.
1. Assuming that one set consists of ControlInterNodeNWIPv4RouteDestination`X`, ControlInterNodeNWIPv4RouteGateway`X`, and ControlInterNodeNWIPv4RouteInterface`X` (`X` is the same number), enter all sets in which the ControlInterNodeNWIPv4RouteInterface`X` value is "control." 2. When you specify Destination in the IP address (IPv4) format, the prefix length is treated as 32 bits.

Item name in the Set routing table screen

Item name in the corresponding VSSB configuration file

Input rule

Destination

ControlInterNodeNWIPv4RouteDestinationX¹

One of the following must be specified:

Network address (CIDR notation) format
IP address (IPv4) format²
"default"

Gateway

ControlInterNodeNWIPv4RouteGatewayX¹

The IP address (IPv4) format must be specified.

1. Assuming that one set consists of ControlInterNodeNWIPv4RouteDestinationX, ControlInterNodeNWIPv4RouteGatewayX, and ControlInterNodeNWIPv4RouteInterfaceX (X is the same number), enter all sets in which the ControlInterNodeNWIPv4RouteInterfaceX value is "control."

2. When you specify Destination in the IP address (IPv4) format, the prefix length is treated as 32 bits.

The Set routing table screen shows setting items for up to 4 RoutingTable per page.

When you configure 5 or more RoutingTable, the Set routing table can span across multiple pages (up to four pages).

If Next is displayed in the lower right corner of the Set routing table screen, you can select it to proceed to the next page.

If any of pages 2 to 4 of the Set routing table screen is displayed, you can select Previous to return to the previous page.

After you entered all the RoutingTable settings, select OK on the last page of the Set routing table screen.

The Check setting screen appears.

Note:

To obtain the number of pages for the Set routing table screen, divide by 4 the value specified for Routing table in the Set control port setting screen and round it up to the nearest integer.

Example:
- If Routing table is set to 5, the number of pages for the Set routing table screen is 2.
- If Routing table is set to 16, the number of pages for the Set routing table screen is 4.
If the value you entered does not meet the input rules, an error message appears at the bottom of the screen. If you see the error message, verify the contents and then enter the correct value.
If any of the items on the screen does not meet the input rules, selecting Next or OK will not show the next screen.
To return to the Top menu screen, select Back to top, and then select OK. In this case, the settings entered in the Set node name screen, Set control port setting screen, and Set routing table screen will not be saved.
To return to the Set control port setting screen, select Previous on the first page of the Set routing table screen. In this case, the settings entered in the Set routing table screen will not be saved.

In the Check setting screen, verify the settings you have currently entered.

If you configured network ports or routing tables, the Check setting screen spans across multiple pages (up to 6 pages).

If Next is displayed in the lower right corner of the Check setting screen, you can select Next to proceed to the next page.

If any of pages 2 to 6 of the Check setting screen is displayed, you can select Previous to return to the previous page.
1. After you verified that the settings displayed on the Check setting screen are the same as those in the VSSB configuration file, select Submit on the last page of the Check setting screen.
  
  Note:
  When you are performing this procedure for preparing spare nodes, enter the setting values that were determined for spare nodes.
  
  A confirmation message appears.
2. If there is no problem, select OK.
  The setup processing for each storage node or each spare node is performed, and then the entered settings are applied to the storage nodes or spare nodes.
  
  This process might take approximately 15 seconds. After the process is completed, the storage node or spare node is automatically restarted.
  Note:
  - When the storage node or spare node is restarted, even if the console interface screen is not displayed normally, do not need to take action.
  - To return to the Top menu screen, select Back to top, and then select OK. In this case, the settings entered in the Set node name screen, Select network port configuration mode screen, Network port configuration screen, Set control port setting screen, and Set routing table screen will not be saved.
  - To modify the setting items, select Previous on the first page of the Check setting screen to return to the Set control port setting screen or the Set routing table screen.
After the restart, the Keyboard layout configuration screen will appear on the BMC remote console. Perform the following.

After selecting OK in step 10, it takes about 10 minutes for the Keyboard layout configuration screen to appear after the restart.
1. Select Login in the Keyboard layout configuration screen.
  
  The login screen for the setup user is displayed.
2. Enter the password of the setup user set in step 3, and then press the Enter key.
  
  If login is successful, the Top menu screen is displayed.
On the Top menu screen, perform the following steps:
1. Verify that "NodeSettingcompleted" is displayed for Storage node status, and then select Show setting.
  
  The Show setting screen appears.
2. Verify that the settings you entered for the control port are reflected in the Show setting screen.
  
  If the entered settings are correctly applied, the setup for the storage node is complete.
  
  After this operation is complete, select Back to top to go back to the Top menu screen. Then, select Logout to log out.
  
  Note:
  When this procedure completes, control ports of the storage nodes or spare nodes are enabled, enabling communication confirmation by Ping from the controller node to control ports of the storage nodes or spare nodes.
Perform steps 1 to 12 for all the storage nodes or spare nodes.
This completes the procedure. You can proceed to the next step for configuring a storage cluster.
Note:
- If you are performing this procedure as a part of storage node addition or replacement, perform this procedure for each of the storage nodes to be added or replaced.
- When you are performing this procedure for preparing spare nodes, perform this procedure for all the spare nodes to be prepared.