To deploy Phoenix CloudCache for your setup, add Phoenix CloudCache from the Phoenix Management Console.
When you add CloudCache, Phoenix Cloud generates an activation key. The activation key functions as a unique identifier and establishes a connection between Phoenix Cloud and Phoenix CloudCache. After installation, use the key to activate Phoenix CloudCache.
- You must install Phoenix CloudCache within the firewall limits of your remote office locations.
- In a production environment, we recommend that you install Phoenix CloudCache on a server on which Phoenix agent is not installed.
- To ensure faster backups and restores, we recommend that you use a dedicated server for Phoenix CloudCache.
Perform the following steps:
- Step 1: Download the installer
- Step 2: Get CloudCache activation token
- Step 3: Install Phoenix CloudCache
- Step 4: Configure Web proxy (Optional)
- Step 5: Activate Phoenix CloudCache
Before you begin
Ensure that the server on which you plan to install Phoenix CloudCache matches the minimum requirements listed under System requirements.
Step 1: Download the installer
You can download the Phoenix CloudCache installer from the > Downloads option on the Phoenix Management Console menu or from the Downloads page.
Note: You can also download the installer at the time of adding Phoenix CloudCache.
- Log in to Phoenix Management Console.
- On the top menu, click > Downloads.
- Scroll to the bottom of the Druva downloads page, and download Phoenix CloudCache Installer.
For GovCloud, download Phoenix GovCloud CloudCache Installer.
Step 2: Get CloudCache activation token
- Log on to Phoenix Management Console.
- On the menu bar, click All Organizations, and select the required organization from the drop-down list.
- On the menu bar, click Manage > CloudCache.
- Click Add New CloudCache.
- In the CloudCache Name box, type a name for your Phoenix CloudCache, and click Next.
Note: If you did not download the Phoenix CloudCache installer in step 1, click Download here.
Note: You can use the activation token to activate only one instance of Phoenix CloudCache. The token remains active only for 3 days from the time of generation. If you do not use it to activate Phoenix CloudCache within 3 days, regenerate your activation token.
- Copy this token to a simple text file, and save the file.
Note: Phoenix does not store activation tokens.
- Click Finish.
Phoenix CloudCache appears under the Unconfigured CloudCache tab on Phoenix Management Console. The Cache Status appears as "Not activated".
Step 3: Install Phoenix CloudCache
To install Phoenix CloudCache, administrator privileges are required on the server.
- Double-click the installer, and click Next.
- Accept the license agreement, and then click Next.
- In the Install Location box, type or select the full path to the installation home directory.
- (Optional) Select Desktop Shortcut.
- Click Install.
- 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.
- Open the command line interface window.
- Change the directory path to the location on your system, where You have installed the Phoenix agent.
Default path: C:\Program Files\Druva\Phoenix CacheServer.
- 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
Field Details Proxy_type Druva supports the following proxy types:
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.
- 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:
Client Path 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.
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 Phoenix CloudCache
To establish a persistent connection between Phoenix CloudCache and Phoenix Cloud, activate Phoenix CloudCache using the activation token generated in step 2.
Note: Before you activate Phoenix CloudCache, ensure that the file containing the activation token is available on your server.
You can use the activation token to activate only one instance of Phoenix CloudCache.
If you lose the activation token or if the activation token crosses expiration (3 days), you must regenerate the activation token. For instructions, see Regenerate activation token.
- Wait for the Druva Phoenix CloudCache window to appear or double-click the Phoenix CloudCache desktop shortcut.
- Disable the govCloud option and enter the activation token.
Note: If you are activating CloudCache with Gov Phoenix, enable the govCloud option.
- Click Activate.
After activation, the status of Phoenix CloudCache listed under the Unconfigured CloudCache tab changes to Connected. The entry in the Action column changes to Configure.
(Optional) Command-line method for activation
- Open the Command Prompt and go to the following directory:
- 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:
If the activation completes successfully, the message Successfully Connected appears.
If the activation does not complete successfully, the message Activation Failed appears. Perform the step 1 again.
- Open the Command Prompt and go to the following directory: