Install - Single Node / POC

This section explains how to install KumoScale in Appliance mode for a single storage node.

Single Node Installation Guide

The KumoScale storage software is installed by booting from an install media. Using a virtual DVD ROM device is the best way to install the KumoScale software. You should mount the install image as a virtual DVD ROM device using a remote console session. Then proceed to boot the server using the virtual DVD ROM device.

Prepare the Installation Files

The ISO image file is named kumoscale-3.20-xxxxxx.iso, where xxxxx is the version number. It is available at https://flex1717.flexnetoperations.com/flexnet/operationsportal/startPage.do. Attach the ISO to the virtual CD-ROM device of the server.

Installation Command Line Parameters

Several installation settings can be changed via kernel parameters passed in as command line arguments. Some of them are explained in Table 6 below (a complete list of kernel parameters can be found in

Supply the values through the grub menu as explained in Virtual CD Installation in the Install - Multinode / Production section.

Table.  Installation Command Line Parameters for a Single Node Installation

Parameter

How Used

kx_cluster_vip

Master VIP. The virtual IP of the KumoScale storage cluster must be provided during the installation of the first node for the cluster. It is bound to the management interface and must be on the same subnet as the KumoScale management IP. If this parameter is not set, the server is set up as a storage node. Do NOT provide it for any other node.

For example, kx_cluster_vip=192.###.1.###

kx_pods_cidr

Optional parameter for the first master node installation only. It allows the user to manually select the value of $POD_NETWORK_CIDR.

When this parameter is not defined by the user, a /16 range is selected out of the free private range.

The value must be in cidr annotation and must define a free private address range. free private range is within:

1.      192.168.0.0/16 - entire range

2.     10.0.0.0/8 - excluding 10.96.0.0/12 used for k8s services (10.0.0.0/16 - 10.95.0.0/16, 10.112.0.0/16 - 10.255.0.0/16)

3.     172.16.0.0/12 - excluding 172.16.0.0/16 used by docker (172.17.0.0/16 - 172.31.0.0/16)

All the above excluding subnets configured on the machine (mgmt: static/dhcp)

Configure the Boot Order

NOTE: In AMD server-based systems, the IOMMU needs to be disabled. This is done by setting Virtual Technology to Disable. Specifically, in the certified Quanta Cloud Technology (QCT) systems, this BIOS setting is found under:

AMD CBS > NBIO Common Options > NB Configuration > IOMMU (default = Auto). Change this value to Disabled.

You will need to configure the BIOS to boot from the correct location. For details on how to configure the BIOS, refer to your platform’s user manual or vendor.

Complete the steps below to configure the boot order:

1. Set the UEFI. Booting from the UEFI instead of legacy BIOS requires choosing the UEFI boot setting in the BIOS menu.
2. Set the following boot order
    • Local hard drive
    • Virtual CD-ROM

3. Disable Hyper-Threading. Hyper-threading must be disabled (or verify it is disabled).

4. Configure Serial Port Redirection. To install via serial port, configure the BIOS for serial port redirection with the first device (COM0 or COM1).

Start the Installation

To start the installation, complete the following steps for your install environment. Installation will take a few minutes; the exact time depends on your environment. You may observe multiple reboots, and even be prompted for a login before installation has completed. You must wait until you get a confirmation that the Installation has completed successfully before logging in as instructed in the next step.

  1. Boot your platform. You will be presented with a boot menu. Use the up and down keys to highlight the first menu entry, KumoScale Master of Cluster (Define the cluster VIP).

installman-fig9

2. Press the e key to edit the entry.

installman-fig12

4. Use the Up and Down keys to go to the third line on the screen that starts with the word linuxefi.

5. Go to the end of the line and replace the IP address there with your cluster VIP.

6. Press the Ctrl-x key to continue.The CentOS installation screen will appear,
installman-fig14

Verify Installation Success

At the end of a successful installation:

  • The masters are set up with the KumoScale Provisioner service, control operators for installation and configuration, and the CSI driver.
  • Worker storage nodes are configured with DHCP unless a static IP has been specified.

Do not proceed until you get the message stating installation success similar to the message below.

installman-fig15

Configure the KumoScale Storage Cluster from a Remote Administrative Host

Refer to Install: Prerequisites &Preparation to review the requirements for a remote administrative host.

  1. From your remote host enter:
ssh admin_cli@<VIP for the Master>.
2.  When asked for a password, enter:
admin
3. You will be prompted for a new password for admin_cli. Set the password according to operating system requirements.
4. Confirm the new password.
5. You will get a message about re-opening the session. The above interaction is shown below.
installman-fig16

6. Log back in using the new password. You are now ready to set up your remote host to access the KumoScale storage cluster.

installman-fig17

7. At the CLI> prompt enter the command:
CLI> setup-wizard

8. The following screen will be displayed. Enter and then confirm the RBAC password. This is the administrative password for your KumoScale cluster.

installman-fig18

9. On the next screen, enter the license key provided by your KIOXIA representative.

installman-fig19

10. Provide a name for your node.

installman-fig20

11. KumoScale gathers the NVMe SSDs in your node in a group. Provide a name for this group on the next screen.

installman-fig21

12. On the next screen, pick option 1 (1- Manual Time Settings).

installman-fig22


13. Then select the time zone region.

installman-fig23

14. After that, select the city closest to you in your time zone.

installman-fig24
15. Next you will be answering questions about the data path connection to your node. First pick a name for the connection, portal.

installman-fig25

16. Next identify the transport type. TCP IP is a safe choice here as all NICs support it. If you are doing a performance-focused installation, you may want to choose the RoCEv2 option. Please consult the KumoScale Hardware Compatibility List (HCL) to ascertain whether your NIC supports RoCEv2.

installman-fig26

17. Next pick the type of connection. Option 1 (1-Physical) is a safe choice here which allows you to connect a single physical port on your NIC to the data path. Both LACP and VLAN connections require support from the network switch connected to your node.installman-fig27

18. On the next screen you will pick the physical port(s) on your NIC you will be using for the data path. If you picked a physical connection in the previous step, then you will be asked to pick exactly one port. Please make sure that you know which port on the NIC you have connected your network cable and the MAC address of that port. Look for that MAC address in the list provided on your screen and pick the corresponding interface.


19. Finally, you will be asked to provide an IP address, subnet mask and port number for the data connection. This IP address is assigned statically. So please make sure that it falls outside the range of addresses that that your DHCP server (if you have one in your network) assigns from.

20. On the next screen, you will see all the information you have provided so far (except the RBAC password). Note that the license key has been blacked out in the screenshot below. Please read it carefully. Type Yes if you want to go ahead with these configurations.

installman-fig28

21. If you enter No on the previous screen, you will be asked if you want to reset the node to factory settings. Please answer Yes. The node will then perform a factory reset during which you will lose your network connection. When the node finished boot back up, you can retry the procedure in this section to configure the node starting at Configure the KumoScale Storage Cluster from a Remote Administrative Host.


22. Please refer to Install Internal Components on Storage Cluster to install additional software components on your KumoScale node.

Next: Maintenance