ArcGIS Mission Server can be installed using the installation wizard or the command prompt. For instructions on using the installation wizard, see Install ArcGIS Mission Server with the installation wizard.
Tip:
The installation mode that you choose determines the default uninstallation mode. For example, if you install silently from the command line, the uninstallation defaults to a silent uninstallation from the command line.
Each machine with an installation of ArcGIS Mission Server requires an authorization file. The recommended method of registration is to use the software authorization wizard, which opens after installation, or you can visit My Esri to obtain an authorization file before installing the software.
Prepare to install ArcGIS Mission Server
Before installing ArcGIS Mission Server, complete the following steps:
- Sign in to My Esri and obtain the following files:
- Your ArcGIS Mission Server software download
- Your authorization file
- Verify that your machine meets the system requirements.
- Verify that ports 20443, 20301, and 20160 are available on the ArcGIS Mission Server machine. Ports 20443 and 20301 must be reachable by the ArcGIS Web Adaptor (if used) or external clients. If a firewall is in place between ArcGIS Web Adaptor or external clients, open ports 20443 and 20301 in the firewall. If ArcGIS Mission Server is configured to be highly available, ensure that communication between ArcGIS Mission Server machines is possible via port 20160.
Once you've completed these steps, proceed with the command line installation detailed below.
Note:
Command line parameters are case sensitive. If you have trouble getting your installation to work, confirm that the case matches each property as shown in the code examples below.
Install ArcGIS Mission Server silently from the command line
By default, ArcGIS Mission Server is installed at ${HOME}/arcgis/mission.
- Open a command shell as the user who will run ArcGIS Mission Server. Browse to the directory where you downloaded the ArcGIS Mission Server tar.gz file from My Esri.
- Uncompress the tar.gz file with the following command:
tar -xvzf ArcGIS_Mission_Server_Linux_<version>.tar.gz
- Browse to the directory where the file was uncompressed; then browse to <untar directory>/Documentation/EULA.pdf. Read the license agreement.
- From the directory, run the setup silently and authorize it using a .prvc file. The syntax is as follows:
The parameters of the command line tool are as follows:<untar directory>/Setup -m silent -l yes -a <full path to .prvc file>
Parameter Description -m; --mode MODE (Optional) The install mode: silent or GUI. The default is GUI.
-l; --license-agreement CHOICE Required for silent mode; either yes or no. Yes indicates that you have read and agreed to the Esri Master Agreement (E204, E300). You can review the agreement at any time.
-a; --authorization-file PATH_TO_FILE (Optional) The absolute file path to the authorization or provisioning file provided by Esri.
If this option is not used, you must authorize the software after installation, as detailed in the next section.
-d; --directory DIRECTORY (Optional) By default, ArcGIS Mission Server is installed to your ${HOME}directory. DIRECTORY specifies a different installation directory.
The path /arcgis/mission/ is appended to the installation directory.
The name of the installation directory should be lowercase. The samples and data bundled with the installation require the data path to be lowercase.
-v; --verbose (Optional) Run the installer in verbose mode.
-h; --help Displays the command line help and exits.
-e; --examples Displays usage examples of each option and exits.
- Modify your OS privileges to allow systemd to load and manage processes on ArcGIS Mission Server as follows:
- In a terminal, switch to the root user.
- Copy the <ArcGIS Mission Server install directory>/framework/etc/scripts/agsmission.service unit file to /etc/systemd/system.
- Change the file permissions of this relocated file from 700 to 600 using chmod 600 /etc/systemd/system/agsmission.service.
- Still as the root user, run the following command:
$ systemctl enable agsmission.service
- Restart the systemd service and review its status to verify that it's properly configured:
$ systemctl stop agsmission.service $ systemctl start agsmission.service $ systemctl status agsmission.service
- End the root user session.
- Reboot the operating system and verify that ArcGIS Mission Server starts properly.
Authorize your software silently
If you did not authorize your software during installation, run the software authorization with the following syntax to authorize ArcGIS Mission Server silently. Run the following command to view all options for authorization:<ArcGIS Mission Server install directory>/tools/authorizeSoftware --help
Authorize in a headless environment
You can authorize ArcGIS Mission Server in an environment with no display (headless) using a provisioning (.prvc) file.
- At the prompt, run the following command after the ArcGIS Mission Server installation is complete:
<ArcGIS Mission Server installation directory>/tools/authorizeSoftware -f <full path to the .prvc file> -o <full path to authorization file output>
- When the output information file has been created, do one of the following:
Browse to the Esri customer service website. Follow the instructions to upload your authorization information file and download your .prvc authorization file.
Send your authorization information file by email to authorize@esri.com. Esri will send your .prvc authorization file back to you in an email.
- When you receive your .ecp authorization file, run the authorizeSoftware script again to process it and complete the server authorization process:
<ArcGIS Mission Server installation directory>/tools/authorizeSoftware -f <full path to the .ecp file>
Repeat this workflow for each machine where ArcGIS Mission Server will be installed.
After installing all software, configure ArcGIS Mission Server and create your server site. There is an option to create the site using the createsite command line utility.