RHEL 7 / CentOS 7 / Scientific Linux 7 (RHEL/CentOS/SL 7) does not ship with a version of OpenSSH that is compatible with Moonshot (they ship with a non-Moonshot-enabled v6.6 of OpenSSH). To get Moonshot support for it, you must install a specific Moonshot-enabled version. We have a precompiled version available in our repositories.

Contents

All of the instructions below assume that you have root access, and will work as the root user (either directly or using sudo).

The instructions on this page will replace the system provided OpenSSH packages with the Moonshot enabled ones (don't worry, standard SSH things will still work!)

Following the instructions on this page will give you a Moonshot-enabled OpenSSH Server only.

1. System Preparation

1.1. Add the Moonshot libraries.

If you have not already done so, you first need to follow the instructions on how to install the Moonshot Libraries on RHEL/CentOS/SL 7.

1.2. Install the Yum priorities plug-in

Install the Yum Priorities plugin to enable repository priority management:
```
$ yum install yum-plugin-priorities
```
For more information on the yum-plugin-priorities package, please see https://wiki.centos.org/PackageManagement/Yum/Priorities
Check that the yum-priorities plugin is enabled in your yum configuration:
```
$ grep enabled /etc/yum/pluginconf.d/priorities.conf
enabled = 1
$ 
```
If the plugin is not enabled, change the enabled line in /etc/yum/pluginconf.d/priorities.conf to 1.

1.3. Add the Moonshot OpenSSH Repository

We've moved the OpenSSH packages from the main Moonshot repository into their own, so add the Moonshot RedHat OpenSSH repository to your system by creating a new file at /etc/yum.repos.d/moonshot-ssh.repo with the following content:
```
[Moonshot-OpenSSH]
name=Moonshot-OpenSSH
baseurl=http://repository.project-moonshot.org/rpms/centos7-openssh/
failovermethod=priority
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/Moonshot
priority=1
```

1.4. Ensure that your hostname is correct

The channel bindings check requires that the hostname of your SSH server match the hostname people are SSHing to. That is, the output of the "hostname" and "hostname -f" commands should match the FQDN of the server. If it doesn't, change the relevant line in /etc/sysconfig/network to make it so.

2. Installation Instructions

Install the Moonshot-enabled pre-compiled OpenSSH packages using yum. This will replace the system-provided OpenSSH:
```
$ yum update openssh*
```
If you have already installed the latest version of OpenSSH from the CentOS updates repository and its version is either the same or is newer than the version in our repository, you must use the yum downgrade command to switch the packages to our version:
```
$ yum downgrade openssh*
```

3. Configuration Instructions

Once installed, the Moonshot-enabled OpenSSH server will still need a few quick tweaks in order to turn on the Moonshot support.

Follow the configuration instructions on the OpenSSH Server page to configure the server.

OpenSSH Server on RHEL/CentOS/SL 7