Manually Install and configure HPE Ezmeral Runtime Enterprise 5.6.x

Follow the steps as outlined to install and configure the HPE Ezmeral Runtime Enterprise. This section assumes you have followed all the prerequisites mentioned in the earlier sections.

1. Login to the host that will be used as the Controller host. Navigate to the HPE Ezmeral Runtime Enterprise binary (.bin) folder and provide the necessary execution permission.

> chmod a+x <<HPE Ezmeral Runtime Enterprise.bin>>
> ./<<HPE Ezmeral Runtime Enterprise.bin>> --default-password <<password>>

After the software is installed on the Controller, launch the Web UI using the URL provided at the end of the installation. The link should be like http://controller-ip (opens new window). The screen shown in Figure 13 will appear. For further configuration of the controller, provide the necessary information, and click Submit.

Figure 13. HPE Ezmeral Runtime Enterprise Controller setup

2. After the successful configuration, a screen appears as shown in Figure 14. Enter an appropriate username and password to login to the HPE Ezmeral Runtime Enterprise management UI.

Figure 14. HPE Ezmeral Runtime Enterprise Management UI login screen

3. The dashboard as shown in Figure 15 appears upon successful login.

Figure 15. HPE Ezmeral Runtime Enterprise Kubernetes – Dashboard

Platform high availability

• Add Arbiter & Shadow Controller hosts

Login to the HPE Ezmeral Runtime Enterprise web interface. Navigate to Controllers&HA, click on Shadow Contorller & Arbiter hosts and add hosts as shown in Figure 16

Figure 16. HPE Ezmeral Runtime Enterprise – Arbiter & Shadow host installation

1. Select the respective disks for the Docker storage and for the HPE Ezmeral Data Fabric and proceed for the installation of worker nodes.

2. Prior to adding the HPE Ezmeral Runtime Enterprise high availability, the HPE Ezmeral Runtime Enterprise needs to be put into Site Lockdown mode. To do this, select Enter site lockdown in the quick access menu.

3. After successfully adding worker hosts to the HPE Ezmeral Runtime Enterprise, go to Controllers&HA and select enable HA checkbox as shown in Figure 17. Provide the Cluster IP, Shadow Controller, and Arbiter Node and click Submit.

Figure 17. HPE Ezmeral Runtime Enterprise – Enabling platform HA

HPE Ezmeral Runtime Enterprise Gateway

Gateway servers map the services running in Ezmeral nodes or containers to ports and balance service loads. Add the designated gateway server(s) to the HPE Ezmeral Runtime Enterprise.

Figure 18. HPE Ezmeral Runtime Enterprise gateway Kubernetes orchestrator

1. Prior to adding the HPE Ezmeral Runtime Enterprise Gateway host, the HPE Ezmeral Runtime Enterprise needs to be put into Site Lockdown mode.

2. Add the gateway by clicking the Gateway LB on the left pane and provide the details as shown in Figure below. Click Add Gateway

Figure 19: HPE Ezmeral Runtime Enterprise – Adding Gateway Server

3. After the Gateway Server is installed, a green “Installed” status is seen as shown in Figure below.

Figure 20. HPE Ezmeral Runtime Enterprise – Gateway added and installed.

Gateway Host high availability

Redundancy for multiple Gateway hosts can be achieved by mapping multiple Gateway host IP addresses to a single hostname. When this is done, then either the DNS server or an external load balancer will load-balance requests to the hostname among each of the Gateway hosts on a round-robin basis. This ensures that there is no single point of failure for the Gateway host.

If required existing load balancing solution such as NGINX can be used to further enhance the capability of the Gateway such as least connection load balancing, SSL termination, etc.

The existing load balancing solution is shown in Figure 21 as an External load balancer.

Figure 21. External Load Balancer for HPE Ezmeral Runtime Enterprise

Add multiple gateway servers as Gateway LB as shown in Figure 22. Map these Gateway host IP addresses to a single hostname that adds redundancy for Gateway hosts. After this is done, then either the DNS server or an external load balancer will load-balance requests to the hostname among all the Gateway hosts on a round-robin basis. This ensures that there is no single point of failure for the Gateway host.

Figure 22. HPE Ezmeral Runtime Enterprise – Gateway LB high availability

To add one or more Gateway Worker host(s) to your HPE Ezmeral Runtime Enterprise deployment, you must specify a hostname in the Hostname field. If you specify one hostname for more than one Gateway IP address, then either the DNS server or external load balancer will load-balance requests to the hostname among all the Gateway hosts on a round-robin basis. For example, if three Gateway hosts are sharing a hostname, then Users 1-3 will access virtual nodes via Hosts 1-3. User 4 will access virtual nodes using Host 1, and so on. You may add additional Gateway host(s) to an existing set at any time by specifying the IP address (es)of the Gateway host(s) you are adding and then entering an existing Gateway hostname. You can use Gateway hostnames in one of the following ways:

