v2.3.5.0 Installing with x-install Tool (Kubernetes)

The x-install tool is the newest Exostellar installer designed to simplify the setup process. It offers a variety of subcommands to provision a sandbox environment, install Exostellar products, and verify post-installation readiness.

Prerequisites

Before using the x-install tool, ensure that your environment meets the following requirements:

• Terraform: Version 1.8+

• kubectl: Version 1.28+

• Helm: Version 3.14.2+

• AWS CLI

• AWS Authentication, Credentials, and Region
  Please properly configure AWS authentication and default region in your local environment.

Ensure the account has the following IAM permissions:

• Valid AWS Marketplace Subscriptions for Exostellar Management Server, Exostellar Controller, Exostellar Worker AMIs for the same AWS account

• SSH Key

• x-install tool: Version 0.0.15+

Installation Steps

Creating a Sandbox EKS Cluster and Deploying the Management Server

1. Create a Standalone Stack

Navigate to the directory where x-install is downloaded and use the following command to create a standalone stack, customizing the cluster name, VPC CIDR, SSH key pair, and region to suit your environment:

• The new VPC and EKS cluster will inherit the stack name.

• The VPC will be assigned the CIDR block 10.0.0.0/16.

• The EC2 SSH key pair, my-dev-key, will be used to access the Exostellar Management Server.

2. Verify Post-Installation Readiness

After the standalone stack is successfully created, use the following command to check if the stack is ready:

Deploying the Management Server into an Existing EKS Cluster

1. Add Necessary IAM Permissions

Ensure all required IAM resources are present by running:

2. Check the Target Environment

Verify the existing EKS cluster meets installation prerequisites:

3. Install the Management Server

Deploy the Management Server into the existing EKS Cluster:

4. Integrate the Management Server with the Existing EKS Cluster

Run the following command to complete the integration:

Adding X-Compute Nodes to the EKS Cluster via eks-node-cli

1. Access the Management Server

SSH into the Exostellar Management Server using:

2. Add a New Node

Run this command on the server to add a new node to the EKS cluster:

Adding X-Compute Nodes to the EKS Cluster via Exostellar Karpenter

Reference deployment example:

Cleaning Up

The entire standalone stack can be deleted with the destroy command:

Additional Help and Support

To explore other subcommands, use the following command for a list of available options: