Ubuntu Installation (Tanaguru 3.x)

mfaure's picture

This page describes the steps to follow to install Tanaguru since Version 3.0.0-beta3 from the binary files or from the sources. The sofware has been tested on 12.04 LTS (Precise Pangolin).

PLEASE ensure you meet all prerequisites for Tanaguru 3.x on Ubuntu.

Tanaguru Web Application

wget http://www.tanaguru.org/Download/tanaguru-latest.tar.gz
tar xzf tanaguru-latest.tar.gz
cd tanaguru*
sudo ./install.sh --mysql-tg-db <Tanaguru_mysql_db> \
         --mysql-tg-user <Tanaguru_mysql_user> \
        --mysql-tg-psswd <Tanaguru_mysql_password> \
         --mysql-root-user <mysql_root_user> \
         --mysql-root-passwd <mysql_root_password> \
        --tanaguru-url <Tanaguru_webapp_url> \
        --tomcat-webapps <tomcat_webapps_directory> \
         --tomcat-user <tomcat_unix_user> \
        --tg-admin-email <Tanaguru_admin_email> \
        --tg-admin-passwd <tanaguru_admin_password> \
     --firefox-esr-path <path_to_Firefox_ESR> \
     --display-port <Xorg_display_port>

Installation options

--mysql-root-user Mysql user with privileges of database creation and user creation (e.g. mysql root user)
--mysql-root-passwd Password of the user specified by --mysql-root-user
--mysql-tg-user Mysql user for Tanaguru
--mysql-tg-passwd Password of the user specified by --mysql-tg-user. if this user already exists, please ensure you give its correct password. If not, the user will be automatically created.
--mysql-tg-db Database for Tanaguru
--tanaguru-url URL where tanaguru will be deployed (e.g. http://localhost:8080/)
--tomcat-webapps Tomcat webapps directory (e.g. /var/lib/tomcat6/webapps)
--tomcat-user Unix user name for the tomcat service (e.g. tomcat6)
--tg-admin-email Email of the Tanaguru admin user (by the way, it's you !)
--tg-admin-passwd The tanaguru application admin password
--firefox-esr-path Path to Firefox-ESR binary (e.g. /opt/firefox-esr/firefox)
--display-port Xorg display port (e.g. ":99.1")

Example of install-script invocation

sudo ./install.sh --mysql-root-user root \
--mysql-root-passwd MyPassWord \
--mysql-tg-user tanaguru \
 --mysql-tg-passwd MyTGPassWord \
--mysql-tg-db tanaguru \
--tanaguru-url http://localhost:8080/tanaguru \
 --tomcat-webapps /var/lib/tomcat6/webapps/ \
--tomcat-user tomcat6 \
--tg-admin-email me@email.com \
--tg-admin-passwd toto42 \
--firefox-esr-path /opt/firefox/firefox \
--display_port :99.1

Tanaguru "Command Line Interface"

Tanaguru runs as a non-installed shell script, which allows you to run Tanaguru as a non-root user.

Mysql scripts invocation

Edit "tanaguru-10-create-user-and-base.sql" with the correct user and password for your tanaguru mysql and execute the script with a mysql user with user and database creation privileges.

wget http://www.tanaguru.org/Download/tanaguru-latest.tar.gz
tar xzf tanaguru-latest.tar.gz
cd tanaguru*
mysql -u ${root-user} -p < install/engine/sql/tanaguru-10-create-user-and-base.sql

Execute the table creation script and data insertion scripts

mysql -u ${tanaguru-user} -p < install/engine/sql/tanaguru-20-create-tables.sql
mysql -u ${tanaguru-user} -p < install/engine/sql/tanaguru-30-insert.sql 
mysql -u ${tanaguru-user} -p < install/rules/sql/10-rules-resources-insert.sql
mysql -u ${tanaguru-user} -p < install/rules/sql/accessiweb2.2-insert.sql
mysql -u ${tanaguru-user} -p < install/rules/sql/rgaa2.2-insert.sql
mysql -u ${tanaguru-user} -p < install/rules/sql/seo-10-insert.sql

Configuration

Edit tanaguru.conf file and replace all stars '*********' with the correct user and password for your tanaguru mysql and replace the content of the jdbc.url variable with the right settings.

vi conf/context/tanaguru.conf

Running Tanaguru

See running Tanaguru