Prerequisites

Supported Web browsers

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

Supported public clouds

Cloud Manager currently supports Amazon EC2 and Rackspace public clouds.

Supported regions for Amazon EC2

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)

Supported Amazon EC2 configurations

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.

Note:

Refer to this Help page to learn more about Amazon EC2 concepts.

Supported Rackspace account types

Managed and unmanaged Rackspace accounts are supported.

Supported regions for Rackspace

The following Rackspace data centers/regions are currently supported:

  • US
  • UK

Supported Rackspace configurations

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

Cloud provider service account

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.

CQ license

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.

Note:

Deactivated users are counted when the CQ license is metered.

Choose a Cloud Manager locale

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.

Configure cloud provider and CQ WEM

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

Video: Retrieve your Amazon Web Services credentials

Video: Retrieve your Amazon Web Services credentials
In the video tutorial below, Pierre Tager — <i>Group Manager, Adobe CQ Cloud Manager</i> — explains how you can retrieve your AWS account credentials for use within Cloud Manager.
Pierre Tager

 

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

Configure necessary services

  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
  1. (Only for AWS) Configure Amazon EC2:
  • Select a supported Region.
  • Select a supported Instance Type.
  • Select a supported EBS Storage Size.
  1. 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)
topology
  1. (Only for AWS) Upload a Key Pair Name file (.PEM) and specify a Security Group.
  2. (Only for Rackspace) Enter your Rackspace credentials:
  • User Name
  • API Key
  1. (Only for Rackspace) Configure Rackspace:
  • Select a supported region/datacenter.
  • Select a supported instance type: Small, Medium, or Large.
rackspace
  1. Click Validate. Cloud Manager validates your cloud provider settings.
  1. Click Add. You've now successfully added your cloud provider.
  1. Click + on the Services tab.
  2. Click Adobe CQ and then select CQ Web Content Management.
  3. 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.
  4. Click Add.

Video: Set up Amazon Web Services credentials and CQ WEM license

Video: Set up Amazon Web Services credentials and CQ WEM license
Adobe WEM Techies

Add a CQ cloud

  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.

blue
Blue status while the cloud is initializing

green
Green status; the cloud is now ready for use

red
Red status; a stopped cloud

Note:

Rackspace CQ clouds launched using credentials created afresh in Cloud Manager versions later than August 2012 support keypair-based login and SSH host key validation. Additionally, you can reset the cloud password for these clouds using the Rackspace admin console.

CQ cloud statuses

CQ clouds can assume one of the following statuses:

Status
Cloud state
Green
Running
Yellow Paused; you can restart the cloud
Blue In transit from one state to another; typical state when a new cloud is initializing
Red
Stopped; a user has stopped the cloud
Red cloud with hazard icon Failed cloud; the cloud failed to initialize successfully
Green cloud with hazard icon Running cloud with a failed node. This status usually indicates failure while adding a new Publish instance to a running cloud.
hazard_icon
Hazard icon; a red cloud with a hazard icon indicates that a CQ cloud that has failed to initialize. You can view the activity log to troubleshoot the underlying issue.

Manage CQ clouds

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

Open_a_Cloud

Pause

(Only for AWS) Pauses the currently-open cloud. When you pause a cloud, the cloud provider charges for CPU cycles at a reduced rate. However, you are still charged for the allocated storage (for example, Amazon EBS volumes).

Start

(Only for AWS) Restarts the paused cloud. When the cloud is restarted, the cloud provider reattaches the allocated storage to new instances.

Stop

Stops the cloud. When you stop a cloud; no memory, storage, or instances remain allocated to it anymore. However, any online backups you created for the stopped cloud are still retained and can be restored. The cloud provider continues to charge for these saved online backups.

Stopped clouds are displayed in your Clouds dashboard with a red status.

Remove

You can remove clouds that have either stopped successfully or are in a failed/inconsistent state. Follow these steps:

  1. Open the cloud from the Clouds dashboard.
  2. Select Actions > Remove.
  3. Confirm that you want to irrevocably remove the cloud.

Add instances/nodes

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.

Note:

To delete a node you added earlier, click Actions > Scale and then remove the node.

Back up the cloud

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.

Schedule backups

  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.

Note:

Do not schedule backups until the cloud is in the Running state.

Start an on-demand full backup 

  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.
backup
Back up CQ clouds; encryption support is currently available only for CQ clouds hosted using AWS

Restore the cloud from backups

You can restore a stopped cloud from online backups.

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

Note:

Backed up CQ clouds having more than one Dispatcher or Publish instance are always restored in the 1-1-1 configuration (1 Dispatcher, 1 Author instance, and 1 Publish instance).

Note:

After a cloud is restored from backups, any future scheduled backups are unscheduled.

Change the admin/author password for the cloud

  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.

Open Author/Publish instance management console

  • Click Go To Publish or Go To Author.

Note:

The Go To Publish/Go To Author buttons access the Publish/Author instances using DNS. Sometimes, right after restarting or restoring a cloud, you may not be immediately able to access these instances using DNS. As a workaround, access the instances using their IP addresses.

author-publish

View the activity log

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.

Filter 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.

Install packages and services

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

Install packages

  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.
search_for_package
  1. Click the package. On the package information page, click Install.
install_package

Note:

You can Love a package, bookmark it (*), or read its EULA. Packages that you bookmark are displayed in the Packages dashboard along with the packages you installed.

bookmark
Bookmark a package...

 

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

Unbookmark a package

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

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

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

Download a package

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.
download_package2
Download a package to your computer

Install services

  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.

Note:

More Adobe and third-party services will be available for installation soon.

  1. Enter your credentials and the other information required to add the service. For example, the Adobe SiteCatalyst service requires the following details:
sitecatalyst
  1. Click Add.
  2. Open the newly-added service from the Services tab.
  3. Click Install.
  4. In the Install Service dialog, select the CQ clouds on which you want to install the service.
  5. Click Install.

View list of installed packages and services

  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_packages

Upload packages to a private folder

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.

Delete a private package

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

Share packages or make them publicly available

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.

View metering data for services

  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.
services1
  1. 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

Bar-chart color coding

Color
Meaning
Green
Running
Blue
Installing, starting, initializing, or restarting
Gray
Failed
Yellow
Paused or pausing
Red Stopped or stopping

Video: Metering services on your Adobe CQ clouds

Video: Metering services on your Adobe CQ clouds
Adobe WEM Tech

Enable caching on the ephemeral disk for Dispatcher instances

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

This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Twitter™ and Facebook posts are not covered under the terms of Creative Commons.

Legal Notices   |   Online Privacy Policy