Development (build from source)
1. Install and configure the necessary software
Install Oracle Java (JDK) version 8 http://www.oracle.com/technetwork/java/javase/downloads/index.html
Apache Maven 3.2.5+ http://maven.apache.org/download.cgi
Mercurial https://www.mercurial-scm.org/
Set the environment variables. Set M2_HOME = <MAVEN_PATH> /apache-maven-3.3.1
2. Set up maven to work with Citeck artifacts
For maven, you need to make additional settings to connect to citeck artifactory in the settings.xml file (copy the file to your .m2 directory)
3. Cloning of the ECOS Community repository
1. The mercurial command for cloning the repository:
> hg clone https://bitbucket.org/citeck/ecos-community
2. The command to go to the master branch
> hg update master
4. Launch project from CLI
$ run.sh
> run.bat
User: admin / admin
Configure IntelliJ IDEA (optional)
Opening a project from Idea - as maven project (pom.xml in root directory)
Configuration for launching from IntelliJ IDEA
- Edit configurations → Create → maven
- Parameters → Command line: clean install ecos: run -DskipTests = true
- Profiles → citeck development
- Runner → Environment variables: MAVEN_OPTS = -Xms256m -Xmx2G
You can run this configuration both on Run and Debug with running breakpoints in Java
Useful links
http://docs.alfresco.com/5.1/concepts/alfresco-sdk-installing-prerequisite-software.html - Setting Up the Environment
Test / Production
The document describes how to install and configure Citeck ECOS system.
Installing Citeck ECOS - Docker container
Docker-image of ECOS Community is based on CentOS 7.
All required software is already installed.
Run the image with:
It is recommended to use environment variables to configure the container:
To store data during startup it is better to mount volumes for data. You can do it with:
It will create /opt/alfresco/ directory with content, solr4, postgresql sub-directories mounted to docker-container by docker-engine.
To create a separate volume for logs is also a good idea. The command is:
There is also a function allowing you to mount additional properties file and it will be included in alfresco-global.properties
Few tags are available for ECOS Community:
- latest - redeployed every day and usually used for QA purposes
- stable - release version
List of variables and default values:
Operation check
In the event of faults in operation of the system, it is worth looking for a cause in the log files.
- Alfresco log files – alfresco.log, share.log;
- Tomcat log file – tomcat/logs/catalina.out;
- In “catalina.out” after successful start:
INFO: Server startup in 472138 ms - In alfresco.log after successful start:
INFO [...DeclarativeRegistry] Registered 501 Web Scripts (+0 failed), 783 URLs - In share.log after successful start
INFO [...DeclarativeRegistry] Registered 462 Web Scripts (+0 failed), 480 URLs - In share.log after successful login
INFO [...EditionInterceptor] Successfully retrieved license information from Alfresco.
- In share.log after login with an error:
INFO [...EditionInterceptor] Unable to retrieve License information from Alfresco: 404
(see the text of the error in alfresco.log)
- In share.log after login with an error:
INFO [...EditionInterceptor] Successfully retrieved license information from Alfresco.
(the user has entered the password incorrectly)
Alfresco and ECOS settings
When installing, the settings shall be corrected in unusual cases only: individual installation of DBMS, LibreOffice, imagemagick, swftools, etc.
Settings file: tomcat/shared/classes/alfresco-global.properties
Settings of the access to the DBMS
db.driver=org.postgresql.Driver db.username=alfresco db.password=admin db.url=jdbc:postgresql://localhost/alfresco
External program settings
LibreOffice
ooo.exe=/opt/alfresco-5.1.f/libreoffice/program/soffice.bin ooo.enabled=true ooo.port=8100
Image Magic
img.root=/opt/alfresco-5.1.f/common
img.dyn=${img.root}/lib
img.exe=${img.root}/bin/convert
SWF Tools
swf.exe=/opt/alfresco-5.1.f/common/bin/pdf2swf swf.languagedir=/opt/alfresco-5.1.f/common/japanese
Other settings
Path to the file repository
dir.root=./alf_data
dir.contentstore=${dir.root}/contentstore
dir.contentstore.deleted=${dir.root}/contentstore.deleted
External protocols and interfaces
system.webdav.servlet.enabled=true imap.server.enabled=false imap.server.port=143 ftp.enabled=true ftp.port=21 cifs.enabled=true cifs.tcpipSMB.port=445
Flowable BPM engine configuration