Automatische Installation¶

Administration¶

Für eine unbeaufsichtigte Installation oder ein Rollout stehen verschiedene Kommandozeilenparameter zur Verfügung, die an das Setup übergeben werden können:

/STUMM /NACHRICHTENFENSTER_AUSBLENDEN: Installiert die Software ohne Nutzerinteraktion mit den Standard-Werten. Der Installationsfortschritt wird angezeigt.
/SEHRSTUMM /NACHRICHTENFENSTER_AUSBLENDEN: Installiert die Software ohne Nutzerinteraktion mit den Standard-Werten ohne jegliches visuelles Feedback.
/PASSWORD=InstallKey: Registriert die Software mit dem angegebenen Installationsschlüssel.
/VERZEICHNIS="x:\verzeichnisname": Gibt den Pfad an, unter dem der SpaceObServer installiert werden soll
/DIENSTBENUTZER “<benutzername>”: Übermittelt der Anwendung den Namen des Benutzerkontos, welches für Scans und Indizierung benutzt werden soll. Bei keiner Eingabe wird das Standard-Systemkonto verwendet (nicht empfohlen).
/DIENSTPASSWORT “<passwort>”: Übergibt der Anwendung das Passwort des Benutzerkontos, das zum Scannen und Indizieren verwendet werden soll. Wenn keine Eingabe erfolgt, wird das Standard-Systemkonto verwendet (nicht empfohlen). Hinweis: Verwenden Sie diesen Parameter nur in Kombination mit /SERVICEUSER „<Benutzername>“.
/ENABLEINDEXSERVER: Verwenden Sie diesen Parameter um die zentrale Indizierung zu aktivieren (DataCentral Dienst). Durch diese Option können Sie mit UltraSearch diesen zentralen Index durchsuchen. So benötigen mehrere Endgeräte nur den einzelnen gemeinsamen Suchindex.
/USESELFSIGNEDCERTIFICATE: Verwenden Sie diesen Parameter um ein neues selbst signiertes Zertifikat (PFX-Datei) zu erstellen und zu nutzen. Hinweis: Wenn bei den Zertifikat Parametern nichts angegeben wird, ist dieser Parameter hier der Standard-Fall.
/INDEXSERVERZERTIFIKAT “<voller pfad zur pfx-datei>”: Gibt den vollständigen Pfad zu einer Zertifikatsdatei (PFX-Datei) an, die bereits installiert ist und für die Verschlüsselung der Kommunikation mit dem DataCentral-Server verwendet werden soll.
/INDEXSERVERZERTIFIKATPASSWORT “<passwort der pfx-datei>“: Wenn die mit dem Parameter /INDEXSERVERCERTIFICATE angegebene PFX-Datei durch ein Passwort geschützt ist, verwenden Sie diesen Parameter zur Angabe des Passworts. Hinweis: Verwenden Sie diesen Parameter nur in Kombination mit /INDEXSERVERCERTIFICATE.

Unbeaufsichtigte Installation per PowerShell-Skript¶

Mithilfe der oben genannten Optionen kann SpaceObServer automatisiert verteilt werden. Als Beispiel dient folgendes Powershell-Skript, das die Setup.exe von einem festgelegten Verzeichnis auf einen PC kopiert und dort ausführt. Für dieses Beispiel müssen administrative Freigaben aktiviert sein.

In den ersten Zeilen werden der Suchpfad der Installationsdatei und der Name des Zielrechners definiert. Anschließend werden Benutzername und Passwort für den Zugriff auf den Rechner abgefragt. Nach dem Test auf Erreichbarkeit des Rechners wird das temporäre Verzeichnis C:temp angelegt und die Setup-Exe dorthin kopiert.

Schließlich wird die Setup.exe mit diesen Optionen aufgerufen, um SpaceObServer mit aktiviertem DataCentral-Dienst und selbstsignierten Zertifikaten zu installieren: /VERYSILENT, /SUPPRESSMSGBOXES, /ENABLEINDEXSERVER, /USESELFSIGNEDCERTIFICATE

$SOSSetupName = "SpaceObServer-Setup.exe"
$SetupPath = "\\intranet\setups\$SOSSetupName"
$DestinationHost = "client-pc"

$User = Read-Host "User name (z.B. domain\username)"
$SecPassword = Read-Host "Password" -AsSecureString

$Credential = New-Object System.Management.Automation.PSCredential ($User, $SecPassword)

$RemoteTempFolder = "\\$DestinationHost\C$\Temp\"
$LocalSetup = "C:\Temp\$SOSSetupName"

if (-not (Test-Connection -ComputerName $DestinationHost -Count 1 -Quiet)) {
    throw "Target host '$DestinationHost' cannot be reached."
}

if (-not (Test-Path $RemoteTempFolder)) {
    New-Item -Path $RemoteTempFolder -ItemType Directory -Force | Out-Null
}

Copy-Item -Path $SetupPath -Destination $RemoteTempFolder

$ScriptBlock = {
    param($LocalSetup)
    Start-Process -FilePath $LocalSetup -ArgumentList "/VERYSILENT", "/SUPPRESSMSGBOXES", "/ENABLEINDEXSERVER", "/USESELFSIGNEDCERTIFICATE" -NoNewWindow -Wait
}

Invoke-Command -ComputerName $DestinationHost -ScriptBlock $ScriptBlock -ArgumentList $LocalSetup -Credential $Credential

Remove-Item -Path "$RemoteTempFolder$SOSSetupName" -Force

Unbeaufsichtigte Installation auf mehreren Servern als lokale Scan-Agenten¶

