This is an automated email from the ASF dual-hosted git repository.
jbonofre pushed a commit to branch karaf-4.2.x
in repository https://gitbox.apache.org/repos/asf/karaf.git
The following commit(s) were added to refs/heads/karaf-4.2.x by this push:
new 4673995 updated-boot-features-documentation (#908)
4673995 is described below
commit 46739957e9b958d4dfe9a1123b386a6c703d53c9
Author: Alex <[email protected]>
AuthorDate: Mon Sep 16 14:39:43 2019 +0100
updated-boot-features-documentation (#908)
Update boot features documentation
(cherry picked from commit e3f5d90db3a02da8efd140836487c07450b6ba98)
---
manual/src/main/asciidoc/user-guide/provisioning.adoc | 17 ++++++++++++++---
1 file changed, 14 insertions(+), 3 deletions(-)
diff --git a/manual/src/main/asciidoc/user-guide/provisioning.adoc
b/manual/src/main/asciidoc/user-guide/provisioning.adoc
index 96bc426..255e755 100644
--- a/manual/src/main/asciidoc/user-guide/provisioning.adoc
+++ b/manual/src/main/asciidoc/user-guide/provisioning.adoc
@@ -123,16 +123,27 @@ To prevent this behaviour, you can specify features as
boot features.
==== Boot features
-You can describe some features as boot features. A boot feature will be
automatically install by Apache Karaf, even if it has
-not been previously installed using `feature:install` or FeatureMBean.
+A boot feature is automatically installed by Apache Karaf, even if it has not
been previously installed using `feature:install` or FeatureMBean.
-Apache Karaf features configuration is located in the
`etc/org.apache.karaf.features.cfg` configuration file.
+The Apache Karaf features configuration is located in the
`etc/org.apache.karaf.features.cfg` configuration file.
This configuration file contains the two properties to use to define boot
features:
* `featuresRepositories` contains a list (comma-separated) of features
repositories (features XML) URLs.
* `featuresBoot` contains a list (comma-separated) of features to install at
boot.
+========
+To remove features from the `featuresBoot` list in the
`etc/org.apache.karaf.features.cfg` configuration file:
+
+. Navigate to `etc/org.apache.karaf.features.cfg`.
+. Remove the undesired feature.
+. Restart your container.
+
+NOTE: After the restart, the features will be present in the
`etc/org.apache.karaf.features.cfg` configuration file, but they will not be
installed and the undesired feature or behavior will no longer be present or
active.
+
+NOTE: Another way to clean up the `featuresBoot` is to stop Karaf, update
`featuresBoot`, and remove the *data* folder.
+========
+
==== Features upgrade
You can update a release by installing the same feature (with the same
SNAPSHOT version or a different version).
