Manual Setup

Red Hat RAIS installation and setup

This guide may become out of sync with real-world setup, so please refer to Installation for general installation help, or the Dockerfile if you really need low-level information!

This is primarily here to document how we use RAIS with our Open ONI site, as opposed to a general-purpose installation guide.

Dependencies

RAIS needs OpenJPEG with dev headers:

yum install -y openjpeg2-devel

We need a relatively recent version of Go, not what RHEL has. On the plus side, you can install this as any user, not just root. In fact it's probably safer to install as a non-root user just so you aren't adding random binaries to your PATH when you run go get ....

cd ~
curl -OL https://dl.google.com/go/go1.14.2.linux-amd64.tar.gz
tar -xzf go1.14.2.linux-amd64.tar.gz

Build

cd ~

# These may make sense in a .bashrc or similar to ease compiling RAIS in the future
export GOROOT=~/go
export GOPATH=~/gopath
export PATH=$PATH:~/go/bin

git clone [email protected]:uoregon-libraries/rais-image-server.git
cd rais-image-server
make

Configure

Let apache talk to RAIS:

semanage port -a -t http_port_t -p tcp 12415

Set up the rais config file by copying and modifying the example:

cp ~/rais-image-server/rais-example.toml /etc/rais.toml
vim /etc/rais.toml

TilePath, IIIFBaseURL and IIIFWebPath should probably be changed. CapabilitiesFile should probably be commented out or deleted.

Install the service

Replace $raispath with whatever path you cloned RAIS into, e.g.:

export raispath=/home/rais/rais-image-server

Copy files, register and start RAIS:

mkdir /usr/local/rais
cp -r $raispath/bin/* /usr/local/rais
cp $raispath/rh_config/rais.service /usr/local/rais
systemctl enable /usr/local/rais/rais.service
systemctl start rais