Page tree
Skip to end of metadata
Go to start of metadata

On this page you will find instructions on how to install the Moonshot Libraries on a RHEL / CentOS / Scientific Linux device to enable its use as a Moonshot client.


Assumptions & Prerequisites

This guide assumes you have root access to the Linux device. This is required as new software needs to be installed system-wide.

1. Install the Moonshot Client libraries

1.1. Add the Required Repositories

Supported versions

At the moment, CentOS/RHEL/SL 7 and 8 are supported.

Moonshot requires three yum repositories to be added to the system - EPEL and the Shibboleth repositories (home of some required dependencies), and the Moonshot repository itself.

  1. Install EPEL by running the following command:

    yum install epel-release

    Depending on your platform, the epel-release package is part of one of the optional repositories.

    On CentOS, it is part of the Extras repository. On RHEL, you must enable both the Optional and Extras repositories. For more information, visit the EPEL homepage.

    On newer releases of Scientific Linux 7, the epel-release package does not exist. Use yum install yum-conf-epel instead. For more information, see the Scientific Linux 7.2 release notes.

  2. Install the Moonshot repository information running one of the the following commands depending on your CentOS version:

    CentOS 7
    yum install -y
    CentOS 8
    yum install -y

    This installs the Yum repository, the current Moonshot GPG key, and a package that can update both. This is the preferred method of deploying repository information.

    Verifying the Moonshot GPG key

    If you wish to verify the Moonshot GPG key's validity and integrity, please see the Packaging GPG Key for further details.

  3. (Optional - Not required if you install the noshib versions) Install the official Shibboleth repository using one of the following commands, according to your CentOS version:

    CentOS 7
    curl -o /etc/yum.repos.d/shibboleth.repo
    CentOS 8
    curl -o /etc/yum.repos.d/shibboleth.repo

We’re now ready to install the Moonshot software and its required dependencies. Install the software by running the following command:

yum install moonshot-noshib

2. Next steps

At this point, you now have all of the required Moonshot software on your device, including the Moonshot Identity Selector. Depending on what client application you are using and wish to enable Moonshot authentication for, you job may now be done, or you may need to go and install a Moonshot compatible version of the client software or configure your existing client. Check the section on client compatibility if you are unsure.