Chapter 2. Installation

Installing Red Hat Single Sign-On is as simple as downloading it and unzipping it. This chapter reviews system requirements as well as the directory structure of the distribution.

2.1. System Requirements

These are the requirements to run the Red Hat Single Sign-On authentication server:

  • Can run on any operating system that runs Java
  • Java 8 JDK
  • zip or gzip and tar
  • At least 512M of RAM
  • At least 1G of diskspace
  • A shared external database like Postgres, MySql, Oracle, etc. Red Hat Single Sign-On requires an external shared database if you want to run in a cluster. Please see the database configuration section of this guide for more information.
  • Network multicast support on your machine if you want to run in a cluster. Red Hat Single Sign-On can be clustered without multicast, but this requires a bunch of configuration changes. Please see the clustering section of this guide for more information.

2.2. Installing Distribution Files

The Red Hat Single Sign-On Server is contained in one distribution file:

  • 'rh-sso-7.0.0.[zip|tar.gz]'

The 'rh-sso-7.0.0.[zip|tar.gz]' file is the server only distribution. It contains nothing other than the scripts and binaries to run the Red Hat Single Sign-On Server.

To unpack of these files run the unzip or gunzip and tar utilities.

2.3. Distribution Directory Structure

This chapter walks you through the directory structure of the server distribution.

distribution directory structure

distribution

Let’s examine some of the purposes of each directory

bin/
This contains various scripts to either boot the server or perform some other management action on the server.
domain/
This contains configuration files and working directory when running Red Hat Single Sign-On in domain mode.
modules/
These are all the Java libraries used by the server.
standalone/
This contains configuration files and working directory when running Red Hat Single Sign-On in standalone mode.
themes/
This directory contains all the html, style sheets, javascript files, and images used to display any UI screen displayed by the server. Here you can modify an existing theme or create your own. See the Server Developer Guide for more information on this.