Quick Install

From LogicalDOC Community Wiki
Jump to: navigation, search

In less than five minutes you can install LogicalDOC and run it on your own server.

Windows

Requirements are:

  • Install java jdk 1.8
  • Install LogicalDOC-Tomcat bundle

Install Java JDK 1.8

Go to the Oracle Java download site and select to download the Java Developer Kit (JDK) 8, latest update. The url is http://www.oracle.com/technetwork/java/javase/downloads/index.html
(Note that the url or version number may change as time goes by).
When the file has been downloaded, execute it to install Java on your system using the setup wizard.

Install LogicalDOC

Download the LogicalDOC 7 + Tomcat 8 bundle and uncompress on your file system disk (a good option is to uncompress on C:\). If you experience problems uncompressing logicaldoc-7.x.x-tomcat-bundle.zip, try using 7-Zip or the WinRAR application to uncompress it.

Application startup

  • Execute the command C:\tomcat\bin\catalina.bat start to run LogicalDOC + Tomcat application server.

Complete the installation

Linux

Requirements are:

  • Install java jdk 1.8
  • Install LogicalDOC-Tomcat bundle

There are several ways to install it. These steps were used to install on Ubuntu but can be used for any other Linux flavor.

Install Java JDK 1.8

Execute the following commands on the Terminal by copying and pasting them one at a time

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

Install LogicalDOC

Download the LogicalDOC 7 + Tomcat 8 bundle and uncompress on your file system disk (a good option is to uncompress under /opt/).

Execute the following command on the terminal

$ unzip logicaldoc-7.x.x-tomcat-bundle.zip

Application startup

  • Execute the command /opt/tomcat/bin/catalina.sh start to run LogicalDOC + Tomcat application server.

Complete the installation

Mac OS X

Requirements are:

  • Install java jdk 1.8
  • Install LogicalDOC-Tomcat bundle

Install Java JDK 1.8

Go to the Oracle Java download site and select to download the Java Developer Kit (JDK) 8, latest update. The url is http://www.oracle.com/technetwork/java/javase/downloads/index.html (Note that the url or version number may change as time goes by).

Follow the instructions as shown in the installation page of JDK 8 for Mac https://docs.oracle.com/javase/8/docs/technotes/guides/install/mac_jdk.html

Install LogicalDOC

Download the LogicalDOC 7 + Tomcat 8 bundle and uncompress on your file system disk (a good option is to uncompress under /Library) or alternatively copy, move by OS X GUI, open a new finder window and browse your Macintosh HD, Locate and move/copy LogicalDOC 7 + Tomcat 8 inside the Library folder.

In OS X, open the Terminal application by browsing through Finder and navigate to Applications/Utilities folder and double click Terminal application.

Execute the following command on the terminal OR alternatively, just double click the zip file you have copied/moved in the finder and it will extract itself! Same result and no need to type or use Terminal commands.

$ unzip logicaldoc-7.x.x-tomcat-bundle.zip

Application startup

  • Execute the command /Library/tomcat/bin/catalina.sh start to run LogicalDOC + Tomcat application server.


Complete the installation

Setup Procedure

  • Wait until the boot process of Tomcat ends

You should wait until you see a message on the console similar to the one shown below

INFO: Server startup in 8423 ms
  • Restart Tomcat for the 2nd time
  • Wait that the startup complete
  • On a client browser, open the URL http://localhost:8080/logicaldoc/.
  • You should see under the login form a triangle of warning, click on the link to the right to activate the setup procedure
  • Perform the LogicalDOC Setup procedure using admin/admin as username/password in order to access the protected setup section
  • Define a folder (on the filesystem) to use for the document repository (in some systems it may be necessary in advance the creation of the folder setting the correct write privileges)
  • Select the type of database to use, the fastest procedure is to select the internal database (of course you can decide to use a more efficient database, the only thing is that you first need to proceed to the creation of a database schema)

First Login

Post Installation Notes


Note idea.png Once installed, please read the User's Guide to familiarize yourself with LogicalDOC, or Administration Guide to learn the administrator features.

In case of problems you can refer to the Community Forums.

You can also use the Bug Tracking tool to report an issue with the software.