Accessing the Migration Console

Managing the Migration Process via the Migration Console

The Migrations Assistant deployment includes an ECS task that hosts tools to run different phases of the migration and check the progress or results of the migration.

AWS Solutions Bootstrap

Following the AWS Solutions deployment, the bootstrap box contains a script that simplifies access to the migration console through that instance.

To access the Migration Console, use the following commands:

export STAGE=dev
export AWS_REGION=us-west-2
/opensearch-migrations/deployment/cdk/opensearch-service-migration/accessContainer.sh migration-console ${STAGE} ${AWS_REGION}

Manually via AWS CLI

On a machine with the AWS CLI and the AWS Session Manager Plugin, you can directly connect to the migration console. Ensure you've run aws configure with credentials that have access to the environment.

Use the following commands:

export STAGE=dev
export SERVICE_NAME=migration-console
export TASK_ARN=$(aws ecs list-tasks --cluster migration-${STAGE}-ecs-cluster --family "migration-${STAGE}-${SERVICE_NAME}" | jq --raw-output '.taskArns[0]')
aws ecs execute-command --cluster "migration-${STAGE}-ecs-cluster" --task "${TASK_ARN}" --container "${SERVICE_NAME}" --interactive --command "/bin/bash"

Troubleshooting

Deployment Stage

Typically, STAGE is dev, but this may vary based on what the user specified during deployment.

TODO: Add steps to verify that the user is connected to the migration console after running the commands. s