Prerequisites for AWS

An AWS IAM User with the permissions to create the terraform IAM user and role is required. If that is not possible, your IT team could be provided with a Terraform script or step-by-step documentation to create an IAM user and role to be used further in the setup process.

Access to the following services will be granted as part of the IAM role's policy:

• "sns:*"
• "cloudformation:ListStacks"
• "application-autoscaling:*"
• "s3:*"
• "logs:*"
• "cloudtrail:*"
• "dynamodb:*"
• "sts:*"
• "elasticloadbalancing:*"
• "autoscaling:*"
• "iam:*"
• "route53domains:*"
• "secretsmanager:*"
• "cloudwatch:*"
• "ses:*"
• "kms:*"
• "route53:*"
• "lambda:*"
• "ec2:*"
• "cognito-idp:*"
• "ebs:*"
• "eks:*"
• "acm:*"
• "rds:*"

• Available domain or subdomain to be used as the base for all endpoints (e.g. openidl.myorg.com)
• Port 443 is allowed in your organization. It is used by the gRPCs (gRPC over TLS) protocol

Credentials to access https://app.terraform.io

The account is used to store the Terraform workspace data.

Linux or MacOS

In case Windows is the only host OS supported by your IT department, a virtual machine running Ubuntu would be a good workaround. Virtualization software such as VirtualBox or VmWare Workstation Player/Pro can be of help in running the VM on your local host.

The following list represents the open-source software required on the client machine that will be used to deploy the initial components of an openIDL Node.

• Terraform
• Terragrunt
• Kubectl
• AWS CLI
• Python ^3.8.x
• Helm

Other open-source software used to deploy and run an openIDL Node:

• Hyperledger Fabric
• Ansible
• Ansible Tower (AWX)
• Jenkins
• Fabric Operator
• Fabric Operations Console
• Kubernetes
  • Cert Manager
  • Vault
  • Nginx
  • MongoDB

The following public Git repositories are used in the process of deploying an openIDL Node directly or indirectly.

• https://github.com/openidl-org/openidl-aais-gitops - Scripts to facilitate the deployment of the openIDL Nodes, a fork of the openIDL repository with fixes, improvements and new features
• https://github.com/openidl-org/openidl-main - openIDL Applications, a fork of the openIDL repository with fixes and improvements
• https://github.com/senofi/fabric-operations-console - A fork of the open-source repository by IBM with fixes, improvements, and new features
• https://github.com/senofi/openidl-devops - DevOps-related scripts to help install and configure the openIDL Node components