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 learn more about interactive analyses in Terra, see the Interactive 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 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. Why?
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.
What to expect
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 where you would like to delete the VM.
3. Select Delete environment.
Galaxy app deletion
Galaxy VMs must be running to be deleted. If your Galaxy VM is paused, it needs to be resumed before it can be deleted.