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.

  1. 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, and DATACENTER that match your installation.
  2. 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
      Correctdfw.backup.api.rackspacecloud.com
      Incorrecthttps://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 the agent Updater service.

Following are optional, expert installation options:

  • 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 you want.
  • UPGRADEBASEURL (default https://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.