Skip To Content

Administer your Amazon EC2 Ubuntu Linux instance with remote access from Linux

If you use the Amazon Web Services (AWS) console to create an AWS instance running ArcGIS for Server, you can log in to authorize ArcGIS for Server, and configure data and services on the instance.

  1. Log in to the AWS Management Console and open the instance list for your account and region.
  2. Make sure your instance is running.
  3. Choose your instance from the list and examine its Description information. Note or copy the name given for Public DNS.


    Depending on how you created your EPC-VPC instance, it may not have a public DNS. For example, instances created by ArcGIS Server Cloud Builder on Amazon Web Services do not have a public DNS. If there is no public DNS for your instance, allocate an Amazon Elastic IP and associate it with your instance. Record the Elasitc IP. You will use the Elastic IP instead of the DNS to connect to your instance later in this workflow.

  4. Open any SSH client (such as PuTTY).
  5. Locate your private key file that you specified when you created the instance, for example, arcgisserver.pem.
  6. Use chmod to make sure your key file isn't publicly viewable; otherwise, SSH won't work:
    chmod 400 arcgisserver.pem
  7. Connect to your AWS instance using its public DNS or Elastic IP.

    To perform ArcGIS Server tasks, such as authorizing ArcGIS for Server, connect as the arcgis user. To perform operating system-level tasks, such as starting the web server, connect as the ubuntu user.

    The following example makes an ssh connection as the arcgis user to an instance with an Elastic IP of using the key file arcgisserver.pem:

    ssh –i arcgisserver.pem
  8. Authorize ArcGIS for Server by running the authorizeSoftware script. You need to reference an Esri license file.
    arcgis@ip-10-82-222-58:$ cd /arcgis/server/tools/
    arcgis@ip-10-82-222-58:/arcgis/server/tools$ ./authorizeSoftware <prvc_license_file> [email]

    You can run the authorizeSoftware tool with the --help option to see all possible syntax.

  9. ArcGIS for Server is ready for you to create a site.

    Every time you stop and start the instance, Amazon assigns your instance a new machine name and Public DNS name/IP Address. Therefore, it is not helpful to create shortcuts or hard-coded references to your instance unless you have configured an Amazon Elastic IP for your instance and you reassociate this IP every time you start the instance.