milestone 4 - Installing The "Tuque" library

On This Page

Pre-Installation Software Checklist

You must have the following installed before you install the Tuque library:

• Fedora Respository Software
• Drupal Web CMS System

About the "Tuque" library

The Tuque library is a bundle of code that acts as the conduit between Islandora and Fedora Commons. In order for Islandora to properly communicate with Fedora Commons, you must have the Tuque library installed. For more information on the Tuque library, please see the documentation on github [https://github.com/islandora/tuque].

Installing the Tuque library

To install the Tuque library, run the following on your command line where Drupal is installed:

# mkdir -p /var/www/drupal/sites/all /var/www/drupal/sites/all/libraries
# cd /var/www/drupal/sites/all/libraries
# wget https://github.com/islandora/tuque/archive/1.5.zip
# unzip 1.5.zip
# mv tuque-1.5 tuque

Testing the Tuque installation

• You will require phpunit, which in turn has changed the installation method since ubuntu 12.04. You can find more information on how to install phpunit with composer here: https://coderwall.com/p/88x20g/installing-phpunit-on-ubuntu-with-composer

• Download and modify https://github.com/Islandora/tuque/blob/1.x/tests/phpunit.xml to have the credentials and URL of your Fedora: /var/www/sites/all/libraries/tuque/tests/phpunit.xml (don't forget the FEDORAPASS value)

  <phpunit>
    <php>
      <const name="FEDORAURL" value="http://localhost:8080/fedora"/>
      <const name="FEDORAUSER" value="fedoraAdmin"/>
      <const name="FEDORAPASS" value="wei9bo0eethooD"/>
    </php>
    <logging>
      <log type="coverage-html" target="../build/coverage" title="Tuque"
           charset="UTF-8" yui="true" highlight="true"
           lowUpperBound="35" highLowerBound="70"/>
      <log type="coverage-clover" target="../build/logs/clover.xml"/>
      <log type="junit" target="../build/logs/junit.xml" logIncompleteSkipped="false"/>
    </logging>
  </phpunit>

• From your Tuque install directory run the test:

  # cd /var/www/drupal/sites/all/libraries/tuque
  # phpunit -c tests/phpunit.xml tests/

• If the majority of tests fail with HttpConnectionException: Unauthorized, just delete your $FEDORA_HOME/data/fedora-xacml-policies/repository-policies/default directory, and restart Tomcat, it will repopulate itself. Do make sure to backup any customizations to your policies before you do that.

  You can also reload your policies with the fedora-reload-policies.sh in $FEDORA_HOME/server/bin

   

  NOTE: Tuque should pass the majority of the tests. If you see partial failure your installation may still work for most part, however you may want to contact the support community for help so to ensure you get 100% pass.

Advanced Tuque Topics

For advanced usage of Tuque you can consult the All About Tuque Appendix.