Configuration settings

Configuration settings allow administrators to configure application-level organizational settings within ArcGIS Excalibur. This includes general application settings and specific ArcGIS Video Server settings. These ArcGIS Video Server settings are only available on ArcGIS Enterprise. The application-level configuration settings will only be displayed and available if you are signed in as an administrator. These settings can be accessed through Set app configuration level settings in the side navigation bar. Alternatively access these settings by clicking the profile drop-down menu in the upper corner and clicking App settings. 

Configure general app settings

General settings are configured with the following workflows.

Change the theme

An administrator can choose to change the Default Theme setting, which is set to the dark theme by default. To change the default theme, complete the following steps: 

1. Select the theme.
   • Dark Theme works well when viewing imagery or video in dark or dimly lit operating environments.
   • Light Theme works well when viewing imagery or video in brighter and well-lit environments.
2. Relaunch the application to apply the selected theme.

Users can override the default theme with Viewing Mode in the user settings.

Change the default start page

An administrator can also change the Default Start Page setting, which is set to Connect View by default. To change the Default Start Page, complete the following steps: 

1. Click the start drop-down menu and select the desired theme.
2. Relaunch the application to apply the new default start page.

Users can override the default start page with Start Page in the user settings.

Configure ArcGIS Video Server settings

If an ArcGIS Video Server is installed and federated in the environment in which Excalibur is running, an administrator can configure specific settings that directly impact the server running Video Server. If no Video Server server is identified, these settings will not be available. These settings will only be available for ArcGIS Enterprise.

Configure a system managed data store

The defaults storage location for streaming web optimized video content and metadata is the local file system. Alternatively, a portal administrator can register an existing object store to the video server. The hosting server's object store is a data management system for streaming web-optimized video content and metadata. To optionally register an existing object store to the Video Server, complete the following steps:

1. Click the Data Storestab in the Configuration Settings page.
2. Click Register Hosted Data Store.
3. Click Register on the dialog box to confirm.

Set active data store

Once an object store has been registered with Video Server, an administrator can set the object store as the active data store on the server running Video Server. All video and associated video service metadata files will be stored in the active data store. By default, ArcGIS Video Server uses the filesystem to store these files. To set the active data store in Video Server, complete the following steps: 

1. Click a data store.
2. Click Set as Active data store.

Set the elevation source

Using an elevation source increases the accuracy of the video frame footprints. ArcGIS Video Server is installed with a preconfigured set of global elevation resources, including Shuttle Radar Topography Mission (SRTM) 2 and Earth Gravitational Model (EGM) 2008 1 and 2.5 minute spacing for use in georeferencing video content. An administrator can register additional elevation-based imagery layer items that are registered as an item in the system.

To register an elevation source, complete the following steps:

1. Click the Elevation Sources tab in the Configuration Settings page.
2. Input the item ID of the ArcGIS imagery layer to use as the elevation source.
3. Click Register Layer.

The layer will be registered as the elevation source. To remove the registered elevation source, click Remove on the layer you want to remove.

Set port configurations for livestreams

An administrator can manage multiple livestream settings to include defining default ports used by certain livestream protocols and defining the dynamic port range. To set the port configurations and protocols for livestreams, complete the following steps: 

1. Click the Livestreamstab in the Configuration Settings page.
2. Specify a default RTMP port or RTSP port.

   By default, ArcGIS Video Server uses the reserved ports for RTMP (port 1935) and RTSP (port 554). These ports can be changed, but must be within the port range of 1024 to 65535.

3. Specify a dynamic port range that should be allowed for livestream that uses dynamic port bindings.

   The dynamic port range applies to the SRT and UDP livestream protocols.

4. Click Save to save your changes.
5. Select which Listen Mode or Pull Mode protocols that should be available during livestream video layer publishing.
6. Click Save.

   Changes are saved for livestream ports.

Set Listen and Pull Mode settings

An administrator can enable or disable the use of specific protocols and protocol listeners when publishing new or viewing existing video layers for both Listen and Pull modes. Listen mode enables ArcGIS Video Server to listen for livestream content being pushed to it using designated ports and protocols. The livestream listener for Listen mode can turned off for specific protocols. Pull mode enables ArcGIS Video Server to pull remote livestream content using a provided URL. To specify the Listen and Pull mode settings, complete the following steps:

1. Click the Livestreamstab in the Configuration Settings page.
2. Select which Listen Mode listeners should be turned on or off.

   Turning off a listener will disable the processor required to view existing or create new livestream feeds for the selected protocol. This means any existing video layer of the selected protocol published prior will no longer be accessible.

3. Select Listen Mode protocols should be available during livestream video layer publishing.
4. Click Save.
5. Select Pull Mode protocols.
6. Click Save.

   Listen mode and pull mode settings are updated.

Set the maximum upload file size

An administrator can set the maximum upload file size for a single file when uploading video content during the publishing process. The default maximum upload size is 5 GB and can be increased up to 10 GB. Setting the maximum upload size to 0 will disallow uploaded files from being saved on the server and will prevent publishing video layers by file uploads. To set the maximum upload file size, complete the following steps: 

1. Click the Uploads tab in the Configuration Settings page.
2. Use the slider or input a value to the desired maximum upload file size.
3. Click Update Max Size.