Installation guide
This guide applies to the On-prem/Cloud deployment (customer managed) models
Prior to the installation of Kubeark, it is important to ensure that the requisite infrastructure is appropriately configured. Options for this infrastructure include physical machines, virtual machines, or a private cloud solution to host the necessary resources.
Prerequisites:
Resource allocation: A minimum of 3 machines need to be configured
HW/SW Requirements: Ensure that each machine meets or exceeds the minimum hardware requirements such as CPU, RAM, and disk space.
Network Configuration and Firewall: please follow the recommended setup here
Once the necessary infrastructure has been established, the subsequent step involves generating a configuration file. This file is a mandatory component in tailoring the Kubeark installation process to align with your organization's requirements.
Create Configuration File: Utilize a text editor to generate a new configuration file, ensuring it is saved with the relevant file extension, such as YAML.
Edit Parameters: Incorporate the requisite settings into the configuration file to reflect the specifications of your operational environment. Such settings may include machine IP addresses, network configurations, and additional variables integral to the system's proper functioning.
- Mandatory parameters
- Optional parameters
Save and Copy: After customization, save the configuration file. Then securely copy this file onto each machine in your infrastructure setup.
For an online installation of Kubeark, you will need to download specific packages and use SSH for secure data transfer and commands. The process involves both local and remote operations on your infrastructure nodes.
Receive Custom URL: Once your Kubeark license is activated, check your email for a message containing your unique custom URL. This URL is specifically generated for your organization and will guide you through the online installation process. The URL would typically look like this: Kubeark Installer 3.0.0-beta.4566
Set permissions: Open your terminal and navigate to the directory where the installer binary is saved. Use the chmod command to set the necessary execution permissions:
Prepare SSH Key: Ensure you have an SSH key pair to securely communicate with your nodes. If not, generate one and then use scp to copy the private key to your first infrastructure node. This will be used to comunicate with the other nodes, as alternative you can use user/pass but is not that secure
Transfer Configuration and Installer: Use scp to copy the configuration file and installer binary to the target node.
SSH into the Node: Connect to the first infrastructure node using SSH. Replace 192.168.xx.xx with the IP address of the node you're connecting to:
Run the Installer: Execute the installer with the following command. This uses the transferred configuration file (e.g. online-install.yaml) and initiates the cluster creation process:
The offline installation method is intended for environments without internet connectivity. Unlike the online installation, this method requires you to download the complete installation package image files, which are approximately 5GB in size. You'll then run the installation locally on your target infrastructure nodes.
Download Required Files: Navigate to the Kubeark download page and download the installer and image files. e.g. kk-artifact-3.0.0-beta.4566.tar.gz
This specific download page URL will be provided to the customer through an email communication following the license activation.
Set permissions: Open your terminal and navigate to the directory where the installer binary is saved. Use the chmod command to set the necessary execution permissions.
Transfer Files to Node: Use a secure method, such as scp, to transfer the downloaded installer and image files to the first infrastructure node.
Prepare SSH Key: Ensure you have an SSH key pair to securely communicate with your nodes. If not, generate one and then use scp to copy the private key to your first infrastructure node. This will be used to comunicate with the other nodes, as alternative you can use user/pass but is not that secure
Initialize the local container registry: Before running the installer to create your cluster, you'll first initialize a local container registry and populate it with the necessary images. These commands also use the kk-artifact-3.0.0-beta.4566.tar.gz package, which should be located in the same directory as your offline-install.yaml file.
Push the artifact images to the registry
Create the cluster using the local registry and packages
After successfully completing the installation of Kubeark, please validate that the deployment is operational and configured as expected. This step involves accessing the custom Kubeark URL that you specified earlier in the configuration file (refer to Step 2). By doing so, you can verify that the service is accessible and functioning correctly.
