Skip To Content

Administer your Amazon Elastic Compute Cloud Ubuntu Linux instance with remote access from Linux

Once you have launched an ArcGIS Server or ArcGIS Enterprise instance on Amazon Web Services (AWS), you can log in to the Amazon Elastic Compute Cloud (EC2) instances to authorize software (if necessary) or perform other ArcGIS administrative tasks.

  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. 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. Add a rule to your security group that opens port 22 (the SSH port) to your network. See Open an Amazon Elastic Compute Cloud security group for ArcGIS for instructions.
  5. Open any SSH client.
  6. Locate your private key file that you specified when you created the instance, for example, arcgisserver.pem.
  7. Use chmod to make sure your key file isn't publicly viewable; otherwise, SSH won't work:
    chmod 400 arcgisserver.pem
  8. Connect to your EC2 instance using its public DNS or Elastic IP.

    To perform ArcGIS tasks—such as authorizing ArcGIS Server or Portal for ArcGIS, creating a site, or upgrading ArcGIS software—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
  9. If you launched your instance from the AWS Management Console, you need to authorize ArcGIS Server. ArcGIS Server includes an authorizeSoftware script in its tools directory. Run the script and reference an ArcGIS Server authorization file. You must also provide an email address when your run the script.

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

    The following example authorizes ArcGIS Server using the ArcGIS_Server.prvc license file and the email

    arcgis@ip-10-82-222-58:$ cd /arcgis/server/tools/
    arcgis@ip-10-82-222-58:/arcgis/server/tools$ ./authorizeSoftware ArcGIS_Server.prvc

    You also need to import a Portal for ArcGIS license file when you create the portal. You can create the portal through a web browser, though, so you do not need to connect to the EC2 instance to license Portal for ArcGIS.