Shut down and restart RStudio - Amazon SageMaker
Suspend your RSessionsDelete your RSessionsDelete your RStudioServerPro app
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).

Shut down and restart RStudio

Important

Custom IAM policies that allow Amazon SageMaker Studio or Amazon SageMaker Studio Classic to create Amazon SageMaker resources must also grant permissions to add tags to those resources. The permission to add tags to resources is required because Studio and Studio Classic automatically tag any resources they create. If an IAM policy allows Studio and Studio Classic to create resources but does not allow tagging, "AccessDenied" errors can occur when trying to create resources. For more information, see Provide permissions for tagging SageMaker resources.

Amazon Managed Policies for Amazon SageMaker that give permissions to create SageMaker resources already include permissions to add tags while creating those resources.

To shut down and restart your Posit Workbench and the associated RStudioServerPro app, you must first shut down all of your existing RSessions. You can shut down the RSessionGateway apps from within RStudio. You can then shut down the RStudioServerPro app using the Amazon CLI. After the RStudioServerPro app is shut down, you must reopen RStudio through the SageMaker console.

Any unsaved notebook information is lost in the process. The user data in the Amazon EFS volume isn't impacted.

Note

If you are using a custom image with RStudio, ensure that your docker image is using an RStudio version that is compatible with the version of Posit Workbench being used by SageMaker after you restart your RStudioServerPro app.

The following topics show how to shut down the RSessionGateway and RStudioServerPro apps and restart them.

Suspend your RSessions

Complete the following procedure to suspend all of your RSessions.

  1. From the RStudio Launcher, identify the RSession that you want to suspend.

  2. Select Suspend for the session.

  3. Repeat this for all RSessions.

Delete your RSessions

Complete the following procedure to shut down all of your RSessions.

  1. From the RStudio Launcher, identify the RSession that you want to delete.

  2. Select Quit for the session. This opens a new Quit Session window.

  3. From the Quit Session window, select Force Quit, to end all child processes in the session.

  4. Select Quit Session to confirm deletion of the session.

  5. Repeat this for all RSessions.

Delete your RStudioServerPro app

Run the following commands from the Amazon CLI to delete and restart your RStudioServerPro app.

  1. Delete the RStudioServerPro application by using your current domain id. 

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

  2. Re-create the RStudioServerPro application. 

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