From 6c3b91214983059dea49429694dec8e21d70d07c Mon Sep 17 00:00:00 2001
From: mposolda <mposolda@gmail.com>
Date: Tue, 6 Sep 2016 11:45:57 +0200
Subject: [PATCH] KEYCLOAK-3526 Fuse adapter ZIP docs

---
 SUMMARY.adoc                               |  1 +
 topics/oidc/java/fuse-adapter.adoc         |  1 +
 topics/oidc/java/fuse/install-feature.adoc | 68 ++++++++++++++++++++++
 3 files changed, 70 insertions(+)
 create mode 100644 topics/oidc/java/fuse/install-feature.adoc

diff --git a/SUMMARY.adoc b/SUMMARY.adoc
index 9729f18fe2..ed8fb7f5c4 100644
--- a/SUMMARY.adoc
+++ b/SUMMARY.adoc
@@ -11,6 +11,7 @@
       ... link:topics/oidc/java/java-adapter-config.adoc[Java Adapters Config]
       ... link:topics/oidc/java/jboss-adapter.adoc[JBoss EAP/Wildfly Adapter]
       ... link:topics/oidc/java/fuse-adapter.adoc[JBoss Fuse Adapter]
+      .... link:topics/oidc/java/fuse/install-feature.adoc[Install Feature]
       .... link:topics/oidc/java/fuse/classic-war.adoc[Classic WAR application]
       .... link:topics/oidc/java/fuse/servlet-whiteboard.adoc[Servlet Deployed as OSGI Service]
       .... link:topics/oidc/java/fuse/camel.adoc[Apache Camel]
diff --git a/topics/oidc/java/fuse-adapter.adoc b/topics/oidc/java/fuse-adapter.adoc
index 58f42914bd..9f3258a023 100755
--- a/topics/oidc/java/fuse-adapter.adoc
+++ b/topics/oidc/java/fuse-adapter.adoc
@@ -23,6 +23,7 @@ What is supported for Fuse is:
 
 ===== How to secure your web applications inside Fuse
 
+The first thing to do is usually installing of {{book.project.name}} Karaf feature. Then do the steps according to what type of application you want to secure.
 Basically all mentioned web applications require to inject {{book.project.name}} Jetty authenticator into underlying Jetty server . The steps to achieve it are bit different
 according to application type. The details are described in individual sub-chapters.
 
diff --git a/topics/oidc/java/fuse/install-feature.adoc b/topics/oidc/java/fuse/install-feature.adoc
new file mode 100644
index 0000000000..42bb1e6823
--- /dev/null
+++ b/topics/oidc/java/fuse/install-feature.adoc
@@ -0,0 +1,68 @@
+
+[[_fuse_install_feature]]
+===== Install Feature
+
+First thing to be done is to install the feature `keycloak` into the JBoss Fuse environment. This will install the Fuse adapter
+together with all needed 3rd party dependencies. There are 2 possibilities to install it.
+
+
+====== Install from Maven Repository
+
+You need to be online and have access to the maven repository.
+
+{% if book.community %}
+For community it's sufficient to be online as all the artifacts and 3rd party dependencies should be available in maven central repository.
+{% endif %}
+
+You need to start JBoss Fuse and then in the Karaf terminal you type this:
+
+[source]
+----
+features:addurl mvn:org.keycloak/keycloak-osgi-features/{{book.project.versionMvn}}/xml/features
+features:install keycloak
+----
+
+Then in JBoss Fuse 6.2 you may need to install Jetty 8 feature:
+
+[source]
+----
+features:install keycloak-jetty8-adapter
+----
+
+Or in JBoss Fuse 6.3 you may need to install Jetty 9 feature:
+
+[source]
+----
+features:install keycloak-jetty9-adapter
+----
+
+Then you can check that requested features were installed:
+
+[source]
+----
+features:list | grep keycloak
+----
+
+====== Install from ZIP bundle
+
+This is useful if you are offline and/or don't want to use maven for download jar files and other artifacts. Once you download ZIP bundle of {{book.project.name}} Fuse adapter,
+you will need to unzip it into the root directory of JBoss Fuse. This should install the dependencies under the `system` directory. For example see this for Fuse 6.2.1 :
+
+[source]
+----
+cd /path-to-fuse/jboss-fuse-6.2.1.redhat-084
+unzip -q /path-to-adapter-zip/keycloak-fuse-adapter-dist-{{book.project.versionMvn}}.zip
+----
+
+Feel free to overwrite all already existing jars. Once you unzip archive, you can start the Fuse and again run commands in fuse/karaf terminal
+
+[source]
+----
+features:addurl mvn:org.keycloak/keycloak-osgi-features/{{book.project.versionMvn}}/xml/features
+features:install keycloak
+----
+
+And also install the corresponding Jetty adapter. The difference from the previous part is, that nothing will be downloaded from maven repository as the artifacts were
+available directly in JBoss Fuse `system` directory.
+
+