Indigo-ELN-v.-2.0

Indigo - The Open-Source Chemistry Electronic Lab Notebook

Sandbox

https://indigo-eln.test.lifescience.opensource.epam.com/ please contact indigoeln@epam.com to request access

Installation

NB: Indigo ELN is currently being severely transformed. Deployment script, application code and documentation may contain errors and inconsistencies.

Please contact the Indigo ELN team in case of any questions.

NB: Right now, build script assumes the application is deployed into us-east-1 region (North Virginia) because it uses AWS Public Container Registry which is only available in this region. However, you can copy images to your own ECR repository and adjust XXXServiceTag parameters to refer to that repository.

Local Installation

• You must have recent version of Docker installed
• Check our Indigo ELN repository:

git clone https://github.com/epam/Indigo-ELN-v.-2.0.git
cd Indigo-ELN-v.-2.0

• Create directories for persistent data:

sudo mkdir -p /var/local/indigoeln/{mongo-db,postgres-signature,postgres-crs,bingodb}

• From the root of the repository, run:

docker compose -f docker-compose-local.yml up

It will build all containers and start the application. You can access the application UI at http://localhost:9000

Installation on AWS

• Check our Indigo ELN repository:

git clone https://github.com/epam/Indigo-ELN-v.-2.0.git
cd Indigo-ELN-v.-2.0

Deploy a CloudFormation script

indigo_eln_script.yaml

You can do it via AWS Console or AWS CLI (aws cloudformation create-stack) or a helper tool like Rain (https://github.com/aws-cloudformation/rain)

Be sure to review the script adjust parameters before deploy.

Some required parameters:

• KeyPairName: Name of an existing Amazon EC2 key pair to enable SSH or RDP access to the instances
• VPCId: ID of your existing AWS VPC
• HostedZoneId: Existing Route53 Hosted zone ID
• IndigoELNDomainName: Domain name where Indigo ELN will be hosted
• IndigoELNAPIDomainName: Domain name where Indigo ELN API will be hosted
• IndigoELNContentBucketName: S3 bucket where frontend code will be served from (will be created)
• IndigoELNBuildLogsBucketName: S3 bucket where build logs are stored (will be created)
• MongoDBPassword: password for the created instance of MongoDB
• DefaultAdminPassword: password for main application admin user, BCrypt encoded

Also, update image tags for the Docker images used. Typically, you need the latest time tag with given prefix. Latest tags at the time of writing are already included in the CloudFormation script. Alternatively, you can find it here https://gallery.ecr.aws/m5k0g6n7/indigo_eln.

Validate installation and troubleshooting

• Make sure CloudFormation stack is deployed and all resources created without errors.

• Connect to EC2 instance using specified key pair, make sure all docker containers are running:

docker ps

There should be 8 containers running: mongo-db, postgres-signature, postgres-crs, bingodb, server, signature, crs, indigo

If there are fewer of them, you can find IDs of stopped containers and inspect its logs:

docker ps --all
docker logs <container_id>

• Now you can log into the application using the domain name you specified in the CloudFormation script (default credentials is admin/admin, if you didn't change the password parameter)