Install the Cloud Backup agent on Windows by using silent installation
This article describes how to perform a fresh installation or update of the
Rackspace Cloud Backup agent on your Windows® server by using the silent
installation method. If you are using a Linux® server, see Install the Cloud Backup agent on Linux for
the parallel instructions.
WARNING: The procedure described in this article is for advanced users and should be run
from an administrator account. All others users should install the
Rackspace Cloud Backup agent by using the interactive installation described in
Install the Cloud Backup agent on Windows.
Before you install
The Rackspace Cloud Backup agent requires .NET® 4.0 or later.
Reinstalling the agent on a server disconnects any previously registered agents
that were running on that server. The only way to associate the backup data from
a disconnected agent registration is to perform a backup migration. You can
perform a vault migration
to a connected agent by using the Cloud Backup API call.
Download the installer
For a 64-bit Windows server architecture, download the latest MSI installation
file for that architecture from 64-bit Windows MSI. This file
is almost always the correct one for your server.
Perform a silent installation
Use the Windows package installer (msiexec.exe) to install the Cloud Backup agent.
-
Run the following command:
msiexec /i driveclient-latest.msi /qn /l*v %tmp%\install-driveclient-latest.log APIUSER=<user> APIKEY=<apikey> APIHOSTNAME=<region>.backup.api.rackspacecloud.com DATACENTER=<region>
- Use values for
APIUSER
,APIKEY
,APIHOSTNAME
, andDATACENTER
that match your installation.
- Use values for
-
During a fresh installation, use the following values:
APIUSER
(required): The user name you use to log in to the Rackspace Cloud Control Panel.APIKEY
(required): Your Rackspace Cloud API key.
Note: For information about viewing your API key, see View and reset your API key.
-
APIHOSTNAME
(required): The host address where the Cloud Backup API
endpoints reside. Host addresses for various data centers are listed in
the Service Access endpoints.
The Service Access endpoints pass in only the domain name of
the endpoint and not the full URL.Example Correct dfw.backup.api.rackspacecloud.com
Incorrect https://dfw.backup.api.rackspacecloud.com/v1.0/1234/
-
DATACENTER
(required): The data center associated with this server. The data center is the same as the region. Possible values are ORD, DFW, SYD, IAD, HKG, and LON. -
DEBUGHIGH
(defaultfalse
): Turns on debug-level logging in the MSI custom actions and the agent Updater service.
Following are optional, expert installation options:
FLAVOR
(defaultraxcloudserver
): Possible values areprivatecloud
,raxcloudserver
, andpersonalmachine
.INSTALLDIR
(default%ProgramFiles%\Driveclient
): The installation directory for agent executables.SERVICENETENABLED
(default<null>
): This option decides whether the agent uses public IP addresses for backup operations. You can set this option toSERVICENETENABLED=1
to force the agent to never use public IP addresses for backup operations.UPGRADEARCH
(defaultwin64
orwin32
depending on the MSI agent type): The folder on the download server where you find the MSI for the architecture you want.UPGRADEBASEURL
(defaulthttps://agentrepo.drivesrvr.com/
): The URL for the download server where the setup MSI files are stored.
For more options for installing MSI packages, see msiexec command line options.
A successful installation results in two running services, the Driveclient and the Updater. You can see these via services.msc. For the verification steps to test the installation, see the Test Windows installation or update section in Install the Cloud Backup agent on Windows.
Updated 12 months ago