# Manually Install and configure HPE Ezmeral Container Platform 5.2

Follow the steps as outlined to install and configure the HPE Ezmeral Container Platform. 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 Container Platform binary (.bin) folder and provide the necessary execution permission.
> chmod a+x <<HPE Ezmeral Container Platform.bin>>

> ./<<HPE Ezmeral Container Platform.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 similar to http://controller-ip (opens new window). The screen shown in Figure 16 will appear. For further configuration of the controller, provide the necessary information, and click Submit.

Figure 16. HPE Ezmeral Container Platform Controller setup

Figure 17 shows the configuration required to set up a Data Fabric.

Figure 17. HPE Ezmeral Container Platform Controller setup with HPE Ezmeral Data Fabric for Kubernetes

  1. After the successful configuration, a screen appears as shown in Figure 18. Enter an appropriate username and password to login to the HPE Ezmeral Container Platform management UI.

Figure 18. HPE Ezmeral Container Platform Management UI login screen

  1. The dashboard as shown in Figure 19 appears upon successful login.

Figure 19. HPE Ezmeral Container Platform Kubernetes - Dashboard

# Platform high availability

Add EPIC Hosts - Worker Node

  1. Login to the HPE Ezmeral Container Platform web interface. Navigate to EPIC drop-down on the left pane, click hosts and add EPIC worker hosts as shown in Figure 20

Figure 20. HPE Ezmeral Container Platform -- EPIC worker 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 Container Platform high availability, the HPE Ezmeral Container Platform 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 Container Platform, go to GLOBAL SETTINGS drop-down. Click Controllers and select enable HA checkbox as shown in Figure 21. Provide the Cluster IP, Shadow Controller, and Arbiter Node and click Submit.

Figure 21. HPE Ezmeral Container Platform -- Enabling platform HA

# HPE Ezmeral Container Platform 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 Container Platform.

Figure 21. HPE Ezmeral Container Platform gateway Kubernetes orchestrator

  1. Prior to adding the HPE Ezmeral Container Platform Gateway host, the HPE Ezmeral Container Platform 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 22. HPE Ezmeral Container Platform - Adding Gateway Server

  1. After the Gateway Server is installed, a green "Installed" status is seen as shown in Figure below.

Figure 23. HPE Ezmeral Container Platform -- 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 24 as an External load balancer.

Figure 24. External Load Balancer for HPE Ezmeral Container Platform

Add multiple gateway servers as Gateway LB as shown in Figure 25. 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 25. HPE Ezmeral Container Platform -- Gateway LB high availability

To add one or more Gateway Worker host(s) to your HPE Ezmeral Container Platform 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 Container Platform does not validate these rules.

For more information on load balancing, see https://docs.containerplatform.hpe.com/52/52/universal-concepts/Load_Balancing.html?hl=load%2Cbalancing (opens new window).

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. Do not select the Host view under the EPIC tab.

  3. Enter details for IP List, Username, Credentials, and Password and then click Submit as in Figure below. HPE Ezmeral Container Platform will install the software and perform the initial configuration. This step will complete when the status shows "phase 1 of 2 completed". Figure 26. HPE Ezmeral Container Platform -- 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 Container Platform 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 27. HPE Ezmeral Container Platform -- 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 28. HPE Ezmeral Container Platform -- 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 27. When done, click Next. HPE Ezmeral Container Platform 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.

    NOTE

    Please refer to Creating DataFabric Cluster

Figure 29. HPE Ezmeral Container Platform Kubernetes Cluster creation Host configuration

  1. The Cluster Configuration page appears. Provide the necessary information as shown below and then click on Next. Figure 30. HPE Ezmeral Container Platform Kubernetes Cluster Configuration Page

  2. Authentication page appears, Provide the necessary information if required and then click on Next. Figure 31. HPE Ezmeral Container Platform Kubernetes Cluster Authentication Page

  3. Application Configuration page appears, select the list of applications if required and then click on Next. Figure 32. HPE Ezmeral Container Platform Kubernetes Cluster List of Applications

  4. Summary page shows selected hosts and configuration details. Click on Submit to create cluster. Figure 33. HPE Ezmeral Container Platform Kubernetes Cluster creation Summary

  5. When the Kubernetes cluster has successfully been created, a page appears as in Figure below. Figure 34. HPE Ezmeral Container Platform 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 35. HPE Ezmeral Container Platform 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 up 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 36. HPE Ezmeral Container Platform launching Kubernetes Dashboard -- Auth token

  • Paste the token value in the next screen and click Sign in as in Figure below Figure 37. HPE Ezmeral Container Platform launching Kubernetes Dashboard -- applying Auth token

  • A Dashboard Overview page similar to Figure below appears. Figure 38. HPE Ezmeral Container Platform Kubernetes Dashboard