GhostScript

LogicalDOC needs to print documents to a virtual device sometimes when performing barcode recognition.

In general in GhostScript is a package installed by default in all Linux distributions. On Ubuntu you can install in this way

$ sudo apt-get install ghostscript

Once you have GhostScript installed set the command.gs property(in file conf/context.properties) to the path of the gs executable:

command.gs=/usr/bin/gs

For Windows users

In Windows you don't have to do anything since the installer takes car of all installation and configuration issues.

System Requirements

Hardware requirements may vary based on the number of concurrent users, repository size and system configuration. Larger implementations may require some configuration tuning to perform optimally. LogicalDOC Commercial Subscribers may contact the LogicalDOC Support Team for further assistance. It is highly recommended that the hardware be dedicated to running the LogicalDOC Installation

LogicalDOC Cloud is the hosted version of LogicalDOC Enterprise and requires no server infrastructure. All you will need to connect to your LogicalDOC Cloud account is a modern Internet browser (see 'Supported Internet Browsers').

Minimum Hardware Requirements
Server 2.4 GHz 32-bit (x86) or 64-bit (x64) dual core processor
6 GB of system memory
1 GB of storage for the application data and repository storage as needed.
Workstations 2.0 GHz 32-bit (x86) or 64-bit (x64) processor
1 GB of system memory
50 MB storage space
Broadband connection to server
Minimum Software Requirements
LogicalDOC Server Installer Package Red Hat Enterprise Linux 7 (32-bit and 64-bit)
SUSE Linux Enterprise Server 10 (32-bit and 64-bit)
CentOS Linux 6 (32-bit and 64-bit)
Ubuntu 14 (32-bit and 64-bit)
Microsoft Windows 2008 Server (32-bit and 64-bit)
Microsoft Windows 7 (32-bit and 64-bit)
MAC OS X Lion (OS X 10.8)
Java JDK 8
Supported Browsers Firefox 40
Internet Explorer 11
Edge 25
Google Chrome 40
Safari 6
 

Install from Command line

The Linux setup is: logicaldoc-cross-platform-installer-<ver>.jar
Download it and execute the following commands command from command line:

$ unzip logicaldoc-cross-platform-installer-<rel>.jar -d tmp
$ mkdir /LogicalDOC
$ tar -zxf tmp/LogicalDOCJex.tar.gz -C /LogicalDOC
$ chmod u+x /LogicalDOC/bin/*.sh
$ chmod u+x /LogicalDOC/tomcat/bin/*.sh
$ chmod u+x /LogicalDOC/ant/bin/*
$ cd /LogicalDOC/tomcat/webapps/
$ unzip root.zip -d ROOT

At this point you have a complete LogicalDOC distribution in the directory /LogicalDOC.

Now enter the directory /LogicalDOC/bin and /LogicalDOC/conf and where needed adjust the paths in shell scripts(.sh) and configuration files(.properties): find the placeholdes LDOCHOME and replace with the installation path. This activity is normally performed by the graphical setup, so in this case you have to do it by hand.

Start the execution using this command:

$ /LogicalDOC/bin/logicaldoc.sh start

After that, LogicalDOC is in execution and you have to perform the first setup, just point your browser to: http://localhost:8080/setup
If the browsers ask you the credentials, use admin / admin to access to the
Web Setup Procedure.


In the first step, select the repository folder as follows:

When you are asked to choose the database, select the External Database:


Than in the next panel, insert your connection parameters and in particular use logicaldoc as user and database schema and digit your password as specified earlier during database account creation.

Post-installation

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

$ cp /LogicalDOC/bin/logicaldoc /etc/init.d

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

$ chkconfig --add logicaldoc
$ /etc/init.d/logicaldoc 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.

 /LogicalDOC

Installation

The application can be installed using the proper installer program downloadable from: http://dist.logicaldoc.com
Please, download the installer package available for your Operating System.

Verify the presence of Java JDK (Java Development Kit)

The Java JDK (version 8 or more recent) is a technological component required to execute both LogicalDOC installer and application, so you have to provide it before starting the installation procedure. You can check the presence of Java in your system by executing this command from a console:

$ java -version

If you don't have Java installed in your system please download it 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.

Do not use OpenJDK

Your system may come with a pre-installed OpenJDK package, if this is the case please replace it with an official Java JDK downloaded from the Oracle website as described above. Remember that LogicalDOC is not tested against OpenJDK and that the usage of OpenJDK will invalidate your support contract and could cause loss of informations.

 

Start the Installation

Once you have Java installed you are ready to start the installation of LogicalDOC in your server, please open the section of this guide dedicated to your Operative System.

Always download the last release

Beta and release candidate (RC) are only recommended for testing and not are considered stable for production

There is no support for beta or release candidates of the application

Uninstallation

Procedure for Windows

Execute the program located at: C:\LogicalDOC\Uninstaller\uninstaller.jar
At the end of the procedure delete the directory C:\LogicalDOC

 

Procedure for MAC OSX

Shutdown the service: /LogicalDOC/bin/logicaldoc.sh stop
Delete the file: /System/StartupItems/logicaldoc.plist
Delete the directory: /LogicalDOC

 

Procedure for Linux

Shutdown the service: /etc/init.d/logicaldoc stop
Delete the file: /etc/init.d/logicaldoc
Delete the directory: /LogicalDOC