Unable to start Portal for ArcGIS, ArcGIS Server, or ArcGIS Data Store using systemd in ArcGIS Enterprise 10.9.1 on Ubuntu (Dec 2021) Amazon Machine Image (AMI) EC2 instance launched directly from the Amazon Web Services (AWS) Management Console

Description

BUG-000145299, which affected the ArcGIS Enterprise 10.9.1 on Ubuntu (Dec 2021) Amazon Machine Image (AMI) only, was fixed in ArcGIS Enterprise 10.9.1 on Ubuntu (April 2022). Esri recommends that you use the ArcGIS Enterprise 10.9.1 on Ubuntu (April 2022) AMI to launch new 10.9.1 deployments.

If you downloaded the ArcGIS Enterprise 10.9.1 on Ubuntu (Dec 2021) AMI or created a template from it and are using it to create a deployment, follow the instructions in this article to launch a deployment from the AWS Management Console.

There are two ways to start Portal for ArcGIS, ArcGIS Server, and ArcGIS Data Store services in an Esri ArcGIS Enterprise 10.9.1 on Ubuntu (Dec 2021) AMI EC2 instance that is launched directly from the AWS Management Console.

The first method is to use the built-in start tools that reside in the installation directory. For example:

• /opt/arcgis/portal/startportal.sh
• /opt/arcgis/server/startserver.sh
• /opt/arcgis/datastore/startdatastore.sh

The second method is through systemd by using the following commands:

• sudo systemctl start arcgisportal.service
• sudo systemctl start arcgisserver.service
• sudo systemctl start arcgisdatastore.service

The following errors are returned when using the command sudo systemctl start arcgisportal.service to start the Portal for ArcGIS service:

Job for arcgisportal.service failed because the control process exited with error code.
systemd[1]: Starting Portal for ArcGIS Service...
systemd[14250]: arcgisportal.service: Failed at step EXEC spawning /arcgis/portal/startportal.sh: No such file or directory
systemd[1]: Failed to start Portal for ArcGIS Service.

The following errors are returned when using the command sudo systemctl start arcgisserver.services to start the ArcGIS Server service:

Job for arcgisserver.service failed because the control process exited with error code.
systemd[1]: Starting ArcGIS Server Service...
systemd[14250]: arcgisserver.service: Failed at step EXEC spawning /arcgis/server/startserver.sh: No such file or directory
systemd[1]: Failed to start ArcGIS Server Service.

The following errors are returned when using the command sudo systemctl start arcgisdatastore.service to start the ArcGIS Data Store service:

Job for arcgisdatastore.service failed because the control process exited with error code.
systemd[1]: Starting ArcGIS Data Store Service...
systemd[14250]: arcgisdatastore.service: Failed at step EXEC spawning /arcgis/datastore/startdatastore.sh: No such file or directory
systemd[1]: Failed to start ArcGIS Data Store Service.

Cause

At 10.9.1, the installation directory for ArcGIS Server, Portal for ArcGIS, and ArcGIS Data Store were changed on the ArcGIS Enterprise 10.9.1 on Ubuntu (Dec 2021) AMI from /arcgis to /opt/arcgis, but the systemd service files in /etc/systemd/system were not updated with the new installation directories.

Workaround

Instructions are provided to start the service for each component and configure each service to start with the operating system.

Portal for ArcGIS

1. Connect to your ArcGIS Enterprise 10.9.1 on Ubuntu (Dec 2021) AMI EC2 instance using SSH and a terminal emulator from Windows, or an SSH connection from Linux.
2. Using a text editor of your choice, modify the /etc/systemd/system/arcgisportal.service.
   1. Change ExecStart=/arcgis/portal/startportal.sh to ExecStart=/opt/arcgis/portal/startportal.sh
   2. Change ExecStop=/arcgis/portal/stopportal.sh to ExecStop=/opt/arcgis/portal/stopportal.sh
3. Save the changes made to /etc/systemd/system/arcgisportal.service.
4. Run the following command to enable the service to start with the operating system:

sudo systemctl enable arcgisportal.service

5. Run the following command to start the service:

sudo systemctl start arcgisportal.service

6. Check the status of the service to verify it started successfully:

sudo systemctl status arcgisportal.service

ArcGIS Server

1. Connect to your ArcGIS Enterprise 10.9.1 on Ubuntu (Dec 2021) AMI EC2 instance using SSH and a terminal emulator from Windows, or an SSH connection from Linux.
2. Using a text editor of your choice, modify the /etc/systemd/system/arcgisserver.service.
   1. Change ExecStart=/arcgis/server/startserver.sh to ExecStart=/opt/arcgis/server/startserver.sh
   2. Change ExecStop=/arcgis/server/stopserver.sh to ExecStop=/opt/arcgis/server/stopserver.sh
3. Save the changes made to /etc/systemd/system/arcgisserver.service
4. Run the following command to enable the service to start with the operating system:

sudo systemctl enable arcgisserver.service

5. Run the following command to start the service:

sudo systemctl start arcgisserver.service

6. Check the status of the service to verify it started successfully:

sudo systemctl status arcgisserver.service

1. Connect to your ArcGIS Enterprise 10.9.1 on Ubuntu (Dec 2021) AMI EC2 instance using SSH and a terminal emulator from Windows, or an SSH connection from Linux.
2. Using a text editor of your choice, modify the /etc/systemd/system/arcgisdatastore.service.
   1. Change ExecStart=/arcgis/datastore/startdatastore.sh to ExecStart=/opt/arcgis/datastore/startdatastore.sh
   2. Change ExecStop=/arcgis/datastore/stopdatastore.sh to ExecStop=/opt/arcgis/datastore/stopdatastore.sh
3. Save the changes made to /etc/systemd/system/arcgisdatastore.service
4. Run the following command to enable the service to start with the operating system:

sudo systemctl enable arcgisdatastore.service

5. Run the following command to start the service:

sudo systemctl start arcgisdatastore.service

6. Check the status of the service to verify it started successfully:

sudo systemctl status arcgisdatastore.service