You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@karaf.apache.org by jb...@apache.org on 2014/08/19 10:46:18 UTC

git commit: [KARAF-3159] Fix features deployer documentation about auto installation of the features

Repository: karaf
Updated Branches:
  refs/heads/master 088b48f16 -> c58047573


[KARAF-3159] Fix features deployer documentation about auto installation of the features


Project: http://git-wip-us.apache.org/repos/asf/karaf/repo
Commit: http://git-wip-us.apache.org/repos/asf/karaf/commit/c5804757
Tree: http://git-wip-us.apache.org/repos/asf/karaf/tree/c5804757
Diff: http://git-wip-us.apache.org/repos/asf/karaf/diff/c5804757

Branch: refs/heads/master
Commit: c5804757328698d7c11c28ae45f8a3910eed939b
Parents: 088b48f
Author: Jean-Baptiste Onofré <jb...@apache.org>
Authored: Tue Aug 19 10:45:30 2014 +0200
Committer: Jean-Baptiste Onofré <jb...@apache.org>
Committed: Tue Aug 19 10:45:30 2014 +0200

----------------------------------------------------------------------
 .../main/webapp/users-guide/provisioning.conf   | 29 ++++++++++++++------
 1 file changed, 21 insertions(+), 8 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/karaf/blob/c5804757/manual/src/main/webapp/users-guide/provisioning.conf
----------------------------------------------------------------------
diff --git a/manual/src/main/webapp/users-guide/provisioning.conf b/manual/src/main/webapp/users-guide/provisioning.conf
index 78f9897..a0a7f8d 100644
--- a/manual/src/main/webapp/users-guide/provisioning.conf
+++ b/manual/src/main/webapp/users-guide/provisioning.conf
@@ -508,17 +508,30 @@ You can "hot deploy" a features XML by dropping the file directly in the {{deplo
 
 Apache Karaf provides a features deployer.
 
-The features deployer handles the features XML files dropped into the {{deploy}} folder and automatically register and
-install all features described in the features XML.
+When you drop a features XML in the deploy folder, the features deployer does:
+* register the features XML as a features repository
+* the features with {{install}} attribute set to "auto" will be automatically installed by the features deployer.
 
-If you want to install a single feature, you can do so by writing a feature descriptor like the following:
+For instance, dropping the following XML in the deploy folder will automatically install feature1 and feature2, whereas
+feature3 won't be installed:
 
 {code:lang=xml}
-<features>
-  <repository>mvn:groupId/artifactId/1.0.0/xml/features</repository>
-  <feature name="target">
-    <feature>target</feature>
-  </feature>
+<?xml version="1.0" encoding="UTF-8"?>
+<features name="my-features" xmlns="http://karaf.apache.org/xmlns/features/v1.2.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+        xsi:schemaLocation="http://karaf.apache.org/xmlns/features/v1.2.0 http://karaf.apache.org/xmlns/features/v1.2.0">
+
+    <feature name="feature1" version="1.0" install="auto">
+        ...
+    </feature>
+
+    <feature name="feature2" version="1.0" install="auto">
+        ...
+    </feature>
+
+    <feature name="feature3" version="1.0">
+        ...
+    </feature>
+
 </features>
 {code}