1. Configure the Gateway hostname in the corporate DNS server to resolve the IP address (es) of the Gateway host(s).

2. Configure an external load balancer with rules to point traffic to the IP address (es) of the Gateway host(s). HPE Ezmeral Runtime Enterprise does not validate these rules.

For more information on load balancing, see gateway-lb.

Note: Ensure that you exit from Site lockdown mode at this point.

Add Kubernetes Hosts

Adding each K8s host is a two-phase process:

• Phase 1: Add the host and do an initial bundle installation

• Phase 2: Configure and confirm storage allocation for this node

Add the host and perform the initial installation

1. Expand the KUBERNETES tab on the left pane of Web UI.

2. Navigate to the Hosts tab under the KUBERNETES tab.

3. Enter details for IP List, Username, Credentials, and Password and then click Submit as in Figure below. HPE Ezmeral Runtime Enterprise will install the software and perform the initial configuration. This step will complete when the status shows “phase 1 of 2 completed”.

Figure 23. HPE Ezmeral Runtime Enterprise – Adding Kubernetes Hosts

Configure and confirm storage allocation for this node

1. After the bundle is installed, phase 1 is completed. Click edit to confirm disk allocation. HPE Ezmeral Runtime Enterprise can only add raw disks.

2. After the disk allocation is confirmed, select the newly added host and click Install as in Figure below to complete the Kubernetes node installation.

Figure 24. HPE Ezmeral Runtime Enterprise – Storage allocation and installing Kubernetes nodes

3. When Install is selected, a new dialog box will appear to confirm the action. Select OK to continue. The installation will take between 5-10 minutes.

4. After the Kubernetes node is successfully added, a ready status appears as shown in Figure below

Figure 25. HPE Ezmeral Runtime Enterprise – Kubernetes nodes Ready status

Create a Kubernetes Cluster

1. Click the Create Kubernetes Cluster on the Kubernetes Clusters page under the KUBERNETES tab.

2. Provide a Name and description and then select the master and worker nodes for the cluster as shown in Figure 26. When done, click Next. HPE Ezmeral Runtime Enterprise will automatically configure the HPE Ezmeral Data Fabric using the local drives configured with the nodes. This will be used as persistent storage for containerized application.

Figure 26. HPE Ezmeral Runtime Enterprise Kubernetes Cluster creation – Host configuration

3. The Cluster Configuration page appears. Provide the necessary information as shown below and then click on Next.

Figure 27. HPE Ezmeral Runtime Enterprise Kubernetes Cluster Configuration Page

4. Authentication page appears, Provide the necessary information if required and then click on Next.

Figure 28: HPE Ezmeral Runtime Enterprise Kubernetes Cluster Authentication Page

5. Application Configuration page appears, select the list of applications if required and then click on Next.

Figure 29: HPE Ezmeral Runtime Enterprise Kubernetes Cluster List of Applications

6. Summary page shows selected hosts and configuration details. Click on Submit to create cluster.

Figure 30. HPE Ezmeral Runtime Enterprise Kubernetes Cluster creation - Summary

7. When the Kubernetes cluster has successfully been created, a page appears as in Figure below.

Figure 31. HPE Ezmeral Runtime Enterprise Kubernetes Cluster Creation Status Ready

Launch the Kubernetes Dashboard

To access the Kubernetes Dashboard for the cluster that was just created, click Dashboard icon for the cluster as shown in Figure below.

Figure 32. HPE Ezmeral Runtime Enterprise launching Kubernetes Dashboard

• Click the download icon to download the kubeconfig file. For more details on how to configure or use the kubeconfig on your client see https://kubernetes.io/docs/concepts/configuration/organize-cluster-access-kubeconfig/ (opens new window)

• Select the Dashboard icon to open in a new window. This allows the user to access the Kubernetes Dashboard with an Auth token as shown in Figure below Highlight and copy the token. Select Proceed to Kubernetes Dashboard.

Figure 33. HPE Ezmeral Runtime Enterprise launching Kubernetes Dashboard – Auth token

• Paste the token value in the next screen and click Sign in as in Figure below

Figure 34. HPE Ezmeral Runtime Enterprise launching Kubernetes Dashboard – applying Auth token

• A Dashboard Overview page similar to figure below appears.

Figure 35. HPE Ezmeral Runtime Enterprise Kubernetes Dashboard