Create an ArcGIS Mission Server site

A server site is an individual deployment of ArcGIS Mission Server and you can federate it with your ArcGIS Enterprise portal.

You can create the site using the ArcGIS Mission Server configuration wizard or the createsite command line utility.

Use the wizard to create a site

The ArcGIS Mission Server configuration wizard creates an ArcGIS Mission Server site on the machine.

  1. Open the wizard and click Create Site.
  2. Provide a user name and password and click Next.
  3. Note:
    The primary site administrator account using this user name and password is recognized only by ArcGIS Mission Server. It's not an operating system account, and it's managed separately from the user accounts in your user store. The primary site administrator has unrestricted access to the ArcGIS Mission Server site. This account is typically used to create the ArcGIS Mission Server site and to configure and manage security. The primary site administrator account shouldn't be confused with the ArcGIS Mission Server account you provided during installation.
  4. Type the paths to the directories you want to use for your content directory, workspace directory, and configuration store.

    By default, they are created in <ArcGIS Mission Server installation directory>/arcgis/mission/usr/directories.

    You can use different directories on your local drive or your network for the configuration store, content store, and logs. This location must be accessible to the ArcGIS Mission Server account, and the account must have read and write permissions to it.

  5. Click Next.
  6. Review the summary page and click Finish to create your site, or click Back to make changes.

When your server site has been created, configure a reverse proxy with ArcGIS Mission Server or install and configure ArcGIS Web Adaptor.

Use the createsite utility to create a site

After ArcGIS Mission Server is installed, you can use the createsite command line utility to create a server site. If you use the createsite utility, you have the following options:

  • Provide the path to the createsite.properties file that specifies these parameters. This is the recommended option, as it is more secure.
  • Run the createsite utility as the ArcGIS Mission Server account from the command prompt window, specifying the following:
    • User name
    • Password
    • Configuration store location
    • Directory

The configuration store and directory parameters are optional. The utility is located at <ArcGIS Mission Server install directory>/tools/createsite/createsite.sh.

Note:

If using a UNC path for directories and config-store, you must escape any backslashes \ when designating them. This applies only for the createsite utility and when using createsite utility to create a site from a file.

The command line parameters for the utility are as follows:

ParameterDescription

-u or --username

The user name for the primary site administrator. The user name cannot contain these characters: \:/*?!<>"".

-p or --password

The password for the primary site administrator. The password cannot contain these characters: \:/*?!<>"".

-d or --directory

The root server directory. By default, the server directories are created locally, for example, <ArcGIS Mission Server install directory>/usr/directories.

-c or --configstore

The configuration store for the ArcGIS Mission Server site. A sample properties file is located in /<ArcGIS Mission Server install directory>/usr/config-store.

-f or --file

The properties file for the createsite utility. By default, the createsite.properties file is located at <ArcGIS Mission Server installation directory>/tools/createsite.

-h or --help

Display this help message and exit.

Specify parameters in the utility

If you're specifying parameters in the utility, run the command with the following syntax: createsite.sh [-u <username>] [-p <password>] [-d <directory>] [-c <config-store>]. The directory and config-store parameters are optional in this command.

The following code example demonstrates keeping the default directory and configuration store locations:

<ArcGIS Mission Server install directory>/tools/createsite/createsite.sh -u missionPSA -p password -d path/to/directories -c path/to/config-store

Specify parameters from a file

If you're specifying parameters from a file, run the command to use the createsite.properties file with the following syntax: createsite.sh [-f <filepath>]. A sample template of this file is located in <ArcGIS Mission Server install directory>/tools/createsite. The file should use the following syntax:

# Configuration properties for Server site creation
#
# user name for primary site administrator.
# Cannot contain these characters: \\/:*?<>"
SERVER_ADMIN_USERNAME =
# Password for primary site administrator.
# Cannot contain these characters: \\/:*?<>"
SERVER_ADMIN_PASSWORD =
# Initially, leave SERVER_ADMIN_PASSWORD_ENCRYPTED set to false.
# When you run the tool the first time, the password will be
# encrypted and SERVER_ADMIN_PASSWORD_ENCRYPTED will change to true.
SERVER_ADMIN_PASSWORD_ENCRYPTED = false
# Root server directory. By default, the server directories will be created locally.
SERVER_DIRECTORIES_PATH =
# Configuration store for the ArcGIS Mission Server site. By default, the configuration store will be created locally.
SERVER_CONFIGSTORE_PATH =

When you run the utility successfully, a message appears before the tool closes indicating that the ArcGIS Mission Server site was created.

When your server site has been created, configure a reverse proxy with ArcGIS Mission Server or install and configure ArcGIS Web Adaptor.