diff --git a/getting_started/topics/first-boot/distribution-files-community.adoc b/getting_started/topics/first-boot/distribution-files-community.adoc index 49066bcfd4..fd82f5d4d4 100644 --- a/getting_started/topics/first-boot/distribution-files-community.adoc +++ b/getting_started/topics/first-boot/distribution-files-community.adoc @@ -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' ---- diff --git a/getting_started/topics/first-boot/distribution-files-product.adoc b/getting_started/topics/first-boot/distribution-files-product.adoc index c989638bd8..82102632cb 100644 --- a/getting_started/topics/first-boot/distribution-files-product.adoc +++ b/getting_started/topics/first-boot/distribution-files-product.adoc @@ -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' ---- diff --git a/getting_started/topics/secure-jboss-app/install-client-adapter.adoc b/getting_started/topics/secure-jboss-app/install-client-adapter.adoc index 241d748a61..be9abd8fa4 100644 --- a/getting_started/topics/secure-jboss-app/install-client-adapter.adoc +++ b/getting_started/topics/secure-jboss-app/install-client-adapter.adoc @@ -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] ---- diff --git a/server_installation/topics/installation/distribution-files-product.adoc b/server_installation/topics/installation/distribution-files-product.adoc index 95dacc24b1..63537e6f5d 100644 --- a/server_installation/topics/installation/distribution-files-product.adoc +++ b/server_installation/topics/installation/distribution-files-product.adoc @@ -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 /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. diff --git a/server_installation/topics/installation/installing-rpm.adoc b/server_installation/topics/installation/installing-rpm.adoc index 375add818a..d3a27717ce 100644 --- a/server_installation/topics/installation/installing-rpm.adoc +++ b/server_installation/topics/installation/installing-rpm.adoc @@ -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]. diff --git a/topics/templates/document-attributes-product.adoc b/topics/templates/document-attributes-product.adoc index e73d839680..323608bdf1 100644 --- a/topics/templates/document-attributes-product.adoc +++ b/topics/templates/document-attributes-product.adoc @@ -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