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 containers via docker-compose
Docker-image of ECOS Community is based on CentOS 7.
Install docker https://docs.docker.com/v17.09/engine/installation/
Install docker-compose https://docs.docker.com/compose/install/
All required software is already installed.
Для Citeck ECOS Community подготовлен docker-compose файл для запуска всех необходимых сервисов. В нём заложен запуск всех компонентов и ПО, необходимых для работы системы.
Для запуска выполните следующие шаги:
1. Создать дерево каталогов для данных сервисов
2. Получить актуальный docker-compose.yaml
3. Запустить контейнеры
4. Внести изменения в файл /etc/hosts
5. В браузере перейти по адресу:
Для авторизации используем следующие учётные данные:
Пользователь - admin
Пароль - alfr3sc0
Журналы и данные приложений хранятся в каталоге /opt/alfresco/
Развертывание сервисов с помощью docker-compose протестировано на ОС Ubintu 16.06 и Centos 7
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