Installing Management Server
This is an installation guide for deploying the Infrastructure Optimizer Management Server using the provided AWS CloudFormation template. Intended for DevOps, System Administrators, and Cloud Engineers, it outlines the process from prerequisites to accessing the deployed instance.
CloudFormation Template Installation
Step 1: Preparation
Please verify your environment configurations align with the prerequisites outlined on this page.
Step 2: Navigate to AWS CloudFormation
Log in to the AWS Management Console and select the CloudFormation service.
Step 3: Create a New Stack
Select Create stack > With new resources (standard).
Select Choose an existing template.
Choose to use the Amazon S3 URL, then copy the URL below.
Proceed by clicking Next.
Step 4: Specify Stack Details
Stack Name: Assign a unique name to your CloudFormation stack, e.g.,
IOManagementServer.
Network Configurations
VPC ID: Choose the VPC where the Management Server will be deployed.
Subnet ID: Select the appropriate subnet for deployment.
Is Subnet Public? Indicate
truefor public subnets.VPC CIDR: Enter the CIDR block for the selected VPC.
Shared Security Group ID: Enter the Security Group ID for your EKS or Slurm cluster, or leave it blank.
Instance Configurations
EC2 Instance Type: Select a suitable instance type for the Management Server. The default is
m5d.xlarge.SSH Key Pair: Select an existing SSH key pair. This is used to access the Management Server.
TerminationProtection: We recommend enabling termination protection for your Management Server to prevent accidental deletions or stops.
Volume Size: Define the volume for the Management Server. The default is set to 100 GB, which you can adjust based on your needs.
Click Next to continue.
Step 5: Configure Options
This step is optional. Configure any additional stack options such as tags, permissions, and other settings relevant to your organization. Click Next to advance.
Step 6: Review and Deploy
Carefully review all configurations to ensure accuracy.
Acknowledge the creation of IAM resources by ticking the relevant checkbox.
Initiate the deployment by clicking Create stack.
Step 7: Access the Management Server
Upon successful deployment, navigate to the Outputs section of your CloudFormation stack to retrieve access details:
ExostellarMgmtServerURL: Access URL for the Management Server.
ExostellarMgmtServerPrivateIP: Private IP of the Management Server.
ExostellarAdminUsername: The initial admin username for the Management Server.
ExostellarOptimizerAdminPassword: The initial admin password. Make sure to change this upon your first login for security.
Post-Installation
After successful deployment, log in to the Management Server with the provided credentials. You will be prompted to change the admin password. It's also recommended to explore the platform and configure your infrastructure optimization settings as per your organization's requirements.
How can I verify that my environment is correctly configured and the installation is successful without connecting to a cluster?
Step 1 - Navigate to the Resources tab of the CloudFormation page and go to ExostellarInstance
Step 2 - SSH into the Management Server EC2 instance and start a Hello World VM on Spot!
cp /xcompute/slurm/bin/xcompute-daemon/host-cluster/slurm/test_createVm.sh ~/test_createVm.sh && \
sed -i "s/^XCOMPUTE_HEAD_IP.*/XCOMPUTE_HEAD_IP=127.0.0.1/g" ~/test_createVm.sh && \
cat > ~/user_data.sh <<- EOX
#!/bin/bash
echo "$(cat ~/.ssh/id_rsa.pub)" >> /root/.ssh/authorized_keys
EOX
cd ~ && ./test_createVm.sh -i ubuntu -h hello_world_ubuntu -u ./user_data.shIf you see a message similar to this, congratulations! You have successfully configured and installed everything correctly!
NodeName: hello_world_ubuntutu... 340s
Controller: az1-yy7jyuv5-1
Controller IP: 192.0.12.xx
Vm IP: 192.0.6.xxx
########## done ##########Clean up - Shut down the Hello World VM, and the instances will be automatically terminated:
curl -v -X DELETE http://localhost:5000/v1/xcompute/vm/hello_world_ubuntu