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.
OBSERVATION
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.
| Feld | Description |
|---|---|
| Name | The name of the package. |
| group | The group name to add the package to organize packages.Enter the name of a new group or select an existing group. |
| execution | Text for the custom version. |
| Description | A brief description of the package.html marking can be used for formatting. |
| Miniature view | The symbol that is displayed on the package list.Click Search to select a local file. |
| Feld | Description | Format/example |
|---|---|---|
| Name | The name of the provider. | AEM GeomeTrixx |
| Url | Provider URL. | https://www.aem-geometrixx.com |
| shortcut | -Link Package specific for a provider page. | https://www.aem-geometrixx.com/mypackage.html |
| Requires |
| |
| AC -Manipulation | Specify how access control defined in the package is treated with information when importing the package:
The default value isIgnore. |
|
| Feld | Description | Format/example |
|---|---|---|
| Tested with | Product name and product name and package are intended for the package or compatible. | To stretch |
| Errors/problems corrected | A 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 on | List 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 |
| Substituted | A 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.
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:
| /libs/sling/install(/.*?lang=en)? |
| 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). | /libs/wcm/foundation/components(/.*?lang=en)? |
OBSERVATION
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:
OBSERVATION
To avoid confusion, use a descriptive symbol for your package and do not use any of the official symbols.
Official Hotfix Package:
Official Package of AEM Installation or Expansion:
Official Resource Packages:
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:
Click Click on the Welcome ScreenPackages(or fromToolDouble -click consolePackages).
Then selectPackage manager.
CliqueCreate Package.
OBSERVATION
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.
IM Dialogue:
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 Packagesexecution
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.
List the new package in the corresponding group folder.
Click on the symbol or name of the package to open it.
OBSERVATION
If necessary, you can return to this page later.
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.
Add toScreen CapturesAs needed for a package, an instance is available if the package is created. Add morePAKET Screen CaptureFrom the friend.
See AlsoHow to work with packagesAdd the actual image by clicking double to the component of the imageScreen CapturesArea, add and click on an imageOK.
Define itPackage filterPulling instances of theFilterDefinitionFrom the friend, then click twice to open for editing:
Indicate:
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.
OBSERVATION
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.
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.
Now you canBuildYour package.
OBSERVATION
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.
OBSERVATION
Before creating the package, it can be helpful to advance the package content.For this clickvisualization.
Open the definition ofPackage manager(Click on the symbol or name of the package).
CliqueBuildIn a dialogue, you are asked to confirm that you want to create the package.
OBSERVATION
This is of particular importance if you rebuild a package because the package content is replaced.
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.
Package
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.
Open the definition ofPackage manager(Click on the symbol or name of the package).
CliqueTo editand update thePackage Settingsby need. ClickOKSave to the computer.
CliqueRewriteA dialog box is requested for confirmation.
Show and edit package information
Show or edit information about a package definition:
In the Orders Manager, browse the package you want to display.
Click on the package of the package you want to display.
OBSERVATION
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 PackagesWhen 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:
In the Orders Manager, browse the package you want to display.
Click on the package of the package you want to display and the package page is listed, which lists information about the package setting.
To display the content, clickContentA window opens and lists all package content:
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:
Download packages from your file system
This section describes how to download an AEM package to your file systemPackage manager.
OBSERVATION
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.
Click Click on the Welcome ScreenPackages, then selectPackage manager.
Browse to the package you want to download.
Click on the link to the package you want to download with the name of the Zip File (underlined).For example
export-for-offline.zip.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.
OBSERVATION
VerLoad packages for the sharing of the Company Company InternalThus, send a package to your company's private package area.
To upload a package:
NavigatePackage manager.Then the group folder in which the package must be loaded.
CliquePack the package.
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.
OBSERVATION
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 its
Manifest.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 TutorialHow 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.OBSERVATION
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.
CAREFUL
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
OBSERVATION
Validation should always occur after package loading, but before installation.
Package validation through the Orders Manager
Open the Orders Manager in
https: // <merver>: <sot>/crx/packmgrSelect the package in the list and selectMoreSuspended from the header and thenconfirmedNo suspense menu.
OBSERVATION
This should be done after uploading the content package, but before installing the package.
Use "modal" in the "modal" dialog box, which is displayedconfirmed.Alternative clickCancel.
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,aclsOBSERVATION
OTYPEParameters can be all separated separated list lists by comma:
OsgipackageImportsOverlappingACLs
The value ofTYPEby defaultOsgipackageImportsUnless.
The following is an example of the use of CRO to perform a package validation.
If you use Curl, make a similar instruction as follows:
CURL -V -X POST -Admin: admin -f -file=@users/someguy/desktop/core.wcm.components.all-1.0.zip 'http: // localhost: 4502/crx/packmgr/Service.JSP?The requested validation is performed and the answer is returned as a JSON object.
OBSERVATION
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
CAREFUL
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
OBSERVATION
An instant package is created immediately before installing your package to contain replaced content.
This instant will be reinstalled when you uninstall your package.
CAREFUL
If you install digital assets, you should:
First, disable the workflow launcher.
Use the Osgi console component menu to disablecom.day.cq.workflow.launcher.impl.workflownungenerimpl.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.
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.
OBSERVATION
Alternatively, you can open the package by clicking on your symbol to access themTo installKey there.
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.
OBSERVATION
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.
OBSERVATION
During installation, an instant package is created, which contains the content that is replaced.
This package will be reinstalled if you uninstall the package.
- At the Orders Manager, browse the package you want to uninstall.
- Click on the package of the package you want to uninstall.
- 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:
OBSERVATION
The package files/knots arenooff.
I amToolConsole expands thePackagesFolders to display your package in the right area.
Click on the package you want to delete to be highlighted and then:
- CliqueExtinguishNo Menu gives ferramentas bar.
- Right -Click and SelectExtinguish.
Aem asks you to confirm that you want to delete the package.ClickOKTo confirm the exclusion.
CAREFUL
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:
I amPackage managerBrowse to the package you want to replicate.
Click on the symbol or name of the package you want to replicate to expand it.
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.
CAREFUL
Currently, AEM Package Manager is not usable with software distribution.You download your packages to the local hard drive.
Business.adobe.com features
Automated integrationFilling of Car FormDirected contentAsset CollectionsIncorporated diagramshistory