SUB/Agent-Windows: Unterschied zwischen den Versionen

Aktuelle Version vom 27. Oktober 2023, 07:45 Uhr

Installation des Windows Agents über Setup oder Skriptgesteuert

Letzte Anpassung zur Version: 8.90 10.2021

Neu:

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

notemptyDieser Artikel bezieht sich auf eine Beta-Version

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


1.	2.	3.


Abb.1	Abb.2	Abb.3


Abbildungen

Download des erforderlichen Agents im Downloadbereich des Dashboards

Auswahl der Sprache des Installationsassistenten

Willkommensanzeige

Supportinformationen

Den Lizenzbedingungen muss zugestimmt werden

Auswahl des benutzerdefinierten Setups gewählt

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

Der Zielordner kann bei Bedarf geändert werden

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.

Auswahl der Datenverschlüsselungsmethode

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.

Installation starten

Die Installation wird durchgeführt

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

@@ Zeile 2: / Zeile 2: @@
 {{#vardefine:headerIcon|spicon-sub}}
 {{:SUB/Agent-Windows.lang}}
-</div><noinclude>{{DISPLAYTITLE:{{#var:display}} }}{{TOC2}}
+{{var	| Neu--autokonfig
+		| Automatische Agent-Konfiguration mit standardmäßigem Verschlüsselungskennwort
-'''{{#var:head}}'''
+		| Automatic agent configuration with default encryption password }}
+{{var	| Neu--Parameter
+		| Neue Parameter für Silent Installationen
-{{#var:ver}} 8.90 <small>'''10.2021'''</small>
+		| New parameters for silent installations }}
-{{cl|{{#var:neu}} |
-* {{#var:Neu--autokonfig}} {{Hinweis| ab Agent 8.90|1.1}}
-* {{#var:Neu--Parameter}} {{Hinweis| ab Agent 8.90|1.1}}
-}}<br>
-{{#var:prev}} [[SUB/Agent-Windows_v1 | Agent ≤8.90]]
+</div><noinclude>{{TOC2}}{{Select_lang}}
+{{Header|8.90 <small>'''10.2021'''</small>|
+* {{#var:Neu--autokonfig}}
+* {{#var:Neu--Parameter}}
+|[[SUB/Agent-Windows_v1 | Agent ≤8.90]]
+| {{Menu|Dashboard}}
+}}
 ----
 </noinclude>
-=== {{#var:Windows-Setup}} ===
+=== Windows-Setup ===
 <div class="Einrücken">
 {{#var:Windows-Setup--desc}}
@@ Zeile 34: / Zeile 31: @@
 * {{#var:Windows-Setup--Benutzerdefiniertes Setup--Hinweis}}
 * {{#var:Windows-Setup--Portalregistrierung--Hinweis}}
-* {{#var:Windows-Setup--Autokonfig--cap}}{{Hinweis|§ Neu ab Agent 8.90|1.1}}
+* {{#var:Windows-Setup--Autokonfig--cap}}
 * {{#var:installieren}}
 {{Gallery3| {{#var:Download--Bild}} | {{#var:Download--desc}}
-	| {{#var:Windows-Setup--Wizard--Bild}} | {{#var:Windows-Setup--Wizard--cap}}
+	      | {{#var:Windows-Setup--Wizard--Bild}} | {{#var:Windows-Setup--Wizard--cap}}
-	| {{#var:Windows-Setup--Willkommen--Bild}} | {{#var:Windows-Setup--Willkommen--cap}}
+	      | {{#var:Windows-Setup--Willkommen--Bild}} | {{#var:Windows-Setup--Willkommen--cap}}
-	| {{#var:Windows-Setup--Supportinformationen--Bild}} | {{#var:Windows-Setup--Supportinformationen--cap}}
+	      | {{#var:Windows-Setup--Supportinformationen--Bild}} | {{#var:Windows-Setup--Supportinformationen--cap}}
-	| {{#var:Windows-Setup--Lizenzbestimmungen--Bild}} | {{#var:Windows-Setup--Lizenzbestimmungen--cap}}
+	      | {{#var:Windows-Setup--Lizenzbestimmungen--Bild}} | {{#var:Windows-Setup--Lizenzbestimmungen--cap}}
-	| {{#var:Windows-Setup--Setuptyp--Bild}} | {{#var:Windows-Setup--Setuptyp--cap}}
+	      | {{#var:Windows-Setup--Setuptyp--Bild}} | {{#var:Windows-Setup--Setuptyp--cap}}
-	| {{#var:Windows-Setup----Bild}} | {{#var:Windows-Setup----cap}}
+	      | {{#var:Windows-Setup--Anmeldeinformationen--Bild}} | {{#var:Windows-Setup--Anmeldeinformationen--cap}}
-	| {{#var:Windows-Setup--Anmeldeinformationen--Bild}} | {{#var:Windows-Setup--Anmeldeinformationen--cap}}
+	      | {{#var:Windows-Setup--Zielordner--Bild}} | {{#var:Windows-Setup--Zielordner--cap}}
-	| {{#var:Windows-Setup--Zielordner--Bild}} | {{#var:Windows-Setup--Zielordner--cap}}
+	      | {{#var:Windows-Setup--Benutzerdefiniertes Setup--Bild}} | {{#var:Windows-Setup--Benutzerdefiniertes Setup--cap}}
-	| {{#var:Windows-Setup--Benutzerdefiniertes Setup--Bild}} | {{#var:Windows-Setup--Benutzerdefiniertes Setup--cap}}
+	      | {{#var:Windows-Setup--Datenverschlüsselungsmethode--Bild}} | {{#var:Windows-Setup--Datenverschlüsselungsmethode--cap}}
-	| {{#var:Windows-Setup--Datenverschlüsselungsmethode--Bild}} | {{#var:Windows-Setup--Datenverschlüsselungsmethode--cap}}
+	      | {{#var:Windows-Setup--Portalregistrierung--Bild}} | {{#var:Windows-Setup--Portalregistrierung--cap}}
-	| {{#var:Windows-Setup--Portalregistrierung--Bild}} | {{#var:Windows-Setup--Portalregistrierung--cap}}
+	      | {{#var:Windows-Setup--Autokonfig--Bild}} | {{#var:Windows-Setup--Autokonfig--cap}}
-	| {{#var:Windows-Setup--Autokonfig--Bild}} | {{#var:Windows-Setup--Autokonfig--cap}}
+	      | {{#var:Windows-Setup--Installation--Bild}} | {{#var:Windows-Setup--Installation--cap}}
-	| {{#var:Windows-Setup--Installation--Bild}} | {{#var:Windows-Setup--Installation--cap}}
+	      | {{#var:Windows-Setup--installieren--Bild}} | {{#var:Windows-Setup--installieren--cap}}
-	| {{#var:Windows-Setup--installieren--Bild}} | {{#var:Windows-Setup--installieren--cap}}
+	      | {{#var:Windows-Setup--Abgeschlossen--Bild}} | {{#var:Windows-Setup--Abgeschlossen--cap}}
-	| {{#var:Windows-Setup--Abgeschlossen--Bild}} | {{#var:Windows-Setup--Abgeschlossen--cap}}
+	      | {{#var:Windows-Setup--reboot--Bild}} | {{#var:Windows-Setup--reboot--cap}}
-	| {{#var:Windows-Setup--reboot--Bild}} | {{#var:Windows-Setup--reboot--cap}}
 |i=3| einblenden={{#var:step-by-step}}|ausblenden={{#var:hide}} |collapsed=true|layout=dezent|Vorschau=step-by-step.png}}
 </div>
 === {{#var:Windows-Skriptbasiert}} ===
@@ Zeile 62: / Zeile 59: @@
 {{#var:Windows-Skriptbasiert--desc}}
 <li class="list--element__alert list--element__hint">{{#var:Windows-Skriptbasiert--Hinweis}}</li><br>
+<br>
 <li class="list--element__alert list--element__warning">{{#var:Windows-Skriptbasiert--Password-Hinweis}}</li><br>
+<br>
+<p>{{code|Agent-Windows-x64-x-xx-xxxx.exe /s /v"''Parameter''"}} </p>
-<p>{{code|{{#var:Windows-Skriptbasiert--Code}} }}</p>
+<p>{{code|Agent-Windows-x64-8-90-1038a.exe /s /v"REGISTERWITHWEBCC=True AMPNWADDRESS=backup.securepoint.cloud AMPUSERNAME=register@anyideas.local AMPPASSWORD=insecure FEATUREVOLUMEIMAGE=ON NEW_DEFAULT_ENC_PWD=True DEFAULTJOBENCRYPTIONKEY=insecure123 CONFIRM_DEFAULTJOBENCRYPTIONKEY=insecure123 /qn"}} </p>
+</div>
-<p>{{code|{{#var:Windows-Skriptbasiert--Beispiel-Code}} }}</p>
+{| class="sptable2 pd5 sortable Einrücken"
-{| class="sptable2 pd5 sortable"
 ! {{#var:Parameter}} !! {{#var:desc}}
 |-
@@ Zeile 86: / Zeile 84: @@
 | AMPPASSWORD=password || {{#var:AMPPASSWORD}}
 |-
-| SILENTINSTALLDIR=\"Pfad"|| {{#var:SILENTINSTALLDIR}} {{Hinweis| Neu § ab Agent 8.90|1.1}}
+| SILENTINSTALLDIR=\"Pfad"|| {{#var:SILENTINSTALLDIR}} {{Hinweis-box| Neu § ab Agent 8.90|1.1}}
 |-
-| NEW_DEFAULT_ENC_PWD=True || {{#var:NEW_DEFAULT_ENC_PWD}} {{Hinweis| Neu § ab Agent 8.90|1.1}}
+| NEW_DEFAULT_ENC_PWD=True || {{#var:NEW_DEFAULT_ENC_PWD}} {{Hinweis-box| Neu § ab Agent 8.90|1.1}}
 |-
-| DEFAULTJOBENCRYPTIONKEY=''insecure'' || {{#var:DEFAULTJOBENCRYPTIONKEY}} {{Hinweis| Neu § ab Agent 8.90|1.1}}
+| DEFAULTJOBENCRYPTIONKEY=''insecure'' || {{#var:DEFAULTJOBENCRYPTIONKEY}} {{Hinweis-box| Neu § ab Agent 8.90|1.1}}
 |-
-| CONFIRM_DEFAULTJOBENCRYPTIONKEY==''insecure'' || {{#var:CONFIRM_DEFAULTJOBENCRYPTIONKEY}} {{Hinweis| Neu § ab Agent 8.90|1.1}}
+| CONFIRM_DEFAULTJOBENCRYPTIONKEY==''insecure'' || {{#var:CONFIRM_DEFAULTJOBENCRYPTIONKEY}} {{Hinweis-box| Neu § ab Agent 8.90|1.1}}
 |-
 | /qn || {{#var:/qn}}
@@ Zeile 100: / Zeile 98: @@
 | FEATUREVOLUMEIMAGE=ON || {{#var:FEATUREVOLUMEIMAGE}}
 |-
-| FEATUREEXCHANGE=ON || {{#var:FEATUREEXCHANGE}}
+| FEATUREEXCHANGE=ON || Exchange Plug-in (Legacy)
 |-
 | FEATUREEXCHANGE2010=ON || {{#var:FEATUREEXCHANGE2010}}
 |-
-| FEATURESQL=ON || {{#var:FEATURESQL}}
+| FEATURESQL=ON || SQL Plug-in
 |-
-| FEATURECLUSTER=ON || {{#var:FEATURECLUSTER}}
+| FEATURECLUSTER=ON || Cluster Plug-in
 |-
-| FEATUREORACLE=ON || {{#var:FEATUREORACLE}}
+| FEATUREORACLE=ON || Oracle Plug-in
 |-
 | SILENTINSTALLDIR=\"C:\Program Files\Example\ || {{#var:SILENTINSTALLDIR}}
 |}
-</div>
 === {{#var:Silent Agenten-Registrierung}} ===