Skip to main content
Download, install, and activate CloudCache - Windows
Updated over a week ago

❗ Important

This guide applies only to CloudCache R1. For more details, see Versions of CloudCache.


To deploy CloudCache for your setup, add CloudCache from the Management Console.

When you add CloudCache, Druva Cloud generates an activation key. The activation key functions as a unique identifier and establishes a connection between Druva Cloud and CloudCache. After installation, use the key to activate CloudCache.


πŸ“ Notes

  • You must install CloudCache within the firewall limits of your remote office locations.

  • In a production environment, we recommend that you install CloudCache on a server on which Hybrid Workloads agent is not installed.

  • To ensure faster backups and restores, we recommend that you use a dedicated server for CloudCache.


Perform the following steps:

Before you begin

Ensure that the server on which you plan to install CloudCache matches the minimum requirements listed under System requirements.

Step 1: Download the installer

You can download the CloudCache installer from the Settings>Downloads option on the Management Console menu or from the Downloads page.


πŸ“ Note
​ You can also download the installer at the time of adding CloudCache.


  1. Log in to Management Console.

  2. Click Manage > CloudCache. Note that if the All Organizations menu is enabled, you have to first select an organization and then click Manage > CloudCache.
    ​

    clipboard_e66f1807bab46c78eaf6b6b93fd6f5786.png
  3. Click Add CloudCache. From the dropdown menu, select R1.

  4. On the Add CloudCache page, in theDownload and Install CloudCache agent on the server section, click Download for downloading the installer for Windows.

Step 2: Get CloudCache activation token

  1. Log on to Management Console.

  2. Click Manage > CloudCache. Note that if the All Organizations menu is enabled, you have to first select an organization and then click Manage > CloudCache.

  3. Click Add New CloudCache.

  4. To copy the activation token, in the Activate CloudCache section, click the Copytoken icon next to the Activation Token box.​
    ​

  5. Click Done.


πŸ“ Note
​ If you did not download the CloudCache installer in step 1, click Download here.


CloudCache appears under the Unconfigured tab on Management Console.

Step 3: Install CloudCache

To install CloudCache, administrator privileges are required on the server.

  1. Double-click the installer, and click Next.

  2. Accept the license agreement, and then click Next.

  3. In the Install Location box, type or select the full path to the installation home directory.

  4. ( Optional ) Select Desktop Shortcut.

  5. Click Install.

  6. After the installation completes, click Finish.

Step 4: Configure Web proxy (Optional)

Perform this step only if you are using Web proxy in your environment. Ensure that CloudCache service is running before you start proxy settings.

  1. Open the command line interface window.

  2. Change the directory path to the location on your system, where You have installed the Hybrid Workloads agent.
    Default path:C:\Program Files\\Phoenix.

  3. On the command prompt, run the following command:
    ​PhoenixCacheControl.exe set_proxy_details -t proxy_type -i proxy_IP:port -u proxy_user -p proxy_password

    • Proxy_type:Druva supports the following proxy types:

      • http

      • socks4

      • socks5

    • Proxy_IP:Valid proxy IP address.

    • Port:Respective proxy port number.

    • Proxy_user:Valid proxy username. Enter * for an unauthenticated proxy.

    • Proxy_password:Valid proxy password. Enter * for an unauthenticated proxy.

    After the command runs successfully, a message appears indicating that Web proxy is installed successfully.

Web Proxy


​

Additional information

  • The TMG drops IDLE connections after the defined timeout duration, due to which the client does an aggressive retry with the server.


πŸ“ Note
​ In TMG application, we recommend to set the connection timeout value to 5 minutes.


  • The configuration file path for Cache Server is as follows:

    • Cache Server:C:\ProgramData\PhoenixCloudCache\PhoenixCloudCache.cfg

  • After successfully setting up the proxy, if you want to remove the proxy setting, then you must manually remove the following proxy entries from Phoenix.cfg file.

    • PROXY_USER

    • PROXY_SERVER

    • PROXY_TYPE

    • PROXY_PASSWD2


πŸ“ Note
​ After deleting the above listed entries, set USE_PROXY = False in same file.In case of cache server, remove proxy entires from PhoenixCloudCache.cfg ​


Step 5: Activate CloudCache

To establish a persistent connection between CloudCache and Druva Cloud, activate CloudCache using the activation token generated in step 2.


πŸ“ Note
​ Before you activate CloudCache, ensure that the file containing the activation token is available on your server. If you lose the activation token or if the activation token crosses expiration, you must regenerate the activation token. For instructions, see Regenerate activation token.


  1. Wait for the Druva CloudCache window to appear or double-click the CloudCache desktop shortcut.

  2. Disable the GovCloud option and enter the activation token. Click Activate.


πŸ“ Note
​​​ If you are activating CloudCache with Gov Phoenix, enable the GovCloud option.


After activation, the status of CloudCache listed under the Unconfigured tab changes to Connected. The entry in the Action column changes to Configure.

( Optional ) Command-line method for activation

  1. Open the Command Prompt and go to the following directory:
    ​C:\Program Files\Druva\PhoenixCacheServer

  2. Run the following command. PhoenixActivate <Activation Token>

    where, <Activation Token> represents the activation token generated in step 2.

    For example, your command might look like this:

    PhoenixActivate 24-33-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

    If the activation completes successfully, the message Successfully Connected appears.

  3. If the activation does not complete successfully, the message Activation Failed appears. Perform step 1 again.

Did this answer your question?