KEYCLOAK-14658 adding a step to start the EAP CLI before applying the patch

This commit is contained in:
Andy Munro 2020-07-06 15:39:05 -04:00 committed by Bruno Oliveira da Silva
parent c3830b1f64
commit af5e005c20
6 changed files with 59 additions and 13 deletions

View file

@ -9,7 +9,7 @@ You can install the server on Linux or Windows. The server download ZIP file con
. Place the file in a directory you choose.
. Unpack the ZIP file using the appropriate `unzip` utility, such as jar, tar, or unzip.
. Unpack the ZIP file using the appropriate `unzip` utility, such as unzip, tar, or Expand-Archive.
+
.Linux/Unix
@ -26,5 +26,5 @@ $ tar -xvzf keycloak-{project_version}.tar.gz
.Windows
[source,bash,subs=+attributes]
----
> unzip keycloak-{project_version}.zip
> Expand-Archive -Path 'C:Downloads\keycloak-{project_version}.zip` -DestinationPath 'C:\Downloads'
----

View file

@ -9,27 +9,27 @@ For this sample instance of {project_name}, this procedure involves installation
. Go to the https://access.redhat.com/jbossnetwork/restricted/listSoftware.html?downloadType=distributions&product=core.service.rhsso[Red Hat customer portal].
. Download the {project_name} Server: *rh-sso-{project_version}.zip*
. Download the {project_name} Server: *rh-sso-{project_version_base}.zip*
. Place the file in a directory you choose.
. Unpack the ZIP file using the appropriate `unzip` utility, such as jar, tar, or unzip.
. Unpack the ZIP file using the appropriate `unzip` utility, such as unzip, tar, or Expand-Archive.
+
.Linux/Unix
[source,bash,subs=+attributes]
----
$ unzip rhsso-{project_version}.zip
$ unzip rhsso-{project_version_base}.zip
or
$ tar -xvzf rh-sso-{project_version}.tar.gz
$ tar -xvzf rh-sso-{project_version_base}.tar.gz
----
+
.Windows
[source,bash,subs=+attributes]
----
$ unzip rhsso-{project_version}.zip
> Expand-Archive -Path 'C:Downloads\rhsso-{project_version_base}.zip` -DestinationPath 'C:\Downloads'
----

View file

@ -20,7 +20,7 @@ endif::[]
. Change to the root directory of {appserver_name}.
. Unzip the downloaded client adapter in this directory.
. Unzip the downloaded client adapter in this directory. For example:
+
[source,bash,subs=+attributes]
----

View file

@ -1,9 +1,50 @@
=== Installing RH-SSO from a ZIP File
The {project_name} Server is contained in one distribution file: rh-sso-{project_version}.zip.gz.
The {project_name} server download ZIP file contains the scripts and binaries to run the {project_name} server. You install the {project_version_base} server first, then the {project_version} server patch.
.Procedure
. Go to the https://access.redhat.com/jbossnetwork/restricted/listSoftware.html?downloadType=distributions&product=core.service.rhsso[Red Hat customer portal].
. Download the {project_name} {project_version_base} server.
. Unpack the ZIP file using the appropriate `unzip` utility, such as unzip, tar, or Expand-Archive.
. Return to the https://access.redhat.com/jbossnetwork/restricted/listSoftware.html?downloadType=distributions&product=core.service.rhsso[Red Hat customer portal].
. Click the `Patches` tab.
. Download the {project_name} {project_version} server patch.
. Place the downloaded file in a directory you choose.
. Go to the `bin` directory of {appserver_name}.
. Start the {appserver_name} command line interface.
+
.Linux/Unix
[source,bash,subs=+attributes]
----
$ jboss-cli.sh
----
+
.Windows
[source,bash,subs=+attributes]
----
> jboss-cli.bat
----
. Apply the patch.
+
[source,bash,subs=+attributes]
----
$ patch apply <path-to-zip>/rh-sso-{project_version}-patch.zip
----
.Additional resources
For more details on applying patches, see link:https://access.redhat.com/documentation/en-us/red_hat_single_sign-on/{project_version_base}/html/upgrading_guide/upgrading#zip-patching[Patching a ZIP/Installer Installation].
The rh-sso-{project_version}.zip.gz archive is the server-only distribution. It contains only the scripts and binaries to run {project_name} Server.
To unpack these files, run the `unzip` or `gunzip` utility.

View file

@ -63,3 +63,7 @@ subscription-manager repos --enable=rh-sso-{project_versionDoc}-for-rhel-8-x86_6
dnf groupinstall rh-sso7
Your installation is complete. The default RH-SSO_HOME path for the RPM installation is /opt/rh/rh-sso7/root/usr/share/keycloak.
.Additional resources
For details on installing the {project_version} patch for {project_name}, see link:https://access.redhat.com/documentation/en-us/red_hat_single_sign-on/{project_version_base}/html/upgrading_guide/upgrading#rpm-patching[RPM patching].

View file

@ -6,9 +6,10 @@
:project_images: rhsso-images
:project_name_full: Red Hat Single Sign-On
:project_version: 7.4.0.GA
:project_version_base: 7.4
:project_version: 7.4.1
:keycloak_upgrade_version: 9.0.x
:project_versionDoc: 7.4
:project_versionDoc: 7.4.1
:project_templates_base_url: https://raw.githubusercontent.com/jboss-container-images/redhat-sso-7-openshift-image/sso74-dev/templates
:project_latest_image_tag: 1.0
:project_doc_base_url: https://access.redhat.com/documentation/en-us/red_hat_single_sign-on/{project_versionDoc}/html-single