Les propriétés accessibles aux administrateurs ArcGIS Video Server sont décrites ci-dessous. Chaque propriété est décrite avec son chemin situé sur le site d’administration ArcGIS Video Server en accédant à l’URL https://machine.domain.com:21443/arcgis/admin.
Désigner le compte ArcGIS Video Server
Le nom par défaut du compte ArcGIS Video Server est arcgis. Dans la plupart des déploiements non destinés à la production, cette valeur par défaut s’avère suffisante ; en revanche, pour les systèmes de production, Esri recommande de créer un compte de domaine ou Active Directory avant d’installer ArcGIS Video Server.
Vous pouvez spécifier un compte local ou un compte de domaine. Vous pouvez exporter le fichier de configuration d’installation lorsque vous installez ArcGIS Video Server sur la première machine de votre site et vous servir de ce fichier de configuration au moment d’installer ArcGIS Video Server sur les autres machines de votre site. Vous avez ainsi la garantie que la configuration du compte ArcGIS Video Server est identique sur toutes les machines de votre site.
Compte de domaine
Un compte de domaine permet d’accéder aux données sur les systèmes distants. Un compte de domaine est préférable pour des raisons de sécurité, car le compte est géré centralement.
Pour spécifier un compte de domaine, suivez le format DOMAIN\username. Si vous ne spécifiez pas le domaine, l’assistant d’installation ArcGIS Video Server crée un compte local avec le nom d’utilisateur que vous avez spécifié. Si vous spécifiez un compte de domaine qui n’existe pas, l’installation renvoie une erreur.
Si vos paramètres de connexion interdisent l’accès à la machine où ArcGIS Video Server est installé, une erreur se produit à l’installation. Vous n’avez pas besoin d’utiliser les paramètres de stratégie de groupe Log on locally (Ouvrir une session localement) pour le compte ArcGIS Video Server.
Compte local
Si vous spécifiez un compte local, ce compte et le mot de passe doivent exister sur chaque machine du site ArcGIS Video Server et doivent être identiques. Vous pouvez créer le compte local avec le même mot de passe sur chaque machine avant d’installer ArcGIS Video Server, ou vous pouvez utiliser l’assistant d’installation ArcGIS Video Server pour créer le compte local. Vous devez utiliser les mêmes nom d’utilisateur et mot de passe sur chaque machine du site.
Si vous avez créé un compte local dans le cadre de l’installation, le mot de passe que vous attribuez au compte doit respecter la stratégie de sécurité locale de votre système d’exploitation. Si le mot de passe ne respecte pas le niveau de sécurité minimal requis par le système d’exploitation, une erreur se produit. Consultez la documentation Microsoft correspondant à la version de Windows que vous utilisez pour savoir comment accéder à la stratégie de sécurité sur vos machines.
Compte de service contrôlé par un groupe
Un compte de service contrôlé par un groupe (gMSA) est un compte de domaine Active Directory offrant une gestion automatique des mots de passe. Le compte ne peut pas être utilisé pour les connexions interactives et ne peut s’utiliser que sur un groupe pré-défini de serveurs.
L’utilisation d’un gMSA est particulièrement avantageuse lorsqu’un compte de service régit les logiciels sur plusieurs machines, par exemple sur un site ArcGIS Video Server constitué de plusieurs machines. Dans la mesure où le gMSA fonctionne au niveau du domaine, il est en mesure de modifier régulièrement le mot de passe du compte de service sur chaque machine, sans intervention manuelle.
Vous pouvez utiliser l’outil de ligne de commande configureserviceaccount, qui est décrit ci-dessous, pour configurer le service ArcGIS Video Server afin que celui-ci s’exécute sous un gMSA. Cet outil se trouve dans le répertoire <Video_Install>\tools\ConfigUtility. Pour le paramètre username, le compte de service contrôlé par un groupe peut être spécifié avec ou sans le symbole $ à la fin. Le paramètre password n’est pas nécessaire. Les paramètres readconfig et writeconfig opèrent de la même manière avec un compte de service contrôlé par un groupe.
Voici un exemple de commande pour configurer un gMSA en tant que compte ArcGIS Video Server :
configureserviceaccount.bat --username mydomain\enterprise-gmsa$ --writeconfig c:\temp\domainaccountconfig.xmlImporter un certificat racine
Pour importer un certificat racine, cliquez sur Home (Accueil) > Machines > MachineName > sslCertificates > importRootOrIntermediate.
Cette opération importe le certificat racine et le certificat intermédiaire d’une autorité de certification dans le fichier KeyStore. Pour créer un certificat signé par une autorité de certification de qualité production, ajoutez les certificats de l’autorité de certification au fichier KeyStore qui active le mécanisme SSL pour approuver l’autorité de certification (et les certificats qu’elle a signés). Même si la plupart des certificats des autorités de certification connues sont disponibles dans le fichier KeyStore, vous pouvez utiliser cette opération si vous disposez de certificats d’une autorité de certification personnalisée ou de certificats intermédiaires spécifiques.
Mettre à jour la configuration de sécurité
Pour mettre à jour la configuration de sécurité, cliquez sur Home (Accueil) > Security (Sécurité) > Config (Configuration) > Update (Mettre à jour).
Cette opération met à jour la configuration de sécurité, notamment les protocoles TLS et les suites de chiffrement, pour le site ArcGIS Video Server. Cette opération entraîne le redéploiement des extrémités des services REST sur chaque machine serveur du site. Si vous avez mis à jour le protocole de communication dans le cadre de cette opération, une minute est nécessaire à ArcGIS Web Adaptor pour reconnaître les modifications apportées au protocole de communication du site.
Mettre à jour les propriétés système
Les administrateurs peuvent mettre à jour les propriétés de ArcGIS Video Server en fonction des besoins de leur organisation. Les valeurs des propriétés personnalisées peuvent être définies à l’emplacement https://machine.domain.com:21443/arcgis/admin/system/properties/update. Une propriété système personnalisée doit être définie en tant qu’objet JSON valide. Il est possible de définir plusieurs propriétés système à la fois, à condition qu’elles soient enchaînées sous forme de JSON valide. En voici un exemple :
{
"maxFrameCount": 1000,
"maxFileUploadSize": 5000
}Définir le nombre maximal d’images vidéo
Le nombre maximal d’images vidéo détermine le nombre maximal d’images pouvant être renvoyées lors de la création d’un jeu d’images. Le minimum autorisé pour le nombre maximal d’images vidéo est 100.
La valeur par défaut est 1 000 images vidéo. Par exemple, {"maxFrameCount": 1000}.
Définir la taille de chargement maximale des fichiers
La taille de chargement maximale des fichiers définit le seuil maximal pour la taille d’un seul fichier à charger sur le serveur vidéo lors de la publication de fichiers vidéo. Si un fichier dépassant cette taille maximale est chargé lors de la publication, le processus échoue. Cette propriété peut être définie sur 10 Go (10 000) au maximum. Si cette propriété est définie sur 0 Go, la publication des fichiers vidéo est désactivée.
La taille par défaut est 5 Go. Par exemple, {"maxFileUploadSize":"5000"}.
Définir la source d’élévation
Un administrateur peut définir la source de données d’élévation utilisée pour orthorectifier le polygone calculé de chaque emprise d’image. Un ID d’élément du service d’imagerie d’élévation peut être défini comme source. Si aucune source d’élévation n’est définie, une élévation constante = 0 est utilisée. L’utilisation d’une source d’élévation augmente la précision des emprises d’image.
Une élévation constante = 0 est utilisée par défaut, mais un ID d’élément du service d’imagerie d’élévation peut également être utilisé. Par exemple, {"elevationSource":"a08984c643a24bfd8f8d2eb0d192357d"}.
Configurer ArcGIS Web Adaptor
Pour configurer ArcGIS Web Adaptor, cliquez sur Home (Accueil) > System (Système) > Web Adaptors > WebAdaptorConfig.
La configuration de ArcGIS Web Adaptor est une ressource pour tous les paramètres de configuration partagés par les Web Adaptors du site. Cette ressource identifie la clé partagée par tous les Web Adaptors pour chiffrer les bits de données de clé dans les demandes entrantes du serveur.
Mettre à jour les paramètres des journaux
Pour mettre à jour les paramètres des journaux, cliquez sur Home (Accueil) > Logs (Journaux) > Settings (Paramètres) > Edit (Mettre à jour).
Cette procédure met à jour les paramètres des journaux pour l’ensemble du site Server, comme la localisation en sortie, le niveau et le format des journaux ainsi que l’ancienneté des fichiers journaux.
Définir le data store d’éléments par défaut
Pour mettre à jour le data store d’éléments par défaut, cliquez sur Home (Accueil) > Data (Données) > Items (Éléments) > Set Default Item (Définir l’élément par défaut).
Le data store d’éléments par défaut est l’emplacement où seront stockés les fichiers vidéo d’origine et leurs fichiers de métadonnées correspondants, ainsi que les fichiers vidéo encodés en sortie et leurs fichiers de métadonnées correspondants après la réussite d’une opération de publication. Il est défini par défaut sur FILESYSTEM.
Inscrire le data store
Pour inscrire un data store existant, cliquez sur Home (Accueil) > Data (Données) > Configure Enterprise Data Stores (Configurer des data stores d’entreprise) > Submit (Envoyer).
Par défaut, ArcGIS Video Server stocke tous les fichiers vidéo et de métadonnées sur le système de fichiers. Une organisation peut inscrire un data store d’objets existant comme emplacement en sortie des fichiers vidéo et des métadonnées. Cette procédure recherche un data store d’objets existant et l’inscrit sur le serveur vidéo. Ce data store peut ensuite être défini comme data store par défaut à l’aide du processus Set default item data store (Définir le data store d’éléments par défaut).
Supprimer un site
Pour supprimer un site, cliquez sur Home (Accueil) > Delete Site (Supprimer un site).
Cette opération supprime la configuration du site et libère toutes les ressources serveur. Indiquée pour les serveurs de développement ou de test qui ont besoin d’être nettoyés régulièrement, elle peut également être exécutée avant une désinstallation. Utilisez cette option avec prudence, car elle supprime tous les paramètres et autres configurations et elle est irréversible.
Cette opération effectue les tâches suivantes :
- Toutes les machines serveur actives sur le site sont arrêtées.
- Toutes les machines serveur sont désinscrites du site.
- Le répertoire de configuration est supprimé.
Sauvegarder le site
Il est recommandé d’exporter fréquemment les paramètres de votre site au moyen de l’API d’administration. Pour ce faire, accédez à Home (Accueil) > Export Site (Exporter un site). Lors de la définition de la propriété destination pour le site exporté, indiquez un lecteur réseau ou un autre emplacement que la machine exécutant ArcGIS Video Server comme localisation. L’emplacement de destination doit être accessible à la machine ArcGIS Video Server. En cas de défaillance du site, il est possible de le récupérer en créant un nouveau site de serveur puis en accédant à Home (Accueil) > Import Site (Importer un site).
Importer un site
Attention :
Cette opération d’administration n’est pas disponible via un Web Adaptor. Accédez à cette opération grâce à une URL directe vers l’un des serveurs SIG de votre site.
Cette opération importe une configuration de site dans le site actuellement en cours d’exécution. L’importation d’un site implique de remplacer toutes les configurations (y compris les services SIG, les configurations de sécurité, etc.) du site actuellement en cours d’exécution par celles contenues dans le fichier de configuration du site que vous indiquez en entrée. Vous pouvez obtenir le fichier de configuration du site en entrée via l’opération exportSite.
Cette opération restaure toutes les informations incluses dans la sauvegarde, comme indiqué dans exportSite. Une fois terminée, cette opération renvoie un rapport en réponse. Vous devez examiner ce rapport et résoudre les problèmes indiqués afin de garantir le bon fonctionnement de votre site.
L’opération importSite vous permet de restaurer votre site à partir d’une sauvegarde que vous avez créée à l’aide de l’opération exportSite. Notez que l’opération importSite utilise les chemins d’accès au répertoire de serveur de la configuration exportée. Par conséquent, ces chemins doivent être disponibles pour que l’opération importSite puisse se terminer correctement.
Attention :
Cette opération demande beaucoup de ressources de calcul et son exécution peut durer longtemps. Vous pouvez être amené à intervenir manuellement au terme de cette opération afin de résoudre les éventuels problèmes indiqués. Comme cette opération change complètement la configuration du site, il est vivement recommandé de ne pas accéder aux services SIG ni d’administrer le site lorsque cette opération est en cours d’exécution.
Paramètres de requête
| Paramètre | Détails |
|---|---|
| location | Chemin d’accès au fichier d’une configuration exportée ou ID référençant la configuration stockée sur le serveur. Exemple |
| validate | Introduit dans ArcGIS Enterprise 11.1. Ce paramètre valide le chemin d’accès au fichier spécifié dans le paramètre location (emplacement), garantissant son accessibilité avant de réaliser l’opération importSite. Si le paramètre est défini sur true, le chemin d’accès est validé et l’opération renvoie une réponse de réussite ou un message d’erreur. La valeur par défaut est false. Valeurs : true | false |
| f | Format de réponse. Le format de réponse par défaut est html. Valeurs : html | json | pjson |
Exemple d’utilisation
Voici un exemple de requête POST pour importSite :
POST /arcgis/admin/importSite HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
location=\\server\share\backup\Jan-15-2023_11-50-33.agssite&validate=true&f=pjsonExporter le site
Exporte la configuration du site vers un emplacement que vous spécifiez en entrée pour cette opération. Le fichier exporté inclut et exclut les informations suivantes :
Attention :
Vous ne pouvez pas effectuer d’autres modifications administratives du site lorsqu’une sauvegarde est en cours. Avant de réaliser l’opération exportSite , vérifiez que toutes les configurations de site voulues ont été effectuées.
Protection des informations non incluses dans la sauvegarde
Comme indiqué ci-dessus, certaines informations ne sont pas incluses dans la sauvegarde de votre site. Il est recommandé de sauvegarder manuellement ces informations lorsque vous exécutez l'utilitaire de sauvegarde. Lorsque vous restaurez le site, recopiez ou replacez manuellement ces informations sur le site, par exemple :
- Données de service : si les données utilisées par vos services n’ont pas été copiées dans un dossier sur le serveur au moment de la publication, elles ne sont pas incluses dans la sauvegarde. Sauvegardez manuellement vos répertoires de données, géodatabases, bases de données, tables sources et toutes les autres informations utilisées par vos services. Lorsque vous restaurez le site, vérifiez que ArcGIS Video Server est autorisé à accéder à vos emplacements de données. Pour plus d’informations, reportez-vous à la rubrique Rendre vos données accessibles dans ArcGIS Video Server.
- Messages de consignation : lorsque le site s’exécute, des journaux sont créés et distribués à toutes les machines ArcGIS Video Server qui participent à votre site. Lorsque vous restaurez le site, replacez ou recopiez les informations dans le répertoire des journaux d'origine.
- Nom et mot de passe de l'administrateur de site principal : après la restauration d'un site, continuez à utiliser le nom et le mot de passe de l'administrateur de site principal qui étaient en vigueur au moment de la restauration. Ceci est vrai même si vous restaurez un site dont l'administrateur de site principal a été désactivé. Il est recommandé d’enregistrer le nom d’utilisateur et le mot de passe et de les stocker dans un emplacement sécurisé avant d’effectuer la restauration.
- Données statistiques : lorsque le site s’exécute, différentes statistiques de service sont enregistrées. Lorsque vous restaurez le site, replacez ou recopiez les informations dans le répertoire des statistiques d'origine.
- Configurations ArcGIS Web Adaptor : si votre site comprend une ou plusieurs instances ArcGIS Web Adaptor, vous devez les reconfigurer avec votre site après avoir effectué la restauration. Pour des instructions complètes, reportez-vous aux rubriques relatives à la configuration pour IIS, Java (Windows) et Java (Linux).
Paramètres de requête
| Paramètre | Détails |
|---|---|
| location (Facultatif) | Chemin d’accès au dossier, accessible à ArcGIS Video Server, où la configuration du site exporté est écrite. Si le paramètre location (emplacement) n’est pas spécifié, le serveur écrit le fichier de configuration du site exporté dans un répertoire appartenant au serveur et renvoie un chemin d’accès virtuel (HTTPS URL) au répertoire. La configuration du site exporté peut être téléchargée à partir du répertoire en accédant à l’URL renvoyée. Exemple |
| validate | Introduit dans ArcGIS Enterprise 11.1. Ce paramètre valide le chemin d’accès au fichier spécifié dans le paramètre de location (emplacement), garantissant son accessibilité avant de réaliser l’opération importSite. Si le paramètre est défini sur true, le chemin d’accès est validé et l’opération renvoie une réponse de réussite ou un message d’erreur. La valeur par défaut est false. Valeurs : true | false |
| f | Format de réponse. Le format de réponse par défaut est html. Valeurs : html | json | pjson |
Exemple d’utilisation
Voici un exemple de requête POST pour exportSite avec le paramètre location (emplacement) défini :
POST /webadaptor/admin/exportSite HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
location=\\server\share\backup&f=jsonVoici un exemple de requête POST pour l’opération exportSite avec le paramètre location (emplacement) non défini :
POST /webadaptor/admin/exportSite HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
location=&validate=false&f=pjsonExemple de réponse JSON
Voici un exemple de réponse pour une requête qui a spécifié le paramètre location.
{
status: "success",
location: "\\videoserver\share\backup\Jan-15-2013_11-50-33.agssite"
}Voici un exemple de réponse pour une requête qui n’a pas spécifié le paramètre location.
{
status: "success",
location: "https://machine.domain.com/webadaptor/admin/uploads/i33d579b6-d8a8-4886-a1bc-671ae52e7a00"
}Exemples avec validation
L’exemple de réponse ci-dessous correspond à une requête qui a défini le paramètre location (emplacement) et qui a défini la validation sur True (Vrai). Cet exemple illustre une réponse de réussite, ce qui signifie que le chemin était accessible à ArcGIS Server:
{
status: "success",
}L’exemple de réponse ci-dessous correspond à une requête qui a défini le paramètre location et qui a défini validate sur true. Cet exemple illustre un échec, ce qui signifie que le chemin n’était pas accessible à ArcGIS Server :
{
"status": "error",
"messages": ["Unable to write to \\videoserver\share\backup. Verify the location is accessible and the service account running ArcGIS Video Server can write to it."],
"code": 500
}Importation et exportation ArcGIS Video Server à partir d’un système de fichiers local
Aucune différence notable immédiate. Les autorisations de lecture et d’écriture sont obligatoires pour le compte de service dans le dossier en sortie/entrée. Dans Linux, l’équivalent du compte de service est l’utilisateur qui a installé ArcGIS Video Server. Vous devez disposer des autorisations complètes de lecture, d’écriture et d’exécution sur les répertoires appropriés, notamment le répertoire Importer/Exporter.
Importation et exportation ArcGIS Video Server à partir d’un object store ou d’un data store
Il est recommandé qu’un compte de domaine exécute le service Video Server Windows si un object store ou un répertoire réseau partagé est utilisé. Les autorisations complètes de lecture et d’écriture sont obligatoires pour le compte de service à l’emplacement choisi. Dans Linux, l’équivalent du compte de service est l’utilisateur qui a installé ArcGIS Video Server.
Vous avez un commentaire à formuler concernant cette rubrique ?