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.
Importer 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 de données 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"}.
Les sources d’élévation sont répertoriées sous l’extrémité /rest/self/ et peuvent être ajoutées ou supprimées dans ArcGIS Video Server via l’extrémité /admin/system/properties/ à l’aide du paramètre elevationSources. L’ID d’élément des services d’imagerie d’élévation peut être fourni pour ajouter plus d’options.
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 du 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 GIS sur le 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 la section Exporter le site ci-dessous. Une fois terminée, cette opération renvoie un rapport en réponse. Examinez ce rapport et résolvez les problèmes indiqués afin de garantir le bon fonctionnement du 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 depuis la configuration exportée. Ces chemins doivent être disponibles pour que l’opération importSite puisse se terminer correctement.
Attention :
Cette opération demande de nombreuses ressources et peut s’exécuter 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 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 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 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
La configuration du site est exportée vers un emplacement que vous spécifiez en entrée pour cette opération. Le fichier exporté inclut ou exclut les informations ci-dessous.
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 nécessaires 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 est actif, 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 l’opération 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
L’exemple de réponse ci-dessous correspond à une requête qui a spécifié le paramètre location.
{
status: "success",
location: "\\videoserver\share\backup\Jan-15-2013_11-50-33.agssite"
}L’exemple de réponse ci-dessous correspond à 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 et qui a défini validate sur true. 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 n’est remarquée de façon 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 spécifié. Dans Linux, l’équivalent du compte de service est l’utilisateur qui a installé ArcGIS Video Server.
Activer le mode de lecture seule
Les administrateurs peuvent activer le mode de lecture seule pour empêcher temporairement d’apporter des modifications à Video Server. Cela inclut la publication de nouveaux services et l’accès aux extrémités Admin et REST via des instances Web Adaptor. Pour activer le mode de lecture seule, accédez à l’extrémité Admin, puis au menu Mode. Définissez la valeur par défaut Editable (Modifiable) sur Read_Only (Lecture_seule). Pour désactiver le mode de lecture seule, accédez au point de terminaison admin à l’aide du port direct (21443) et rétablissez la valeur Editable (Modifiable) de ce paramètre.
ArcGIS Video Server active et désactive les ports et protocoles de flux en direct
Les administrateurs de site principal peuvent activer et désactiver les protocoles de flux en direct à compter de ArcGIS Enterprise 12.0 via l’interface utilisateur d’administration. Pour ce faire, accédez à l’extrémité d’administration pour ArcGIS Video Server, puis aux extrémités System et Livestream (/admin/system/livestream/). Utilisez l’opération Update pour modifier les ports spécifiques utilisés par ces protocoles de flux en direct. Client Mode Protocols et Server Mode Protocols peuvent être activés ou désactivés à l’aide des extrémités associées et avec l’opération Update.
ArcGIS Video Server modifie le nom d’hôte sourceUrl de flux en direct par défaut pour les nouveaux services et ceux existants
Pour les flux en direct en mode Serveur, une propriété sourceUrl est attribuée à chaque couche contenant le nom de domaine complet du serveur ArcGIS Video Server. Cela peut être ajusté en accédant aux extrémités System et Properties (/admin/system/properties/). Utilisez l’opération Update pour ajouter une nouvelle propriété nommée « LivestreamGatewayHostname ». Pour cette propriété, fournissez un hôte et un domaine à utiliser pour les propriétés sourceUrl de flux en direct en mode Serveur (par exemple, « test.exemple.com »). Une fois mise à jour, la propriété sourceUrl utilise automatiquement le nouveau nom d’hôte attribué. Pour rétablir la propriété sourceUrl par défaut, il suffit de supprimer la propriété LivestreamGatewayHostname.
Remarque :
Les modifications apportées à la propriété LivestreamGatewayHostname ne nécessitent pas un redémarrage du service pour prendre effet.
Vous avez un commentaire à formuler concernant cette rubrique ?