Preparing the Mirage 2 build environment on Ubuntu 18.04

mirage2-ubuntu18.04.md

Build Environment for Mirage 2 on Ubuntu 18.04

My earlier notes for 16.04 basically work fine on Ubuntu 18.04 but I've corrected and improved a few things in this version.

DSpace 5's Mirage 2 requires some extra setup if you want to tweak the base config and rebuild it. As Mirage 2 is based on the Bootstrap framework it needs a few NodeJS and Ruby packages to be available in the build environment.

We build and deploy DSpace from the tomcat8 system user (which is the default user for Tomcat on Ubuntu), and there are a few assumptions that must be met to allow the installation of NodeJS and Ruby:

• The tomcat8 user must be able to write to its home folder (/var/lib/tomcat8) so it can create the ~/.nvm, ~/.npm, ~/.rvm, ~/.gnupg and other directories during installation
• The ~tomcat8/.profile file must exist and be writable before installing nvm and rvm, as this is the default config file for login shells, ie sudo su - tomcat8. These tools will append lines to those files to setup their environments on login.

This setup is based on the documentation that shipped with Mirage 2 in DSpace 5.

Node Version Manager (NVM)

$ wget -qO- https://raw.githubusercontent.com/creationix/nvm/v0.33.8/install.sh | bash

After the intstallation is finished, close and re-open your shell to activate NVM. Then install NodeJS v8 and use npm to install the DSpace dependencies:

$ nvm install v8
$ npm install -g bower grunt grunt-cli

Ruby Version Manager (RVM)

Make sure the following dependencies are installed on the system (required by the Ruby build process):

$ sudo apt update
$ sudo apt install libyaml-dev sqlite3 autoconf libgdbm-dev libncurses5-dev automake libtool bison pkg-config libffi-dev gawk g++ libreadline6-dev zlib1g-dev libssl-dev libsqlite3-dev libgmp-dev

N.B. list required RVM system dependencies by installing with autolibs in read-fail mode: $ \curl -sSL https://get.rvm.io | bash -s -- stable --ruby --autolibs=read-fail

Then install RVM:

$ gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3
$ \curl -sSL https://get.rvm.io | bash -s stable --ruby

After the intstallation is finished, close and re-open your shell to activate RVM. Then use gem to install the DSpace dependencies:

$ gem install sass -v 3.3.14
$ gem install compass -v 1.0.3