In this guide, I’ll take you through the steps to install LogicalDOC Community Edition on Ubuntu 20.04/18.04/16.04 LTS server. LogicalDOC is a document management system designed for sharing documents within an organization. It also acts as a content repository, with Activity workflow and Lucene indexing. LogicalDOC is written in Java.
Follow the steps below to install and configure LogicalDOC on Ubuntu 20.04|18.04|16.04 LTS.
Step 1: Install Java 11 on Ubuntu
The version of LogicalDOC we’ll install requires Java 11 in order to work.
For Ubuntu 20.04, run:
sudo apt update
sudo apt install openjdk-11-jdkUbuntu 18.04/16.04:
sudo add-apt-repository ppa:linuxuprising/java
sudo apt update
sudo apt install oracle-java11-set-defaultWhen it has been installed, you can check version using:
$ java -version
openjdk version "11.0.7" 2020-04-14
OpenJDK Runtime Environment (build 11.0.7+10-post-Ubuntu-3ubuntu1)
OpenJDK 64-Bit Server VM (build 11.0.7+10-post-Ubuntu-3ubuntu1, mixed mode, sharing)Step 2: Install LogicalDOC dependency packages
LogicalDOC also require the following third-party Software installed on your system
- LibreOffice: For Preview of Documents
- ImageMagick: Used to manipulate images for previewing
- GhostScript: For printing documents to a virtual device
- Tesseract: Open Source OCR engine adopted by Google
- Xpdf: This is a converter from Pdf to HTML format
Let’s install these packages on to the system:
sudo apt install libreoffice imagemagick ghostscript tesseract-ocrInstalling xpdf:
# Ubuntu 18.04
sudo apt install xpdf
# Ubuntu 20.04
wget http://security.ubuntu.com/ubuntu/pool/main/p/poppler/libpoppler111_21.06.1-1_amd64.deb
sudo apt install -f ./libpoppler111_21.06.1-1_amd64.deb
wget http://archive.ubuntu.com/ubuntu/pool/universe/x/xpdf/xpdf_3.04-7_amd64.deb
sudo apt install ./xpdf_3.04-7_amd64.debStep 3: Install and Configure database
Install MariaDB database server:
sudo apt install mariadb-server mariadb-clientOnce the installation is installed and root password set, add the following lines to the section[mysqld] on /etc/mysql/mariadb.conf.d/50-server.cnffile.
sudo vim /etc/mysql/mariadb.conf.d/50-server.cnfAdd:
[mysqld]
default-storage-engine = INNODB
#
# * Character sets
#
# MySQL/MariaDB default is Latin1, but in Debian we rather default to the full
# utf8 4-byte character set. See also client.cnf
#
character-set-server = utf8
collation-server = utf8_binRestart mysql service for changes to take effect:
sudo systemctl restart mysqlCreate database/user
$ sudo mysql -u root -p
CREATE DATABASE logicaldoc;
GRANT ALL PRIVILEGES ON logicaldoc.* TO 'logicaldoc'@'localhost' IDENTIFIED BY "StrongPassword";
FLUSH PRIVILEGES;
\qStep 4: Install LogicalDOC on Ubuntu 20.04|18.04|16.04
Download latest version of LogicalDOC from Application installers download page. The latest release as of this writing is 8.7.1
export VER="8.7.1"
wget https://s3.amazonaws.com/logicaldoc-dist/logicaldoc/installers/logicaldoc-installer-${VER}.zipExtract the package using unzip command:
sudo apt -y install unzip
unzip logicaldoc-installer-${VER}.zipTo install LogicalDOC, execute the command from the command line:
chmod +x install.sh
sudo ./install.shWhen asked for database settings, provide as configured on step 3
Command line arguments:
Select your language
0 [x] eng
1 [ ] ita
2 [ ] spa
3 [ ] fra
4 [ ] deu
Input selection:
0
──────────────────────────────────────────────────────────────────────────
Welcome
──────────────────────────────────────────────────────────────────────────
Welcome to the installation of LogicalDOC 8.4.2!
This software is developed by:
- LogicalDOC <[email protected]>
The homepage is at: https://www.logicaldoc.com
Press 1 to continue, 2 to quit, 3 to redisplay
1
License
Press 1 to accept, 2 to reject, 3 to redisplay
1
Select target path [/LogicalDOC]
──────────────────────────────────────────────────────────────────────────
Select Installation Packages
──────────────────────────────────────────────────────────────────────────
Select the packs you want to install:
[x] Pack 'Base' required
Done!
Press 1 to continue, 2 to quit, 3 to redisplay
1
──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
Installation
──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
====================
Installation started
Framework: 5.1.3-84aaf (IzPack)
Platform: ubuntu_linux,version=5.4.0-28-generic,arch=x64,symbolicName=null,javaVersion=11.0.7
[ Starting to unpack ]
[ Processing package: Base (1/1) ]
[ Unpacking finished ]
Installation finished
──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
User Data
──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
Registration
Activation Code []
Name []
Organization []
Email []
Web site []
http://logicaldoc.examle.com
Press 1 to continue, 2 to quit, 3 to redisplay
1
Thu Sep 13 00:03:31 EAT 2018 - INFO - Detected Java architecture 32bit
──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
User Data
──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
Database
Engine
0 [x] MySQL / MariaDB (suggested choice for production)
1 [ ] Oracle
2 [ ] SQL Server
3 [ ] PostgreSQL
4 [ ] Embedded (for trial only, not for production)
Input selection:
0
──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
User Data
──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
Database
Username []
logicaldoc
Password
**************
Server name/IP [localhost]
Server port [3306]
Database [logicaldoc]
Instance []
[ ] Manual specification of the database connection URL
Enter 1 to select, 0 to deselect:
1
Press 1 to continue, 2 to quit, 3 to redisplay
1
Step 5: Post-installation Settings
You need to copy the startup service into your system initialization directory to be able to start LogicalDOC at server bootstrap:
sudo cp /LogicalDOC/bin/logicaldoc-all.service /etc/systemd/system
sudo systemctl daemon-reloadStart and enable the service to start on boot:
sudo systemctl enable logicaldoc-all
sudo systemctl start logicaldoc-allOpen LogicalDOC Web UI using your default browser: http://localhost:8080/.
Login with the account admin with password admin for the first time.
For further reading on how to administer LogicalDOC, check user and Admin guides.
