In this article, we’ve listed some of the most frequently asked questions about the Analyses tab and other new interactive analysis features in Terra. If you have additional questions, please visit the Terra Community Forum or leave us a comment on this article. To read more about interactive analyses in Terra, see the Interactice Analysis section of the Terra support site.
1. The Notebooks tab has been replaced by the Analyses tab. Where are my Notebooks?
Jupyter Notebooks are now listed under the Analyses tab. In this tab, you’ll also see files for RStudio if you've uploaded them to your workspace.
2. Where’s the Cloud Environment widget?
The Cloud Environment widget has been replaced by a new sidebar on the right side of the Terra user interface (UI). If you haven't started using any interactive analysis applications yet, the sidebar contains two options: an Environment Configuration and a Terminal.
Selecting the new Environment Configuration button will allow you to choose which application you want to launch (Jupyter Notebooks, RStudio, or Galaxy).
Once an environment is created, you’ll see the application logo (or logos) in the sidebar.
3. Can I run Jupyter and RStudio at the same time in a single workspace?
Because Jupyter notebook and RStudio environments use the same Google Cloud virtual machine (VM), creating an RStudio environment will delete an existing Jupyter notebook environment and vice versa. If you try to do so, you’ll see a warning message:
However, you can have both a Galaxy environment in the same workspace as either a Jupyter or RStudio environment.
4. I tried to upload my file,
analysis.rmd, to Terra in the Analyses tab, but nothing happened. How come?
RStudio requires that R Markdown file extensions be exactly
.Rmd. The “R” in the file extension needs to be capitalized.
5. How do I know the status of my Cloud Environment VM?
The status of each environment VM is indicated by a colored dot on the sidebar of the Analyses tab:
- Green: running
- Blue: pausing/resuming
- Orange: paused
- Red: error
Alternatively, you can hover over the application logo to see the status of the VM.
For more information about the VM, select the Environment Configuration button on the sidebar which opens the Cloud Environment Details pane. You’ll see both a visual and textual description of the environment’s status there. You can update your Cloud Environment settings and status and launch a Jupyter, RStudio, or Galaxy instance from this pane, depending on what you created for your workspace.
6. How do I pause my Cloud Environment VM?
To pause your Cloud Environment VM, follow the steps below:
1. Select the Environment Configuration (cloud icon) button on the sidebar. This will open the Cloud Environment Details pane (left).
2. Select the Pause Environment button for any active VM in your workspace.
When a Cloud Environment is paused, this button changes to Resume Environment.
7. How do I delete my Cloud Environment VM?
To delete your Cloud Environment VM, follow the steps below:
1. Select the Environment Configuration (cloud icon) button on the sidebar. This will open the Cloud Environment Details pane (below).
2. Select the Environment Settings button under the application that you would like to delete the VM for.
3. Select Delete environment.
Note that Galaxy VMs must be running to be deleted. If your Galaxy VM is paused, it will need to be resumed before it can be deleted.