Bitte überprüfen Sie zuerst, ob ein Neustart des Servers nötig ist. Falls ja, verwenden Sie ein Skript, das die Dienste in der richtigen Reihenfolge stoppt und wieder startet. VertiGIS stellt dafür das PowerShell-Skript WebOfficeServerRestart.ps1 bereit. Es ersetzt das bisherige Batch-Skript GISServerRestart.bat.

Download: WebOfficeServerRestart.zip – das Skript WebOfficeServerRestart.ps1 und zwei Vorlagen für die Windows-Aufgabenplanung (nächtlicher Neustart, Start nach dem Hochfahren des Servers).

icon_comment

Das Skript ist für ein Single-Server-Szenario gedacht: ArcGIS Server, IIS, WebOffice FTS-Index, WebOffice extensions und Apache Tomcat laufen auf demselben Rechner.

Läuft ArcGIS Server auf einem eigenen GIS-Server, führen Sie das Skript auf dem WebOffice 10.9 R5 Webserver mit dem Parameter -SkipGisServer aus. Starten Sie den GIS-Server vorher separat neu, damit ArcGIS Server bereit ist, wenn Apache Tomcat startet.

Warum PowerShell statt Batch?

Das Skript macht dasselbe wie die bisherigen Batch-Dateien: Es stoppt die Dienste und startet sie wieder. Es prüft aber jeden Schritt, statt nur feste Pausen abzuwarten. Das Skript ist eine normale Textdatei, die Sie in einem Texteditor öffnen und lesen können. Jeder Abschnitt ist kommentiert. PowerShell ist in jedem Windows Server enthalten, es muss nichts installiert werden. Anpassen müssen Sie nur den Konfigurationsblock am Anfang (Abschnitt CONFIGURATION), der Rest bleibt unverändert.

•net stop / net start: Das Skript wartet zusätzlich, bis der Dienst tatsächlich gestoppt bzw. gestartet ist, und protokolliert es, wenn das nicht gelingt.

•timeout /t 3600 (feste Pause): Das Skript wartet, bis ArcGIS Server bzw. Apache Tomcat antworten. Das ist meist deutlich kürzer.

•taskkill /f: nur, wenn Apache Tomcat nach 180 Sekunden nicht gestoppt ist.

•start https://.../synadmin?...: POST-Anfrage ohne Browser, kein Passwort im Skript.

•Ausgabe, die verloren geht oder überschrieben wird: eine Logdatei pro Lauf mit Uhrzeit, Dauer jedes Schritts und Gesamtlaufzeit, bei Fehlern Exit-Code 1.

Probieren Sie das Skript zuerst mit einem Probelauf aus. Er prüft die Konfiguration (Dienste gefunden? Adressen erreichbar? Passwort richtig?) und protokolliert, was ein echter Lauf tun würde. Dabei wird nichts gestoppt, gestartet oder verändert. Das Passwort wird nur mit einer lesenden Statusabfrage (action=status_fts_index) geprüft:

powershell.exe -NoProfile -ExecutionPolicy Bypass -File "C:\Scripts\WebOfficeServerRestart.ps1" -DryRun

-ExecutionPolicy Bypass gilt nur für diesen einen Aufruf. Die Ausführungsrichtlinie des Servers bleibt unverändert.

Rufen Sie das Skript immer über powershell.exe auf, wie in den Beispielen gezeigt. Anders als eine Batch-Datei lässt sich eine .ps1-Datei in der Eingabeaufforderung (cmd) nicht direkt starten: Windows öffnet sie nur im Editor, das Skript läuft nicht.

Reihenfolge

Das Skript stoppt zuerst die Dienste, die andere Dienste nutzen, und startet alle in umgekehrter Reihenfolge wieder:

1.Stopp: Apache Tomcat, WebOffice extensions, ArcGIS Server, WebOffice FTS-Index, WWW-Publishingdienst, IIS-Verwaltungsdienst

2.Start: IIS-Verwaltungsdienst, WWW-Publishingdienst, WebOffice FTS-Index, ArcGIS Server, WebOffice extensions, zuletzt Apache Tomcat

3.Optional: Volltextsuche der eingetragenen WebOffice 10.9 R5 Anwendungen neu berechnen

