ArcGIS Mission Server administrator operations

The following sections describe the properties available to ArcGIS Mission Server administrators. Each property is described along with its path, located in the ArcGIS Mission Server administration site by browsing to the URL https://machine.domain.com:20443/arcgis/admin.

Import an existing server certificate

To import an existing server certificate, click Home > Machines > MachineName > sslCertificates > importExistingServerCertificate.

This operation imports an existing server certificate into the keystore. If the certificate is a Certificate Authority (CA) signed certificate, you must first import the CA root or intermediate certificate using the importRootOrIntermediate operation.

Import a root certificate

To import a root certificate, click Home > Machines > MachineName > sslCertificates > importRootOrIntermediate.

This operation imports a CA's root and intermediate certificates into the keystore. To create a production-quality CA-signed certificate, add the CA's certificates to the keystore that enables the SSL mechanism to trust the CA (and the certificates it has signed). While most of the popular CA's certificates are already available in the keystore, you can use this operation if you have a custom CA or specific intermediate certificates.

Update the security configuration

To update the security configuration, click Home > Security > SecurityConfig > UpdateSecurityConfig.

This operation updates the security configuration, including TLS protocols and cipher suites, for your ArcGIS Mission Server site. This operation causes the REST service endpoints to be redeployed on every server machine in the site. If you updated the communication protocol as part of this operation, it takes ArcGIS Web Adaptor one minute to recognize changes to the communication protocol of your site.

Delete a site

To delete a site, click Home > Delete Site.

This operation deletes the site configuration and releases all server resources. It is suited for development or test servers that need to be cleaned up regularly and can also be performed before uninstallation. Use caution with this option because it deletes all settings and other configurations and is an unrecoverable operation.

This operation performs the following tasks:

  • All server machines participating in the site are stopped.
  • All server machines are unregistered from the site.
  • The configuration store is deleted.

Edit system properties

Administrators can edit ArcGIS Mission Server properties to fit their organization. Custom property values can be set at https://machine.domain.com:20443/arcgis/admin/system/properties/update. Administrators can find system properties that can be set by using the API Reference link in the upper right corner of the screen. When setting a custom system property, the property must be set as a valid JSON object. Multiple system properties can be set at a time, as long as they are strung together as valid JSON, for example:


{
"WebSocketContextURL":"wss://machine.domain.com/<webadaptor>",
"AuthTokenTimeInSeconds":"180"
}
The sections below describe common system properties an administrator can use.

Define a WebSocketContextURL

A WebSocketContextURL is a system property that allows clients to make WebSocket connections to ArcGIS Mission Server. WebSocket connections are the foundation of real-time communication in ArcGIS Mission Server. If client applications are having difficulty making WebSocket connections to ArcGIS Mission Server, setting a WebSocketContextURL property can resolve connectivity issues. WebSocket connections to ArcGIS Mission Server always begin with wss://, for example:

{"WebSocketContextURL":"wss://machine.domain.com/<context>"}

Define the length of time a JSON Web Token is valid

The JSON Web Token (JWT) is used for user authentication. The length of time that the JWT is valid can be altered.

If this time is not set, the default is 180 seconds, for example:

{"AuthTokenTimeInSeconds":"180"}

Configure ArcGIS Web Adaptor

To configure ArcGIS Web Adaptor, click Home > System > Web Adaptors > WebAdaptorConfig.

The ArcGIS Web Adaptor configuration is a resource for all the configuration parameters shared across the web adaptors in the site. This resource identifies the shared key used by all the web adaptors to encrypt key data bits in the incoming requests to the server.

Back up the site

It is recommended that you frequently export your site settings through the admin API. You can do this by browsing to Home > Export Site. It is recommended when defining a destination property for the exported site that the location be a network drive, or a location other than the ArcGIS Mission Server machine itself. The destination must be a location that is accessible to the ArcGIS Mission Server machine. In the event of a site failure, the site can be recovered by creating a new server site and browsing to Home > Import Site.

Note:

If you have a multimachine ArcGIS Mission Server site and the site fails, it is only necessary to import the site once as described above and then join other ArcGIS Mission Server machines to the site normally.

Edit the log settings

To edit the log settings, click Home > Logs > Logs > Settings > Edit.

This procedure updates the log settings for the entire server site, such as log output location, level, and format, as well as log file age.

Update mode

The update  operation is used to move between the two types of site modes. Switching to READ_ONLY mode will restart all your services as the default behavior. Moving to EDITABLE mode will not restart services. By default, your site is set to editable mode. This means that the site is open to administrative configuration and new services can be published. Enabling this mode prohibits the publishing of new mission services and blocks most administrative operations.

Webhook sync

The webhook sync operation provides the ability for ArcGIS Mission Server to resynchronize its webhooks with Portal. This is an important operation that can be used when ArcGIS Mission Server may appear to not be behaving properly, such as users not being added to a mission, teams not being added, and so on. Use this operation with caution, as any users connected to an ongoing mission will be disconnected. You can initiate this operation by browsing to the Admin API, then choosing System > Webhooks > Sync.