How to work with packages (2023)

Packages allow the import and export of repository content.For example, you can use packages to install new functions, transmit content between instances and ensure repository content.

Packages can be accessed and/or managed on the following pages:

  • Package manager, with which you manage the packages in the local body.

  • Package approval, a central server that considers publicly available and private packages for your company.Public packages may contain hotfixes, new functions, documentation etc.

You can transfer packages between Parcel Manager, package approval and your file system.

What are packages?

One package is an ZIP file that contains repository content in the form of an eriaization of the file system (referred to as "" safe "eriaization).This offers a display of friendly and war -related files and folders.

Packages include content, page content, and project selected with filters.

A package also contains information about Vault -Meta, including filter settings and import configuration information.Advanceable content properties (which are not used for packet extraction) can be included in the package, for example, b.A description, a visual image or a symbol.These properties apply only to the consumer of the content package and only for information purposes.


Packages represent the current version of the content at the time of package creation.They do not contain previous versions of the content that AEM kept in the repository.

You can perform the following actions in or with packages:

  • Create new packages;Set package settings and filter as needed
  • View the contents of the package (before construction)
  • Create Packages
  • Show package information
  • Show package content (after construction)
  • Change the definition for existing packages
  • Evaluation packages
  • Delicate packages
  • Download AEM packages to your file system
  • To the packages of your file system in your instance aem local
  • Validate package content before installation
  • Run a dry installation
  • Install packages (AEM installs packages after upload not automatically)
  • Delete packages
  • Download packages such as Hotfixes from the Share Library Package
  • Download packages in the Hoch Package Agency Library section

Package information

A definition of package consists of different types of information:

  • Package Settings
  • Package filter
  • Paket -Screenshots
  • Order Symbols

Package Settings

You can edit a variety of order settings to define aspects such as package description, related errors, premises and provider information.

OPackage SettingsThe dialog box is available through theTo editSE buttonTo createoreditionA package and offers three guides for configuration.After making changes, click clickOKto save them.

How to work with packages (1)

NameThe name of the package.
groupThe group name to add the package to organize packages.Enter the name of a new group or select an existing group.
executionText for the custom version.
DescriptionA brief description of the package.html marking can be used for formatting.
Miniature viewThe symbol that is displayed on the package list.Click Search to select a local file.

How to work with packages (2)

Feld Description Format/example
Name The name of the provider. AEM GeomeTrixx
Url Provider URL.
shortcut -Link Package specific for a provider page.
  • Administrator: Choose when the package can only be installed with one account with administrator rights.
  • Restart: Choose when the server needs to be restarted after the package installation.
AC -Manipulation

Specify how access control defined in the package is treated with information when importing the package:

  • Ignore
  • To replace
  • Mingle
  • Clear
  • MergePreserve

The default value isIgnore.

  • Ignore- Protect ACLs in the repository
  • To replace- Replace ACLs in the repository
  • Mingle- Together the two ACL sets
  • Clear- Clear acls
  • MergePreserve- Merging access control in the content with the package

How to work with packages (3)

Tested withProduct name and product name and package are intended for the package or compatible.To stretch
Errors/problems correctedA text field with which you can list details about corrected errors with this package.List all errors in a separate line.I summarize bug-nr
Depends onList dependency information that must be respected if other packages are necessary for the current package to be performed as expected.This field is important if hot corrections are used.Groupid: Name: Version
SubstitutedA list of outdated packages that replace this package.Before installing, this package contains all the necessary content of the outdated packages so that no content is replaced.Groupid: Name: Version

Package filter

Filter Identify the repository nodes included in the packageFilterDefinitionIndicates the following information:

  • ORoot pathInclude the content.
  • RulesThis includes or excludes certain knots below the main path.

The filter may contain zero or more rules.If no rule is defined, the package contains all content below the main path.

You can set one or more filter definitions for a package.Use more than one filter to include the content of various root paths.

How to work with packages (4)

The following table describes these rules and contains examples:

Control type Description Example
to contain You can set a path or use a regular expression to specify all nodes you want to include.

Including a directory:

  • Add this directoryEAll files and folders in this directory (ie H. The whole tree)
  • noAdd other files or folders under the path of the trunk specified on the way to the specified trunk
delete You can specify a path or use a regular expression to indicate all nodes you want to discard.

Without a directory, this directory excludesEAll files and folders in this directory (ie the whole sub -arrangement).



A package can contain several filter definitions so that nodes from different locations can be easily combined in a package.

Package filters are defined more often when they are for the first timeCreate the packagebut they can also be processed later (after that, the package must be rebuilt).

Paket -Screenshots

You can attach screenshots to your package to make a visual presentation of what the content is like.For example, providing screen captures of new functions.

Order Symbols

You can also connect your package to a quick visual presentation of what the package contains, a quick visual display provides.This is displayed on the package list and can help it easily identify the package or package class.

As a package may contain a symbol, the following conventions are used for official packages:


To avoid confusion, use a descriptive symbol for your package and do not use any of the official symbols.

Official Hotfix Package:

How to work with packages (5)

Official Package of AEM Installation or Expansion:

Official Resource Packages:

How to work with packages (6)

Package manager

The package manager manages the packages in the local AEM installation.After havingAttributed the necessary authorizationsYou can use the package manager for different actions, including configuring, creating, downloading and installing your packages.The main elements to be configured are:

  • Package Settings
  • Package filter

Necessary permissions for the use of package manager

To give users the right to create, change, upload and install packages, they must provide the corresponding permissions in the following locations:

  • / etc / bag(Complete rights without excluding)
  • The knot that contains the package content

VerDefine AuthorizationsFor instructions to change permissions.

Creating a new package

How to create a new definition of orders:

  1. Click Click on the Welcome ScreenPackages(or fromToolDouble -click consolePackages).

  2. Then selectPackage manager.

  3. CliqueCreate Package.


    If there are many packages in your instance, there may be a folder structure so that you can navigate to the required destination folder before creating the new package.

  4. IM Dialogue:

    How to work with packages (7)

    Of the:

    • Group's name

      The name of the group -Alvo (or the folder).Groups must be used to help you organize your packages.

      A folder is created for the group if not yet available.

    • Package

      The name of your new package.Select a descriptive name to help you easily identify the package content.

      (Video) Project Task Descriptions - Work Packages

    • execution

      A text field in which you specify a version.This is attached to the package name to form the name of the ZIP file.

    CliqueOKTo create the package.

  5. List the new package in the corresponding group folder.

    How to work with packages (8)

    Click on the symbol or name of the package to open it.

    How to work with packages (9)


    If necessary, you can return to this page later.

  6. CliqueTo editTo edit themPackage Settings.

    Here you can add information and set certain settings.For example, this contains a description thatSymbol, related errors and add details of the provider.

    CliqueOKAfter being ready to edit the settings.

  7. Add toScreen CapturesAs needed for a package, an instance is available if the package is created. Add morePAKET Screen CaptureFrom the friend.

    Add the actual image by clicking double to the component of the imageScreen CapturesArea, add and click on an imageOK.

  8. Define itPackage filterPulling instances of theFilterDefinitionFrom the friend, then click twice to open for editing:

    How to work with packages (10)


    • Root path
      The content to be packed;This may be the root of a subtree.

    • Rules
      The rules are optional;For simple package definitions, it is not necessary to include or exclude rules.

      If necessary, you can defineInclude or exclude rulesTo accurately define the package content.

      Add rules with Add+Alternatively, remove the symbol with the- -The symbols are applied according to your order, soHochEBelowChaves.

    So clickOKTo save the filter.


    You can use how many filter definitions it is necessary, even if you need to be careful not to have a conflictvisualizationTo confirm what the package content will look like.

  9. To confirm what the package will be recorded, you can usevisualizationThis performs a dry race of the construction process and lists everything that is added to the package when it is actually created.

  10. Now you canBuildYour package.


    It is not mandatory to create the package at this time, it can occur later.

Create a package

A package is often created with them at the same timeCreate the definition of the package, but you can later return to create the package or rebuild it.This can be useful if the content has changed in the repository.


Before creating the package, it can be helpful to advance the package content.For this clickvisualization.

  1. Open the definition ofPackage manager(Click on the symbol or name of the package).

  2. CliqueBuildIn a dialogue, you are asked to confirm that you want to create the package.


    This is of particular importance if you rebuild a package because the package content is replaced.

  3. CliqueOK.The package creates and lists all content added to the package.If the full AEM shows a confirmation that the package was created and (if you close the dialog box) Update information from the package list.


Once a package was created, it can be circulated if necessary.

UmWetting Changes Package Information -whoChange the package.Package SettingsDialogue (to open this clickTo edit).

A large rewriting app is when preparing a package for the release of the package.For example, you may have an existing package and decide to share it with other people.To reproduce your functions (which runs some time and the risk that the package is no longer identical to the original) you can re -mode it and simply add the viewing image and the description.

  1. Open the definition ofPackage manager(Click on the symbol or name of the package).

  2. CliqueTo editand update thePackage Settingsby need. ClickOKSave to the computer.

  3. CliqueRewriteA dialog box is requested for confirmation.

Show and edit package information

Show or edit information about a package definition:

  1. In the Orders Manager, browse the package you want to display.

  2. Click on the package of the package you want to display.

    How to work with packages (11)


    You can also edit and perform certain actions in the package of this page.

    The available buttons depend on whether the package has already been created or not.

    (Video) Work Packages

  3. When the package has already been created, click ClickContentA window opens and lists all package content:

Show package content and test the installation

After a package was created, you can display the content:

  1. In the Orders Manager, browse the package you want to display.

  2. Click on the package of the package you want to display and the package page is listed, which lists information about the package setting.

  3. To display the content, clickContentA window opens and lists all package content:

    How to work with packages (12)

  4. To perform a dry race of the installation, clickTestimalAfter confirming the campaign, a window opens and the list of results as if the installation was performed:

    How to work with packages (13)

Download packages from your file system

This section describes how to download an AEM package to your file systemPackage manager.


VerPackage approvalInformation on downloading hotfixes, resource packages and public sector packages and your company's internal packaging area.

Of the Package Share you can:

  • Download packagesPackage approval directly to your local instance.
    When downloading, the package is imported to your repository. So you can install it immediately with the local authorityPackage manager.These packages contain hotfixes and other approved packages.

  • Download packagesPackage approval for your file system.

  1. Click Click on the Welcome ScreenPackages, then selectPackage manager.

  2. Browse to the package you want to download.

    How to work with packages (14)

  3. Click on the link to the package you want to download with the name of the Zip File (underlined).For

    AEM carries the package on your computer (using a standard dialog box to download the default browser).

Carry packages from your file system

With a -Lload package, you can upload a package of your file system to the AEM package manager.


VerLoad packages for the sharing of the Company Company InternalThus, send a package to your company's private package area.

To upload a package:

  1. NavigatePackage manager.Then the group folder in which the package must be loaded.

    How to work with packages (15)

  2. CliquePack the package.

    How to work with packages (16)

    • file

      You can insert the file name directly or use themTo search for ...Dialog box to select the necessary package from your local file system (after a selection, clickOK).

    • Upload upload

      If there is already a package with this name, you can click it to force upload (and replace the existing package).

    CliqueOKSo that the new package is loaded and listed on the list of package managers.


    To make the content available, you must definitely guaranteeInstall the package.

Validate packages

Before installing a package, you can check the content.Overlapping file packages can be changed in/APPSand/or add, modify and remove the ACLs. Often times, it is useful to validate these changes before installation.

Validation options

The validation mechanism can verify the following packet properties:

  • Osgi -packetportport
  • Overlapping
  • ACLs

These options are detailed below.

  • Validating Osgi Partimports

    What is verified

    This validation inspects the package for all Jar (Osgi package) files, extracts itsManifest.xml(containing the version facilities on which the OSGI package is based) and checks AEM instance exports, which contains the dependencies with the correct versions.

    How it is reported

    All version premises that cannot be met by the AEM instance are listed in theActivity protocolof the package manager.

    Failed states

    If the dependencies are not satisfied, the Osgi package will not start in the package with these dependencies.This leads to a broken application provision, as everything that is based on the unpaid Osgi package does not work correctly.

    Error solution

    To correct errors due to packets of dissatisfied Osgi, the package version should be adjusted with dissatisfied imports.

  • Validate overlays

    What is verified

    This validation determines whether the package to be installed contains a file that is already overlapping at destination.

    For example, with an existing overlap/Apps/sling/servlet/errorhandler/404.jsp, a package that contains/libs/sling/servlet/errorhandler/404.jsp, for this to change the existing file/libs/sling/servlet/errorhandler/404.jsp.

    (Video) GoLang Packages and Modules | Beginners Go Tutorial

    How it is reported

    Such overlaps are described in theActivity protocolof the package manager.

    Failed states

    An error status means that the package tries to provide an overlapping file. Therefore, changes in the package are replaced by overlap (and therefore "hidden") and is not effective.

    Error solution

    To correct this problem, the overlay file supervisor is in/APPSShould check the changes in the overlaid file/Libsand integrate changes in overlap as needed (/APPS) and re -apply the overlaid file.


    Note that the validation mechanism cannot enter the line if the overlapping content has been adequately included in the overlap file.This validation will continue to report in conflicts even after the necessary changes.

  • Validate ACLS

    What is verified

    These validation checks which are added permissions, how they are treated (mixed/replacement) and if current permissions are influenced.

    How it is reported

    Authorizations are described in theActivity protocolof the package manager.

    Failed states

    No explicit error can be provided.Validation only indicates whether new ACL permissions are added or influenced by the package installation.

    Error solution

    Using the information provided by validation, the affected nodes can be checked in Crxde and ACLs can be adjusted in the package as needed.


    Proven procedures recommend that packages do not influence ACLs ready for AEM as this can lead to unexpected product behavior.

Validation Implementation

Package validation can be performed in two different ways:

  • Through the Package Manager user interface
  • Via http posting request, as in curl


Validation should always occur after package loading, but before installation.

Package validation through the Orders Manager

  1. Open the Orders Manager inhttps: // <merver>: <sot>/crx/packmgr

  2. Select the package in the list and selectMoreSuspended from the header and thenconfirmedNo suspense menu.


    This should be done after uploading the content package, but before installing the package.

  3. Use "modal" in the "modal" dialog box, which is displayedconfirmed.Alternative clickCancel.

  4. The selected validation is then performed.

Package validation via http posting requirement

The following form accepts the posting requirement.

https: // <dost>: <sot> /crx/packmgr/service.jsp?cmd=validate&type=osgipackageImports.overlays,acls


OTYPEParameters can be all separated separated list lists by comma:

  • OsgipackageImports
  • Overlapping
  • ACLs

The value ofTYPEby defaultOsgipackageImportsUnless.

The following is an example of the use of CRO to perform a package validation.

  1. If you use Curl, make a similar instruction as follows:

    CURL -V -X POST -Admin: admin -f -file=@users/someguy/desktop/ 'http: // localhost: 4502/crx/packmgr/Service.JSP?
  2. The requested validation is performed and the answer is returned as a JSON object.


The response to a http post requirey validation is a JSON object with validation results.

Install packages

After sending a package, you must install the content.The package content is installed and functional, it must be both:

  • loaded in AEM (alsoLoaded loaded from your file systemorDownloaded from the package launch)

  • Furnished


Installing a package can replace or delete existing content.Load only one package if you are sure not to exclude or replace the necessary content.

To see the content or effects of a package, you can:

  • Run a package test installation without changing the contents:
    Open the package (click on the symbol or package name) and clickTestimal.

  • See a package content list:
    Open the package and clickContent.

    (Video) Relocation Packages: The What and How of Relocation Assistance


An instant package is created immediately before installing your package to contain replaced content.

This instant will be reinstalled when you uninstall your package.


If you install digital assets, you should:

  • First, disable the workflow launcher.
    Use the Osgi console component menu to

  • Then, when the installation is completed, reactivates the workflow launcher.

The deactivation of the workflow launcher ensures that the structure for the importer of assets does not handle active during installation.

  1. In Order Manager, browse the package you want to install.

    ATo installThe button is displayed on the side of the packages that have not yet been installed.


    Alternatively, you can open the package by clicking on your symbol to access themTo installKey there.

  2. CliqueTo installTo start the installation.In a dialog box, confirmation is requested and all changes made.To closeNo dialogue.

    The wordFurnishedappears next to the package after installation.

File system based on upload and installation

There is an alternative way to upload and install packages in your instance.In your file system, you have aCrx-QuickstartFolder next to its glass andLicenseFile.sie must create a folder calledTo installsobCrx-Quickstart.They will have something like this:<aem_home>/crx-quickstart/installation

In this installation you can add your packages directly.They are loaded and automatically installed in their instance.If it is completed, you can see the packages in the package manager.

If your instance is performed, add a package to add to addTo installThe folder starts upload and installation in the instance.To installThe folder is installed in the alphabetical order at the beginning.


You can also do this before starting the instance for the first time.Crx-QuickstartManual folder you create theTo installFolders below and provide your packages there.If you start your instance for the first time, the packages will be installed in the alphabetical order.

Uninstall packages

With AEM, you can uninstall packages.This campaign returns the contents of the repository, which is affected on the instantaneous created immediately before the package installation.


During installation, an instant package is created, which contains the content that is replaced.

This package will be reinstalled if you uninstall the package.

  1. At the Orders Manager, browse the package you want to uninstall.
  2. Click on the package of the package you want to uninstall.
  3. CliqueUninstallTo remove the contents of this repository package.In a dialog box, confirmation is requested and all changes made.To closeNo dialogue.

Delete packages

How to delete a package from the list (s) packet manager:


The package files/knots arenooff.

  1. I amToolConsole expands thePackagesFolders to display your package in the right area.

  2. Click on the package you want to delete to be highlighted and then:

    • CliqueExtinguishNo Menu gives ferramentas bar.
    • Right -Click and SelectExtinguish.

    How to work with packages (17)

  3. Aem asks you to confirm that you want to delete the package.ClickOKTo confirm the exclusion.


If this package has already been installed, then theFurnishedThe content becomesnoTo be deleted.

Replace packages

Replicate the contents of a package to install it in the publication instance:

  1. I amPackage managerBrowse to the package you want to replicate.

  2. Click on the symbol or name of the package you want to replicate to expand it.

  3. I amMoreSelect Suspended Menu in the toolbarReplicate.

The launch of the package was a central server that was made available to the public to share content packages.

Was replaced bySoftware distribution.

Software Distribution

Software DistributionIt is the new user interface that simplifies the search and downloading AEM packages.

You can find more information inSoftware distribution documentation.


Currently, AEM Package Manager is not usable with software distribution.You download your packages to the local hard drive. features

(Video) Project Management Concept #14: Work Packages v Activities

Automated integrationFilling of Car FormDirected contentAsset CollectionsIncorporated diagramshistory


1. How to use Microsoft Access - Beginner Tutorial
(Kevin Stratvert)
2. Relocation Packages - Part 1
(Brian Safchik)
3. How Amazon's Super-Complex Shipping System Works
(Wendover Productions)
4. How Customs At JFK Searches 1 Million Mail Packages A Day
(Insider Business)
5. Introduction to R Packages
6. Pricing Freelance Packages (Work Session!)
(Latasha James)
Top Articles
Latest Posts
Article information

Author: Francesca Jacobs Ret

Last Updated: 01/04/2023

Views: 6435

Rating: 4.8 / 5 (68 voted)

Reviews: 91% of readers found this page helpful

Author information

Name: Francesca Jacobs Ret

Birthday: 1996-12-09

Address: Apt. 141 1406 Mitch Summit, New Teganshire, UT 82655-0699

Phone: +2296092334654

Job: Technology Architect

Hobby: Snowboarding, Scouting, Foreign language learning, Dowsing, Baton twirling, Sculpting, Cabaret

Introduction: My name is Francesca Jacobs Ret, I am a innocent, super, beautiful, charming, lucky, gentle, clever person who loves writing and wants to share my knowledge and understanding with you.