From ACS 7.1 two Search Engines are available:
- Search Services 1.x and 2.x, that is relaying on a customization of Apache SOLR 6.6
- Search Enterprise 3.x, that is a standard client for Elasticsearch and Amazon OpenSearch
This project provides a sample deployment for ACS 7.2 with Alfresco Search Enterprise 3.1.0 using AWS Managed Services (Amazon OpenSearch, Amazon RDS and Amazon MQ). Note that deploying the product in production environments would require additional configuration.
Docker Images from quay.io are used, since this product is only available for Alfresco Enterprise customers. If you are Enterprise Customer or Partner but you are still experimenting problems to download Docker Images, contact Alfresco Hyland Support in order to get required credentials and permissions.
Docker Compose template includes following files:
.
├── .env-RemovePostFix
├── docker-compose.yml
├── alfresco
│ └── Dockerfile
├── keystores
├── license
├── scripts
└── cfn-aws_resources_for_alfresco_opensearch.yml
.env-RemovePostFix
includes common values and service versions to be used by Docker Compose. A sample is provided (.env-RemovePostFix), save it as.env
after values for your environment has been provideddocker-compose.yml
is a regular ACS Docker Compose, including Elasticsearch Connector and the endpoints provided by OpenSearch Service, RDS and MQ in AWSDockerfile
has the build instructions to customize default Alfresco Repository Docker Image.keystores
folder is empty by default, copy yourtruststore.pkcs12
file produced withscripts/build-truststore.sh
toollicense
folder is empty be default, copy youralfresco.lic
file in this folderscripts
folder includes a set of bash scripts to configure the Alfresco EC2 Instancecfn-aws_resources_for_alfresco_opensearch.yml
CloudFormation template to deploy AWS resources to run this Alfresco system
After deploying the AWS resources with the provided Cloudformation template, retrieve values for your AWS environment on the Cloudformation stack's output tab.
Before deploying Docker Compose templates, follow this steps to configure the EC2 Instance using the scripts available in scripts
folder.
cd scripts
Install Docker and Docker Compose
./1-install-docker.sh
After this step, reboot the instance (use sudo shutdown -r now
command). If the instance is powered off and then restarted (rather than rebooted), it is likely that the public ipv_4 address will change.
Login quay.io
./2-login-quay.sh
Credentials required to download Alfresco Docker Images from quay.io. Contact Alfresco Support to get them.
Use the values from your Cloudformation stack's output tab for for your environmental values
Create Database
./3-create-database <DatabaseEndPoint>
<DatabaseEndPoint>
is the DB DNS Name created using the Cloud Formation Template, for instance acs-opensearch-opensearchalfresco.cijbca5yttz2.eu-west-1.rds.amazonaws.com
Mount Filesystem
./4-mount-efs.sh <FileSystemMount>
<FileSystemMount>
is the EFS DNS Name created using the Cloud Formation Template, for instance fs-06919b0d9d232efe3.efs.eu-west-1.amazonaws.com
Create TrustStore from OpenSearch
./5-build-truststore.sh <OpenSearchDomainEndpoint>
<OpenSearchDomainEndpoint>
is the OpenSearch DNS Name created using the Cloud Formation Template, for instance vpc-acs-opensearch-kwu4eqb2qmj745h7fdcoa5jp5e.eu-west-1.es.amazonaws.com
Once this script has been executed successfully, copy the produced truststore/truststore.pkcs12
file to keystores
folder
Adding Alfresco License
Copy your alfresco.lic
file to license
folder. Contact Alfresco Support to get a valid license file for ACS 7.2.
$ docker-compose up --build --force-recreate
http://ipv4OfAlfrescoServer:8080/workspace
ADW
- user: admin
- password: admin
http://ipv4OfAlfrescoServer:8080/alfresco
Alfresco Repository
- user: admin
- password: admin