Recommended
Recommended
More Related Content
Recently uploaded
Recently uploaded (20)
Featured
Featured (20)
Adobe AEM Office Hour : Managing AEM Deployment PPT
- 1. © 2016 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. ADOBE AEM: Managing AEM Deployments Customer Care Office Hours Jaideep Brar | Technical Support Consultant Lisa Ha | Technical Support Consultant Vanshika Agarwal | Software Engineer
- 2. © 2016 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. AGENDA Audience: AEM administrators and developers Introduction to Service Packs / Cumulative Fix Packs Security Bulletin Package Share / Package Manager AEM Tools Introduction to Maven Archetype / Lazybones Q&A 2
- 3. © 2016 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. 3 Service Packs / Cumulative Fix Packs SPs: improvements and fixes CFPs: bug fixes Both are cumulative Version convention as of AEM 6.3 AEM Version SP Version CFP Version 6.3.3.2
- 4. © 2016 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. Aug Sept Oct Nov Dec Jan AEM 6.4 AEM 6.3 AEM 6.2 AEM 6.1 4 Current SP/CFP release roadmap SP3 CFP1 Nov 8 SP3 Sep 12 SP2 Sep 27 SP3 Dec 30 SP1 CFP17 Oct 10 SP1 CFP18 Dec 11 SP2 CFP17 Oct 9 SP2 CFP18 Jan 11 SP1 CFP16 Aug 10 https://helpx.adobe.com/experience-manager/maintenance-releases-roadmap.html
- 5. © 2016 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. 5 Security Bulletin https://www.adobe.com/subscription/adbeSecurityNotifications.html
- 6. © 2016 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. 6 Package Share https://www.adobeaemcloud.com/content/packageshare.html AEM Instance CRX/DE Package Share Email cuscare@adobe.com for access
- 7. © 2016 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. 7 Package Share Assets tab provides direct download URL
- 8. © 2016 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. 8 Patch Best Practices Always take a full backup before patching Patch (SP / CFP) uninstall is not supported Check and confirm SP / CFP dependencies are met Do not install official patches via …/crx-quickstart/install directory Monitor the logs to confirm package install completion
- 9. © 2016 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. Working with Packages
- 10. © 2016 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. 10 AEM Permissions for Package Manager Users permissions to create, modify, upload, and install packages /etc/packages package content nodes
- 11. © 2016 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. 11 CURL Command for Packages Upload a new package curl -u admin:admin -F package=@"name_of_package.zip" http://localhost:4505/crx/packmgr/service/.json/?cmd=upload Upload a package AND install curl -u admin:admin -F file=@"name of zip file" -F name="name of package” -F force=http://localhost:4505/crx/packmgr/service.jsptrue -F install=true Download (the package) curl -u admin:admin http://localhost:4505/etc/packages/export/name_of_package.zip > name of local package file https://helpx.adobe.com/experience-manager/kb/common-AEM-Curl-commands.html
- 12. © 2016 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. 12 Access Control (AC) Handling How to handle package AC on install Ignore (default) Overwrite Merge MergePreserve Clear https://helpx.adobe.com/experience-manager/6-4/sites/administering/using/package-manager.html
- 13. © 2016 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. 13 Validating Packages https://helpx.adobe.com/experience-manager/6-4/sites/administering/using/package-manager.html#ValidatingPackage
- 14. © 2016 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. 14 Validating Packages https://helpx.adobe.com/experience-manager/6-4/sites/administering/using/package-manager.html#ValidatingPackage
- 15. © 2016 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. 15 Common Package Related Issues Packages are not installing /system/sling/installer/jcr/pauseInstallation path should be empty Constraint Violation Exception org.apache.jackrabbit.vault.packaging.PackageException: javax.jcr.nodetype.ConstraintViolationException: OakConstraint0001/etc/cloudsettings/default/contexthub[[nt:folder]] Packages not visible via CRX/DE Package Manager Special character in package name Uploading an asset package results in high number of workflows triggering Deactivate Workflow Launcher Impl component Activate component after asset package completely installs https://helpx.adobe.com/experience-manager/kb/common-package-related-issues.html
- 16. © 2016 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. AEM Tools
- 17. © 2016 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. 17 Existing Tools AEM Stuff blog Bundle Version Checker OSGi Configuration Diff Node Diff https://helpx.adobe.com/experience-manager/kb/tools/aem-tools.html http://www.aemstuff.com/tools/coi.html
- 18. © 2016 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. 18 New Tools Content Package Compare Activity Log Analyzer OSGi Component Diff https://helpx.adobe.com/experience-manager/kb/tools/aem-tools.html
- 19. © 2016 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. Content Package Comparator • This tool is used to compare the versions of the packages installed in your AEM instance before and after the installation of CFP/SP or upgarde. • This is helpful in validating successful AEM upgrades and service pack installations. Requires: http://<host>:<port>/crx/packmgr/serv ice.jsp?cmd=ls 19 https://helpx.adobe.com/experience-manager/kb/tools/content-package-comparator.html
- 20. © 2016 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. Activity Log Analyzer • This tool helps to validate the deletions that occurred as a result of installing a fix pack. • Also helpful in validating deletions that occurred during any AEM package installations.. Requires: http://<host>:<port>/crx/packmgr/service.jsp?cmd=ls 20 https://helpx.adobe.com/experience-manager/kb/tools/activity-log-analyzer.html
- 21. © 2016 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. OSGi Component Diff • Helps to compare the OSGi components b/w aem instances • Validates issues related to changes in OSGi components. Requires: http://<host>:<port>/system/console/components.json 21 https://helpx.adobe.com/experience-manager/kb/tools/osgi-component-diff.html
- 22. © 2016 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. Maven Archetype / Lazybones
- 23. © 2016 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. AEM Project Archetype 23 Archetype creates a minimal AEM project as starting point for your own projects. Includes : Archetype Version AEM Version 11 6.2 or newer 12 6.3 or newer 13 6.4, 6.3 + SP2 14 6.3, 6.3 + SP2 • Pages • One editable template • Page component • Content, form components • Configurations • Client libraries • Bundle with some examples • Tests
- 24. © 2016 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. AEM Lazybones 24 Provides a template to create a initial project structure. Based on AEM Archetype with added functionality. Auto include uber-jar and acs- commons
- 25. © 2016 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. AEM Archetype vs Lazybones 25 FEATURES ARCHETYPE LAZYBONES Number of customizable properties 12 40 Acs-commons × ✓ Create Environment Specific Folders × ✓ Uber-Jar Dependency × ✓ Configure Workflow Purge × ✓ Sling Models × ✓
- 26. © 2016 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. Lazybones Demo Create an AEM Project using Lazybones
- 27. © 2016 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. AEM Lazybones Installation 27 • In a Terminal window, run these two commands: - curl -s "https://get.sdkman.io" | bash - source ~/.sdkman/bin/sdkman- init.sh Once sdkman is installed, you can use it to install lazybones with the following command: - sdk install lazybones Windows Install latest binary:- https://bintray.com/pledbrook/lazybones- templates/lazybones#files
- 28. © 2016 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. Slide Resources Condensed Maintenance Release Roadmap - https://helpx.adobe.com/experience- manager/6-4/sites/deploying/using/maintenance-release-vehicle-definitions.html Adobe End Of Life Matrix - https://helpx.adobe.com/support/programs/eol- matrix.html Security Bulletin - https://helpx.adobe.com/security.html#experience-manager AEM Security Bulletin - https://helpx.adobe.com/security/products/experience- manager.html Subscribe to Security Bulletin Email Notifications - https://www.adobe.com/subscription/adbeSecurityNotifications.html AEM Security Board APSB18-26 (released Aug 14th ,2018) - https://helpx.adobe.com/security/products/experience-manager/apsb18-26.html Package Share - https://www.adobeaemcloud.com/content/packageshare.html LazyBones - https://helpx.adobe.com/experience- 28
- 29. © 2016 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. Additional Resources AEM LazyBones Documentation : https://helpx.adobe.com/experience-manager/using/aem_lazybones.html Experience League : https://landing.adobe.com/experience-league/ 29
- 30. © 2016 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. Q&A
Editor's Notes
- Targets AEM admins and developers and can be applied to all AEM versions I will start us off with an introduction to Service Packs and Cumulative Fix Packs Briefly mention Security Bulletins Provide general information about Package Share Vanshika will Introduce our new AEM tools Jaideep will talk about how to set up a new AEM project using Adobe Maven Archetype or Lazybones We will conclude with a Q&A session
- Jumping straight into AEM patches Adobe releases two types of fix packs : Service Packs and Cumulative Fix Packs SPs include both improvements and bug fixes CFPs consist of fixes Both fix packs are cumulative – the higher patch version includes the lower patch versions In terms of naming convention, as of AEM 6.3, we specify SP and CFP within the product version as shown on the slide https://helpx.adobe.com/experience-manager/6-4/sites/deploying/using/maintenance-release-vehicle-definitions.html
- This is a diagram representing the maintenance release roadmap Starting with 6.4 SPs are released quarterly And CFPs are released after 4 SPs have been released Moving on to 6.3 – there is a bit of a change SP 3 , which is due to release September 12th, will be the last service pack for 6.3 And CFPs will continue to be released every 8 weeks In terms of 6.2 Not much happening as there are no SP released And CFPs are released every 8 weeks Last, but not least, for 6.1 CFP17 is scheduled for October and CFP18 is scheduled for January CFP 18 is the last maintenance release for 6.1 As it has reached end of core support as of May 31st of this year (2018) The end of extended support is scheduled for May 31st of 2020 Contact the sales team to purchase an extended support maintenance contract as we do not provide support for end of life versions Also, if using 6.1 or lower, we highly advise to upgrade
- The Security Bulletin is how Adobe releases important information about security vulnerabilities that could affect Adobe products Use the link on the slide to subscribe to receive email notifications for security updates Currently, the most recent security board was released on August 14th regarding cross-site scripting vulnerabilities that affect all AEM versions Do review the security board and take the corrective actions provided by Adobe https://helpx.adobe.com/security/products/experience-manager/apsb18-26.html
- Package Share is how Adobe provides patches and there are two ways to access it The first way is to click the link on the slide, this is a direct link to Package Share And the second way is from within an AEM instance Within the CRX/DE admin console, click the package share icon in the top menu Link or CRX/DE you will be prompt with a Sign In form If you have an Adobe ID and proper permissions to access Package Share you would log in and be able to access the packages available For new users: An Adobe ID must be created and validated through email verification And an email should be sent to cuscare@adobe.com requesting access to Package Share
- Lastly regarding package share, when viewing a package, there is an Assets tab which allows you to download the patch directly onto your filesystem
- I will now cover some some best practices when installing patches Always take a full backup before installing patches Do not uninstall patches as oftentimes there will be unintended side effects and issues, instead, if the patch has to be reverted, perform a rollback or restore While installing patches, check that all dependencies are met, when the package is uploaded, if dependencies are missing you will see red text regarding dependencies Do not install patches using /crx-quickstart/install filesystem directory as there is a higher chance that the package will be uninstalled inadvertently During package install, monitor log files during to confirm when the patch has completely installed There will be a lot of UNREGISTERING and REGISTERED logs during patch install These logs will typically stop and this is when we can safely assume the patch has completely installed
- Moving on to working with Packages
- By default, permissions to work with packages are not provided The /etc/packages path requires full permissions And the same permissions need to be applied to the package content nodes We suggest to apply permissions to groups and not directly to users
- Package actions are also available in CURL command I have listed a couple of them on this slide For more information, review the listed resource https://helpx.adobe.com/experience-manager/kb/common-AEM-Curl-commands.html
- Packages are configurable One such configuration is Access Control handling This determines how the package ACs are handled on install Ignore ignores the packaged ACs – this also is the default value Overwrite applies the ACs provided in the package and also removes existing ACs Merge adds ACs from the package at the end of the list MergePreserve merges the ACs and preserves the order Clear - deletes all Acs This is all in terms of package content nodes
- I just covered that packages can modify access controls which can be the difference between a working and non-working AEM instance We suggest to validate package content before installing AEM 6.4 now comes with a package validation tool built in This tool allows us to validate the package content to see if it modifies overlaid files and/or access controls To access the tool, in Package manager, click More and Validate
- Validate Package popup will appear The Package validation tool has three validation options: The OSGi Package Imports option: Confirms that OSGi bundle dependencies are satisfied by the AEM instance The Overlays option: Checks if the package contains any files that are already overlaid in the destination AEM instance And the ACLs option: Reviews which permissions are being modified, how they will be handled such as merge or overwrite, and if the current permissions will be impacted For more details, review the resource listed – the documentation provides details on what each check returns and how to resolve each conflict
- Packages are not installing This is commonly caused by PauseInstallation nodes There should be no nodes under “/system/sling/installer/jcr/pauseInstallation” before or after package installation Constraint Violation Exception thrown while installing a package Check the path stated in the error and correct the node primary type (protected node) No Packages Visible in AEM Package Manager This issue mainly occurs when one of the packages has a special character in the package name Navigate to /crx/packmgr/list.jsp Find the offending package and delete it from /etc/packages/ directory using CRX/DE When uploading an asset package it is observed that a high number of workflows have been triggered To solve this, deactivate the Workflow Launcher component in the OSGi components admin console This will ensure that no workflows start when uploading the asset package Be sure to turn the workflow launcher on after asset package upload is completed
- Now lets talk about AEM Tools
- Some of you may be familiar with the AEM Stuff blog which had various tools to help verify multiple aspects of AEM instances Adobe has been granted permission to internalize and maintain the source code from AEM Stuff Existing tools include: Bundle Version Checker tool designed to compare OSGi bundle versions across instances This tool combines the AEM Stuff’s OSGi Sanity Checks into a single tool OSGi Configuration Diff tool designed to compare OSGi configurations across instances And Node Diff tool which compares query results between instances Some of the tool names are slightly different from AEM Stuff TRANSITION TO VANSHIKA : I will now handoff to Vanshika who will be introducing our new AEM Tools
- Hi , Myself Vanshika Agarwal , Working as a software engineer for AEM sustenance team Adobe India. These three utility tools were newly developed and added on helpx documention for the customers to troubleshoot OOTB instances,. These tools will help validate issues with configurations, node deletions and component changes on aem instances. All the tools are accessible at the url mentioned below
- Coming to the tool CPC This tool basically compares version of packages between aem instances . This will help to validate packages added/deleted/changed after upgrading an instance . It will help troubleshoot issues related to package versions/ installations. Demo for this tool:-
- This tool analyses the activity logs generated after a package is installed on aem instance. and helps to validate nodes that gets deleted after a package installation. It helps to know what all nodes got deleted and that will help to validate any useful nodes that got deleted as part of custom package installation . There might be nodes in OOTB which gets removed as part of installation. This will help to look into such issues . Demo for the tool :-
- This tools helps to compare OSGi components b/w aem instances. It helps to troubleshoot issues related to changes in component as part of OSGi bundles version bumps which otherwise might be overlooked. Demo for the tool ;- In short, the tools added on helpx will help to validate issues in aem instances and come to a concrete conclusion about the root cause which otherwise makes it difficult and time consuming as well. Now I pass on to Jaideep who will be taking you through Maven Archtype/Lazybones concept. TRANSITION TO JAIDEEP:
- In a Terminal window, run these two commands: curl -s "https://get.sdkman.io" | bash source ~/.sdkman/bin/sdkman-init.sh Once sdkman is installed, you can use it to install lazybones with the following command: sdk install lazybones Windows :- https://bintray.com/pledbrook/lazybones-templates/lazybones#files