Installation using MariaDB
- 1 Update Current Packages
- 2 Setup Oracle Java 8
- 3 Install MariaDB
- 4 Install Third Parties Components
- 5 Install LogicalDOC Community
- 6 Configure Service for Reboot
LogicalDOC CE 7.5.1 has been successfully installed on Ubuntu 14.04 Server using MariaDB 10.1.
This install was on a vanilla install of Ubuntu 14.04 LTE 64bit Server. The steps below follow what I did to configure Ubuntu for LogicalDOC.
Update Current Packages
It is assumed that the user is logged in and has sudo access. For information on giving a user sudo access visit Liquidweb page on How to Add a User and Grant Root Privileges on Ubuntu 14.04.
These steps are performed from the command line.
sudo apt-get update
Setup Oracle Java 8
These simple steps have been retrieved from: How to Install Oracle Java 8 on Ubuntu 14.04 LTS
Add the WebUpd8 Team Personal Package Archive (PPA)
Add the PPA:
sudo apt-add-repository ppa:webupd8team/java
sudo apt-get update sudo apt-get install oracle-java8-installer
The output should be similar to:
Brief introduction MariaDB 5.5 corresponds to version 5.5 of MySQL, MariaDB 10 instead corresponds essentially to the 5.6 version of MySQL. Initially we had thought to install on the system MariaDB version 5.5 using the instructions published at this address https://www.liquidweb.com/kb/how-to-install-mariadb-5-5-on-ubuntu-14-04-lts/ Afterwards, having verified the availability of newer versions we opted to install MariaDB 10.1 following the instructions published by this other address https://www.vultr.com/docs/install-mariadb-on-ubuntu-14-04
Add the MariaDB Repository
sudo apt-get install software-properties-common
To find which repo you should use with the MariaDB repository generator. We’re going to add the Ubuntu 14.04 “trusty” MariaDB 10.1 repository.
Import the public key and add the MariaDB repository:
sudo apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 0xcbcb082a1bb943db sudo add-apt-repository 'deb http://mirror.jmu.edu/pub/mariadb/repo/10.1/ubuntu trusty main'
Once the key is imported and the repository added you can install MariaDB with:
sudo apt-get update sudo apt-get install mariadb-server
Verify that MariaDB is operational
After installation, run
mysql -u root -p
Enter your password when prompted. You will see output similar to the following:
Congratulations, you have successfully installed MariaDB. If you instead received an error, retry by running the following command:
sudo service mysql start
Install Third Parties Components
LogicalDOC Community needs a couple of additional commands in order to produce the thumbnail of documents. These are two very common and easy to install packages: ImageMagick and Ghostscript. The first is used for image manipulation, and the second to convert PDF documents to image.
sudo apt-get install ghostscript sudo apt-get install imagemagick
Check version and installation path
The first command will show the location path where the ImageMagic command convert is located. You need to record this path because you will need it during LogicalDOC installation.
whereis convert convert –version
Install LogicalDOC Community
Download LogicalDOC Installer from SourceForge
The LogicalDOC Community project is hosted on SourceForge at: https://sourceforge.net/projects/logicaldoc/]
The downloads of the latest release version 7.5.1 are available at: https://sourceforge.net/projects/logicaldoc/files/distribution/LogicalDOC%20CE%207.5/
We choose to download the package logicaldoc-community-installer-7.5.1.zip using the direct link
Uncompress the installer
Make a temporary folder and uncompress there the installer
sudo mkdir tmpldisntaller sudo mv logicaldoc-community-installer-7.5.1.zip tmpldisntaller/ cd tmpldisntaller/ unzip logicaldoc-community-installer-7.5.1.zip
Launch the installation
Create an empty folder on the root of the Filesystem
sudo mkdir /LogicalDOC
Launch the setup installer
sudo java -jar logicaldoc-installer.jar
One of the most important things of this installation is the specification of the database engine that LogicalDOC will use to store its data
In this case you must pay attention to choose MySQL as database engine and then to enter username and password of MariaDB's root user we have previously installed
Configure Service for Reboot
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 /etc/init.d sudo chmod 755 /etc/init.d/logicaldoc
Then edit the file
/etc/init.d/logicaldoc adjusting the paths.
Save the file and execute the commands:
sudo update-rc.d logicaldoc defaults sudo service logicaldoc start
Now you can access the program using the browser, pointing it to http://localhost:8080/
Use the credentials admin/admin (username/password) to enter the first time.