When working with machines provisioned using Amazon EC2, one can use a Lumino Controller AMI to provision, deploy, configure and controls X applications within the cloud environment.

The controller AMI includes a Lumino Server, a Lumino Agent, and an influx instance. Applications can be run on the controller machine (depending on its capacity) or additional machines can be provisioned and the controller machine configured to be able to deploy and control applications on the provisioned machine. Additionally, one can deploy just a Lumino Agent in the cloud environment and connect it to an on-premise Lumino Server instance allowing on-premise users visibility into cloud environments over a secure connection.

In this section, we'll walk through how to use the pre-bundled nvx-controller AMI to bootstrap a cloud environment.

Provisioning a Lumino Controller AMI

Execute the following steps to provision an X Controller

  1. Login to AWS/EC2
  2. Select AMIs from the left-hand sidebar
  3. Change the filter from "Owned by me" to "Public images"
  4. Enter "nvx-controller" into the search bar, and select the latest
  5. Launch a new machine using the nvx-controller-<version> AMI 
    1. Click on AMIs on the left panel of the EC2 Management Console, select the AMI and click Launch
    2. A minimum of 4GB RAM is recommended (we recommend using a t2.large).
  6. In the launch wizard when you get to the section on configuring the security group, create a Custom TCP rule to allow access to port 8001. 


  7. When prompted for a key-pair, create a new one, or use an existing one you already have access to. If you need additional assistance, please see here
  8. Wait for the instance to launch
  9. (Recommended) Configure local hostname address in /etc/hosts:
    This step is recommended if you plan to launch applications on this host that use loopback or 0.0.0.0 addresses to ensure that the address can be resolved. 
    1. Locate the Private DNS entry by clicking on the newly launched instance: 
    2. ssh into the machine using the key pair you selected during configuration and the public IP address shown for your instance. 
      1. ssh -i ~/Downloads/YOUR_PEM_FILE.pem ec2-user@public_ipv4_ip

    3. using vi or another editor edit /etc/hosts to add the private DNS address from above to the 127.0.0.1 entry: 
      sudo su - root
      vi /etc/hosts

      127.0.0.1 localhost localhost.localdomain ip-XX.XX9-57
  10. Record the public address/name of the new machine (e.g. the IPv4 address shown above). 
  11. Go to http://<publicAddress>:8001
    1. You should see the X Platform Lumino console, you can log in with admin/admin. 
  12. (Optional) If you are not able to get to the console or you see an error that the agent is not available, it is possible that the hostname has not been applied. In this case reboot your instance. 
    1. Note: This needs to be done only once after a fresh provision
  13. Repeat step 11

The controller is ready for use.