diff --git a/server_installation/SUMMARY.adoc b/server_installation/SUMMARY.adoc index a28d260982..aa5bcf9c77 100755 --- a/server_installation/SUMMARY.adoc +++ b/server_installation/SUMMARY.adoc @@ -8,7 +8,8 @@ ... link:server_installation/topics/installation/distribution-files-community.adoc[Installing Distribution Files] {% endif %} {% if book.product %} -... link:server_installation/topics/installation/distribution-files-product.adoc[Installing Distribution Files] +... link:server_installation/topics/installation/distribution-files-product.adoc[Installing RH-SSO from a ZIP File] +... link:server_installation/topics/installation/installing-rpm.adoc[Installing RH-SSO from an RPM] {% endif %} ... link:server_installation/topics/installation/directory-structure.adoc[Distribution Directory Structure] .. link:server_installation/topics/operating-mode.adoc[Choosing an Operating Mode] diff --git a/server_installation/topics/installation.adoc b/server_installation/topics/installation.adoc index b78634455b..d6ed447288 100755 --- a/server_installation/topics/installation.adoc +++ b/server_installation/topics/installation.adoc @@ -1,5 +1,10 @@ == Installation +{% if book.community %} +Installing {{book.project.name}} is as simple as downloading it and unzipping it. This chapter reviews system requirements +as well as the directory structure of the distribution. +{% endif %} -Installing {{book.project.name}} is as simple as downloading it and unzipping it. This chapter reviews system requirements -as well as the directory structure of the distribution. \ No newline at end of file +{% if book.product %} +You can install {{book.project.name}} by downloading a ZIP file and unzipping it, or by using an RPM. This chapter reviews system requirements as well as the directory structure. +{% endif %} \ No newline at end of file diff --git a/server_installation/topics/installation/distribution-files-product.adoc b/server_installation/topics/installation/distribution-files-product.adoc index 215a265210..a1f9928f54 100755 --- a/server_installation/topics/installation/distribution-files-product.adoc +++ b/server_installation/topics/installation/distribution-files-product.adoc @@ -1,16 +1,9 @@ -=== 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. - +=== Installing RH-SSO from a ZIP File +The {{book.project.name}} Server is contained in one distribution file: rh-sso-{{book.project.version}}.zip.gz. +The rh-sso-{{book.project.version}}.zip.gz archive is the server-only distribution. It contains only the scripts and binaries to run {{book.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 new file mode 100644 index 0000000000..95601f4fe2 --- /dev/null +++ b/server_installation/topics/installation/installing-rpm.adoc @@ -0,0 +1,41 @@ +[[_installing_rpm]] + +=== Installing RH-SSO from an RPM + +NOTE: With Red Hat Enterprise Linux 7, the term channel was replaced with the term repository. In these instructions only the term repository is used. + +You must subscribe to both the JBoss EAP 7.0 and RH-SSO 7.1 repositories before you can install RH-SSO from an RPM. + +NOTE: You cannot continue to receive upgrades to EAP 7.0 RPMs but stop receiving updates for RH-SSO. + +[[subscribing_EAP_repo]] +==== Subscribing to the JBoss EAP 7.0 Repository + +.Prerequisites + +. Ensure that your Red Hat Enterprise Linux system is registered to your account using Red Hat Subscription Manager. For more information see the link:https://access.redhat.com/documentation/en-US/Red_Hat_Subscription_Management/1/html-single/Quick_Registration_for_RHEL/index.html[Red Hat Subscription Management documentation]. + +. If you are already subscribed to another JBoss EAP repository, you must unsubscribe from that repository first. + +Using Red Hat Subscription Manager, subscribe to the JBoss EAP 7.0 repository using the following command. Replace with either 6 or 7 depending on your Red Hat Enterprise Linux version. + + subscription-manager repos --enable=jb-eap-7.0-for-rhel--server-rpms + +==== Subscribing to the RH-SSO 7.1 Repository and Installing RH-SSO 7.1 + +.Prerequisites + +. Ensure that your Red Hat Enterprise Linux system is registered to your account using Red Hat Subscription Manager. For more information see the link:https://access.redhat.com/documentation/en-US/Red_Hat_Subscription_Management/1/html-single/Quick_Registration_for_RHEL/index.html[Red Hat Subscription Management documentation]. +. Ensure that you have already subscribed to the JBoss EAP 7.0 repository. For more information see xref:subscribing_EAP_repo[Subscribing to the JBoss EAP 7.0 repository]. + +To subscribe to the RH-SSO 7.1 repository and install RH-SSO 7.1, complete the following steps: + +. Using Red Hat Subscription Manager, subscribe to the RH-SSO 7.1 repository using the following command. Replace with either 6 or 7 depending on your Red Hat Enterprise Linux version. + + subscription-manager repos --enable=rh-sso-7.1-for-rhel--server-rpms + +. Install RH-SSO from your subscribed RH-SSO 7.1 repository using the following command: + + yum install rh-sso7-keycloak-server + +Your installation is complete. The default RH-SSO_HOME path for the RPM installation is /opt/rh/rh-sso7/root/usr/share/keycloak.