Setting Up cBioPortal in MyDRE

Setting Up cBioPortal in MyDRE


If you're using a clean Linux VM and want to install cBioPortal manually:

1. Create the VMs in one workspace

  1. Add one default Windows VM and start it.
  2. Add a standard Linux Ubuntu 22 VM and start it.

2. Whitelist Required URLs

Whitelist the following domains under External Access settings in myDRE:

github.com
raw.githubusercontent.com
packages.microsoft.com
azure.archive.ubuntu.com
docker.com
docker.io
cbioportal-datahub.s3.amazonaws.com (only needed for example dataset)
oncokb.org
civicdb.org/
genomenexus.org
gsea-msigdb.org
oncotree.mskcc.org

3. Prepare and Upload Scripts

Since copy-paste is not possible inside the VM, we will prepare scripts in advance and upload them using the Files feature in myDRE.

Upload the following files:

a. install_docker.sh

#!/bin/bash

# Add Docker's official GPG key:
sudo apt-get update sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
echo \
      "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
      $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null sudo apt-get update sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# Adds current user to docker security group
sudo groupadd -f docker
sudo usermod -aG docker $USER
newgrp docker

b. configuration.sh 

[Service]
Environment="HTTP_PROXY=http://proxy.mydre.org:3128"
Environment="HTTPS_PROXY=http://proxy.mydre.org:3128"
Environment="NO_PROXY=localhost,127.0.0.1"

c. install_cbioportal.sh 

mkdir -p ~/cbioportal
cd ~/cbioportal
cd cbioportal-docker-compose

./init.sh
docker compose up

4. Connect to VMs

RDP into the Windows VM (log in with your @mydre.nl account).
Follow the SSH instructions here to connect to the Linux VM within the windows VM

5. Install Docker on Linux VM

  1. On the Linux VM, navigate to the Z: drive (mounted file share).
  2. Run the Docker installation script:  ./install_docker.sh
  3. Enter your sudo password when prompted.

6. Configure Docker Proxy

To route Docker traffic through the MyDRE proxy:

  1. Create a docker proxy settings file 

    1. sudo mkdir -p /etc/systemd/system/docker.service.d/
    2. sudo nano /etc/systemd/system/docker.service.d/http-proxy.conf

  2. Paste the contents of configuration.sh into the file (exit and save) 

  3. Then apply the changes:

    1. sudo systemctl daemon-reload
    2. sudo systemctl restart docker

  4. Verify that docker is running and check with  hello world

    1. sudo systemctl status
    2. docker docker run hello-world

7. Install cbioportal

Notes
This step may take a while to complete.
RUN  install_cbioportal.sh from home folder 

8. Enable VM Communication

To allow communication between the Windows and Linux VMs in the same Workspace. Add the Linux VM’s IP address to the Windows proxy exception list: (Windows menu → Settings → Network & Internet → Proxy) 

9. Access cBioPortal in Browser

From the Windows VM:
  1. Open Google Chrome.
  2. Navigate to:
    1. http://<linux-vm-ip>:8080
    2. Replace <linux-vm-ip> with the actual IP of your Linux VM.

    • Related Articles

    • Activating your new @mydre.org account

      Before you can access your DRE workspace(s) at mydre.org, you need to activate your @mydre.org account. Below, we explain the steps in this activation process, along with screenshots for illustration. Prerequisite: your new @mydre.org username, along ...

    • Federated Learning on myDRE with VANTAGE6

      VANTAGE6 An open source privacy preserving Federated Learning Infrastructure for Secure Insight Exchange. ARCHITECTURE VANTAGE6 uses a client-server model, which is shown in the figure below. In this scenario, the researcher can pose a question and ...

    • Shiny Server in a myDRE Workspace

      Version = 2023-02-02 This instruction is used to get Shiny Server up and running in a Workspace. For your actual workloads you might need other size VMs. Also there is much more to be configured, but being able to get Shiny up and running is a good ...

    • Why is my support.mydre.org account different from my @mydre.org account?

      We get this question regularly now and here is why: Your @mydre.org account may look like an e-mail address, but it is not. It has no e-mail functionality and it is strictly your username on the mydre.org platform. For support.mydre.org however, you ...

    • What is new on mydre.org?

      Last updated 20-04-2021 New features have been added or improved.  View the announcement at: Improved & New Features. Last updated 30-03-2021 New features have been implemented after the migration from researchenvironment.org to mydre.org. Therefore, ...