There are some prerequisites to meet and configurations to make before you begin to deploy Adeptia Automate using Adeptia Rancher package. Adeptia provides the Adeptia Rancher package, which includes Rancher, Rancher Kubernetes Engine 2 (RKE2), Adeptia Automate application, and other required components to simplify deployment and cluster management.
Prerequisites
System requirements
-
**Linux VM nodes:**To be used as master/server nodes. Rancher Infrastructure will be deployed on these VMs. Ensure that the following prerequisites are met:
- The VMs have private IPs assigned to them.
- VMs are prepared. This is required only when you have Red Hat OS installed on the VMs.
- You have administrative privileges on each Linux VM.
- The following inbound ports are opened on the the VM nodes:
- 9345 - required for RKE2 nodes clustering
- 6443 - required for Kubernetes API
- 443 - required for the Adeptia Automate application
-
**Jumpbox (Optional):**A Jumpbox is a secure computer system used to provide secure access to the VMs in the network. The purpose of a jumpbox is to provide a single entry point for administrators to access the VMs through private IPs. When an administrator wants to access a system within the network, they first connect to the jumpbox using a secure protocol such as SSH (Secure Shell). From the jumpbox, they can then connect to the target VMs. If you want to connect through Jump Box, ensure that you have:
-
One Jumpbox with internet access and SSH connectivity with the Linux nodes to download, extract, and run the package. The minimum configuration for Jumpbox is given below.
-
Administrative privileges on Jumpbox.
Rancher deployment can be performed using either a Primary Linux VM or a Jump Box.
-
-
The following table shows the recommended configuration for the VM nodes and the Jump Box:
Hardware Prod Prod Prod Non-Prod Non-Prod Non-Prod Linux node Jumpbox NFS Storage Linux node Jumpbox NFS Storage --- --- --- --- --- --- Number of VMs 3 1 500 GBs 3 1 250 GBs RAM (in GB) 32 4 32 4 Processor cores 16 2 8 2 Hard disk (in GB) 128 128 128 128 Operating System Any of the following:
• Ubuntu 24.04
• Red Hat Enterprise Linux 10.2
• Amazon Linux 2Same as you use for the VM nodes. Any of the following:
• Ubuntu 24.04
• Red Hat Enterprise Linux 10.2
• Amazon Linux 2Same as you use for the VM nodes.
| | RHEL-based operating systems typically mount the /var and /tmp directories as separate filesystems. To ensure reliable operation and accommodate application workloads, sufficient storage capacity must be allocated to both locations before deployment.
The recommended storage allocation varies depending on the deployment model:
| Directory | Cluster deployment | Single-node deployment |
| --- | --- | --- |
| /var | Minimum 40 GB per node | Approximately 100 GB |
| --- | --- | --- |
| /tmp | Minimum 10 GB | Approximately 20 GB |
| --- | --- | --- |
Ubuntu typically places the /var and /tmp directories on the root (/) filesystem.
If your Ubuntu deployment uses separate filesystems for either of these directories, the same storage sizing recommendations apply. |
| --- | --- |
- **Load Balancer:**Ensure that you have either L4 or L7 load balancer.
- If you have L4 load balancer, ensure that you have:
- Publicly accessible Load Balancer on the top of Linux VMs.
- The following inbound ports opened on the Load Balancer and the VM nodes:
- 9345 - required for RKE2 nodes clustering
- 6443 - required for Kubernetes API
- 443 - required for the Adeptia Automate application
- If you have L7 load balancer, ensure the,
- Publicly accessible Load Balancer on the top of Linux VMs.
- Port 443 is open.
- If you have L4 load balancer, ensure that you have:
Apart from the aforementioned system requirements, ensure that you have:
-
The user Id 1000 is assigned to you before you begin to install the Adeptia Rancher package on cluster nodes.
-
SSH private key in PEM (Privacy Enhanced Mail) format for communication between one VM to another and with the Jumpbox.
You need to use the PEM file without passphrase protection. -
CA/self signed certificates.
-
Python 3.12.x, Python Package Manager (PIP), and Ansible 2.18.x installed on the primary node or the Jump Box. ******