Child pages
  • Upgrade to OpenTUSK 5.0
Skip to end of metadata
Go to start of metadata


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 .



  • No labels