Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Note
titleAssumptions & Prerequisites

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

All the Moonshot packages are currently built using libssl1.0. However, in Debian 9 libevent-openssl is built using libssl1.1. This difference makes that Moonshot fails randomly. Hence, we provide a version of libevent-openssl built with libssl1.0 to replace the original one.

System Preparation

First, there are a few Debian configuration options that need to be set in advance.

Add the Moonshot Repository

  1. Add the Moonshot Debian Stretch repository to your system. To do this, run the following command (as root, or using sudo):

Warningnumberedheadings
titleExperimental

This guide is experimental, as the Debian 9 packages have not been moved to the official repository yet. Currently only AMD64 packages are available.

Numbered Headings

System Preparation

The Moonshot client mechanism and ID manager are part of the standard Debian 9 repository. However, if you prefer having the most updated packages, use the following procedure.

Get the Debian 9 packages

  1. Go to https://jisc365-my.sharepoint.com/:f:/g/personal/alex_perez-mendez_jisc_ac_uk/Eirerz1CGgFKpU8eHYC-1qoBPIMTvo8GgWpo-KY7szMWcQ and get the following files:

    1. libevent-openssl-2.0-5_2.0.21-stable-3_amd64_libssl1.0.deb

    2. moonshot-ui_1.0.6-2_amd64.deb

    3. moonshot-gss-eap_1.0.1-3_amd64.deb

    4. libmoonshot1_1.0.6-2_amd64.deb
Info
titlelibevent issue
Code Block
languagebash
$ echo "deb http://repository.project-moonshot.org/debian-moonshot stretch main" > /etc/apt/sources.list.d/moonshot.list
  • Install the Moonshot GPG key:

    Code Block
    languagebash
    $ wget -O - http://repository.project-moonshot.org/key.gpg | apt-key add -
  • Update the apt cache with the new repository information:

    Code Block
    languagebash
    $ apt-get update
  • Install the Moonshot Client libraries

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

    Try to install the packages (it will fail, but that is intended):

    Code Block
    languagebash
    $ 
    dpkg
    apt-
    i libevent-openssl-2.0-5_2.0.21-stable-3_amd64_libssl1.0.deb moonshot-ui_1.0.6-2_amd64.deb moonshot-gss-eap_1.0.1-3_amd64.deb libmoonshot1_1.0.6-2_amd64.deb
  • Finalise the installation of the packages and the dependencies:

    Code Block
    languagebash
    $ apt-get install -f
  • get install moonshot-gss-eap moonshot-ui

    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.

     

    ...