TriDoc Install Guide - Linux operating system

TriDoc System hardware requirements

The system’s hardware requirements, like for any other server applications, depends on the planned number of users and the amount of documents to be stored.
We recommend that you configure your hardware based on below information!

For your information see the following to 2 configurations:
               Recommended system configuration for installations above 20 users:
               Intel Xeon Quad-Core 3 Ghz CPU, 8 GB RAM, 1 TB RAID 5 Storage, Gigabit Ethernet
               An Internet connection is needed to activate the product!
               Minimum requirements:
               2 GHZ CPU, 2 GB RAM, 200GB HDD,
               An Internet connection is needed to activate the product!

Applications to be installed

Installation can be done with the built-in Debian-based package manager. (In case of other Linux distributions please, follow the relevant instructions.)
               •     Database server: MySQL 5.0. Database server
               •     Application server: Apache Tomcat 5.5 Application server
               •     TriDoc standard 2.0.24

MySQL installation

To install the MySQL database manager use the following command.
apt-get install mysql-server

1. Start MySQL Server
To install the TriDoc database you needed to start the database daemon.
Type the following command to start MySQL.
               •     To start MySQL: /etc/init.d/mysql start
               •     To stop MySQL: /etc/init.d/mysql stop

2. Open Terminal application and create the TriDoc database
               •      Execute the following command in Terminal to get a MySQL prompt:
                      mysql --user=root mysql -p
               •      Execute the following statements in the MySQL prompt to create a user and a database:
                      CREATE USER ’tridoc’@’localhost’ IDENTIFIED BY ’changeit’;
                   GRANT USAGE ON * . * TO ’tridoc’@’localhost’ IDENTIFIED BY ’changeit’ WITH MAX_QUERIES_PER_HOUR 0 MAX_CONNECTIONS_PER_HOUR 0 MAX_UPDATES_PER_HOUR 0 MAX_USER_CONNECTIONS 0;
                   CREATE DATABASE IF NOT EXISTS ’tridoc’ DEFAULT CHARACTER SET utf8 COLLATE utf8_unicode_ci;
                   GRANT ALL PRIVILEGES ON ’tridoc’ . * TO ’tridoc’@’localhost’;

Apache Tomcat installation

Apache Tomcat (or Jakarta Tomcat or simply Tomcat) is an open source servlet container developed by the Apache Software Foundation (ASF). Tomcat implements the Java Servlet and the JavaServer Pages (JSP) specifications from Sun Microsystems, and provides a “pure Java” HTTP web server environment for Java code to run.

1. Download and install Sun JDK if needed:
Please note! In case of certain Linux distributions, if you install the Sun JDK, you will need to enable the use of certain repositories (eg.: non-free repository, repository component).
                   apt-get install sun-java5-jdk

2. Download and install Apache Tomcat using the package manager:
                   apt-get install tomcat-5.5 tomcat-5.5-admin

3. Prepare the Tomcat Server start
In order to start the Tomcat server, choose the appropriate service starting mode of the Linux distribution. If necessary, check the installed startup and shutdown scripts in the bin directory of the Tomcat application.
Eg.:
               •      To start Tomcat:
                      /etc/init.d/tomcat start
               •      To stop Tomcat:
                      /etc/init.d/tomcat stop

TriDoc installation

1. Insert the Trilobita TriDoc DVD into the optical drive.

2. Copy the contents of tridoc-2.0-bin.zip from the DVD to /var/lib/tomcat5.5/webapps.
Don’t forget to adjust the file privileges according to the Tomcat service user!

