Im Folgenden werden die für ArcGIS Video Server-Administratoren verfügbaren Eigenschaften und deren Verwendung beschrieben. Jede Eigenschaft ist zusammen mit einer Beschreibung und dem entsprechenden Pfad in der ArcGIS Video Server-Administrations-Site unter der URL https://machine.domain.com:21443/arcgis/admin aufgeführt.
Festlegen des ArcGIS Video Server-Kontos
Der standardmäßige ArcGIS Video Server-Kontoname lautet arcgis. Diese Standardeinstellung ist für die meisten nicht produktionsbezogenen Bereitstellungen ausreichend. Bei Produktionssystemen empfiehlt sich jedoch, vor der Installation von ArcGIS Video Server ein Domänen- oder ein Active Directory-Konto zu erstellen.
Sie können ein lokales Konto oder ein Domänenkonto auswählen. Sie können beim Installieren von ArcGIS Video Server auf dem ersten Computer der Site die Setupkonfigurationsdatei exportieren und diese verwenden, wenn Sie ArcGIS Video Server auf den anderen Computern der Site installieren. Auf diese Weise ist sichergestellt, dass das ArcGIS Video Server-Konto auf allen Computern der Site gleich konfiguriert ist.
Domänenkonto
Ein Domänenkonto ermöglicht den Zugriff auf Daten in Remote-Systemen. Ein Domänenkonto ist aus Sicherheitsgründen vorzuziehen, da das Konto zentral verwaltet wird.
Wenn Sie ein Domänenkonto angeben, verwenden Sie das Format DOMAIN\username. Wenn Sie keine Domäne festlegen, erstellt der ArcGIS Video Server-Installationsassistent ein lokales Konto mit dem von Ihnen angegebenen Benutzernamen. Wenn Sie ein Domänenkonto angeben, das nicht vorhanden ist, wird bei der Installation ein Fehler zurückgegeben.
Wenn Sie keine Anmelderechte für den Computer haben, auf dem ArcGIS Video Server installiert ist, tritt bei der Installation ein Fehler auf. Es ist nicht notwendig, dem ArcGIS Video Server-Konto die Gruppenrichtlinieneinstellungen Lokal anmelden zu erteilen.
Lokales Konto
Wenn Sie ein lokales Konto angegeben haben, muss dieses zusammen mit dem Kennwort auf jedem Computer der ArcGIS Video Server-Site vorhanden und identisch sein. Sie können auf jedem Computer das lokale Konto mit demselben Kennwort erstellen, bevor Sie ArcGIS Video Server installieren, oder das lokale Konto vom ArcGIS Video Server-Installationsassistenten erstellen lassen. Sie müssen auf jedem Computer der Site den gleichen Benutzernamen und das gleiche Kennwort verwenden.
Wenn Sie im Rahmen der Installation ein lokales Konto erstellt haben, muss das Kennwort, das Sie für das Konto angeben, der lokalen Sicherheitsrichtlinie des Betriebssystems entsprechen. Wenn das Kennwort die minimale Kennwortstärke des Betriebssystems nicht erfüllt, tritt bei der Installation ein Fehler auf. Entnehmen Sie der Microsoft-Dokumentation die von Ihnen verwendete Windows-Version, um zu ermitteln, wie Sie auf die Sicherheitsrichtlinie auf Ihren Computern zugreifen und diese überprüfen.
Gruppenverwaltetes Dienstkonto
Ein gruppenverwaltetes Dienstkonto (gMSA) ist ein Active Directory-Domänenkonto, das die automatische Verwaltung von Kennwörtern ermöglicht. Das Konto kann nicht für interaktive Anmeldungen verwendet werden, und seine Verwendung ist auf vordefinierte Servergruppen beschränkt.
Die Verwendung eines gMSA ist insbesondere dann sinnvoll, wenn über ein Dienstkonto Software auf mehreren Computern gesteuert wird, beispielsweise in einer ArcGIS Video Server. Da das gMSA auf Domänenebene konfiguriert ist, kann damit das Dienstkonto-Kennwort für jeden Computer regelmäßig geändert werden, ohne dass manuelle Schritte erforderlich sind.
Mit dem im Folgenden beschriebenen Befehlszeilenwerkzeug configureserviceaccount kann der ArcGIS Video Server-Service für die Ausführung unter einem gMSA konfiguriert werden. Dieses Werkzeug befindet sich im Verzeichnis <Video_Install>\tools\ConfigUtility. Im Parameter username kann das gruppenverwaltete Dienstkonto mit oder ohne das Zeichen $ am Ende der Zeichenfolge angegeben werden. Der password-Parameter ist nicht erforderlich. Die Funktion der readconfig- und writeconfig-Parameter bleibt bei Verwendung eines gruppenverwalteten Service-Kontos unverändert.
Im Folgenden finden Sie einen Beispielbefehl, mit dem ein gMSA als ArcGIS Video Server-Konto konfiguriert werden kann:
configureserviceaccount.bat --username mydomain\enterprise-gmsa$ --writeconfig c:\temp\domainaccountconfig.xmlImportieren eines Stammzertifikats
Um ein Stammzertifikat zu importieren, klicken Sie auf Home > Machines > MachineName > sslCertificates > importRootOrIntermediate.
Damit werden die Stamm- und Zwischenzertifikate einer Zertifizierungsstelle in den Keystore importiert. Um ein von einer Zertifizierungsstelle signiertes Zertifikat in Produktionsqualität zu erstellen, fügen Sie dem Keystore die Zertifikate der Zertifizierungsstelle hinzu, sodass der SSL-Mechanismus der Zertifizierungsstelle (und den von dieser signierten Zertifikaten) vertrauen kann. Die meisten gängigen Zertifikate der Zertifizierungsstelle sind im Keystore verfügbar. Mit diesem Vorgang können Sie jedoch eine benutzerdefinierte Zertifizierungsstelle oder bestimmte Zwischenzertifikate verwenden.
Aktualisieren der Sicherheitskonfiguration
Klicken Sie zum Aktualisieren der Sicherheitskonfiguration auf Home > Security > Config > Update.
Damit wird die Sicherheitskonfiguration, einschließlich der TLS-Protokolle und Verschlüsselungssammlungen, für die ArcGIS Video Server-Site aktualisiert. Durch diese Operation werden die REST-Service-Endpunkte auf jedem Servercomputer in der Site erneut bereitgestellt. Wenn Sie im Rahmen dieses Vorgangs das Kommunikationsprotokoll aktualisiert haben, dauert es eine Minute, bis von ArcGIS Web Adaptor Änderungen am Kommunikationsprotokoll der Site erkannt werden.
Bearbeiten der Systemeigenschaften
Administratoren können die Eigenschaften von ArcGIS Video Server für ihre Organisation anpassen. Benutzerdefinierte Eigenschaftswerte können unter https://machine.domain.com:21443/arcgis/admin/system/properties/update festgelegt werden. Beim Festlegen einer benutzerdefinierten Systemeigenschaft muss die Eigenschaft als gültiges JSON-Objekt festgelegt werden. Es können mehrere Systemeigenschaften gleichzeitig festgelegt werden, sofern diese zu einem gültigen JSON-Objekt verkettet sind. Beispiel:
{
"maxFrameCount": 1000,
"maxFileUploadSize": 5000
}Definieren der maximalen Anzahl an Videobildern
Die maximale Anzahl an Videobildern bestimmt die Anzahl der Bilder, die beim Erstellen von Framesets maximal zurückgegeben werden können. Für die maximale Anzahl müssen mindestens 100 Videobilder angegeben werden.
Der Standardwert beträgt 1000 Videobilder, z. B. {"maxFrameCount": 1000}.
Definieren der maximalen Upload-Größe für Dateien
Mit der maximalen Upload-Größe für Dateien wird der maximale Schwellenwert für die Größe einer Datei festgelegt, die beim Veröffentlichen von Videodateien auf den Video-Server hochgeladen werden kann. Wenn beim Veröffentlichen eine Datei hochgeladen wird, deren Größe den Maximalwert überschreitet, schlägt der Vorgang fehl. Für diese Eigenschaft können maximal 10 GB (10000) festgelegt werden. Wenn für diese Eigenschaft 0 GB festgelegt wird, wird das Veröffentlichen von Videodateien deaktiviert.
Der Standardwert beträgt 5 GB, z. B. {"maxFileUploadSize":"5000"}.
Definieren der Höhenquelle
Ein Administrator kann die Höhendatenquelle definieren, die zum Orthorektifizieren des berechneten Polygons der einzelnen Bild-Footprints verwendet wird. Als Quelle kann die Element-ID eines Höhenbilddaten-Service angegeben werden. Wenn keine Höhenquelle definiert wird, wird eine konstante Höhe = 0 verwendet. Durch Verwenden einer Höhenquelle wird die Genauigkeit von Bild-Footprints erhöht.
Standardmäßig ist eingestellt, dass eine konstante Höhe = 0 verwendet wird. Sie können jedoch auch die Element-ID eines vorhandenen Höhenbilddaten-Service festlegen, z. B. {"elevationSource":"a08984c643a24bfd8f8d2eb0d192357d"}.
Konfigurieren von ArcGIS Web Adaptor
Klicken Sie zum Konfigurieren von ArcGIS Web Adaptor auf Home > System > Web Adaptors > WebAdaptorConfig.
Die ArcGIS Web Adaptor-Konfiguration ist eine Ressource für sämtliche Konfigurationsparameter, die für alle Web Adaptors in der Site verwendet werden. Mit dieser Ressource wird der freigegebene Schlüssel identifiziert, der von allen Web Adaptors zur Verschlüsselung wichtiger Daten-Bits in den eingehenden Anforderungen für den Server verwendet wird.
Bearbeiten der Protokolleinstellungen
Klicken Sie zum Bearbeiten der Protokolleinstellungen auf Home > Logs > Settings > Edit.
Mit dieser Prozedur werden die Protokolleinstellungen für die gesamte Server-Site, z. B. das Protokollausgabeverzeichnis, das Protokoll-Level und das Protokollformat sowie das Alter der Protokolldatei, aktualisiert.
Festlegen des Standard-Data-Store für Elemente
Klicken Sie zum Bearbeiten des Standard-Data-Store für Elemente auf Home > Data > Items > Set Default Item.
Der Standard-Data-Store für Elemente ist der Speicherort, an dem die ursprünglichen Videodateien mit den entsprechenden Metadatendateien sowie die codierten Ausgabevideodateien mit den entsprechenden Metadatendateien nach einer erfolgreichen Veröffentlichung gespeichert werden. Diese Einstellung ist standardmäßig auf FILESYSTEM festgelegt.
Registrieren des Data Store
Klicken Sie zum Registrieren eines vorhandenen Data Store auf Home > Data > Configure Enterprise Data Stores > Submit.
In ArcGIS Video Server werden standardmäßig alle Video- und Metadatendateien im Dateisystem gespeichert. Eine Organisation kann einen vorhandenen Objekt-Data-Store zur Verwendung als Ausgabeverzeichnis von Video- und Metadaten registrieren. Bei diesem Verfahren wird nach einem vorhandenen Objekt-Data-Store gesucht, und der Data Store wird beim Video-Server registriert. Anschließend kann dieser Data Store mit dem Workflow zum Festlegen des Standard-Data-Store für Elemente als Standard-Data-Store festgelegt werden.
Löschen eines Standorts
Klicken Sie zum Löschen einer Site auf Home > Delete Site.
Damit wird die Site-Konfiguration gelöscht, und sämtliche Serverressourcen werden freigegeben. Dieser Vorgang eignet sich für die Entwicklung oder zum Testen von Servern, die regelmäßig bereinigt werden müssen, und kann auch vor der Deinstallation durchgeführt werden. Verwenden Sie diese Option mit Bedacht, da alle Einstellungen und sonstigen Konfigurationen gelöscht werden und der Vorgang nicht rückgängig gemacht werden kann.
Mit dieser Operation werden die folgenden Tasks ausgeführt:
- Alle zu der Site gehörigen Servercomputer werden angehalten.
- Die Registrierung bei der Site wird für alle Servercomputer aufgehoben.
- Der Konfigurationsspeicher wird gelöscht.
Sichern der Site
Es wird empfohlen, die Site-Einstellungen regelmäßig über die Admin-API zu exportieren. Navigieren Sie dazu zu Home > Export Site. Geben Sie beim Definieren der Eigenschaft destination für die exportierte Site ein Netzlaufwerk oder einen anderen Speicherort als den ArcGIS Video Server-Computer an. Der ArcGIS Video Server-Computer auf den Zielspeicherort zugreifen können. Bei einem Site-Ausfall kann die Site wiederhergestellt werden, indem Sie eine neue Server-Site erstellen und zu Home > Import Site navigieren.
Importieren einer Site
Vorsicht:
Dieser Verwaltungsvorgang ist beim Zugriff über einen Web Adaptor nicht verfügbar. Auf diesen Vorgang sollten Sie über eine direkte URL zu einem der GIS-Server der Site zugreifen.
Bei diesem Vorgang wird eine Site-Konfiguration in die aktuell ausgeführte Site importiert. Eine Site zu importieren bedeutet, alle Site-Konfigurationen (mit allen GIS-Services, Sicherheitskonfigurationen usw.) der derzeit ausgeführten Site durch die in der Site-Konfigurationsdatei enthaltenen Site-Konfigurationen zu ersetzen, die Sie als Eingabe bereitstellen. Die Eingabe-Site-Konfigurationsdatei können Sie über den Vorgang exportSite abrufen.
Bei diesem Vorgang werden alle in der Sicherung enthaltenen Informationen gemäß "exportSite" wiederhergestellt. Nach Abschluss des Vorgangs wird als Antwort ein Bericht bereitgestellt. Verschaffen Sie sich einen Überblick über den Bericht, und beheben Sie alle darin aufgeführten Probleme, um sicherzustellen, dass Ihre Site wieder vollständig funktionsfähig ist.
Mit dem Vorgang importSite können Sie Ihre Site von einer Sicherung, die Sie mit dem Vorgang "exportSite" erstellt haben, wiederherstellen. Beim Vorgang importSite werden die Serververzeichnispfade aus der exportierten Konfiguration verwendet. Daher müssen diese Pfade verfügbar sein, damit der Vorgang importSite durchgeführt werden kann.
Vorsicht:
Dieser Vorgang ist rechenintensiv und kann einige Zeit in Anspruch nehmen. Am Ende dieses Vorgangs ist möglicherweise ein manuelles Eingreifen erforderlich, um hervorgehobene Probleme zu beheben. Da bei diesem Vorgang die Site-Konfiguration vollständig verändert wird, wird dringend davon abgeraten, während des Vorgangs auf GIS-Services zuzugreifen und die Site zu verwalten.
Anforderungsparameter
| Parameter | Details |
|---|---|
| location | Ein Dateipfad zu einer exportierten Konfiguration oder eine ID, mit der die gespeicherte Konfiguration auf dem Server referenziert wird. Beispiel |
| validate | Eingeführt in ArcGIS Enterprise 11.1. Mit diesem Parameter wird vor dem Durchführen des Vorgangs "importSite" der im Parameter "location" angegebene Dateipfad überprüft und sichergestellt, dass darauf zugegriffen werden kann. Wenn dieser Parameter auf true festgelegt ist, wird der Pfad überprüft, und nach dem Vorgang wird eine Erfolgsmeldung oder eine Fehlermeldung angezeigt. Als Standardwert ist false festgelegt. Werte: true | false |
| f | Das Antwortformat. Das Standardantwortformat lautet html. Werte: html | json | pjson |
Beispiel für die Verwendung
Im Folgenden ist ein Beispiel für eine POST-Anforderung für importSite dargestellt:
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=pjsonExportieren einer Site
Exportiert die Site-Konfiguration in ein Verzeichnis, das Sie als Eingabe für diesen Vorgang angeben. Mit der exportierten Datei werden die folgenden Informationen einbezogen und ausgeschlossen:
Vorsicht:
Während eine Sicherung durchgeführt wird, können keine anderen administrativen Änderungen an der Site-Konfiguration vorgenommen werden. Stellen Sie vor dem Durchführen des Vorgangs exportSite sicher, dass alle gewünschten Site-Konfigurationen vorgenommen wurden.
Schutz von Informationen, die nicht in die Sicherung einbezogen wurden
Wie bereits erwähnt, werden einige Informationen nicht in die Sicherung der Site einbezogen. Es wird empfohlen, diese Informationen zeitgleich manuell mit der Ausführung des Backup-Dienstprogramms zu sichern. Wenn Sie die Site speichern, kopieren oder verschieben Sie diese Informationen manuell auf die Site, z. B.:
- Service-Daten: Wenn die von Ihren Services verwendeten Daten beim Veröffentlichen nicht in einen Ordner auf dem Server kopiert wurden, werden sie nicht in die Sicherung einbezogen. Sichern Sie Ihre Datenverzeichnisse, Geodatabases, Datenbanken, Quelltabellen und andere von Ihren Services verwendeten Informationen manuell. Überprüfen Sie, ob ArcGIS Video Server Berechtigungen für den Zugriff auf Ihre Datenspeicherorte hat, wenn Sie die Site wiederherstellen. Weitere Informationen finden Sie unter Bereitstellen der Daten für ArcGIS Video Server.
- Protokollmeldungen: Wenn die Site ausgeführt wird, werden Protokolle erstellt und an alle ArcGIS Video Server-Computer der Site verteilt. Wenn Sie die Site wiederherstellen, verschieben oder kopieren Sie die Informationen wieder in das ursprüngliche Protokollverzeichnis.
- Name und Kennwort des primären Site-Administrators: Nachdem Sie eine Site wiederhergestellt haben, können Sie weiterhin den Namen und das Kennwort des primären Site-Administrators verwenden, das vor der Wiederherstellung benutzt wurde. Dies gilt auch dann, wenn Sie eine Site wiederherstellen, deren primärer Site-Administrator deaktiviert wurde. Es empfiehlt sich, vor der Wiederherstellung den Benutzernamen und das Kennwort aufzuzeichnen und an einem sicheren Ort aufzubewahren.
- Statistische Daten: Wenn die Site ausgeführt wird, werden verschiedene Service-Statistiken aufgezeichnet. Wenn Sie die Site wiederherstellen, verschieben oder kopieren Sie die Informationen wieder in das ursprüngliche Statistikverzeichnis.
- ArcGIS Web Adaptor-Konfigurationen: Wenn Ihre Site einen oder mehrere ArcGIS Web Adaptor umfasst, müssen Sie sie nach der Wiederherstellung mit der Site neu konfigurieren. Ausführliche Anweisungen finden Sie in den Konfigurationsthemen für IIS, Java (Windows) und Java (Linux).
Anforderungsparameter
| Parameter | Details |
|---|---|
| location (Optional) | Ein Ordnerpfad, auf den ArcGIS Video Server zugreifen kann, und an dem die exportierte Site-Konfiguration gespeichert wird. Wenn der Parameter location nicht angegeben wird, wird die exportierte Site-Konfigurationsdatei in einem Verzeichnis auf dem Server gespeichert, das im Besitz des Servers ist, und es wird ein virtueller Pfad (HTTPS-URL) zu diesem Verzeichnis angezeigt. Die exportierte Site-Konfiguration kann durch Aufrufen der angezeigten URL von diesem Verzeichnis heruntergeladen werden. Beispiel |
| validate | Eingeführt in ArcGIS Enterprise 11.1. Mit diesem Parameter wird vor dem Durchführen des Vorgangs importSite der im Parameter location angegebene Dateipfad überprüft und sichergestellt, dass darauf zugegriffen werden kann. Wenn dieser Parameter auf true festgelegt ist, wird der Pfad überprüft, und nach dem Vorgang wird eine Erfolgsmeldung oder eine Fehlermeldung angezeigt. Als Standardwert ist false festgelegt. Werte: true | false |
| f | Das Antwortformat. Das Standardantwortformat lautet html. Werte: html | json | pjson |
Beispiel für die Verwendung
Im Folgenden ist ein Beispiel für eine POST-Anforderung für exportSite dargestellt, in dem der Parameter "location" angegeben wurde:
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=jsonIm Folgenden ist ein Beispiel für eine POST-Anforderung für den Vorgang exportSite ohne Angabe des Parameters location dargestellt:
POST /webadaptor/admin/exportSite HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
location=&validate=false&f=pjsonBeispiel für eine JSON-Antwort
Im Folgenden ist ein Beispiel für eine Antwort auf eine Anforderung dargestellt, in dem der Parameter location angegeben wurde.
{
status: "success",
location: "\\videoserver\share\backup\Jan-15-2013_11-50-33.agssite"
}Im Folgenden ist ein Beispiel für eine Antwort auf eine Anforderung dargestellt, in dem der Parameter location nicht angegeben wurde.
{
status: "success",
location: "https://machine.domain.com/webadaptor/admin/uploads/i33d579b6-d8a8-4886-a1bc-671ae52e7a00"
}Beispiele mit Validierung
Im Folgenden ist ein Antwortbeispiel für eine Anforderung dargestellt, in dem der Parameter "location" angegeben und "validate" auf "true" festgelegt wurde. In diesem Beispiel wird eine Erfolgsmeldung angezeigt, was bedeutet, dass ArcGIS Server auf den Pfad zugreifen kann:
{
status: "success",
}Im Folgenden ist ein Antwortbeispiel für eine Anforderung dargestellt, in dem der Parameter location angegeben und validate auf true festgelegt wurde. In diesem Beispiel wird eine Fehlermeldung angezeigt, was bedeutet, dass ArcGIS Server nicht auf den Pfad zugreifen kann:
{
"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
}ArcGIS Video Server-Import und -Export aus einem lokalen Dateisystem
Keine sofort erkennbaren Unterschiede. Für das Service-Konto im Eingabe-/Ausgabeordner sind Lese- und Schreibberechtigungen erforderlich. In Linux entspricht das Service-Konto dem Benutzer, der ArcGIS Video Server installiert hat. Sie benötigen alle Berechtigungen zum Lesen, Schreiben und Ausführen für alle relevanten Verzeichnisse, auch für das Import-/Exportverzeichnis.
ArcGIS Video Server-Import und -Export aus einem Objekt oder Data Store
Bei Verwendung eines freigegebenen Netzwerkverzeichnisses oder Objektspeichers wird empfohlen, den Video Server Windows Service über ein Domänenkonto auszuführen. Für das Service-Konto im gewählten Verzeichnis sind alle Lese- und Schreibberechtigungen erforderlich. In Linux entspricht das Service-Konto dem Benutzer, der ArcGIS Video Server installiert hat.