If you’re new to AWS Portal we recommend starting here. If you’re new to Deadline we recommend starting here.

Connecting to AWS Portal Worker with Session Manager

If you would like to connect to an AWS Portal Worker using AWS Session Manager use the following steps.

Add Session Manager Permissions

In the AWS Console, navigate to the IAM Service and select the Role section. In the Search box, enter ‘AWSPortalWorkerRole’ and click on it.

../../_images/aws_console_iam_worker_role.png

Under Permissions, click on the ‘Add permissions’ button and ‘Attach policies’.

Search for ‘AmazonSSMManagedInstanceCore’, select it and click the ‘Attach policies’ button.

../../_images/aws_console_iam_add_session_manager_policy.png

Connect to the Instance

Now you are able to connect to your instances with Session Manager. The simplest way is through the EC2 console. Navigate to your instance and click on ‘Connect’. Choose the ‘Session Manager’ option and click ‘Connect’. That will open a session in your webbrowser on your instance.

../../_images/aws_console_ec2_connect.png

Cleanup

When you’re done connecting to your instance, it’s best practice to remove this policy from the Role. To do that, navigate back to IAM, and find the ‘AWSPortalWorkerRole’ Role. Under ‘Permissions’, select the ‘AmazonSSMManagedInstanceCore’ policy and click ‘Remove’ then ‘Delete’.