Upgrade to the new version - Amazon SageMaker AI
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Upgrade to the new version

Existing domains using version 2023.03.3-547.pro5 can upgrade to 2024.04.2+764.pro1 version in one of two ways:

  • Create a new domain from the Amazon CLI with RStudio enabled.

  • Update an existing domain to use the 2024.04.2+764.pro1 version.

The following procedure shows how to delete the RStudio application for an existing domain, set the default version to 2024.04.2+764.pro1, and then create an RStudio application.

  1. Delete the RStudioServerPro application and all RSessionGateway applications associated with your existing domain. For information about how to find your domain ID, see View domains. For more information about deleting applications, see Shut down RStudio.

    aws sagemaker delete-app \
    --region region \
    --domain-id domainId \
    --user-profile-name domain-shared \
    --app-type RStudioServerPro \
    --app-name default

  2. If your domain is using RStudio version 2023.03.3-547.pro5, update the domain to set 2024.04.2+764.pro1 as the default Posit Workbench version. The SageMakerImageArn value in the following update-domain command specifies the RStudio 2024.04.2+764.pro1 version as the default. This ARN must match the Region that your domain is in. For a list of all available ARNs, see Versioning.

    Pass an execution role ARN for the domain that provides permissions to update the domain. 

    aws sagemaker update-domain \
    --region region \
    --domain-id domainId \
    --domain-settings-for-update "{\"RStudioServerProDomainSettingsForUpdate\":{\"DefaultResourceSpec\": {\"SageMakerImageArn\": \"arn-for-2024.04.2+764.pro1-version\", \"InstanceType\": \"system\"}, \"DomainExecutionRoleArn\": \"execution-role-arn\"}}"

  3. Create a new RStudioServerPro application in the existing domain.

    aws sagemaker create-app \
    --region region
    --domain-id domainId \
    --user-profile-name domain-shared \
    --app-type RStudioServerPro \
    --app-name default

Your RStudioServerPro application is now updated to version 2024.04.2+764.pro1. You can now relaunch your RSessionGateway applications.