Statt fester Pausen wartet das Skript nach jedem Schritt, bis der Dienst tatsächlich gestoppt bzw. gestartet ist. Nach dem Start von ArcGIS Server wartet es auf eine erfolgreiche Antwort des ArcGIS Server Health Checks, nach dem Start von Apache Tomcat auf eine HTTP-Antwort. Jeder Schritt hat eine Obergrenze. Apache Tomcat wird nur dann hart beendet, wenn er nicht innerhalb von 180 Sekunden regulär stoppt. Dienste, die auf dem Rechner nicht installiert sind, werden mit einer Warnung übersprungen.

Parameter

•-DryRun: Probelauf, prüft die Konfiguration und protokolliert, was getan würde. Verändert nichts.

•-SkipGisServer: lässt die Dienste des GIS-Servers (ArcGIS Server, WebOffice extensions) unverändert. Für Installationen, bei denen ArcGIS Server auf einem eigenen Rechner läuft.

•-StartOnly: führt nur den Start-Teil aus, z. B. nach einem Neustart der Servermaschine.

•-SkipFullTextSearch: berechnet die Volltextsuche nicht neu, auch wenn Anwendungen dafür eingetragen sind (siehe unten).

•-LogDir: Ordner für die Logdateien (Standard: Unterordner Logs neben dem Skript). Pro Lauf entsteht eine Logdatei, Dateien älter als 30 Tage werden gelöscht. Die Spalten sind durch Tabulatoren getrennt: Uhrzeit, bisherige Laufzeit (Elapsed), Dauer seit der vorigen Zeile (Step), Status und Meldung; am Ende steht die Gesamtlaufzeit. Wer die Zeiten auswerten möchte, markiert den gesamten Inhalt im Editor und fügt ihn in Excel ein – die Spalten werden dabei automatisch getrennt.

Anpassen

Passen Sie vor der ersten Verwendung den Konfigurationsblock am Anfang des Skripts an Ihren Server an: die Namen der Dienste (z. B. Tomcat11), die URLs für den Health Check von ArcGIS Server und Apache Tomcat sowie die Wartezeiten. Das Skript verwendet den Dienstnamen (Spalte Name, z. B. W3SVC). Er ist im Gegensatz zum Anzeigenamen (WWW-Publishingdienst bzw. World Wide Web Publishing Service) unabhängig von der Sprache von Windows. Die Namen der Dienste listet folgender PowerShell-Befehl auf:

Get-Service | Format-Table Name, DisplayName

Für den Health Check von ArcGIS Server ist https://localhost:6443/arcgis/rest/info/healthCheck?f=json voreingestellt (ArcGIS Server 10.7 oder neuer). Ist dieser Port gesperrt, kann stattdessen die Adresse über den ArcGIS Web Adaptor eingetragen werden, z. B. https://server/webadaptor/rest/info/healthCheck?f=json. Der Probelauf zeigt, ob die Adresse erreichbar ist.

Volltextsuche neu berechnen (optional)

Ist eine Volltextsuche konfiguriert, kann das Skript nach dem Start von Apache Tomcat die Subindizes einer oder mehrerer WebOffice 10.9 R5 Anwendungen neu berechnen lassen. Tragen Sie dazu die Adressen der Anwendungen im Konfigurationsblock unter $FtsApplications ein, z. B. 'https://server/WebOffice'. Unter $FtsSubindex legen Sie fest, welche Subindizes berechnet werden (Standard ALL_OUTDATED).

Das Skript sendet für jede Anwendung einen Batchfähigen Administrationsrequest mit action=recreate_fts_index als POST-Anfrage. Das Passwort steht damit weder in einer URL noch in den Zugriffsprotokollen von Apache Tomcat oder im Log des Skripts. Antwortet eine Anwendung noch nicht mit OK, weil sie noch initialisiert, wiederholt das Skript die Anfrage bis zu 15 Minuten lang.

Das Skript liest das verschlüsselte Passwort des Benutzers batchadmin für jede Anwendung aus deren Anwendungskonfiguration: Attribut pwd von BATCHADMIN_USER in WEB-INF\classes\configuration\application_config.xml. Jede Anwendung verwendet so ihr eigenes Passwort, im Skript wird nichts gespeichert, und eine Änderung in WebOffice author standalone unter Anwendungskonfiguration > WebOffice > Admin User für Batch Requests gilt sofort, siehe Kapitel Admin User für Batch Requests.

Den Ordner der Anwendung findet das Skript wie Apache Tomcat selbst: über eine Context-Datei conf\Catalina\localhost\<Anwendung>.xml oder einen Context-Eintrag in server.xml (z. B. wenn die Anwendung wie in GEONIS-Installationen außerhalb von webapps liegt), sonst im Ordner webapps. Den Tomcat-Ordner liest es aus dem Tomcat-Dienst. Liegt die Konfiguration an einem anderen Ort, geben Sie sie für diese Anwendung direkt an:

