boot

SUMMARY.adoc

@@ -1,8 +1,16 @@
 = {{book.title}}
 
  . link:topics/overview.adoc[Overview]
- . link:topics/first-boot.adoc[First Time Boot]
- . link:topics/cluster.adoc[Boot in Cluster]
+ . link:topics/first-boot.adoc[Install and First Time Boot]
+{% if book.community %}
+ .. link:topics/first-boot/distribution-files-community.adoc[Installing Server]
+{% endif %}
+{% if book.product %}
+ .. link:topics/first-boot/distribution-files-product.adoc[Installing Server]
+{% endif %}
+ .. link:topics/first-boot/boot.adoc[Boot Server]
+ .. link:topics/first-boot/initial-user.adoc[Create Admin Account]
+ .. link:topics/first-boot/admin-console.adoc[Login Into Admin Console]
  . link:topics/first-realm-user.adoc[Creating Your First Realm and User]
  . link:topics/first-jboss-servlet.adoc[Securing a JBoss Servlet Application]
  .. link:topics/installation/system-requirements.adoc[System Requirements]

topics/first-boot.adoc

@@ -0,0 +1,5 @@
+== Install and Boot
+
+This very short tutorial walks you through booting up the server in standalone mode, setting up the initial admin user,
+and logging into the {{book.project.name}} admin console.
+

topics/first-boot/admin-console.adoc

@@ -0,0 +1,20 @@
+
+=== Login to Admin Console
+
+After you create the initial admin account, click on the _Administration Console_ link on the bottom of the Welcome Page.
+
+.Login Page
+image:../../{{book.images}}/login-page.png[]
+
+Enter the username and password you created on the Welcome Page.  This will bring you to the {{book.project.name}} Admin Console
+
+.Admin Console
+image:../../{{book.images}}/admin-console.png[]
+
+TIP:  If you are curious about a certain feature, button, or field within the Admin Console, simply hover your mouse
+      over any question mark `?` icon.  This will pop up tooltip text to describe the area of the console you are interested in.
+      The image above shows the tooltip in action.
+
+
+
+

topics/first-boot/boot.adoc

@@ -0,0 +1,22 @@
+
+=== Boot the Server
+
+To boot the {{book.project.name}} server, go to the _bin/_ directory of the server distribution.
+
+.Standalone Boot Scripts
+image:../../{{book.images}}/standalone-boot-files.png[]
+
+To boot the server:
+
+.Linux/Unix
+[source]
+----
+$ .../bin/standalone.sh
+----
+
+.Windows
+[source]
+----
+> ...\bin\standalone.bat
+----
+

topics/first-boot/distribution-files-community.adoc

@@ -0,0 +1,17 @@
+
+=== Installing Distribution Files
+
+The {{book.project.name}} Server is contained in one distribution file:
+
+* 'keycloak-{{book.project.version}}.[zip|tar.gz]'
+
+The 'keycloak-{{book.project.version}}.[zip|tar.gz]' file is the server only distribution.  It contains nothing other than the scripts and binaries
+to run the {{book.project.name}} Server.
+
+To unpack of these files run the `unzip` or `gunzip` and `tar` utilities.
+
+
+
+
+
+

topics/first-boot/distribution-files-product.adoc

@@ -0,0 +1,16 @@
+
+=== Installing Distribution Files
+
+The {{book.project.name}} Server is contained in one distribution file:
+
+* 'RH-SSO-{{book.project.version}}.[zip|tar.gz]'
+
+The 'RH-SSO-{{book.project.version}}.[zip|tar.gz]' file is the server only distribution.  It contains nothing other than the scripts and binaries
+to run the {{book.project.name}} Server.
+
+To unpack of these files run the `unzip` or `gunzip` and `tar` utilities.
+
+
+
+
+

topics/first-boot/initial-user.adoc

@@ -0,0 +1,17 @@
+
+=== Create Admin Account
+
+After the server boots, open your browser and go to the http://localhost:8080/auth URL.  The page should look like this:
+
+.Welcome Page
+image:../../{{book.images}}/standalone-boot-files.png[]
+
+{{book.project.name}} does not have any configured admin account out of the box.  You must create one on the Welcome Page.
+This account will allow you to create an admin that can log into the _master_ realm's administration console so that
+you can start creating realms, users and registering applications to be secured by {{book.project.name}}.
+
+NOTE:  You can only create an initial admin user on the Welcome Page if you connect via `localhost`.  This is a security
+       precaution.  You can also create the initial admin user at the command line with the `add-user-keycloak.sh` script.  This is discussed more in the
+       link:{{book.installguide.link}}[{{book.installguide.name}}] and link:{{book.adminguide.link}}[{{book.adminguide.name}}].
+
+