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+
Git: Version 2.34+
x-install tool: Version 0.0.10+
AWS Account: Ensure the following IAM permissions are in place:
| Expand | ||
|---|---|---|
| ||
|
Installation Steps
1. Create a Standalone Stack
Use the following command to create a standalone stack:
(Please ensure you modify the stack name, VPC CIDR, SSH key pair, and region to suit your environment.)
| Code Block |
|---|
x-install create-standalone \ --stack-name=xio-standalone \ --vpc-cidr=10.0.0.0/16 \ --ssh-key-pair-name=my-dev-key \ --region=us-west-1 |
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:
| Code Block |
|---|
x-install post-install --stack-name=xio-standalone |
| Info |
|---|
It might take a few attempts for |
3. Add an X-Compute Node to the Standalone EKS Cluster
To add an X-Compute node to the newly created standalone EKS cluster, first SSH into the Exostellar Management Server:
| Code Block |
|---|
ssh rocky@<management-server-public-ip> |
On the server, run the following command to add a new node to the EKS cluster:
| Code Block |
|---|
eks-node-cli add -n node-00 -c 1 -m 4096 -p pool-a -r az1 -k xio-standalone |
The new node can be verified using the kubectl command:
| Code Block |
|---|
$ kubectl get node -l eks.amazonaws.com/nodegroup=x-compute |
The output should display the new nodes as ready:
| Code Block |
|---|
NAME STATUS ROLES AGE VERSION ip-10-0-39-220.us-west-1.x-compute.internal Ready <none> 4m17s v1.29.3-eks-ae9a62a |
By default, the EKS token used to access the standalone EKS cluster expired after 60 minutes. Following that, all attempts to access the cluster will fail with Unauthorized errors.
To generate a new EKS token and use it with your existing kubeconfig file, run:
| Code Block |
|---|
x-install update-kubeconfig --stack-name=xio-standalone |
Once the free trial period is over, the entire standalone stack can be deleted with the destroy command:
| Code Block |
|---|
x-install destroy --stack-name xio-standalone |
Sometimes, Terraform might time out during the destroy process. Re-running the destroy command will allow Terraform to reconcile its final state.
| Info |
|---|
At this time, all controllers and workers EC2 instances need to be manually terminated. |
For more information on other subcommands, run:
| Code Block |
|---|
x-install help |
| Info |
|---|
If you encounter any issues, please take a screenshot of your |