Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Panel
panelIconId1f40d
panelIcon:snake:
panelIconText🐍
bgColor#E3FCEF

This example is about installing and using a Python package called multiqc on Sol.

...

The “conda install” on the above page gives the installation commands:

...

The conda part in the red circle needs to be changed to mamba, and the bioconda part in the blue box is the channel name of this multiqc package. Channel is similar to the name of an online folder, that mamba can find and download the correct package. This is important for the next step.

...

Step 2 - Install

  1. Connect to the VPN

  2. Open a terminal app or a command line interface on a personal laptop or pc, or in a Sol desktop session. And then type in the commands:ssh asurite@solSol by navigating to sol.asu.edu on your browser and
    selecting the "Sol Shell Access" option from the "System" menu option. Or by SSHing into
    Sol using the command ssh <asurite>@sol.asu.edu

  3. interactive -p htc -c 4 -t 30

  4. module load mamba/latest

  5. mamba create -n myENV -c bioconda multiqc

  6. And answer Y to the promoted question, if everything looks fine

  7. Wait till the installation finish

...

Once the myENV environment is ready, multiqc can be used directly or within a python session/script.

  1. Connect to the VPN

  2. Open a terminal app or a command line interface on a personal laptop or pc, or in a Sol desktop session. And then type in the commands:ssh asurite@solSol by navigating to sol.asu.edu on your browser and
    selecting the "Sol Shell Access" option from the "System" menu option. Or by SSHing into
    Sol using the command ssh <asurite>@sol.asu.edu

  3. interactive -p htc -c 4 -t 30

  4. module load mamba/latest

  5. source activate myENV

  6. python

  7. import multiqc

...

The commands to have this package installed to a mamba env are:

  1. Connect to the VPN

  2. Open a terminal app or a command line interface on a personal laptop or pc, or in a Sol desktop session. And then type in the commands:ssh asurite@solSol by navigating to sol.asu.edu on your browser and
    selecting the "Sol Shell Access" option from the "System" menu option. Or by SSHing into
    Sol using the command ssh <asurite>@sol.asu.edu

  3. interactive -p htc -c 4 -t 30

  4. module load mamba/latest

  5. source activate myENV

  6. pip install q2-greengenes2

...

After multiqc and q2-greengenes2 have been installed to myENV, we want to use this mamba env in the Jupyter Notebook session on the Sol web portal. So we need to make a Jupyter kernel from this mamba env. More details are covered in Preparing Python Environments for Jupyter and here are the example steps:

  1. Connect to the VPN

  2. Open a terminal app or a command line interface on a personal laptop or pc, or in a Sol desktop session. And then type in the commands:ssh asurite@solSol by navigating to sol.asu.edu on your browser and
    selecting the "Sol Shell Access" option from the "System" menu option. Or by SSHing into
    Sol using the command ssh <asurite>@sol.asu.edu

  3. interactive -p htc -c 4 -t 30

  4. module load mamba/latest

  5. mkjupy myENV "myENV_kernel"

  6. Find and use myENV_kernel

    1. Log in to the Sol web portal

    2. On the top bar: Interactive Apps > Jupyter > Fill out request form > Connect to Jupyter

    3. Inside the Jupyter Notebook: Open a Launcher page > Click on myENV_kernel icon