Update server and adapter install docs
This commit is contained in:
Stian Thorgersen
parent
28a50df746
commit
162f31baa2
3 changed files with 35 additions and 31 deletions
|
|
@ -102,6 +102,27 @@
|
|||
to newer version and upgrade few methods, which has changed signature. Changes are really minor, but were needed to improve performance of federation.
|
||||
</para>
|
||||
</simplesect>
|
||||
<simplesect>
|
||||
<title>WildFly 9.0.0.CR2</title>
|
||||
<para>
|
||||
Following on from the distribution changes that was done in the last release the standalone download
|
||||
of Keycloak is now based on WildFly 9.0.0.CR2. This als affects the overlay which can only be deployed
|
||||
to WildFly 9.0.0.CR2 or JBoss EAP 6.4.0.GA. WildFly 8.2.0.Final is no longer supported for the server.
|
||||
</para>
|
||||
</simplesect>
|
||||
<simplesect>
|
||||
<title>WildFly, JBoss EAP and JBoss AS7 adapters</title>
|
||||
<para>
|
||||
There are now 3 separate adapter downloads for WildFly, JBoss EAP and JBoss AS7:
|
||||
<itemizedlist>
|
||||
<listitem><literal>eap6</literal> - for JBoss EAP 6.x</listitem>
|
||||
<listitem><literal>wf9</literal> - for WildFly 9.x</listitem>
|
||||
<listitem><literal>wf8</literal> - for WildFly 8.x</listitem>
|
||||
<listitem><literal>as7</literal> - for JBoss AS 7.x</listitem>
|
||||
</itemizedlist>
|
||||
Make sure you grab the correct one.
|
||||
</para>
|
||||
</simplesect>
|
||||
</section>
|
||||
<section>
|
||||
<title>Migrating from 1.2.0.Beta1 to 1.2.0.RC1</title>
|
||||
|
|
|
|||
|
|
@ -14,10 +14,17 @@
|
|||
the Keycloak download site. They are also available as a maven artifact.
|
||||
</para>
|
||||
<para>
|
||||
Install on Wildfly:
|
||||
Install on Wildfly 9:
|
||||
<programlisting>
|
||||
$ cd $WILDFLY_HOME
|
||||
$ unzip keycloak-wildfly-adapter-dist.zip
|
||||
$ unzip keycloak-wf9-adapter-dist.zip
|
||||
</programlisting>
|
||||
</para>
|
||||
<para>
|
||||
Install on Wildfly 8:
|
||||
<programlisting>
|
||||
$ cd $WILDFLY_HOME
|
||||
$ unzip keycloak-wf8-adapter-dist.zip
|
||||
</programlisting>
|
||||
</para>
|
||||
<para>
|
||||
|
|
@ -56,7 +63,6 @@ $ unzip keycloak-as7-adapter-dist.zip
|
|||
</profile>
|
||||
]]>
|
||||
</programlisting>
|
||||
<note>For AS7, the extension module is org.keycloak.keycloak-as7-subsystem.</note>
|
||||
</para>
|
||||
<para>
|
||||
Finally, you must specify a shared keycloak security domain.
|
||||
|
|
|
|||
|
|
@ -43,9 +43,9 @@
|
|||
|
||||
|
||||
<section id="overlay_install">
|
||||
<title>Install on existing WildFly 8.2.0.Final</title>
|
||||
<title>Install on existing WildFly 9.0.0.CR2</title>
|
||||
<para>
|
||||
Keycloak can be installed into an existing WildFly 8.2.0.Final server. To do this download
|
||||
Keycloak can be installed into an existing WildFly 9.0.0.CR2 server. To do this download
|
||||
<literal>keycloak-overlay-&project.version;.zip</literal> or <literal>keycloak-overlay-&project.version;.tar.gz</literal>.
|
||||
Once downloaded extract into the root directory of your WildFly installation. To start WildFly with Keycloak
|
||||
run:
|
||||
|
|
@ -72,32 +72,9 @@
|
|||
</para>
|
||||
</section>
|
||||
<section>
|
||||
<title>Install on existing EAP 6.4.0.GA</title>
|
||||
<title>Install on existing JBoss EAP 6.4.0.GA</title>
|
||||
<para>
|
||||
Keycloak can be installed into an existing EAP 6.4.0.GA server. To do this download
|
||||
<literal>keycloak-overlay-&project.version;.zip</literal> or <literal>keycloak-overlay-&project.version;.tar.gz</literal>.
|
||||
Once downloaded extract into the root directory of your EAP installation.
|
||||
</para>
|
||||
<para>
|
||||
To add Keycloak to the a EAP sever configurations (standalone.xml, standalone-ha.xml, etc.) open
|
||||
<literal>standalone/configuration/standalone-keycloak.xml</literal> and the configuration you want to add it
|
||||
to, for example <literal>standalone/configuration/standalone.xml</literal>. From <literal>standalone-keycloak.xml</literal>
|
||||
you need to copy 3 elements:
|
||||
<itemizedlist>
|
||||
<listitem><literal><extension module="org.keycloak.keycloak-subsystem"/></literal></listitem>
|
||||
<listitem><literal><datasource jndi-name="java:jboss/datasources/KeycloakDS" ...></literal></listitem>
|
||||
<listitem><literal><subsystem xmlns="urn:jboss:domain:keycloak:1.0" ...></literal></listitem>
|
||||
</itemizedlist>
|
||||
<note>
|
||||
<literal>standalone-keycloak.xml</literal> is aimed at WildFly and won't work with EAP so you need to
|
||||
copy the required configuration
|
||||
</note>
|
||||
</para>
|
||||
<para>
|
||||
Once the server is started log into the admin console at
|
||||
<ulink url="http://localhost:8080/auth/admin/index.html">http://localhost:8080/auth/admin/index.html</ulink>
|
||||
(username: <emphasis>admin</emphasis> and password: <emphasis>admin</emphasis>). Keycloak will then prompt you to
|
||||
enter in a new password.
|
||||
Same procedure as JBoss EAP 6.4.0.GA, but download <literal>keycloak-overlay-eap6-&project.version;.zip</literal> or <literal>keycloak-overlay-eap6-&project.version;.tar.gz</literal>.
|
||||
</para>
|
||||
</section>
|
||||
<section>
|
||||
|
|
@ -107,7 +84,7 @@
|
|||
To install it first download <literal>keycloak-demo-&project.version;.zip</literal> or
|
||||
<literal>keycloak-demo-&project.version;.tar.gz</literal>. Once downloaded extract it inside
|
||||
<literal>keycloak-demo-&project.version;</literal> you'll find <literal>keycloak</literal> which contains
|
||||
a full WildFly 8.2.0.Final server with Keycloak Server and Adapters included. You'll also find <literal>docs</literal>
|
||||
a full WildFly 9.0.0.CR2 server with Keycloak Server and Adapters included. You'll also find <literal>docs</literal>
|
||||
and <literal>examples</literal> which contains everything you need to get started developing applications that use Keycloak.
|
||||
</para>
|
||||
<para>
|
||||
|
|
|
|||
Loading…
Reference in a new issue