ArcGIS Mission Server includes a diagnostics tool you can use to confirm that your machine meets the minimum system requirements and the software is working as expected. If any issues are encountered when running the tool, it lists possible causes and solutions to any problems.
When you start the software installation, the tool runs automatically to confirm that your machine meets the minimum system requirements. Address any issues noted by the tool before proceeding with the installation. If you experience issues after installation, run the tool again to help you identify and diagnose problems.
Run the tool
Run the diagnostics tool from the command line on the machine hosting ArcGIS Mission Server.
- Open a terminal as the user who owns the ArcGIS Mission Server installation directory.
For the tool to execute, the installation owner must have read and write permissions to the /tmp directory on the machine hosting ArcGIS Mission Server.
- Browse to the <ArcGIS Mission Server installation directory>/arcgis/missionserver/tools/ directory.
- Execute missionserverdiag.
Interpret diagnostic results
After running the tool, a report is generated that contains a summary of all the server diagnostic checks performed. It also indicates whether the checks display a warning and whether they passed, failed, or are not applicable to the system.
Each check is identified with a code formatted DIAG<number> followed by the status of the check performed. For an explanation of each diagnostic check, see the table below. You can use this information to analyze the current state of the machine hosting ArcGIS Mission Server.
Check for 64-bit architecture
ArcGIS Mission Server is supported on 64-bit architecture only. If the machine is 32-bit, this check fails. Consult the system requirements for supported operating systems.
Check OS version
A warning appears if the operating system is not a supported Linux distribution or version. Consult the system requirements for supported Linux platforms and OS versions. If the operating system is not a supported Linux distribution, the other checks will not be performed.
Check host name for invalid characters
Valid characters for the host name of the ArcGIS Mission Server machine include alphanumeric a–z, 0–9, and minus (-) and dot (.) characters as outlined in the RFC 952 specification. The check fails if the host name contains one or more invalid characters.
Check system limits
For ArcGIS Mission Server to run properly, the minimum file handle limits for the installation user are required to be set to 65535 and the minimum number of processes limits set to 25059. This check confirms whether these limits are set properly in the /etc/security/limits.conf file. If the limits are set too low, this check fails. To verify, run the following:
ulimit -Hn -Hu
ulimit -Sn -Su
Check WebSocket port
ArcGIS Mission Server uses port 20300, and 20301 for WebSocket connections. If the WebSocket port is in use by another user or process, this check will return a warning and ArcGIS Mission Server will not run properly. To correct this issue, ensure ports 20300 and 20301 are available and restart ArcGIS Mission Server.
Check HTTPS port
ArcGIS Mission Server uses port 20443 for HTTPS. This check determines whether these ports are in use by another user or process. If this check returns a warning, ArcGIS Mission Server will not run properly. To correct this issue, ensure port 20443 is available and restart ArcGIS Mission Server.
Check host name IP address mismatches
If the host name entry is present for the machine in the /etc/hosts file and it does not match the IP address of the machine, this check returns a warning. This will cause ArcGIS Mission Server to function improperly. To correct this issue, fix the host name entry and restart ArcGIS Mission Server.
Check /etc/hosts for host name entry
The host name entry for the machine in the /etc/hosts file must be formatted as <IP> <FQDN> <Machine_name>. Update the host name entry before creating your ArcGIS Mission Server site.
Check processes for ArcGIS Mission Server core services
The check verifies that all the core services are started after ArcGIS Mission Server is started. It returns a warning if one or more core services do not start. To correct this issue, start ArcGIS Mission Server by running the startmissionserver.sh script, or restart ArcGIS Mission Server if it is already running.