Manually create an AMI on AWS

This is a one-time procedure. The AMI can be used to create multiple instances of Lighthouse, and upgrades can be performed through the Lighthouse Web UI.

IMPORTANT: Before you perform this procedure, ensure that you have an account on AWS with an IAM user, a key pair and an access key. For more detailed requirements, see Before you begin.

1. On your machine, open a Command Line Interface to create a Lighthouse AMI, using the lighthouse-aws-bootstrap.sh script (usage information can be displayed by using the -h option):

   1. Configure AWS using the following command: aws configure

   2. Provide the access key and region details (other settings may be left unchanged). If you are using IAM Identity Center, you must instead configure using aws configure sso, and set the CLI Profile Name to be default.

   3. Download the aws-bootstrap script:
      wget http://ftp.opengear.com/download/lighthouse_software/current/lighthouse/aws/lighthouse-aws-bootstrap.sh

   4. Run the lighthouse-aws-bootstrap.sh script as follows:
      bash ./lighthouse-aws-bootstrap.sh -r https://ftp.opengear.com/download/lighthouse_software/current/lighthouse/aws/lighthouse-<year>-<month>-<version>.aws.raw.tar
      The following is an example of a running bootstrap script:

      $ ./aws-bootstrap.sh -f lighthouse-25.04.2.aws.raw.tar -n "Lighthouse"
      No S3 path specified. Creating temporary S3 bucket...
      Created temporary S3 bucket: lighthouse-bootstrap-temp-1757310585
      Extracting image from tar file...
      Converting lighthouse image disk (lh_hdd) to VMWare image disk (vmdk)...
      Uploading VMDK image to S3...
      Importing VMDK image to EC2 as a snapshot...
      Creating AMI from snapshot: import-snap-701eff180afc7772t
      Registering AMI...
      AMI created with ID: ami-0b579f51631ad0071
      Cleaning up temporary S3 bucket: lighthouse-bootstrap-temp-1757310585
      Done!

   5. Wait while the Lighthouse AMI is created.
      This can take up to 30 minutes.
      If an error occurs, and an S3 bucket was not manually provided to the script, you must delete the S3 bucket created by the script to avoid incurring additional charges. The name of this bucket is printed to the shell.

2. In AWS, navigate to the Amazon Machine Images (AMIs) page of the EC2 Management Console.

3. Select the Lighthouse AMI.
   The Imagine summary for ami-[ID] displays.

4. On the top-right of the page, click Launch instance from AMI.
   The Launch an instance page displays.

5. Complete the steps in Configure and Launch the Instance.