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

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 13 Current »

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:// 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.


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

  • 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)

  • Install shib IF you use Shibboleth authentication (Optional)
> ./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