Konfigurieren von Insights in ArcGIS Enterprise

Insights in ArcGIS Enterprise

Als Insights in ArcGIS Enterprise-Administrator können Sie eine Anwendungskonfigurationsdatei hinzufügen, um verschiedene Optionen festzulegen. Die Konfigurationsdatei muss den Namen insights.json haben und im folgenden Verzeichnis auf dem ArcGIS Server abgelegt werden: ArcGIS Server install directory\framework\etc\insights.json. Verfügbare Optionen werden nachfolgend beschrieben.

Verwaltungseinstellungen

Die folgenden Eigenschaften werden verwendet, um Optionen zu definieren.

EigenschaftBeschreibung

max_feature_copy_limit

Steuert die maximale Größe eines Remote-Feature-Layers, der in den Data Store vom Typ "relational" oder eine Datenbank kopiert werden kann. Wenn die Anzahl der Datensätze im Dataset diesen Wert überschreitet, geben Vorgänge, die das Kopieren von Daten erfordern, einen Fehler zurück. Gültige Werte sind ganzzahlige Werte; der Standardwert ist 250.000. Dies ist ein ganzzahliger Eigenschaftswert, der nicht in Anführungszeichen stehen muss.

Hinweis:

Diese Einschränkung gilt für Remote-Feature-Layer, auf die über einen Proxy zugegriffen wird, für Layer, auf die über eine ArcGIS Enterprise-Bereitstellung ohne Insights zugegriffen wird, sowie für Layer, deren Hosting-Portal nicht ermittelt werden kann.

Bei Überschreitung des Limits wird die folgende Fehlermeldung angezeigt: Das Dataset enthält zu viele Datensätze. Reduzieren Sie die Größe des Datasets. Sie können die Größe des Datasets reduzieren, indem Sie einen Attributfilter oder einen räumlichen Filter anwenden.

Beispiel: "max_feature_copy_limit": 250000

database_timeout

Steuert den Zeitraum in Sekunden für die Ausführung eines Vorgangs unter Verwendung von Daten aus einer Datenbankverbindung, bevor ein Timeout erfolgt. Wenn der Zeitraum für die Ausführung eines Vorgangs diesen Wert überschreitet, wird für den Vorgang ein Fehler zurückgegeben. Gültige Werte sind ganzzahlige Werte; der Standardwert ist 120 Sekunden. Dies ist ein ganzzahliger Eigenschaftswert, der nicht in Anführungszeichen stehen muss.

Beispiel: "database_timeout": 120

Hinweis:

Für mit SAP HANA-Datenbanken durchgeführte Vorgänge gibt es keine Timeouts. Die Eigenschaft "database_timeout" wird auf SAP HANA nicht angewendet.

task_timeout_secs

Steuert den Zeitraum in Sekunden für die Ausführung eines Planungs-Tasks, bevor ein Timeout erfolgt. Wenn der Zeitraum für die Ausführung der geplanten Aktualisierung diesen Wert überschreitet, wird für den Vorgang ein Fehler zurückgegeben. Gültige Werte sind ganzzahlige Werte. Der Standardwert ist 1800 Sekunden (30 Minuten). Dies ist ein ganzzahliger Eigenschaftswert, der nicht in Anführungszeichen stehen muss.

Beispiel: "task_timeout_secs": 1800

allow_running_tasks_without_sandboxing

Hinweis:

Diese Einstellung wird nur für Linux-Bereitstellungen verwendet.

Steuert, ob Planungs-Tasks mit Sandboxing ausgeführt werden. Zulässige Werte sind true oder false. Der Standardwert ist false. Dies ist ein boolescher Eigenschaftswert, der nicht in Anführungszeichen stehen muss.

Beispiel: "allow_running_tasks_without_sandboxing": false

max_concurrent_task_runners

Steuert die Anzahl der Planungs-Tasks, die gleichzeitig ausgeführt werden können. Wenn die Anzahl der für die Ausführung geplanten Tasks den Maximalwert überschreitet, werden Tasks in die Warteschlange eingereiht, bis ein anderer Task abgeschlossen ist. Gültige Werte sind ganzzahlige Werte; der Standardwert ist 4. Dies ist ein ganzzahliger Eigenschaftswert, der nicht in Anführungszeichen stehen muss.

Beispiel: "max_concurrent_task_runners": 4

enforce_database_connection_sharing_permission

Steuert, ob bei der Freigabe eines Berichts, der Daten aus einer Datenbankverbindung referenziert, die entsprechende Verbindung freigegeben werden muss. Zulässige Werte sind true oder false. Der Standardwert ist true. Dies ist ein boolescher Eigenschaftswert, der nicht in Anführungszeichen stehen muss.

Wenn die Eigenschaft auf true festgelegt wird, müssen Sie die Datenbankverbindung mit derselben Freigabeebene wie die Berichte, die Daten der Verbindung verwenden, freigeben (Beispiel: wenn der Bericht öffentlich freigegeben wird, muss die Datenbank ebenfalls öffentlich freigegeben werden). Wird die Eigenschaft auf false festgelegt, muss die Datenbankverbindung nicht freigegeben werden. Jedoch haben Benutzer, die Zugriff auf den Bericht haben, ebenfalls Zugriff auf die dort angezeigten Tabellen.

Beispiel: "enforce_database_connection_sharing_permission":true

Ändern von Einstellungen

