Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
Version 4.5
LogicalDOC 4.5 Administrator's Manual
© 2009 Logical Objects snc, via Bonasi 2/A – 41012 Carpi Italy. All rights reserved.
http://www.logicalobjects.com
License
This work is licensed under a GNU Free Documentation License 1.2.
http://www.gnu.org/licenses/fdl-1.2.txt
Disclaimer
Documentation is provided 'AS IS' and all express or implied conditions, representations
and warranties, including any implied warranty of merchantability, fitness for a particular
purpose or on-infringement, are disclaimed, except to the extent that such disclaimers
are held to be legally invalid.
Contents
Contents
1 PREREQUISITES...........................................................................................4
2 INSTALLATION..............................................................................................4
WINDOWS...........................................................................................................4
LINUX.................................................................................................................5
3 SSL SUPPORT...............................................................................................5
CERTIFICATE IMPORT.............................................................................................5
Create a Certificate Signing Request (CSR)...............................................6
Importing the Certificate...............................................................................6
4 BACKUP.........................................................................................................7
5 UPDATES.......................................................................................................7
6 PATCHES.......................................................................................................8
7 CONFIGURATIONS.......................................................................................9
MAX UPLOAD SIZE.................................................................................................9
1 Prerequisites
LogicalDOC is certified for execution on the following operating systems:
• Windows 2000 and following
• Windows Server 2003 and following
• SuSE Linux 10.0 and following
• CentOS 5.2 and following
• Fedora 10 and following
Software:
• Java JRE 1.6.0 or later
2 Installation
LogicalDOC can be installed using the proper setup program downloadable
from: http://www.logicaldoc.info/dist/logicaldoc
In this page all setup programs are listed, each one dedicated to a particular
operating system.
2.1 Windows
For Windows there are two different setups:
logicaldoc-windows-jvm-installer-<x>.exe
logicaldoc-windows-installer-<x>.exe
The first one contains even the Java runtime, you can use this setup if your
system doesn't have a JRE 1.6 currently installed on your system.
Follow the setup steps. Leave all settings as default or change them at your
will.
Important: Make sure to not to have installed a JRE 1.5, before installing
LogicalDOC. If this is the case, in order to avoid problems and conflicts,
install a fresh JRE 1.6 before launching LogicalDOC setup.
2.2 Linux
On linux the PostgreSQL automatic installation is not provided. So here it is
described the installation using the internal DB. The binding with a
PostgreSQL database is of course possible but you have to manually install
the database before launching LogicalDOC setup.
Follow the setup steps. Leave all settings as default or change them at your
will.
Save the file and execute the command: chkconfig --add logicaldoc
3 SSL support
LogicalDOC supports the protocol HTTPS(SSL) to encrypt the communication
between the server and the browsers. This feature is particularly usefull when
you expose LogicalDOC on the Internet.
Normally you can access LogicalDOC in a secure way pointing your browser
at http://localhost:8443/logicaldoc
Note: Use the password logical for both keystore and keyEntry. It is
important that this password is the same, and if you use logical you doesn't
have to edit other server configuration files.
Note: In some cases you will have to enter the domain of your website (i.e.
www.myside.org) in the field "first and lastname" in order to create a working
Certificate.
Now you have a file called certreq.csr that you can submit to the
Certificate Authority (look at the documentation of the Certificate Authority
website on how to do this). In return you get a Certificate.
First of all, import the so called Chain Certificate or Root Certificate in the
keystore:
• Download a Chain Certificate from the Certificate Authority you
obtained the Certificate from.
4 Backup
LogicalDOC provides a backup procedure that saves all documents files, and
a database dump with all data. Full-text indexes are not considered, since
they can be recreated after.
Windows:
<LDOC_HOME>\bin\backup.bat
Linux:
<LDOC_HOME>/bin/backup.sh
The results of the backup are a set of zip archives in the folder backup.dir,
each archive contains all documents files and a database dump.
Note: The database dump is possible only if you are using PostgreSQL and
only if it is installed in the same machine of LogicalDOC.
5 Updates
You can maintain LogicalDOC updated to the latest release using the icon
“Update LogicalDOC” placed on the desktop during the setup.
Updates are published on Internet at:
http://www.logicaldoc.info/dist/logicaldoc/updates.
The update program searches for update packages loaded into the remote
update site and executes them in sequence.
At the end of the update procedure, LogicalDOC is updated to the latest
release.
The folder <LDOC_HOME>/updates contains the downloaded update
packages and the log file of the last execution.
The update can alter all the components of the system, in paricular some
updates can change the database schema.
1. Notify users about the upgrade, and schedule the time of out-of-
service
2. Shut down LogicalDOC service
3. Launch the backup as described earlier
4. Make a security copy of the folder where LogicalDOC is installed or
at least the sub-folders tomcat/, repository/data/plugins and
JExpress
5. Launch the update
In this way if something goes wrong, we can easily restore the system as it
was before the update.
6 Patches
In particular cases, patches can be released in order to solve very specific
problems, without the need to wait an official release.
As the update packages, even the patches are zip archives, but these are not
published on Internet nor they are automatically downloaded. They are
delivered to the customer or partner by e-mail or other medium.
7 Configurations
The section
<context-param>
<param-name>com.icesoft.faces.uploadMaxFileSize</param-name>
<param-value>52428800</param-value>
</context-param>
defines the maximum accepted size expressed in bytes. After you have
modified this value as you need, save the file and restart the LogicalDOC
service.