Windows Agent installieren

Installation des Windows Agents über Setup oder Skriptgesteuert

Letzte Anpassung: 8.90 10.2021

Neu:

Automatische Agent-Konfiguration mit standardmäßigem Verschlüsselungskennwort
Neue Parameter für Silent Installationen

notempty

Dieser Artikel bezieht sich auf eine Resellerpreview

Agent ≤8.90

Windows-Setup

Installation über das Windows Setup:

Download des erforderlichen Agents im Downloadbereich des Dashboards
Ausführen der Installationsdatei auf dem Computer, für den das Backup eingerichtet werden soll.
Auswahl des benutzerdefinierten Setups gewählt
Auswahl des Kontos, das zur Anmeldung der Agentendienste verwendet werden soll
Ggf. können weitere Plug-ins installiert werden.

Das Image-Plug-in erfordert einen Neustart.
Benutzername im E-Mail-Format und das Kennwort eines Portalbenutzers hinterlegen

Der Computer wird der Endkunden-Site zugeordnet, der auch der Benutzer zugeordnet ist.
Ggf. ein Standardmäßiges Verschlüsselungskennwort setzen.

Nur für Sites, in denen die Automatische Agent-Konfiguration aktiviert wurde.
installieren

Download des erforderlichen Agents im Downloadbereich des Dashboards

Auswahl der Sprache des Installationsassistenten

Willkommensanzeige

Supportinformationen

SUB v1 Agent Win Setup--Lizenzbestimmungen.png

Den Lizenzbedingungen muss zugestimmt werden

Auswahl des benutzerdefinierten Setups gewählt

SUB v1 Agent Win Setup--Anmeldeinformationen.png

Auswahl des Kontos, das zur Anmeldung der Agentendienste verwendet werden soll

Der Zielordner kann bei Bedarf geändert werden

SUB v1 Agent Win Setup--Benutzerdefiniertes Setup.png

Neben dem eigentlichen Backup-Agenten können weitere Plug-ins installiert werden. Je nach Typ des Servers können so beispielsweise einzelne Microsoft SQL-Datenbankinstanzen oder Exchange-Postfächer gesichert werden.

Das Image-Plug-in erfordert einen Neustart.

SUB v1 Agent Win Setup--Datenverschlüsselungsmethode.png

Auswahl der Datenverschlüsselungsmethode

SUB v1 Agent Win Setup--Portalregistrierung.png

Hier muss der Benutzername (E-Mail-Format) und das Kennwort eines Portalbenutzers hinterlegt werden. (Rolle: Benutzer)

Der Computer wird der Endkunden-Site zugeordnet, der auch der Benutzer zugeordnet ist.

Port nur nach Absprache mit unserem Support ändern!

Ggf. ein Standardmäßiges Verschlüsselungskennwort setzen.

Nur für Sites, in denen die Automatische Agent-Konfiguration aktiviert wurde.

SUB v1 Agent Win Setup--Installation.png

Installation starten

SUB v1 Agent Win Setup--installieren.png

Die Installation wird durchgeführt

SUB v1 Agent Win Setup--Abgeschlossen.png

Die Installation ist abgeschlossen. Der Assistent kann mit Fertigstellen beendet werden.

Wurde das Image Plug-in zur Installation ausgewählt (default), ist ein Neustart erforderlich

Skriptbasiert / Silent

Der Agent kann auch im Silent Modus installiert werden. Dies ist dann hilfreich, wenn der Agent auf mehreren Systemen automatisiert ausgerollt werden soll.

Die Parameter müssen in Anführungszeichen eingeschlossen sein und werden lediglich durch Leerzeichen getrennt.

Da das Passwort im Klartext übergeben wird, sollte nach der Installation unbedingt das Skript vom Computer und/oder der Benutzer aus dem Portal entfernt werden.

Wird der Benutzer entfernt, kann zunächst nur ein Administrator den Computer verwalten, bis er einem anderen Benutzer zugewiesen wird!

Agent-Windows-x64-x-xx-xxxx.exe /s /v"Parameter"

Code

Parameter	Beschreibung
Agent-Windows-x64-x-xx-xxxx.exe	Das Setup des Agenten (hier: x64) wird aufgerufen.
/s	Für den Silentmodus erforderlich. Unterdrückt Meldungen und Eingabeaufforderungen der .exe-Datei.
/v	Übergibt die Parameter (in Anführungszeichen) an das MSI-Paket. Kein Leerzeichen vor dem nachfolgenden Anführungszeichen!
REGISTERWITHWEBCC=True	Der Agent soll am Backup Portal registriert werden.
AMPNWADDRESS=backup.securepoint.de	Die Adresse des Backup Portals wird übergeben
AMPUSERNAME=backupkunde@firmaXYZ.de	Der Benutzer der Kundensite wird übergeben
AMPPASSWORD=password	Das von Ihnen vergebene Kennwort für den Benutzer der Kundensite
SILENTINSTALLDIR=\"Pfad"	Installationspfad notempty Neu § ab Agent 8.90
NEW_DEFAULT_ENC_PWD=True	Aktivieren des Features Automatische Agent-Konfiguration notempty Neu § ab Agent 8.90
DEFAULTJOBENCRYPTIONKEY=insecure	Verschlüsselungskennwort notempty Neu § ab Agent 8.90
CONFIRM_DEFAULTJOBENCRYPTIONKEY==insecure	Bestätigen des Verschlüsselungskennwort notempty Neu § ab Agent 8.90
/qn	Für den Silentmodus erforderlich. Verhindert Eingabedialoge des Windows-Installers (MSI).
Parameter für Plug-ins
FEATUREVOLUMEIMAGE=ON	Image Plug-in Erfordert einen Neustart!
FEATUREEXCHANGE=ON	Exchange Plug-in (Legacy)
FEATUREEXCHANGE2010=ON	Exchange Plug-in (Ab 2010)
FEATURESQL=ON	SQL Plug-in
FEATURECLUSTER=ON	Cluster Plug-in
FEATUREORACLE=ON	Oracle Plug-in
SILENTINSTALLDIR=\"C:\Program Files\Example\	Installationspfad

Silent Agenten-Registrierung

Soll ein Agent z.B. in einer anderen Subsite registriert werden, reicht folgender Eintrag in der Kommandozeile aus, um den Agenten am Portal erneut zu registrieren: C:\Program Files\Securepoint Unified Backup\Agent\buagent.exe" -cmdline --reregister --amplogin backupkunde@firmaXYZ.de --amppassword USERPW --ampserver "backup.securepoint.cloud" --ampport 8086

Anschließend müssen einmal die Dienste des Securepoint Unified Backup neu gestartet werden.
Dazu wird die PowerShell mit Administratorrechten gestartet und folgendes eingegeben:
Get-Service -DisplayName "Securepoint Unified Backup*" | Restart-Service