Installation of the Windows Agent via setup or script-driven
Last adaptation to the version: 8.90 10.2021 (1.2)
New:
- Automatic agent configuration with default encryption password
- New parameters for silent installations
This article refers to a Beta version
Windows-Setup
Installation using Windows Setup:
- Download the required agent from the Download Area of the Dashboard.
- Run the installation file on the computer for which the backup is to be set up.
- Custom setup selection chosen
- Selection of the account that will be used for logging in the agent services
- If necessary, additional plug-ins can be installed.
The image plug-in requires a reboot. - Enter the user name in email format and the password of a portal user
The computer is assigned to the end user site to which the user is also assigned. - If necessary, set a Default encryption password.
Only for sites where Automatic Agent Configuration has been enabled. - install
| 1. | 2. | 3. |
| Abb.1 | Abb.2 | Abb.3 |
| Abbildungen | ||
Download the required agent from the Download Area of the Dashboard.
Selecting the language of the installation wizard
Welcome screen
Support information
The licensing conditions must be accepted
Custom setup selection chosen
Selection of the account that will be used for logging in the agent services
The target folder can be changed if necessary
In addition to the actual backup agent, further plug-ins can be installed. Depending on the type of server, individual Microsoft SQL database instances or Exchange mailboxes can be backed up, for example.
The image plug-in requires a reboot.
Selecting the data encryption method
The user name ( email format) and password of a portal user must be entered here. (Role: User)
The computer is assigned to the end user site to which the user is also assigned.
Change port only after consultation with our support!
If necessary, set a Default encryption password.
Only for sites where Automatic Agent Configuration has been enabled.
Start installation
The installation is in process
The installation is completed. The wizard can be closed with .
If the image plug-in was selected for installation (default), a reboot is required
Script-based / Silent
The agent can also be installed in silent mode. This is useful if the agent is to be rolled out automatically on multiple systems.
If the user is removed, initially only an administrator can manage the computer until it is assigned to another user!
Agent-Windows-x64-x-xx-xxxx.exe /s /v"Parameter"
Code
| Parameter | Description |
|---|---|
| Agent-Windows-x64-x-xx-xxxx.exe | The setup of the agent (here: x64) is opened. |
| /s | Required for silent mode. Suppresses messages and prompts from the .exe file. |
| /v | Passes the parameters (in quotes) to the MSI package. No space before the following quotation mark!
|
| REGISTERWITHWEBCC=True | The agent should be registered in the backup portal. |
| AMPNWADDRESS=backup.securepoint.de | The address of the backup portal is handed over |
| AMPUSERNAME=backupkunde@firmaXYZ.de | The user of the client site is handed over |
| AMPPASSWORD=password | The password you assigned for the user of the customer site |
| SILENTINSTALLDIR=\"Pfad" | Installation path notempty Neu § ab Agent 8.90 |
| NEW_DEFAULT_ENC_PWD=True | Enabling the Automatic Agent Configuration feature notempty Neu § ab Agent 8.90 |
| DEFAULTJOBENCRYPTIONKEY=insecure | Encryption password notempty Neu § ab Agent 8.90 |
| CONFIRM_DEFAULTJOBENCRYPTIONKEY==insecure | Confirm encryption password notempty Neu § ab Agent 8.90 |
| /qn | Required for silent mode. Prevents Windows Installer (MSI) input dialogs. |
| Parameter for plug-ins | |
| FEATUREVOLUMEIMAGE=ON | Image plug-in requires a restart!
|
| FEATUREEXCHANGE=ON | Exchange Plug-in (Legacy) |
| FEATUREEXCHANGE2010=ON | Exchange Plug-in (As of 2010) |
| FEATURESQL=ON | SQL Plug-in |
| FEATURECLUSTER=ON | Cluster Plug-in |
| FEATUREORACLE=ON | Oracle Plug-in |
| SILENTINSTALLDIR=\"C:\Program Files\Example\ | Installation path |
Silent agent registration
If an agent is to be registered in another subsite, for example, the following entry in the command line is sufficient to re-register the agent at the portal:
C:\Program Files\Securepoint Unified Backup\Agent\buagent.exe" -cmdline --reregister --amplogin backupkunde@firmaXYZ.de --amppassword USERPW --ampserver "backup.securepoint.cloud" --ampport 8086
The Securepoint Unified Backup services must then be restarted once.
To do this, start PowerShell with administrator privileges and enter the following:
Get-Service -DisplayName "Securepoint Unified Backup*" | Restart-Service