Um eine optimale Scan-Leistung zu erzielen, sollte SpaceObServer Verzeichnisse/Freigaben lokal scannen, anstatt sie remote über das Netzwerk zu scannen (siehe „– Empfohlene Einstellungen “). Um dies zu erreichen oder die Last auf mehrere Rechner zu verteilen, kann es sinnvoll sein, mehrere SpaceObServer-Instanzen auf verschiedenen Rechnern zu installieren. Jede dieser Installationen fungiert dann als lokaler Scan-Agent: Sie kann entweder nur ihre eigenen lokalen Laufwerke oder eine Teilmenge von Servern über das Netzwerk scannen, wobei sie ihren eigenen „-SpaceObServer-Scan-Dienst “ nutzt, und speichert die Ergebnisse in einer gemeinsamen, zentralen Datenbank, sodass alle Server weiterhin gemeinsam über eine einzige „SpaceObServer Client Access“- oder „SpaceObServer Web Access“-Installation überprüft werden können.

Das Beispielskript „UnattendedInstallation.ps1“ im Unterverzeichnis „Demos\powershell“ Ihres SpaceObServer-Installationsverzeichnisses (C:\Program Files\JAM Software\SpaceObServer) automatisiert die Einrichtung eines genau solchen lokalen Scan-Agenten auf einem Server. Es führt nacheinander drei Schritte aus:

Es führt das Setup mit dem Befehl „ /SILENT /SUPPRESSMSGBOXES /SERVICEUSER /SERVICEPWD /PASSWORD=“ aus, um SpaceObServer im Hintergrund zu installieren und den Scan-Dienst „SpaceObServer Agent“ unter einem dedizierten Dienstkonto zu registrieren.
Es erstellt ein SpaceObServer-OLE-Automation-Objekt und setzt ConnectionString, um die neue Instanz auf Ihre zentrale SQL-Datenbank zu verweisen.
Es ruft ScheduleScan auf, um wiederkehrende Scans einzurichten.

Um dies auf mehrere Server auszuweiten, müssen Sie Folgendes anpassen:

Ersetzen Sie die Platzhalterwerte am Anfang des Skripts (Installationspfad, Dienstkonto, Passwort und Installationsschlüssel).
Ersetzen Sie die Verbindungszeichenfolge, indem Sie sie aus Ihrer SpaceObServer-Hauptinstanz unter „Start“ > „Optionen“ > „Datenbank“ kopieren. Beachten Sie, dass Sie den Platzhalter durch das tatsächliche Passwort ersetzen müssen: Es wird in SpaceObServer verschlüsselt gespeichert, muss hier jedoch unverschlüsselt angegeben werden.
Ersetzen Sie die hinzugefügten C:\\- und D:\\-Scans durch die Pfade, die jede einzelne Instanz analysieren soll. Wenn Sie dies hier im Skript tun, ist nur diese lokale Instanz für das Scannen dieser Pfade verantwortlich. Siehe die Experteneinstellung „Observing Server“ als Referenz.

Führen Sie das Skript einmal pro Server aus: entweder lokal auf dem Zielserver oder per Push über Invoke-Command/PsExec, genau wie im obigen Beispiel für einen einzelnen Host. Das Skript selbst konfiguriert immer nur den Rechner, auf dem es ausgeführt wird; es durchläuft keine Serverliste in einer Schleife.

Wenn Sie mehrere dieser lokalen Scan-Agenten für eine gemeinsame Datenbank installieren, beachten Sie bitte Folgendes:

Service account permissions: Das Konto, das über $ServiceUser/$ServicePwd weitergeleitet wird, benötigt Lesezugriff auf die Laufwerke, die gescannt werden auf diesem bestimmten Server. Die Verwendung desselben Domänenkontos auf jedem Server ist praktisch, jedoch müssen dessen Berechtigungen dennoch lokal auf jedem Rechner überprüft werden.
Overlapping scan paths: Jeder Server schreibt in dieselbe Datenbank. Sind zwei Server so konfiguriert, dass sie denselben Pfad scannen (z. B. wenn beide auf dieselbe Netzwerkfreigabe verweisen), wird nur der erste hinzugefügt, da SpaceObServer zulässt, dass ein bestimmter Pfad nur einmal gescannt wird.
Matching connection strings: Alle Agenten müssen die folgende Zeichenfolge verwenden: ConnectionString, die auf genau dieselbe Datenbank verweist, damit „SpaceObServer Client Access“ eine konsolidierte Ansicht anzeigt. Eine falsche Verbindungszeichenfolge wird nicht akzeptiert, da SpaceObServer die Verbindung direkt überprüft – stellen Sie sicher, dass die Datenbank von diesem Rechner aus erreichbar ist.
Installation key: $InstallPwd registriert den Installationsschlüssel auf jedem Rechner einzeln. Prüfen Sie in Ihren Lizenzbedingungen bzw. im Kundenbereich, ob ein Schlüssel für alle Server im Rollout gilt oder ob für jede Installation ein eigener Schlüssel erforderlich ist.
Scan scheduling: Wenn alle Server so geplant werden, dass sie gleichzeitig gescannt werden (wie im Standardskript), schreiben alle Agenten gleichzeitig in die gemeinsame Datenbank. Bei größeren Bereitstellungen sollten Sie die Startzeiten von ScheduleScan über die Server hinweg staffeln, um die Last auf dem zentralen SQL-Server zu verteilen.
Remote execution prerequisites: Wenn Sie das Skript auf Remote-Server übertragen, anstatt es lokal auszuführen, gelten dieselben Anforderungen wie für das Beispiel mit einem einzelnen Host: Administrationsfreigaben sowie – für Invoke-Command – muss PowerShell-Remoting (WinRM) auf jedem Zielserver aktiviert und erreichbar sein.