3. Modify the content of hibernate.cfg.xml located in /var/lib/tomcat5.5/webapps/TriDoc/WEB-INF/
classes as follows:
               The information in the following bold tags written can be modified:
               •     TriDoc path:
                    <property name=”hibernate.connection.url”><![CDATA[jdbc:mysql://localhost/tridoc?useUnicode=yes&characterEncoding=UTF-8]]></property>
               •     User name:
                    <property name=”hibernate.connection.username”>tridoc</property>
               •     User password:
                         <property name=”hibernate.connection.password”>changeit</property>
4. Copy the bcprov-jdk15-141.jar file to /var/lib/tomcat/shared/lib.

5. Start Apache Tomcat using the start_tomcat command prepared in 5.3.

6. Navigate your web browser to http://localhost:8080/TriDoc/.

7. You need to have Flash Player 9.x or any newer version installed on your PC to access the TriDoc system.

8. Follow the instructions on the screen.

First start - Quick configuration

After installation, check the following:

•  The MySQL service has started
•  The Tomcat service has started
•  TriDoc is available in browser application (Flash plug-in required)

The TriDoc system then automatically detects that it’s a newly installed system and displays the Quick configuration wizard. Follow the instructions on the screen.

First use

---

 

TriDoc Install Guide - MAC OS X operating system

TriDoc System hardware requirements

The system’s hardware requirements, like for any other server applications, depends on the planned number of users and the amount of documents to be stored.
We recommend that you configure your hardware based on below information!

For your information see the following to 2 configurations:
              Recommended system configuration for installations above 20 users:
              MAC OS X 10.4 or higher release version, Intel Xeon Quad-Core 3 Ghz CPU, 8 GB RAM, 1     TB RAID 5 Storage, Gigabit Ethernet
              An internet connection is needed to activate the product!
              Minimum requirements:
              MAC OS X 10.4 or higher release version, 2 GHZ CPU, 2 GB RAM, 200GB HDD,
              An internet connection is needed to activate the product!

Applications to be installed

              •     Database server: MySQL 5.1.(42) Database server
              •     Application server: Apache Tomcat 6.0.(20) Application server
              •     TriDoc standard 2.0.24

MySQL installation

You can install MySQL on Mac OS X 10.3.x (“Panther”) or newer using a Mac OS X binary package in PKG format instead of the binary tarball distribution. When installing from the package version, you should also install the MySQL Preference Pane, which will allow you to control the startup and execution of your MySQL server from System Preferences. When installing using the package installer, the files are installed into a directory within /usr/local matching the name of the installation version and platform.

1. Download MySQL 5.1 Mac OS X package from:
http://dev.mysql.com/downloads/mysql/5.1.html#macosx-dmg

2. Mount the DMG file (double click)
The package is located inside a disk image (.dmg) file that you first need to mount by double-clicking its icon in the Finder. It should then mount the image and display its contents.

3. Double-click on the MySQL installer package.
It will be named according to the version of MySQL you have downloaded.

4. Proceed the dialogs.
Follow the instructions on the screen.

5. Install the MySQL Startup Item
•     Double-click on the MySQLStartItem.pkg file to start the installation process.
•     You will be presented with the Install MySQL Startup Item dialog. Click Continue to continue the installation process.
•     A copy of the installation instructions and other important information relevant to this installation are display. Click Continue.
•     Select the drive you want to use to install the MySQL Startup Item. The drive must have a valid, bootable, Mac OS X operating system installed. Click Continue.
•     You will be asked to confirm the details of the installation. To change the drive on which the startup item is installed you can click either Go Back or Change Install Location.... To install the startup item, click Install.
•     Once the installation has been completed successfully, you will be given an Install Succeeded message.
•     The Startup Item for MySQL is installed into /Library/StartupItems/MySQLCOM.
     The Startup Item installation adds a variable MYSQLCOM=-YES- to the system configuration file /etc/hostconfig. If you want to disable the automatic startup of MySQL, simply change this variable to MYSQLCOM=-NO-.
•     To automatically start the MySQL server when the system boots:
     Check the checkbox next to Automatically Start MySQL Server on Startup.

6. Install the MySQL Preference Pane
The MySQL Package installer disk image also includes a custom MySQL Preference Pane that enables you to start, stop
and control automated startup during boot of your MySQL installation.
•     Double click on MySQL.prefPane. The MySQL System Preferences will open.
•     If this is the first time you have installed the preference pane, you will be asked to confirm installation and whether you want to install the preference pane for all users, or only the current user. To install the preference pane for all users you will need administrator privileges. If necessary, you will be prompted for the username and password for a user with administrator privileges.
•     If you already have the MySQL Preference Pane installed, you will be asked to confirm whether you want to overwrite the existing MySQL Preference Pane.
•     Once the MySQL Preference Pane has been installed, you can control your MySQL server instance using the
     preference pane. To use the preference pane, open the System Preferences... from the Apple menu. Select the
     MySQL preference pane by clicking on the MySQL logo within the Other section of the preference panes list.
The MySQL Preference Pane shows the current status of the MySQL server, showing stopped (in red) if the server is not running and running (in green) if the server has already been started. The preference pane will also show the current setting for whether the MySQL server has been set to start up automatically.

7. Start MySQL Server
•     To start MySQL using the preference pane:
     Click Start MySQL Server. You may be prompted for the username and password of a user with administrator privileges to start the MySQL server.
•     To stop MySQL using the preference pane:
     Click Stop MySQL Server. You may be prompted for the username and password of a user with administrator privileges to shutdown the MySQL server.
•     To disable the automatic starting of the MySQL server when the system boots:
     Uncheck the checkbox next to Automatically Start MySQL Server on Startup.
     You can close the System Preferences... once you have completed your settings.

8. Open Terminal application and create the TriDoc database
              •     Execute the following command in Terminal to get a MySQL prompt:
                 /usr/local/mysql/bin/mysql --user=root mysql
              •     Execute the following statements in the MySQL prompt to create a user and a database:
                 CREATE USER ’tridoc’@’localhost’ IDENTIFIED BY ’changeit’;
                 GRANT USAGE ON * . * TO ’tridoc’@’localhost’ IDENTIFIED BY ’changeit’ WITH MAX_QUERIES_PER_HOUR 0            MAX_CONNECTIONS_PER_HOUR 0 MAX_UPDATES_PER_HOUR 0 MAX_USER_CONNECTIONS 0;
                 CREATE DATABASE IF NOT EXISTS ’tridoc’ DEFAULT CHARACTER SET utf8 COLLATE utf8_unicode_ci;
                 GRANT ALL PRIVILEGES ON ’tridoc’ . * TO ’tridoc’@’localhost’;

Apache Tomcat installation

Apache Tomcat (or Jakarta Tomcat or simply Tomcat) is an open source servlet container developed by the Apache Software Foundation (ASF). Tomcat implements the Java Servlet and the JavaServer Pages (JSP) specifications from Sun Microsystems, and provides a “pure Java” HTTP web server environment for Java code to run.

1. Download Apache Tomcat 6.0
You need to download a core type of zip package from the binary distributions.
http://tomcat.apache.org/download-60.cgi

2. Copy ZIP contents to /usr/local/

3. Create start_tomcat command in /usr/local/bin
                 #!/bin/sh
                 CATALINA_HOME=/usr/local/apache-tomcat-6.0.20
                 JAVA_HOME=/usr
                 export CATALINA_HOME JAVA_HOME
                 $CATALINA_HOME/bin/startup.sh
(The actual version number depends on the software version that has effectively been downloaded.)

TriDoc installation

1. Insert the Trilobita TriDoc DVD into the optical drive.

2. Copy the contents of tridoc-2.0-bin.zip file from the Manual_Install/Application directory on the DVD to /usr/local/apache-tomcat-6.0.20/webapps directory. (The actual version number depends on the software version that has effectively been downloaded.)

3. Modify the content of hibernate.cfg.xml located in /usr/local/apache-tomcat-6.0.20/webapps/ TriDoc/WEB-INF/classes as follows:
               The information in the following bold tags written can be modified:
               •     TriDoc path:
                    <property name=”hibernate.connection.url”><![CDATA[jdbc:mysql://localhost/tridoc?useUnicode=yes&
                    characterEncoding=UTF-8]]></property>
               •     User name:
                    <property name=”hibernate.connection.username”>tridoc</property>
               •     User password:
                    <property name=”hibernate.connection.password”>changeit</property>
4. Copy the bcprov-jdk15-141.jar file to /var/local/apache-tomcat-6.0.20/shared/lib.

5. Start Apache Tomcat using the start_tomcat command created in 5.3.

6. Navigate your web browser to http://localhost:8080/TriDoc/.

7. You need to have Flash Player 9.x or any newer version installed on your Mac to access the TriDoc system.

8. Follow the instructions on the screen.

First start - Quick configuration

After installation, check the following:

•  The MySQL service has started
•  The Tomcat service has started
•  TriDoc is available in browser application (Flash plug-in required)

The TriDoc system then automatically detects that it’s a newly installed system and displays the Quick configuration wizard. Follow the instructions on the screen.

First use