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/

...

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.
All required software is already installed.

Run the image with:

docker run -d -p 8080:8080 -p 8443:8443 nexus.citeck.ru/ecos-community

It is recommended to use environment variables to configure the container:

docker run -d --env-file community.env -p 8080:8080 -p 8443:8443 nexus.citeck.ru/ecos-community

To store data during startup it is better to mount volumes for data. You can do it with: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. Создать дерево каталогов для данных сервисов

mkdir -d --env-file community.env -v p /opt/alfresco/content:/content -v /opt/alfresco/solr4:/var/lib/solr4 -v /opt/alfresco/postgresql:/alfresco/alf_data/postgresql -p 8080:8080 -p 8443:8443 nexus.citeck.ru/ecos-community

It will create /opt/alfresco/ directory with content, solr4, postgresql sub-directories mounted to docker-container by docker-engine.

...

{license,conf,solr4,content,logs,postgresql,ecos-ui}

2. Получить актуальный docker-compose.yaml

-v /opt/alfresco/logs:/alfresco/tomcat/logs

...

wget https://bitbucket.org/citeck/ecos-community/downloads/docker-compose.yaml

3. Запустить контейнеры

docker-compose runup -d --env-file community.env -v /opt/alfresco/content:/content -v /opt/alfresco/solr4:/var/lib/solr4 -v /opt/alfresco/postgresql:/alfresco/alf_data/postgresql -v /opt/alfresco/conf/alfresco_additional.properties:/tmp/alfresco/alfresco_additional.properties
-p 8080:8080 -p 8443:8443 nexus.citeck.ru/ecos-community

Few tags are available for ECOS Community:

• latest - redeployed every day and usually used for QA purposes
• stable - release version

...

4. Внести изменения в файл /etc/hosts

replace
127.0.0.1
ALFRESCO_PROTOCOL=http
SHARE_HOSTNAME=127       localhostto127.0.0.1
SHARE_PROTOCOL=http
DB_KIND=postgresql DB_USERNAME=alfresco
DB_PASSWORD=alfr3sc0
DB_NAME=alfresco
DB_HOST=localhost
DB_PORT=5432
SYSTEM_SERVERMODE=PRODUCTION
MAIL_HOST=localhost
MAIL_PORT=25
MAIL_USERNAME
MAIL_PASSWORD
MAIL_FROM_DEFAULT=alfresco@alfresco.org
MAIL_PROTOCOL=smtp
MAIL_SMTP_AUTH=false
MAIL_SMTP_STARTTLS_ENABLE=false
MAIL_SMTPS_AUTH=false
MAIL_SMTPS_STARTTLS_ENABLE=false
FTP_PORT=21
CIFS_ENABLED=true
CIFS_SERVER_NAME=localhost
CIFS_DOMAIN=WORKGROUP
NFS_ENABLED=true
LDAP_ENABLED=false
LDAP_KIND=ldap
LDAP_AUTH_USERNAMEFORMAT=uid=%s,cn=users,cn=accounts,dc=example,dc=com
LDAP_URL=ldap://ldap.example.com:389
LDAP_DEFAULT_ADMINS=admin
LDAP_SECURITY_PRINCIPAL=uid=admin,cn=users,cn=accounts,dc=example,dc=com
LDAP_SECURITY_CREDENTIALS=password
LDAP_GROUP_SEARCHBASE=cn=groups,cn=accounts,dc=example,dc=com
LDAP_USER_SEARCHBASE=cn=users,cn=accounts,dc=example,dc=com
LDAP_USER_ATTRIBUTENAME=uid
LDAP_GROUP_MEMBER_ATTRIBUTENAME=memberUid
CONTENT_STORE=/content
TOMCAT_CSRF_PATCH="${ALF_HOME}/disable_tomcat_CSRF.patch"
TOMCAT_CSRF_ENABLED=true
SOLR_STORE=$CONTENT_STORE/solr4
FLOWABLE_URL=http://localhost:8080
FLOWABLE_DBNAME=alf_flowablelocalhost community-test

5. В браузере перейти по адресу:

http://community-test:8080/share/page

Для авторизации используем следующие учётные данные:
Пользователь - 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)

...