On Ubuntu linux you need to install and execute LogicalDOC as root user(command sudo su), make sure to log-in as root before continuing, since this guide assumes you perform all the operations as root.

To install in Ubuntu you have to provide at least these two components:

Java JDK (Java Development Kit)

Download and install Java JDK(version 11 or more recent) for your server system from 
http://www.oracle.com/technetwork/java/javase/downloads/index.html.

In any case visit http://www.oracle.com/technetwork/java/index.html for more informations.

You can check the presence of Java in your system by executing this command from a terminal:

$ java -version

LogicalDOC requires Java JDK 11 in order to work properly.
If the above command returns a different version of java, follow the instructions below to install the Java JDK 11.

Execute the following commands on the Terminal by copying and pasting them one at a time (Ubuntu 12.04)

$ sudo apt-get purge openjdk*
$ sudo add-apt-repository ppa:webupd8team/java
$ sudo apt-get update
$ sudo apt-get install oracle-java11-installer

MySQL

In order to setup a production system you have to provide a MySQL database where the application will store all data.
To perform this step, make sure to have a MySQL up and running, if this is not the case install it: http://www.mysql.com/downloads/mysql/

In order to setup a production system you have to prepare a MySQL database where the application will store all data.
To perform this step, make sure to have a MySQL up and running, if this is not the case install it: http://dev.mysql.com/downloads/mysql/

Once your MySQL instance is up and running, please open a terminal and execute this command:

$ sudo su

Type your password as requested in order to login as the root user.

Default settings

LogicalDOC requires you to configure your MySQL installation to best fit the needs of a professional DMS, so we need to edit the file /etc/my.cnf in this way:

$ vi /etc/mysql/my.cnf

Now edit your current my.cnf configuration file, and make sure to have the following settings in the [mysql] and [mysqld] sections:

[mysql]
default-character-set = utf8

[mysqld]
character-set-server = utf8
collation-server = utf8_bin
default-storage-engine = INNODB

This sets the encoding to UTF-8 and the default storage engine to the INNODB with transactions support.

Setting Password for MySQL Root User

Execute the following command at a shell prompt:

$ mysqladmin -u root password 'password'

Creating the database

Connect to mysql prompt typing the command:

$ mysql -u root -ppassword

Execute the following command at the mysql prompt:

CREATE DATABASE logicaldoc;

Now we have an empty database called logicaldoc with a user root that can access it using password password.
You can exit the mysql prompt(command \q) and go ahead.

Get from the download website the setup file: installer-linux-<ver>.zip

To install LogicalDOC unpack the zip archive, open a terminal window and execute the command from command line:

$ java -jar logicaldoc-installer.jar

If the system does not have a graphical interface, it is possible to launch the installation from the command console

$ java -jar logicaldoc-installer.jar -console

When the installer asks for database, please put your connection parameters as specified earlier during database preparation, don't use the embedded database for production.

Post-installation

To start LogicalDOC at server bootstrap you need to copy the startup script into your system initialization directory so execute the command:

$ sudo cp /LogicalDOC/bin/logicaldoc-all /etc/init.d
$ sudo chmod 755 /etc/init.d/logicaldoc-all

Then edit the file /etc/init.d/logicaldoc-all adjusting the paths.
Save the file and execute the commands:

$ sudo update-rc.d logicaldoc-all defaults
$ sudo service logicaldoc-all start

Now you can access the program using the browser, pointing it to http://localhost:8080/. Use the account admin with password admin to enter the first time.

Check the paths of external tools

After the installation it is better to check that all needed external apps are correctly configured.

Enter the administration: Administration > Settings > Antivirus

Here, check if the path specified in ClamAV is correct.

Enter the administration: Administration > Settings > OCR

Here, check if the path specified in path is correct.

Enter the administration: Administration > Import & Export > Format Converters > LibreOfficeConverter

Here, check if the path specified in path is correct.

Enter the administration: Administration > Import & Export > Format Converters > ImageConverter

Here, check if the path specified in path is correct.

Enter the administration: Administration > Import & Export > Format Converters > GhostscriptConverter

Here, check if the path specified in path is correct.

NOTE: paths may be different in your system

Save