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é <[email protected]> Authored: Tue Aug 19 10:45:30 2014 +0200 Committer: Jean-Baptiste Onofré <[email protected]> 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}
