Skip To Content

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

Once you have launched an ArcGIS Server or ArcGIS Enterprise instance on Amazon Web Services, you can log in 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. 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. Add a rule to your security group that opens port 22 (the SSH port) to your network. See Open an Amazon EC2 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 AWS 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 Amazon Management Console rather than ArcGIS Server Cloud Builder on Amazon Web Services or an Esri AWS CloudFormation template, you need to authorize the software. Both ArcGIS Server and Portal for ArcGIS contain an authorizeSoftware script in their tools directory. Run the script and reference an Esri license file appropriate to the product you want to authorize. 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

  10. Once your software is authorized, you can create a site or portal. Steps are the same for on-premises and cloud deployments, so follow the instructions in the ArcGIS Server or Portal for ArcGIS help.

    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.