Best Practices Analyzer and Cloud Acceleration Manager

Learn how Best Practices Analyzer (BPA) and Cloud Acceleration Manager (CAM) provides a customized guide for migrating to AEM as a Cloud Service.

Hello and thank you for joining me as we look at Cloud Acceleration Manager and the Best Practices Analyzer.
Today, we are going to have an overview of the approach we have designed to help guide customers through their migrations to AEM as a cloud service. And we’re going to see how using Cloud Acceleration Manager can help guide us with this design.
We have created a migration methodology organized into four different areas, readiness, implementation, go-live and optimization. The readiness step is where you will spend time assessing the migration using tools such as the Best Practices Analyzer, provisioning AEM as a cloud service through cloud manager, defining governance for how the application will be used within your organization, and planning the project and resources based off of the analysis of the assessments provided. The implementation step is where all of the refactoring, migrating content, and deploying your application to AEM will happen. The go-live step will help guide you through planning your content and code freezes provide you with the checklist to make sure nothing is overlooked, provide you with the time to run security and performance testing, as well as help you migrate any content that needs to be migrated from any existing systems. The optimization step is considered the last step where any modernizations or best practices that might have been missed or left out will continue to be worked on.
To help outline the tools and processes we have for each of the steps through the migration process, we have created the Cloud Acceleration Manager portal. The Cloud Acceleration Manager portal utilizes the Best Practices Analyzer to give you a more in-depth analysis and assessment of your current implementation. We’ll then guide you through the steps, providing new tips and tools along the way to help ease your migration efforts. The benefits of Cloud Acceleration Manager are that they allow you to plan better and smarter using our guided methodology. It will also help you accelerate your efforts by providing you with useful tools to help guide your journey along the way.
The Best Practices Analyzer is designed to give you an assessment of your current AEM implementation. It will highlight areas where refactoring analysis will be required to ensure that your functionality will continue to work as expected after migration. It can be found in the Software Distribution Portal and it is supported on AEM version 6.1 and higher.
The Best Practices Analyzer will take a look at the following categories, application functionality, repository items that have been moved, legacy user interface dialogs and components that need to be modernized, any deployment or misconfiguration issues. And then additionally, any features that have been replaced by new functionality or that are not currently supported on AEM as a cloud service. Now that we have an overview of Cloud Acceleration Manager and the Best Practices Analyzer, let’s take a look at how we can use these together to help assess a project and look at the methodology a little bit closer.
So here I have a local AEM instance running, AEM 6.4, and I have some sample code installed. Let’s see how we can use the Best Practices Analyzer and Cloud Acceleration Manager to analyze the project and see what types of changes might be needed in order to migrate this to AEM as a cloud service.
The first thing we’re going to have to do is log in to our Experience Cloud login with going to
From there, we’re going to click on the Quick access and we’ll go to the Experience Manager.
Then, first we need to click on Software Distribution to download the Best Practices Analyzer package.
From the top navigation bar, let’s filter by AEM as a Cloud Service and scroll down and look for Best Practices Analyzer.
Accept the End User License Agreement and click Download.
Once the download is complete, we can log in to Adobe Experience Manager and we can install the package.
Once the package has been installed, we can navigate back to the AEM start screen.
We’re going to click on the Operations, and then Best Practices Analyzer.
Clicking on Generate Report will scan the JCR and create a report for us to upload into Cloud Acceleration Manager. So let’s wait for this to complete.
Now the report has been finished, scan the repository and go in this report of all the violations. Now, let’s download this report and get a little bit of a more in-depth analysis using Cloud Acceleration Manager. So we’re going to click on Export from the top-left toolbar. We’re going to download the report. Now, we’re going to head back to our Experience Cloud log in area.
From here, we’re going to launch the Cloud Acceleration Manager portal.
Since this is the first time it’s been loaded, we’re prompted with a wizard to create our first project. So we’ll go ahead and create our first project, giving a name and a title.
After clicking on the tile, we’ll see we’re presented with a layout similar to what we talked about in the methodologies overview area, readiness, implementation and go-live.
First, we’re going to click on the Readiness Best Practices Analysis tile.
Then from here, we’re going to upload our report.
Once the report has been uploaded, you can see we’re presented with an overview and breakdown of the different findings that it found, the total migration complexity assessed, and then what types of violations there are overview in the report.
From here, we can click on the Best Practices Assessment and we can review all of the different areas where issues have been found, as well as additional information such as Slow Queries.
The Migration Complexity Assessment tab provides us with an overview of the migration complexity as determined by the system.
It will scan the different pages, assets, users in the system, and it will scan the amount of customizations that are there, and it will use these different assessments to count and provide you with a guided level of complexity.
To further deep dive into each of the issues, to understand a little bit more about them, you can click on each of the magnifying glasses and it will open up a little bit more information for each of these areas. It will tell you where the violation occurs. And then, clicking on Learn More, you can be taken to the Experience League pattern detector overview page where it will give you remediation steps and possible solutions to fix the issue.
After reviewing all of the different violations and areas of recommendations, you can come back out and look at the rest of the Cloud Acceleration Manager.
So each tile here is designed to guide you through the setup and what you need to do to make sure that everything is going to run smoothly for your migration process. Each tab on the left will have actionable items and different links and tutorials to help make sure that you’re getting the most out of your migration project.
Going through the implementation phase, we have tabs to talk about how we can get setup with local development as well as code refactoring, learning how to do deployments through cloud manager, as well as getting a better idea for the assessment of your content transfer that you’re going to have to do.
This does include the calculator now where you can put in the estimated size of your repository and you all can estimate the amount of time that it will take to transfer your content from your existing AEM application to AEM as a cloud service.
Finally, we have the go-live tile where we have a list of different items that may need to be performed before you go live.
So it’s important to review each of these areas and make sure that you have not missed anything prior to your go-live.
And this is the Cloud Acceleration Manager portal within cloud manager.
So I hope the takeaway you can get from this session is an understanding of how to run the Best Practices Analyzer, download the report, log in to your Cloud Acceleration Manager portal and upload the Best Practices Analysis report, review the assessment, and hopefully understand your results a little bit better. For any issues that you find within the report or any optimizations that you would like to see, we encourage you to click on the feedback button located on the upper right-hand corner to provide any type of enhancements or issues that might be found.
The last slide contains some helpful resources you might find useful when migrating to AEM as a cloud service. And thank you for taking the time to do this video on Best Practices Analyzer and Cloud Acceleration Manager. -

Using BPA and CAM

BPA and CAM high level diagram

The BPA package should be installed on a clone of the production AEM 6.x environment. The BPA will generate a report that can then be uploaded into CAM, which will provide guidance into the key activities that need to take place in order to move to AEM as a Cloud Service.

Key activities

  • Make a clone of your production 6.x environment. As you migrate content and refactor code, having a clone of a production environment is valuable to test various tools and changes.
  • Download the latest BPA tool from the Software Distribution Portal and install on your AEM 6.x cloned environment.
  • Use the BPA tool to generate a report that can be uploaded to Cloud Acceleration Manager (CAM). CAM is accessed through > Experience Manager > Cloud Acceleration Manager.
  • Use CAM to provide guidance on what updates need to be made to the current code base and environment in order to move to AEM as a Cloud Service.

Hands-on exercise

Apply your knowledge by trying out what you learned with this hands-on exercise.

Prior to trying the hands-on exercise, make sure you’ve watched and understand the video above, and following materials:

Hands-on exercise GitHub repository

Hands-on with Best Practices Analyzer

Explore the Best Practices Analyzer (BPA) and reviewing the results by running it against a legacy WKND code base that contains example violations.

Try out the Best Practices Analyzer

Other resources