Using Adobe CQ Cloud Manager

Cloud Manager supports the following Web browsers:

• Microsoft Internet Explorer 9.x
• Mozilla Firefox 7.x and later
• Google Chrome 13.x and later
• Apple Safari 5.x

Cloud Manager currently supports Amazon EC2 and Rackspace public clouds.

The following Amazon EC2 regions are currently supported:

• US East (Virginia)
• US West (N. California)
• US West (Oregon)
• EU West (Ireland)
• Asia Pacific (Tokyo)
• Asia Pacific (Singapore)
• South America (Sao Paulo)
• Asia Pacific (Sydney)

Five Amazon EC2 instance sizes are supported:

• Small
• Medium
• Large
• Extra Large

25 GB, 50 GB, 100 GB, 250 GB, 500 GB, and 1 TB EBS sizes are supported.

Managed and unmanaged Rackspace accounts are supported.

The following Rackspace data centers/regions are currently supported:

• US
• UK

Small, medium, and extra large Rackspace instances are supported.

Small: 4 GB RAM/160 GB Disk

Medium: 8 GB RAM/320 GB Disk

Large: 16 GB RAM/620 GB Disk

A cloud provider service account is required to create CQ clouds.

You can sign up with Amazon Web Services account at this URL. Visit this URL to sign up with Rackspace.

Before creating CQ clouds, you must upload your .properties CQ license file. If you don't have a CQ license yet, contact Adobe at https://www.day.com/day/en/registration/contact.html.

The Cloud Manager user interface is available in four languages—English, German, French, and Japanese. Follow these steps to choose a language:

1. Log in to Cloud Manager at http://adobecqcloud.com with your Adobe credentials.
2. Select Preferences from the drop-down menu next to your user name.
3. Select a language.
4. Click Submit.

Before you add your first CQ cloud, you must select a cloud provider and configure your Adobe CQ Web Experience Management (WEM) license.

Once you have retrieved these credentials, keep them handy for later use.

1. Log in to Cloud Manager at http://adobecqcloud.com with your Adobe credentials.
   
2. On the Services tab, click the + icon.
3. Select either Amazon or Rackspace as your cloud provider.
4. In the Add Service Cloud Provider dialog, specify a Name for your cloud provider service instance. For example, "AmazonSmall" or "RackspaceExtraLarge".
5. (Only for AWS) Enter your AWS credentials:

• Access Key
• Secret Key

6. (Only for AWS) Configure Amazon EC2:

• Select a supported Region.
• Select a supported Instance Type.
• Select a supported EBS Storage Size.
  

7. Select a topology:

• Development/Testing: 1 Author instance, 1 Publish instance, and 1 Dispatcher
• Staging/Production: 1 Author instance, 1 Publish instance, 1 Dispatcher, and 1 Elastic Load Balancer (ELB)

8. (Only for AWS) Upload a Key Pair Name file (.PEM) and specify a Security Group.
9. (Only for Rackspace) Enter your Rackspace credentials:

• User Name
• API Key

10. (Only for Rackspace) Configure Rackspace:

• Select a supported region/datacenter.
• Select a supported instance type: Small, Medium, or Large.

11. Click Validate. Cloud Manager validates your cloud provider settings.

12. Click Add. You've now successfully added your cloud provider.

13. Click + on the Services tab.
14. Click Adobe CQ and then select CQ Web Content Management.
15. In the Add CQ WCM dialog box, provide a service account name, select a version of CQ, and then upload your .properties CQ license file.
16. Click Add.

1. Click + on the Clouds tab.
2. Enter a cloud name and a password. Confirm the password. This password is applied to the admin and author user names for the cloud.
   
3. If more than one cloud provider accounts or CQ licenses are available, choose the ones that you want to use for the new cloud.
4. Click Add.

Cloud Manager displays the new cloud in your dashboard with a blue status. The status turns green once the cloud has initialized. You can now install packages and services on the new cloud.

CQ clouds can assume one of the following statuses:

You can perform many operations after you've opened a cloud by clicking it in the Clouds dashboard.

Manage a CQ cloud (Click here to view a larger version of the screenshot)

You can easily add Publish instances in addition to the default three nodes (one Dispatcher, one Author instance, and one Publish instance).

1. Open the cloud from the Clouds dashboard.
2. Select Actions > Scale.
3. Click Add Publish Node.
4. For AWS clouds in the Staging/Provisioning topology, you can add a Dispatcher node in addition to the default Dispatcher.

The new node is added with a blue status and initialized. Node initialization may take several minutes.

