❗ Important
This document applies only to CloudCache R1. The instructions for CloudCache R3 are available here.
To configure Linux CloudCache , you must deploy a Linux CloudCache virtual machine in your virtual infrastructure environment and then register the Linux CloudCache using an activation token.
📝 Notes
You must install CloudCache within the firewall limits of your remote office locations.
Ensure that you do not install any other services on the proxy server.
Perform the following steps:
Step 3: Deploy OVA for Linux CloudCache using
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 OVA for Linux CloudCache
Login to the Management Console.
Click Manage > CloudCache. Note that if the All Organizations menu is enabled, you have to first select an organization and then click Manage > CloudCache.
Click Add CloudCache.
On the Add CloudCache page, click Download. You can also go to the Druva Downloads page and download the OVA from there directly.
On the Downloads page, in the Select Agent drop-down list select CloudCache Installer. Also, select the Cloud.
If you are a Cloud subscriber, download the <Name of file> OVA file.
If you are a GovCloud subscriber, download the VMware <Name of file> OVA file.
Step 2: Generate activation token
To copy the activation token, in the Activate CloudCache section, click the Copytoken icon next to the Activation Token box.
📝 Note
You can use the activation token to activate only one instance of CloudCache. The token remains active only for 3 days from the time of generation. If you do not use it to activate CloudCache within 3 days, regenerate your activation token.Copy this token to a simple text file, and save the file.
📝 Note
Druva does not store activation tokens.Click Done.
📝 Note
The name of the CloudCache will be auto generated in the format, CloudCache Device 1. You can edit this name later, once the CloudCache is configured.
Step 3: Deploy OVA for Linux CloudCache using the vSphere Web Client
Log on to vCenter Server using vSphere Client.
From the File menu, click Deploy OVF Template.
In the Deploy from a file or URL box, type or select the full path to the OVF template that you downloaded, and click Next.
In the Name box, type a name for the template.
Select a host or a cluster on which you want to deploy Linux CloudCache and click Next.
From the list of resource pools, click the resource pool that you want to assign to this virtual machine, and click Next.
Review the details and click Next.
Note: The size on the disk cannot be changed during CloudCache deployment. You can, however, add or edit data volumes and increase or decrease disk size using LVM commands. For more info see the Data Volumes article.
Click I Accept all license agreements to accept the End User License Agreement (EULA), and click Next.
In the Select virtual disk format drop-down list, select a provisioning format:
Thick Provisioned Lazy Zeroed: If you select this format, a thick virtual disk is created, and the existing data is lazy zeroed (existing data on the provisioned storage are cleared when the virtual machine writes to the storage for the first time).
Thick Provisioned Eager Zeroed: If you select this format, a thick virtual disk is created, and the existing data is eager zeroed (existing data on the provisioned storage is overwritten with zeroes at the time of creating the virtual machine).
Thin Provisioned: If you select this format, a thin virtual disk is created.
Select destination storage, and click Next. If you created storage profiles, click the storage profile that you want to assign to the virtual machine. From the list of storage, click storage that you want to set as destination storage for this virtual machine.
Note: You can change the disk type to Thin Provision to save storage space.Select the source and destination network and provide the following details:
📝 Note
Linux CloudCache uses the default network mapping settings of the vCenter Server.Network Settings:
Linux CloudCache provides two network interface cards for configuration.
Select the Static IP check box and provide:
IP Address
Netmask
Gateway
Primary DNS
Secondary DNS
Domain
Hostname:
Provide the hostname. Ensure that you do not enter a special character or space in the hostname.
Web Proxy Settings:
You can configure a Web proxy for your environment. To set up the Web proxy, select the Use Web Proxy checkbox and provide the following details:
Proxy Type: Druva supports the following proxy types:
http
socks4
socks5
Proxy Server Name: Valid IP of proxy server.
Proxy Port: Respective proxy port number.
Username: Valid proxy username. For a proxy that does not require authentication, enter *.
Password: Valid proxy password. For a proxy that does not require authentication, enter *.
Activation Token:
The activation token that you have received while registering the VMware setup.
Govcloud: Select the checkbox if you are deploying the Linux CloudCache on GovCloud.
Timezone: From the drop-down list, select the required time zone
Click Next.
Verify the summary, and click Finish.
CloudCache appears under the Unconfigured tab on Management Console.
You can now configure the CloudCache. See, Configure CloudCache.
Step 3: Deploy OVA for Linux CloudCache using the vSphere Desktop Client
Before you begin
Before you begin, ensure the following:
vSphere Client for desktop is installed on the server
The OVA is downloaded on the same machine as the vSphere Client or a location accessible from the system
You have the following information:
vCenter credentials
Web proxy credentials (If you use a Web proxy in your environment).
Activation token. For more information see, Generate activation token.
IP settings.
Note: If you use an HTML5 Web client for proxy deployment, you'd need to enter 'j.proxy type' in the HTTP field under Web Proxy Settings as a hard value even if there is no Web proxy. The proxy will not power on post-deployment without this value.
To deploy the OVA
Log on to vCenter Server using vSphere Client.
From the File menu, click Deploy OVF Template.
In the Deploy from a file or URL box, type or select the full path to the OVF template that you downloaded, and click Next.
Verify the OVF template details, and click Next.
Click Accept to accept the End User License Agreement (EULA), and click Next.
In the Name box, type a name for the template.
Under Inventory Location, expand or collapse the inventory tree, click a location, and click Next.Select a host or a cluster on which you want to deploy Linux CloudCache, and click Next.
From the list of resource pools, click the resource pool that you want to assign to this virtual machine, and click Next.
Select destination storage, and click Next.
If you created storage profiles, click the storage profile that you want to assign to the virtual machine.
From the list of storage, click storage that you want to set as destination storage for this virtual machine.
Select a provisioning format, and click Next.
Thick Provisioned Lazy Zeroed: If you select this format, a thick virtual disk is created, and the existing data is lazy zeroed (existing data on the provisioned storage are cleared when the virtual machine writes to the storage for the first time).
Thick Provisioned Eager Zeroed: If you select this format, a thick virtual disk is created, and the existing data is eager zeroed (existing data on the provisioned storage is overwritten with zeroes at the time of creating the virtual machine).
Thin Provisioned: If you select this format, a thin virtual disk is created.
Note:
📝 Notes:
You can change the disk type to Thin Provision to save storage space.
Linux CloudCache uses the default network mapping settings of the vCenter Server
Select the source and destination network and click Next.
On the Properties screen, provide the following details:
Field | Description |
Network Settings | Linux CloudCache provides two network interface cards for configuration.
Select the Static IP box and provide:
|
Hostname | Provide the hostname. Ensure that you do not enter a special character or space in the hostname. |
Web proxy settings | You can configure a Web proxy for your environment. To set up the Web proxy, select the Use Web Proxy checkbox and provide the following details:
|
Activation Token | The activation token that you have received while registering the VMware setup. |
Govcloud | Select the checkbox if you are deploying the Linux CloudCache on GovCloud. |
Timezone | From the drop-down list, select the required time zone. |
Click Next.
To start the virtual machine after deployment, select Power on after deployment.
Verify the summary, and click Finish.
CloudCache appears under the Unconfigured tab on Management Console. The Activation Status appears as "Activated".
You can now configure the CloudCache. See, Configure CloudCache.
Activate Linux CloudCache using the terminal
The Linux CloudCache is activated as part of the OVA deployment. However, you can activate the Linux CloudCache using the command line, should the activation fail during the deployment. Once the OVA deployment is complete, you can log in to the virtual machine using the following credentials:
Username: root
Password: druvaphoenix
Launch the terminal on the virtual machine, and execute the following command to activate the Linux CloudCache:
PhoenixActivate <Activation-Token>
Where Activation-Token is the activation token copied from the Management Console in Step 2.