Merge pull request #34 from jenmalloy/RHSSO-725

fixed RHSSO-725: add installing using an RPM instructions
This commit is contained in:
Jen Malloy 2017-03-14 10:41:08 -04:00 committed by GitHub
commit e126e00453
4 changed files with 54 additions and 14 deletions

View file

@ -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]

View file

@ -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.
{% 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 %}

View file

@ -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.

View file

@ -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 <RHEL_VERSION> with either 6 or 7 depending on your Red Hat Enterprise Linux version.
subscription-manager repos --enable=jb-eap-7.0-for-rhel-<RHEL_VERSION>-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 <RHEL_VERSION> with either 6 or 7 depending on your Red Hat Enterprise Linux version.
subscription-manager repos --enable=rh-sso-7.1-for-rhel-<RHEL-VERSION>-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.