View Source

You current version is opentusk-4.x.x which is based on RedHat / CentOS 5. The following guidelines will help you install OpenTUSK on RedHat / CentOS 7

Required OS: RedHat / CentOS 7

Upgrade/Install Guidelines

If you database is setup as localhost, please move your database to this new server. Otherwise, you database setting in tusk.conf should take care of remote DB server.

Git clone OpenTUSK 5.0 from GitHub into /usr/local/tusk as either root user or a user with sudo privilege. We will change ownership to tusk user in the 'create_system_account' script.

> sudo mkdir -p /usr/local/tusk/conf    ### We create both tusk and tusk/conf directories as yourself
> sudo chown -R <your_user_id> /usr/local/tusk
> cd /usr/local/tusk
> git clone git://github.com/opentusk/opentusk.git opentusk

Git clone tusk, apache, shibboleth configurations into "/usr/local/tusk/conf" directory if you have "conf" repository. Otherwise, copy them from the old server.

> git clone your-git-conf-repo:opentusk/conf.git conf

Symbolic link the cloned directory to current and setup install settings in a YML file

> cd /usr/local/tusk
> ln -s onentusk current
> cd current/install
> cp templates/conf/tusk/tusk_install.yml  /usr/local/tusk/conf/tusk_install.yml
# Modify conf/tusk_install.yml appropriately. This will be used for installation setup.
> cd centos

Run install script. This will create tusk/apache users if not yet created, install required yum packages and install Perl/CPAN modules. The Perl/CPAN installation takes some time but be careful to enter your passwords a few times correctly.

sudo ./tusk_install_run

Create data directories IF you need data/content directories (Optional)

sudo ../scripts/create_directories.sh

Create SSL certificates IF you need to generate ones. Be sure to put some info including domain, country, state, etc in install_tusk.yml (Optional)

sudo ./create_ssl_cert

Install shib IF you use Shibboleth authentication (Optional)

> sudo ./install_shib

## if your shib settings are in /usr/local/tusk/conf/etc/shibboleth
>  cd /etc/shibboleth

##  Remove or rename these files before soft linking them to /etc/shibboleth directory.
> sudo ln -s /usr/local/tusk/conf/etc/shibboleth/shibboleth2.xml .
> sudo ln -s /usr/local/tusk/conf/etc/shibboleth/tusk-idp.xml .

## start shib
> sudo systemctl start shibd.service

## troubleshooting
> shibd -t    ## find any shib errors
> LD_LIBRARY_PATH=/opt/shibboleth/lib64 shibd -t   ## get a critical message about libcurl
### error messages are in /var/log/shibboleth/shibd.log

Setup Apache configurations

> cd /etc/httpd/conf.d/
> sudo mv ssl.conf ssl.conf.orig
> sudo ln -s /usr/local/tusk/conf/etc/httpd/conf.d/ssl.conf .
> sudo ln -s /usr/local/tusk/conf/etc/httpd/conf.d/tusk_base.conf .
> sudo ln -s /usr/local/tusk/conf/etc/httpd/conf.d/tusk_http.conf .
> sudo ln -s /usr/local/tusk/conf/etc/httpd/conf.d/tusk_https.conf .
> sudo ln -s /usr/local/tusk/conf/etc/httpd/conf.d/tusk_common .
> sudo ln -s /usr/local/tusk/conf/etc/httpd/conf.d/tusk_logging .