Skip to content

Latest commit

 

History

History
215 lines (127 loc) · 6.5 KB

install-software.rst

File metadata and controls

215 lines (127 loc) · 6.5 KB
Raw

Install Software

Open OnDemand uses these packages, among many others.

Some operating systems use Software Collections to satisfy these.

Note

This tutorial is run from the perspective of an account that has sudo access but is not root.

Warning

Be sure to check Supported Operating Systems and Architectures <os-support> before proceeding with install to verify you are on a supported operating system and architecture.

Warning

If you are an administrator responsible for Open OnDemand, you are now an administrator of Apache Httpd as well. As such, you should get comfortable with it as from time to time you will have to troubleshoot it.

1. Enable Dependencies

CentOS 7

sudo yum install centos-release-scl epel-release

RockyLinux/Alma Linux 8

sudo dnf config-manager --set-enabled powertools
sudo dnf install epel-release
sudo dnf module enable ruby:3.1 nodejs:18

RockyLinux/Alma Linux 9

sudo dnf config-manager --set-enabled crb
sudo dnf install epel-release
sudo dnf module enable ruby:3.1 nodejs:18

RHEL 8

sudo dnf install epel-release
sudo dnf module enable ruby:3.1 nodejs:18
sudo subscription-manager repos --enable codeready-builder-for-rhel-8-x86_64-rpms

RHEL 9

sudo dnf install epel-release
sudo dnf module enable ruby:3.1 nodejs:18
sudo subscription-manager repos --enable codeready-builder-for-rhel-9-x86_64-rpms

2. Add repository and install

RedHat/CentOS 7

sudo yum install https://yum.osc.edu/ondemand/{{ ondemand_version }}/ondemand-release-web-{{ ondemand_version }}-1.el7.noarch.rpm

sudo yum install ondemand

RedHat/Rocky Linux/AlmaLinux 8

sudo dnf install https://yum.osc.edu/ondemand/{{ ondemand_version }}/ondemand-release-web-{{ ondemand_version }}-1.el8.noarch.rpm

sudo dnf install ondemand

RedHat/Rocky Linux/AlmaLinux 9

sudo dnf install https://yum.osc.edu/ondemand/{{ ondemand_version }}/ondemand-release-web-{{ ondemand_version }}-1.el9.noarch.rpm

sudo dnf install ondemand

Ubuntu 20.04

sudo apt install apt-transport-https ca-certificates
wget -O /tmp/ondemand-release-web_{{ ondemand_version }}.1-focal_all.deb https://apt.osc.edu/ondemand/{{ ondemand_version }}/ondemand-release-web_{{ ondemand_version }}.1-focal_all.deb
sudo apt install /tmp/ondemand-release-web_{{ ondemand_version }}.1-focal_all.deb
sudo apt update

sudo apt install ondemand

Ubuntu 22.04

sudo apt install apt-transport-https ca-certificates
wget -O /tmp/ondemand-release-web_{{ ondemand_version }}.1-jammy_all.deb https://apt.osc.edu/ondemand/{{ ondemand_version }}/ondemand-release-web_{{ ondemand_version }}.1-jammy_all.deb
sudo apt install /tmp/ondemand-release-web_{{ ondemand_version }}.1-jammy_all.deb
sudo apt update

sudo apt install ondemand

Debian 12

sudo apt install apt-transport-https ca-certificates
wget -O /tmp/ondemand-release-web_{{ ondemand_version }}.1-bookworm_all.deb https://apt.osc.edu/ondemand/{{ ondemand_version }}/ondemand-release-web_{{ ondemand_version }}.1-bookworm_all.deb
sudo apt install /tmp/ondemand-release-web_{{ ondemand_version }}.1-bookworm_all.deb
sudo apt update

sudo apt install ondemand

Amazon Linux 2023

sudo dnf install https://yum.osc.edu/ondemand/{{ ondemand_version }}/ondemand-release-web-{{ ondemand_version }}-1.amzn2023.noarch.rpm

sudo dnf install ondemand

3. Start services

RHEL/CentOS 7

sudo systemctl start httpd24-httpd
sudo systemctl enable httpd24-httpd

RHEL/Rocky 8 & 9

sudo systemctl start httpd
sudo systemctl enable httpd

Ubuntu & Debian

sudo systemctl start apache2
sudo systemctl enable apache2

Amazon Linux 2023

sudo systemctl start httpd
sudo systemctl enable httpd

4. Verify installation

Now that Open OnDemand is installed and Apache is running, it should be serving a public page telling you to come back here and setup authentication.

If this is the case - then you need to add authentication <authentication>. The installation will not move forward without adding authentication.

After adding authentication, but before actually testing that it works, you should secure your Apache <add-ssl>. This way you never send credentials over plain HTTP.

You may also want to enable SELinux <modify-system-security>.

If you're seeing the default Apache page (Ubuntu & Debian users will) you will have to debug virtualhosts <show-virtualhosts> and likely configure a servername <ood-portal-generator-servername>.

Building From Source

Building from source is left as an exercise to the reader.

It's not particularly difficult to build the code, but installing it with all the various files is. Should you be interested, review the Dockerfile and packaging specs for what would be involved.

If you'd like a package built for a system that we don't currently support, feel free to open a ticket!