Linux Installation Troubleshooting

Document created by resplin Employee on Jun 6, 2015
Version 1Show Document
  • View in full screen mode

Obsolete Pages{{Obsolete}}

The official documentation is at:

Labs 33.0

Out of Memory Errors

These can really stuff up the bootstrapping process. If you have not allocated enough memory to the JVM then the bootstrapping process will abort unpredictably.

You can diagnose this by grepping catalina.out for

java.lang.OutOfMemoryError: Java heap space

To fix this make sure the JVM is passed a command line argument of something like -Xmx1024m

Damaged Installation after Out of Memory Errors

Once you have fixed the OOM errors Alfresco may refuse to install or start if there is data left lying around after an aborted install.

For example the following errors may be found in catalina.out:

00:13:42,211 ERROR [repo.admin.ConfigurationChecker] CONTENT INTEGRITY ERROR: System content not found in content store.
00:13:42,211 ERROR [repo.admin.ConfigurationChecker] Ensure that the 'dir.root' property is pointing to the correct data  location.
00:13:42,224 ERROR [web.context.ContextLoader] Context initialization failed
org.alfresco.error.AlfrescoRuntimeException: Ensure that the 'dir.root' property is pointing to the correct data location.

To clean up Alfresco try the following.

1. stop tomcat

2. delete everything in dir.root. This is where Alfresco stores content, indexes, etc. Its defined in

3. drop the database. Log into mysql as root or the alfresco user (defined by 'db.username' in

mysql> drop database alfresco;
mysql> create database alfresco default character set utf8 collate utf8_bin;

4. set the following value in to make Alfresco recreate the indexes


5. start tomcat and monitor the logs.

File Errors

If you are logged in as root and have followed the instructions for configuring Alfresco then you will have edited files and they will be owned by root. Alfresco may not be able to access them. This will give unpredictable errors in catalina.out that Alfresco cannot read files, or create them or whatever.

To fix this try chown-ing everything (once again)

chown -R alfresco:alfresco /opt/alfresco/tomcat
chown -R alfresco:alfresco /var/lib/alfresco

Note that the username and file locations may be different depending on which set of instructions you followed.