You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@sling.apache.org by kw...@apache.org on 2022/12/05 13:04:51 UTC

[sling-site] branch feature/osgi-installer-priorities created (now d2e95c5e0)

This is an automated email from the ASF dual-hosted git repository.

kwin pushed a change to branch feature/osgi-installer-priorities
in repository https://gitbox.apache.org/repos/asf/sling-site.git


      at d2e95c5e0 Descripe priorities

This branch includes the following new commits:

     new d2e95c5e0 Descripe priorities

The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.



[sling-site] 01/01: Descripe priorities

Posted by kw...@apache.org.
This is an automated email from the ASF dual-hosted git repository.

kwin pushed a commit to branch feature/osgi-installer-priorities
in repository https://gitbox.apache.org/repos/asf/sling-site.git

commit d2e95c5e063496289f01e54b412b3f2644c303b6
Author: Konrad Windszus <kw...@apache.org>
AuthorDate: Mon Dec 5 14:04:45 2022 +0100

    Descripe priorities
    
    Add reference to Launchpad provider
---
 .../documentation/bundles/osgi-installer.md        | 22 +++++++++++++++++++---
 1 file changed, 19 insertions(+), 3 deletions(-)

diff --git a/src/main/jbake/content/documentation/bundles/osgi-installer.md b/src/main/jbake/content/documentation/bundles/osgi-installer.md
index 86ef7c615..d1a001931 100644
--- a/src/main/jbake/content/documentation/bundles/osgi-installer.md
+++ b/src/main/jbake/content/documentation/bundles/osgi-installer.md
@@ -33,6 +33,20 @@ In addition to this id, an artifact gets a priority information from the provide
 
 Artifacts with the same unique id are grouped and then sorted by priority and maybe other artifact dependent metadata like the bundle version. Only the first artifact in this sorted group is tried to be applied!
 
+### Priorities
+
+When multiple resources with the same id are provided the one with the *highest priority* is installed.
+
+Provider | Base priority | Priority boost per matching run mode
+------ | ----- | ----
+Launchpad | 50 | 5
+JCR Installer | 100 (libs), 200 (apps), configurable via OSGi) | 1
+File Installer | 100 | 1
+
+The priority is always calculated from the base priority and the priority boost according to the formula:
+
+`priority = <base priority> + (<priory boost> * <no of matching run modes))`
+
 ## Bundle Handling
 
 In general, the OSGi installer always tries to install the highest version of a bundle if several bundles with the same symbolic name are provided. In this case higher version wins over priority.
@@ -73,7 +87,7 @@ The OSGi installer asumes that a symbolic name and version (not a snapshot versi
 
 During development, SNAPSHOT versions should be used, like 1.0.0-SNAPSHOT (using the Maven convention). If a bundle with a snapshot version is changed, it gets updated by the OSGI installer.
 
-## Start Level Handling
+### Start Level Handling
 
 The OSGi installer supports handling of start levels for bundles. If the provided bundle artifacts contain a start level information the bundle is installed with that start level, otherwise the default start level is used.
 Therefore, for initial provisioning to make use of start levels, the OSGi installer and the corresponding provider (see below) should run at a very low start level, probably at 1. This ensure that the bundles with a start level are started with respect to the start level.
@@ -100,8 +114,10 @@ An installer factory provides support for a specific artifact type, like a confi
 
 A provider provides artifacts, e.g. by scanning a directory or a database etc.
 
-* [File Installer Provider](/documentation/bundles/file-installer-provider.html)
-* [JCR Installer Provider](/documentation/bundles/jcr-installer-provider.html)
+* [File Installer Provider](/documentation/bundles/file-installer-provider.html), scheme `fileinstall` followed by the MD5 of the config directory
+* [JCR Installer Provider](/documentation/bundles/jcr-installer-provider.html), scheme `jcrinstall`
+* [Launchpad Provider](https://github.com/apache/sling-org-apache-sling-launchpad-installer), scheme `launchpad`
+
 
 ## Web Console