Online backups of the cloud are saved with your cloud provider. For Rackspace, backups are currently limited to 5 GB and are stored on Cloud Files. Backups are supported for Rackspace CQ clouds created using the July 2012 version of Cloud Manager or later.

1. Open the cloud from the Clouds dashboard.
2. Select Actions > Backup.
3. In the Cloud Backup dialog, do the following:
   • Enable scheduled full backups.
   • Select a start time for the backups.
   • In hours, select how often you want incremental backups to be taken.
   • Specify the number of days for which the cloud provider should retain backups.
   • (Only for AWS) Enable or disable Encryption.
4. Click Update.

1. Select Actions > Backup.
2. (Only for AWS) Select Use Encryption if you want to turn encryption on.
3. Click Start Backup Now to initiate the on-demand backup.

You can restore a stopped cloud from online backups.

1. Select Actions > Restore.
2. Choose a listed online backup and click Restore.

1. Select Actions > Security > Admin Password or Actions > Security > Author Password.
2. Enter your Adobe ID password.
3. Enter and confirm a new password.
4. Click Update.

• Click Go To Publish or Go To Author.
  

The activity log lists package/service installation or uninstallation events, as well as any issues that your CQ cloud may have encountered.

• Click Activity to view the activity log.
  

You can filter the activity log such that only activities by a specified user are displayed.

• Enter a user ID in the Search box.

You can install packages and services from the CQ app market on your clouds.

1. On the Packages tab, click +. Cloud Manager launches Package Share.
   
2. Search for a package. Alternatively, you can select a package from the Adobe hierarchy, the hierarchy of private packages for your company, or the hierarchy of packages shared with your company by other companies.
   

3. Click the package. On the package information page, click Install.

Click here to view a larger version of the screenshot.

4. In the Install Package dialog, select the CQ clouds on which you want to install the package.
5. Click Install.

The Packages dashboard displays the packages that you've bookmarked.

• To unbookmark a package, click the X icon for the package.
  

The unbookmark operation is reversible. You can bookmark the package all over again.

Cloud Manager lets you easily download the ZIP archive for a package from Package Manager. Follow these steps:

1. Open the package from the Packages tab.
2. Click Assets.
3. Click Download [package name].
4. In the dialog box that appears, accept the license agreement. Cloud Manager downloads the ZIP archive to the default download location on your computer.

1. On the Services tab, click +.
2. Browse the available Adobe CQ and Adobe Marketing Cloud services. Click Select next to the service you want to install.

3. Enter your credentials and the other information required to add the service. For example, the Adobe SiteCatalyst service requires the following details:
   

4. Click Add.
5. Open the newly-added service from the Services tab.
6. Click Install.
7. In the Install Service dialog, select the CQ clouds on which you want to install the service.
8. Click Install.

1. Open the cloud from the Clouds dashboard.
2. Click Installed. Cloud Manager displays a tabular list capturing the current package/service status for the Author/Publish instances in the cloud.
   

Installed service/package statuses (Click here to view a larger version of the screenshot)

You can upload packages to a private folder in your company's Package Share hierarchy. Follow these steps:

1. On the Packages tab, click +.
2. On the screen that appears, click Upload.
3. In the Upload Package dialog, browse and select a valid package file (.zip).
4. Specify the name of an existing or new private folder where you want to upload the package.
5. Select Overwrite if you want Cloud Manager to overwrite any prexisting packages with the same name.
6. Click OK.

1. Open the package from the Packages dashboard.
2. Click the trashcan icon.

If you want to share an uploaded package with another company or make the package publicly accessible, email the details of your request to packageshare@adobe.com.

1. Open a service from the Services tab. Cloud Manager displays a color-coded bar-chart summary of the instance hours for which the service has been running for different clouds.

Click here to view a larger version of the screenshot.

2. Click the bar corresponding to a cloud to view further service metering details. Different metering details are displayed for different services.
   
   Example: For the AWS service, the following details are displayed for each CQ instance in the cloud:
   

• Instance hours
• Instance memory allocation
• Instance storage allocation

SSH into the Dispatcher instance and run the following commands:

1. Save a backup copy of the dispatcher.any file:
   cp dispatcher.any > dispatcher.any.bak
2. Rename the instances of the intentionally misspelled /_cache sections to /cache:
   sed -e 's/\/_cache/\/cache/g' /etc/httpd/conf/dispatcher.any.bak > /etc/httpd/conf/dispatcher.any
   
3. Restart the Apache server:
   service httpd restart