Führen Sie die folgenden Schritte aus, um die Einstellungen für Insights in ArcGIS Enterprise zu konfigurieren:

  1. Erstellen Sie eine Datei namens insights.json.
  2. Fügen Sie die Einstellungen, die Sie konfigurieren möchten, einem einzelnen Objekt in der JSON-Datei hinzu.
  3. Kopieren Sie die insights.json-Datei nach \framework\etc\.
  4. Starten Sie ArcGIS Server erneut.
  5. Wenn die Insights in ArcGIS Enterprise-Implementierung mehrere ArcGIS Server-Instanzen umfasst, wiederholen Sie die Schritte 3 und 4 für jede ArcGIS Server-Instanz in Ihrer Site. Die Einstellungen sollten auf allen Servern übereinstimmen.
Hinweis:

Stellen Sie sicher, dass die insights.json-Datei gültigen JSON-Code enthält. Die Einstellungen haben keine Auswirkungen, wenn die Datei nicht ordnungsgemäß konfiguriert ist.

Wenn Sie die administrativen Standardeinstellungen wiederherstellen, können Sie dazu insights.json löschen und ArcGIS Server neu starten. Stellen Sie sicher, dass diese Aktionen für jede ArcGIS Server-Instanz Ihrer Site wiederholt werden.

Beispiel

Inhalt der insights.json-Datei, wenn "enrich_max_features", "locate_geocode_max_features", "buffer_network_max_features" und "max_feature_copy_limit" konfiguriert werden:

{  
"enrich_max_features": 10000,  
"locate_geocode_max_features": 10000,  
"buffer_network_max_features": 1000,
"max_feature_copy_limit": 500000 
}

Sandboxing

Hinweis:

Sandboxing-Einstellungen werden nur in Linux-Bereitstellungen genutzt.

Bei geplanten Aktualisierungen für veröffentlichte Berichte ist die Ausführung des JavaScript-Codes erforderlich. Dies erfolgt über einen speziellen Build des Chromium-Browsers. Chromium bietet mit dem sog. Sandboxing eine Sicherheitsfunktion, die als zusätzlicher Schutz greift, wenn der vom Browser ausgeführte Code die eigenen Sicherheitsbeschränkungen umgehen sollte. Dabei wird der Vorgang vom restlichen System durch die Namespace-Sandbox oder die Setuid-Sandbox isoliert.

Die Verwendung der Namespace-Sandbox erfordert, dass der Kernel einen Namespace-Klon eines nicht berechtigten Benutzers ausführt. Wenn das Kernel-Flag von Ihrem System unterstützt wird, wenden Sie sich an Ihren Administrator, um diese Funktion unter Berücksichtigung der folgenden Punkte zu aktivieren:

sudo sysctl -w kernel.unprivileged_userns_clone=1

Wenn die Namespace-Sandbox nicht unterstützt wird, können Sie stattdessen die Setuid-Sandbox einrichten.

Für die von der Setuid-Sandbox ausgeführten Aktionen sind Root-Berechtigungen erforderlich. Aus diesem Grund muss sie so konfiguriert werden, dass sie von allen Benutzern als Root ausgeführt werden kann.

  1. Navigieren Sie in der ArcGIS Server-Installation zur chrome-sandbox-Datei im folgenden Pfad: framework/runtime/insights/linux/.
  2. Ändern Sie mit dem folgenden Befehl den Besitzer in Root: sudo chown root chrome-sandbox.
  3. Erlauben Sie mit dem folgenden Befehl allen Benutzern, chrome-sandbox als Besitzer (Root) auszuführen: sudo chmod 4755 chrome-sandbox.

Sollten die geplanten Aktualisierungen fehlschlagen, da keine funktionierende Sandbox vorliegt, kann diese Sicherheitsfunktion als letztes Mittel über die Insights-Einstellung allow_running_tasks_without_sandboxing deaktiviert werden. Ist eine funktionierende Sandbox vorhanden, wird diese Einstellung ignoriert. Andernfalls werden die Tasks ohne Sandbox auf Systemebene ausgeführt.

Programm zur Verbesserung der Benutzerfreundlichkeit von Esri

Durch das Programm zur Verbesserung der Benutzerfreundlichkeit von Esri werden Benutzerinformationen gesammelt, die für Verbesserungen an der Software verwendet werden.

Administratoren können bei der Installation die Teilnahme am Programm ablehnen. Nach Abschluss der Installation von Insights in ArcGIS Enterprise kann die Einstellungskonfiguration geändert werden, um die Teilnahme am Programm zu beenden.

Konfigurieren der Einstellungen unter Windows

Bei der Installation von Insights in ArcGIS Enterprise unter Windows können Sie im Installationsassistenten das Kontrollkästchen für Klicken Sie hier, um am Esri Programm zur Verbesserung der Benutzerfreundlichkeit teilzunehmen deaktivieren, um die Teilnahme abzulehnen.

Die Einstellungen für das Programm zur Verbesserung der Benutzerfreundlichkeit von Esri können mit der Einstellungsdatei (<portal_install_dir>/apps/insights/settings.json) konfiguriert werden. Um die Teilnahme am Programm zu beenden, ändern Sie die Einstellung von eueiEnabled: "true" zu eueiEnabled: "false".

Konfigurieren der Einstellungen unter Linux

Wenn Sie Insights in ArcGIS Enterprise unter Linux installieren, können Sie den Installationsbefehl ./Insights-Setup.sh -e No ausführen, um die Teilnahme am Programm zur Verbesserung der Benutzerfreundlichkeit von Esri abzulehnen.

Die Einstellungen für das Programm zur Verbesserung der Benutzerfreundlichkeit von Esri können mit der Einstellungsdatei (<portal_install_dir>/apps/insights/settings.json) konfiguriert werden. Um die Teilnahme am Programm zu beenden, ändern Sie die Einstellung von eueiEnabled: "true" zu eueiEnabled: "false".