Minimum Linux Install

Minimal installation will install Kubernetes and Kato on a Linux node, which can help you save resources. But it is really not friendly to the production environment. If you need to install a production cluster, please test Install the highly available Kato on Linux.

Prerequisites

Installation Steps

Configure Keyless Login

$IP is for all node addresses including itself, enter yes and root password as prompted

ssh-keygen -t rsa -b 2048 -N '' -f ~/.ssh/id_rsa
ssh-copy-id $IP

Download the Installation Package

wget https://kato-pkg.gitlab.com/offline/5.2/easzup && chmod +x easzup && ./easzup -D

Start Installation

  1. Optional, when you need to set the public IP as the access address of the Kato cluster, please execute the following command
export EIP=Public IP
  1. Use the default configuration to install and minimize the Kato cluster
./easzup -S && docker exec -it kubeasz easzctl start-aio
  1. After the execution is complete, the following prompt appears:
 [INFO] save context: aio
 [INFO] save aio roles' configration
 [INFO] save aio ansible hosts
 [INFO] save aio kubeconfig
 [INFO] save aio kube-proxy.kubeconfig
 [INFO] save aio certs
 [INFO] Action successed : start-aio
 [INFO] Visit http://$IP:30008 to view the installation progress
  1. Follow the prompts to visit the corresponding address http://$IP:30008 to check the installation progress of the Kato platform:

    The above page shows that the installation is complete. Click Access Address to register and start using Kato.

Troubleshooting Common Problems

  1. If the server’s sshd service is not installed using the default port 22, modify the /etc/ansible/example/hosts.allinone file in the following format before performing the installation step 2, where $PORT is sshd Service port
 [etcd]
 192.168.1.1 NODE_NAME=etcd1 ansible_ssh_port=$PORT
 [kube-master]
 192.168.1.1 ansible_ssh_port=$PORT
 [kube-node]
 192.168.1.1 ansible_ssh_port=$PORT
  1. http://$IP:30008 or http://$IP:7070 cannot be accessed:

    The cause of this problem may be that the IP address or port indicated by the access address cannot be accessed. It is recommended to check whether the network from the client to the access address IP is normal. When the network is normal, check whether the firewall security group policy, etc., have the corresponding port access authority. If you are using Alibaba Cloud’s ECS resources, confirm whether the displayed IP address is an external IP

  2. Unable to register users after accessing the console:

The cause of this problem may be that the initialization of the console database failed. Re-initialize the console database through the following operations and register again

  • Enter the pod of rbd-db
kubectl exec -it -n rbd-system rbd-db-0 bash
  • Login to the database
 mysql -p$MYSQL_ROOT_PASSWORD
  • Delete the console library
 drop database console;
  • Delete the database initialization job and make it run again
 kubectl delete job -n rbd-system rbd-app-ui-migrations
  • Wait for the database initialization to be completed, and STATUS will be Completed after completion
 kubectl get po -n rbd-system -l name=rbd-app-ui-migrations

For other problems during installation and use, please refer to Installation Troubleshooting Document and Cluster Problem Diagnosis Document