Install the Cloud Backup agent on Windows by using silent installation

  • Last updated on: 2017-06-23
  • Authored by: Rose Contreras

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 silent installation procedure described in this article is for advanced users and should be run from only an administrator account. All others 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 will almost always be the correct one for your server).

Perform a silent installation

Use the Windows package installer (msiexec.exe) to install the Cloud Backup agent.

A typical installation from the command line or a batch file would be run as an Administrator and look like the following example:

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, and DATACENTER that match your installation.

During a fresh installation, the following values are used:

  • APIUSER (required): The user name that you use to log in to Rackspace Cloud Control Panel.

  • APIKEY (required): Your Rackspace Cloud API key. 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 should only be passing in 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 (default false): Turns on debug-level logging in the MSI custom actions and in the agent Updater service.

Following are optional, less-frequently used (expert) installation options that you can use:

  • FLAVOR (default raxcloudserver): Possible values are privatecloud, raxcloudserver, and personalmachine.

  • 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 to SERVICENETENABLED=1 to force the agent to never use public IP addresses for backup operations.

  • UPGRADEARCH (default win64 or win32 depending on the MSI agent type): The folder on the download server where you find the MSI for the architecture that you want.

  • UPGRADEBASEURL (default http://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 section, “Test Windows installation or update,” in Install the Cloud Backup agent on Windows.

Continue the conversation in the Rackspace Community.