@{ Url = 'https://server/WebOffice2'; Config = 'D:\GEONIS\WebOffice2\WEB-INF\classes\configuration\application_config.xml' }

Der Probelauf zeigt pro Anwendung, aus welcher Datei das Passwort gelesen wurde, und prüft es mit einer lesenden Statusabfrage. Mit dem Parameter -SkipFullTextSearch wird der Schritt bei einem Lauf ausgelassen.

Einrichtung in der Windows Aufgabenplanung

Legen Sie für den nächtlichen Neustart der Dienste eine Aufgabe an. Sie läuft als SYSTEM mit höchsten Privilegien. Dafür muss kein Kennwort eines Benutzerkontos hinterlegt werden:

Programm: powershell.exe

Argumente: -NoProfile -ExecutionPolicy Bypass -File "C:\Scripts\WebOfficeServerRestart.ps1"

Statt die Aufgaben von Hand anzulegen, verwenden Sie die beiden Vorlagen aus dem Download: WebOfficeServerRestart_Nightly.xml startet das Skript täglich um 02:00 Uhr, WebOfficeServerRestart_Startup.xml nach dem Hochfahren (siehe unten). Beide laufen als SYSTEM, es wird kein Kennwort abgefragt. Am einfachsten registrieren Sie beide mit einem Befehl in einer PowerShell als Administrator. Legen Sie Skript und Vorlagen in einen Ordner und tragen Sie diesen bei $dir ein. Der Befehl schreibt den Ordner anstelle von C:\Scripts in die Vorlagen und legt die Aufgaben WebOfficeServerRestart_Nightly und WebOfficeServerRestart_Startup an:

$dir = 'C:\Scripts'; foreach ($n in 'Startup', 'Nightly') { $xml = (Get-Content "$dir\WebOfficeServerRestart_$n.xml" -Raw) -replace [regex]::Escape('C:\Scripts'), $dir; Register-ScheduledTask -TaskName "WebOfficeServerRestart_$n" -Xml $xml -Force }

Fügen Sie den Befehl als eine Zeile ein. Beim Einfügen über eine Remotedesktop-Verbindung gehen Zeilenumbrüche sonst verloren, und der Befehl läuft nicht. Die Uhrzeit des nächtlichen Neustarts ändern Sie danach in den Eigenschaften der Aufgabe unter Trigger.

Der Import über die Aufgabenplanung (Aktion > Aufgabe importieren) ist ebenfalls möglich, scheiterte auf einzelnen Servern aber mit dem Fehler 0x80041318. Passen Sie beim Import Uhrzeit und Skriptpfad im Importdialog an. Prüfen Sie danach, ob die Aufgabe auf den richtigen Skriptpfad zeigt. Auch bei einem falschen Pfad meldet schtasks /run „SUCCESS“, das Skript startet aber nicht:

schtasks /query /tn "WebOfficeServerRestart_Nightly" /v /fo list | Select-String "Task To Run","Run As User","Start In"

Den Pfad korrigieren Sie in den Eigenschaften der Aufgabe unter Aktionen oder per PowerShell (als Administrator):

Set-ScheduledTask -TaskName "WebOfficeServerRestart_Nightly" -Action (New-ScheduledTaskAction -Execute powershell.exe -Argument '-NoProfile -ExecutionPolicy Bypass -File "C:\Scripts\WebOfficeServerRestart.ps1"' -WorkingDirectory C:\Scripts)

Bei einem Fehler endet das Skript mit dem Exit-Code 1. Die Aufgabenplanung zeigt das als Ergebnis der letzten Ausführung an.

Wird die Servermaschine zusätzlich regelmäßig neu gestartet, planen Sie das zu einer anderen Zeit als den nächtlichen Neustart der Dienste. Für den Start nach dem Hochfahren legen Sie eine Aufgabe mit dem Trigger Beim Start und dem zusätzlichen Argument -StartOnly an. Setzen Sie dann den Starttyp der Dienste Apache Tomcat und WebOffice extensions auf Manuell, damit allein das Skript die Reihenfolge bestimmt.

icon_cross-reference

•Weitere Administrationsrequests (z. B. Anwendung neu laden) finden Sie im Kapitel Batchfähige Administrationsrequests. Senden Sie diese per POST und legen Sie Passwörter nicht im Klartext in einem Skript ab.

•Siehe auch Kapitel Probleme bei der Projektinitialisierung.