Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info
titleEditor's "To Do" list
  •  add similar style guide / organization as other "installation" pages
  •  create "pre-installation software checklist" section
  •  add extra notes about requiring Drupal and Fedora first
  •  create note about user customization options (i.e. what "[your_drupal_directory]" references)
  •  move "advanced tuque info" from Islandora Install page to today.
  •  Need a way to test tuque functionality from the command line

On This Page

Table of Contents
excludeOn This Page

...

Installing the Tuque library

Info

NOTE

You must have:

  • Drupal Fedora Commons installed and properly configured in order to install properly test Tuque. Fedora Commons
  • Drupal installed and properly configured in order to properly test install Tuque.

 

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

Code Block
languagebash
# 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.35.zip
# unzip 1.35.zip
# mv tuque-1.35 tuque

Testing the Tuque installation

  • Tuque installation is simple enough that it does not require a stand alone test. You will know it's working as you test the Islandora Core Module installation on milestone 5. The test is the green check mark in /admin/islandora/configure. It is as simple as that.

    Image Added

  • You will require phpunit, which in turn has changed the installation method with 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

    Code Block
    languagebash
    <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:

    Code Block
    languagebash
    # cd /var/www/sites/all/libraries/tuque
    # phpunit -c tests/phpunit.xml tests/

    NOTE: you should pass the majority of the test. If you see partial failure you 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.