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/

...

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 and for the "enterprise-reader" username set the password: readpass)

3. Cloning of the ECOS Community repository

...

1. Edit  configurations → Create → maven
2. Parameters → Command line: clean install ecos:run -DskipTests = trueProfiles → citeck development
3. Runner → Environment variables: MAVEN_OPTS = -Xms256m -Xmx2G
   

...

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.

There is a docker-compose file used to start all neccesary services of Citeck ECOS Community.
We should do few steps:
1.Create directories for data of the services.

mkdir -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.

To create a separate volume for logs is also a good idea. The command is:

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

2. Obtain actual docker-compose.yaml

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

...

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

3. Start containers

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. Make changes to /etc/hosts file

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. Go to link in browser

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

Account for authorizatipon:
User - admin
Password - alfr3sc0

Journals and applications data are stored at /opt/alfresco/

This manual tested for Ubintu 16.04 and 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.
Image Removed

• 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)
  Image Removed
• 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

...