For a production environment, the user and business needs for the software may vary. These requirements must be considered in determining hardware needs to meet performance and scalability expectations. Some minimum requirements are listed below. Minimum requirements will support the application, but may not perform well.
Hardware requirements
| Item | Supported and recommended |
|---|---|
CPU | Minimum: 2 cores, simultaneous multithreading Simultaneous multithreading or hyperthreading of CPUs typically features 2 threads per core. A multithreaded 2-core CPU will have 4 threads available for processing, while a multithreaded 6-core CPU will have 12 threads available for processing. |
Storage | Minimum: 200 GB of free space* |
Memory/RAM | Minimum: 8 GB |
Dedicated (not shared) graphics memory | Minimum: 6 GB or more If you're using a notebook computer with an integrated GPU, consider increasing the system RAM to compensate for the use of shared memory. |
Storage on ArcGIS Video Server will depend on how this is configured.
GPU requirements
It is recommended that you install ArcGIS Video Serverin an NVIDIA GPU environment that supports NVENC (encoding) and NVDEC (decoding) for optimal publishing, encoding, use, and dissemination of video services. Driver version 531.61 or later is required. See the NVIDIA support matrix for a complete list of GPU cards that support video encoding and decoding.
Video Server can be installed on a machine without GPU, but certain functionality will be lost and streaming performance will be affected. This includes not having the option to select output resolutions when publishing on-demand video, inability to publish video files encoded with non-h.265 and h.264 codecs, cannot rotate video in landscape mode to portrait mode, and latency or buffering when viewing video services.
| Item | Supported and recommended |
|---|---|
GPU type | NVIDIA GPU with CUDA compute capability 12.1 or above. See the list of CUDA-enabled cards to determine compute capability of a GPU. |
GPU driver | NVIDIA GPU drivers: version 531.61 or later is required. |
Dedicated graphics memory | Minimum: 6 GB or more. |
Note:
An out-of-date GPU driver may cause encoding and decoding issues or for the server to report that it has no GPU. Verify that you have up-to-date GPU drivers directly provided by NVIDIA.
Install GPU drivers
To install GPU drivers on Suse Linux, complete the following steps:
- Type sudo zypper install -y lshw.
- Check which package contains nvdia-smi: cnf nvidia-smi.
- List all NVIDIA packages.
- sudo zypper se nvidia*
- Install all required packages:
- sudo zypper install nvidia-compute-utils-G06
- sudo zypper install nvidia-video-G06
- sudo zypper install nvidia-utils-G06
- sudo reboot
- sudo nvidia-smi -acp UNRESTRICTED
- sudo usermod -a -G video <MY-USER-NAME>
- logout (re-login)
To install GPU drivers on Ubuntu Linux, complete the following steps:
- Type sudo ubuntu-drivers autoinstall 1. sudo reboot.
- Check whether driver update is successful: nvidia-smi.
- Optional: sudo apt install nvidia-cuda-toolkit.
Support and recommendations
There are numerous areas of consideration when publishing video that range from supported video file formats to metadata telemetry requirements. Each of these considerations will impact how the video is published and stored.
Supported video file formats
The supported video formats, including high-resolution 4K formats, are listed in the following table:
| Description | Extension |
|---|---|
MOV file | .mov |
MPEG-2 Transport Stream | .ts |
MPEG-2 Program Stream | .ps |
MPEG file | .mpg |
MPEG-2 file | .mpg2 |
MPEG-2 file | .mp2 |
MPEG file | .mpeg |
VLC (mpeg2) | .mpeg2 |
MPEG-4 Movie | .mp4 |
MPEG-4 file | .mpg4 |
H264 Video file | .h264 |
H265 Video file | .h265 |
VLC Media file (mpeg4) | .mpeg4 |
VLC Media file (vob) | .vob |
Supported video codec formats
The supported video codec formats include h.264 and h.265, which HLS natively supports and does not require GPU to do encoding along with .av1, .mpeg1, .mpeg2, .mpeg4, .wmv, and .mjpeg.
Metadata telemetry requirements
To compute and display metadata telemetry information from the video onto a map, the below metadata fields are required. Videos that contain only a subset of the metadata will still display partial telemetry information.
For example, if the video file or corresponding sidecar metadata files only contain the TimeStamp, SensorLatitude, and Sensor Longitude fields, the location of the sensor will be displayed on the map, but the footprint of the video frames will not be displayed, and some functionality such as capturing a video frame will not be supported.
| Field Name | Description | Units | Telemetry |
|---|---|---|---|
SensorLatitude | Sensor latitude based on WGS84 ellipsoid that ranges from -90.0 to 90.0 | Degrees | Sensor Location - 3D Sensor Trail - 3D Only one timestamp field is required. |
SensorLongitude | Sensor longitude based on WGS84 ellipsoid that ranges from -180.0 to 180.0 | Degrees | |
TimeStamp | Date and time stamp with optional milliseconds | String in format: YYYY-MM-DD HH-MM-SS.zzz | |
UnixTimeStamp | Coordinated universal time (UTC) | Microseconds since 1970 (Unix epoch) | |
SensorEllipsoidHeight | Sensor ellipsoid height as measured from the reference WGS84 ellipsoid | Meters | Sensor Location – 3D Sensor Trail – 3D Only one field is required for 3D locations. |
SensorTrueAltitude | Altitude of sensor as measured from mean sea level (MSL) | Meters | |
PlatformHeading | Asset (platform) heading relative to true north, measured clockwise in the horizontal plane looking down that ranges from 0.0 to 360.0 | Degrees | |
PlatformPitch | Asset (platform) pitch relative to horizontal plane with positive angles for nose above the horizontal plane | Degrees | Sensor Sight Line Frame Outline (Footprint) Frame Center (Footprint Centerpoint) |
PlatformHeading | Asset (platform) roll angle relative to horizontal plane with positive angles for left wing above the horizontal plane | Degrees | |
PlatformRoll | Asset (platform) roll angle relative to horizontal plane with positive angles for left wing above the horizontal plane. | Degrees | |
SensorRelativeRoll | Relative roll angle of sensor to aircraft platform where top of image level is 0 degrees and positive angles are clockwise when looking from behind the camera. | Degrees | |
SensorRelativeElevation | Relative angle of sensor pointing direction to the platform horizontal plane where negative angles down | Degrees | |
SensorRelativeAzimuth | Relative angle of sensor pointing direction to platform longitudinal axis as seen from platform that ranges from 0.0 to 360.0 | Degrees | |
HorizontalFOV | Horizontal field of view of selected imaging sensor | Degrees | |
VerticalFOV | Vertical field of view of selected imaging sensor | Degrees |
Note:
Fields in metadata file must reflect the Field Names above (Field Names are case, space, and dash insensitive). Field headers in metadata files can be matched to the Field Names using a field mapping file. Field Names are only supported in EN locale.
When the metadata is complete and accurate, the application will calculate the video frame corners, and the size, shape, and position of the video frame outline, which can then be displayed on a map. The 12 Field Names comprise the minimum metadata required to compute the transform between video and map, to display the video footprint on the map, and to enable other functionality.
Field mapping metadata
In the event the original metadata file does not contain the 12 field names, a field mapping CSV file can be created following the below schema, with a Metadata Field Name column (Metadata) conveying the field names in the metadata file that would be matched to the expected Video Server Field Names (Field Name) listed below. This CSV table must contain the two listed columns—Field Name for the Video Server expected metadata fields, and a Metadata column for the fields that need to be mapped. Once created, this field mapping file should be included in the upload along with the video file and corresponding metadata file.
| Field Name |
|---|
SensorLatitude |
SensorLongitude |
TimeStamp |
SensorEllipsoidHeight |
PlatformHeading |
PlatformPitch |
PlatformHeading |
PlatformRoll |
SensorRelativeRoll |
SensorRelativeElevation |
SensorRelativeAzimuth |
HorizontalFOV |
VerticalFOV |
SensorTrueAltitude |
UnixTimeStamp |
Time shifting metadata
For optimal metadata results, the video data and metadata should be time synchronous. If the time stamp linking the video and metadata are not accurately synchronized, the video footprint and sensor locations on the map will be offset from the view in the video player.
If the time shift is observable and consistent, a time shift .csv file can be used to adjust the timing of the metadata to match the video. The .csv file should contain two columns labeled ElapsedTime (the time location in the video where the time shift occurs) and TimeShift (the amount of time offset in seconds). If the time shift between the video and metadata is inconsistent, you can list multiple positions in the video with the associated time shift in the .csv file. Once created, this time shift file would be included in the upload along with the video file and corresponding metadata file if applicable.
0.00:00:00 (days.hours:minutes:seconds) | 0.00:00:00 (days.hours:minutes:seconds) (Video time in seconds relative to metadata. Use negative values if the video footprint lags.) |
Video storage
By default, ArcGIS Video Server stores all video and metadata files on the file system. Optionally, an organization can register an existing object data store to use as the output location of video and metadata.
During Video Server site creation, the config-store, directories, and logs locations can be specified. By default, these are all stored on the Video Server file system. The config-store can optionally be stored in a cloud store. The config-store contains a services, and an uploads folder that store .json files about the video uploaded and the output service created.
When a video is published, the video is uploaded to the Video Server file system or object store based on how it was configured. During the publishing process, if in a GPU environment and multiple output resolutions are selected, the uploaded video will be transcoded into additional resolutions and the output files are stored in the directories/arcgisvideoservices location. This will also be the location where the original uploaded video is stored. The more output resolutions selected, the more storage the service requires to successfully and efficiently stream the service in each resolution.
The directories/arcgisvideouploads location stores the original video file based on the file ID created during upload. When using ArcGIS Excalibur to publish video services, the original uploaded video is deleted from this location, as the original video will remain in the arcgisvideoservices location.
Temporary space requirements
By default, resources are extracted to the system /tmp directory. This directory must have read, write, and run permissions enabled. If the required space is not available in the /tmp directory, the setup program will attempt to extract resources to your HOME directory. If the required space is not available in your HOME directory, the setup program will report an error indicating this problem. You can specify an alternate temporary location by setting the IATEMPDIR environment variable.
Linux operating system requirements
The 64-bit operating systems described below satisfy the minimum operating system requirements. Support is not provided for 32-bit operating systems; the setup will only proceed if the operating system is 64 bit. Machines with an underscore in the name are not supported. The setup will not proceed if an underscore is detected in the machine name.
The operating system of your ArcGIS Video Server machines can be different from those of the other machines in your ArcGIS Enterprise deployment. The most common scenario for this is to deploy ArcGIS Video Server on Linux machines while the rest of the ArcGIS Enterprise deployment is on Microsoft Windows machines.
You cannot install the software as a root user. If you attempt to do so, the installation will not proceed, and a software diagnostics tool will display an error message indicating that you cannot install as root.
Do not install the software on an OS (binary) that has been modified. Esri does not provide support for products installed on a developer's release of an operating system.
| Supported operating system | Latest update or service pack tested |
|---|---|
Red Hat Enterprise Linux Server 9 | Update 4 |
SUSE Linux Enterprise Server 15 | Service Pack 5 |
Ubuntu Server LTS 24.04 | 24.04.0 |
Ubuntu Server LTS 22.04 | 22.04.4 |
Oracle Linux 9 | Update 4 |
Rocky Linux 9 | Update 4 |
AlmaLinux 9 | Update 4 |
Prior and future updates or service packs on these operating system versions are supported unless otherwise stated. The operating system version and updates must also be supported by the operating system provider.
File handle and process limits
ArcGIS Server is a data-intensive server product, and many of its data formats consist of hundreds of thousands of files. In heavily used systems, thousands or tens of thousands of files may be in use at any given time. If there are insufficient file handles and processes, requests may fail randomly, leading to system downtime. The actual number of file handles and processes needed varies based on the data and the number of instances (threads or processes) running. Setting a file handle limit of 65,535 and a process limit of 25,059 ensures that the system remains running.
There are soft and hard limits for file handles and processes on Linux. To determine the hard limits, use the ulimit -Hn -Hu command (or the limit -h descriptors if you're using csh). To determine the soft limits, use the ulimit -Sn -Su command (or the limit descriptors if you're using csh).
To increase the soft and hard limits, you need to edit the /etc/security/limits.conf file with superuser access. For example, you can add four lines in the file as follows and change the values for the limits:
<ArcGIS Server installation user> soft nofile <file limit>
<ArcGIS Server installation user> hard nofile <file limit>
<ArcGIS Server installation user> soft nproc <process limit>
<ArcGIS Server installation user> hard nproc <process limit>
After making this change, sign out and sign back in with the particular user for the new values to take effect. To verify that the limits have been modified appropriately, use the ulimit -Hn -Hu and ulimit -Sn -Su commands as described above.
Cloud implementation
ArcGIS Video Server can manually be deployed in Microsoft Azure and Amazon Web Services. Full support for Microsoft Azure and Amazon Web Services cloud formation templates are not currently supported.
SSL certificates
ArcGIS Video Server is preconfigured with a self-signed certificate that allows the server to be initially tested and to help you quickly verify that the installation was successful.
You must request a certificate from a trusted certificate authority (CA) and configure ArcGIS Video Server to use it. This can be a domain certificate issued by your organization or a CA-signed certificate. The certificate must have a Subject Alternative Name (SAN) configured or ArcGIS Video Server will not work properly.
Portal for ArcGIS also includes a preconfigured self-signed certificate. Because you'll federate an ArcGIS Video Server site with your portal, request a certificate from a trusted CA and configure the portal to use it.
Software prerequisites
ArcGIS Video Server can be installed on its own or with other ArcGIS Enterprise 11.4 components.
Note:
Whether you are installing a new deployment or upgrading from an earlier version, ensure that all the desired software components—such as the ArcGIS Enterprise portal, an ArcGIS Server site, and ArcGIS Data Store—are installed and running ArcGIS Enterprise 11.4.
During ArcGIS Video Server set up, you will federate the new ArcGIS Video Server site with your Enterprise portal.
As part of an ArcGIS Enterprise base deployment, an ArcGIS Data Store is often required to act as the Hosting Server for the Portal Please note that ArcGIS Video Server does not itself utilize the Relational Data Store.
Domain name system and fully qualified domain name recommendations
It's recommended that you configure your organization's domain name system (DNS) to include fully qualified domain name (FQDN) entries for the ArcGIS Video Server site. The ArcGIS Enterprise portal will request the FQDN of your server site when you federate it.
Supported web browsers
The ArcGIS Video Server installation wizard is supported by all web browsers including, but not limited to, the following:
- Google Chrome version 122 and later
- Microsoft Edge version 122 and later
- Mozilla Firefox version 125 and later
- Mozilla Firefox version 115 (ESR)
- Safari version 16 and later