Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Below you will find instructions with example commands to run.
  2. Commands to be run on your local machine will be marked with blue colorshown on green background.
  3. Commands to be run on the Gateway will be marked with green colorshown on white background.
  4. Commands to be run in the running container will be marked with red color.
  5. The documentation covers usage of both Docker (running on your own computer) and uDocker (running on the Gateway). You do not have to follow both scenarios.

...

  • Docker on your own computer:
  • uDocker on Gateway:

    Code Block
    languagebash
    mkdir -p ~/.local/bin $ITMWORK/dot-udocker
    ln -s $ITMWORK/dot-udocker ~/.udocker
    curl https://raw.githubusercontent.com/indigo-dc/udocker/master/udocker.py > ~/.local/bin/udocker
    chmod u+rx ~/.local/bin/udocker
    echo "tmpdir='$ITMSCRATCH'" > ~/.udocker/udocker.conf
    ~/.local/bin/udocker install

...

  • Docker on your own compujter:

    Code Block
    themeDJango
    languagebash
    scp login.eufus.eu:~g2tomz/public/imas-installer-20180921112143.tar.xz ./
    xzcat imas-installer-20180921112143.tar.xz | docker load
  • uDocker on Gateway:

    Code Block
    themeMidnight
    languagebash
    xzcat ~g2tomz/public/imas-installer-20180921112143.tar.xz | ~/.local/bin/udocker load

...

  • Create a container and start a shell in it:

    • Docker on your own computer:

      Code Block
      themeDJango
      languagebash
      docker run --interactive --tty --name imas imas-installer:20180921112143
    • uDocker on Gateway:

      Code Block
      languagebash
      ~/.local/bin/udocker create --name=imas imas-installer:20180921112143
      ~/.local/bin/udocker run imas

...

  • Transfer the results to the Gateway:

    • Docker on your own computer:

      Code Block
      themeDJango
      languagebash
      docker cp imas:/home/imas/public/imasdb/test/3/0/ids_120001.characteristics /tmp/
      docker cp imas:/home/imas/public/imasdb/test/3/0/ids_120001.datafile /tmp/
      docker cp imas:/home/imas/public/imasdb/test/3/0/ids_120001.tree /tmp/
      scp /tmp/ids_120001.* login.eufus.eu:public/imasdb/test/3/0/
    • uDocker on Gateway:

      Code Block
      languagebash
      cp ~/.udocker/containers/imas/ROOT/home/imas/public/imasdb/test/3/0/ids_120001.* ~/public/imasdb/test/3/0/

...

  • Create a container and start a shell in it:

    • Docker on your own computer:

      Code Block
      themeDJango
      languagebash
      docker run --interactive --tty --name imas imas-installer:20180921112143
    • uDocker on Gateway:

      Code Block
      languagebash
      ~/.local/bin/udocker create --name=imas imas-installer:20180921112143
      ~/.local/bin/udocker run imas
  • In the container shell, execute:

    Code Block
    languagebash
    module load imas kepler
    module load keplerdir
    imasdb test
    export USER=imas
    kepler -runwf -nogui -user imas /home/imas/simple-workflow.xml
  • Transfer the results to the Gateway:

    • Docker on your own computer:

      Code Block
      themeDJango
      languagebash
      docker cp imas:/home/imas/public/imasdb/test/3/0/ids_10001.characteristics /tmp/
      docker cp imas:/home/imas/public/imasdb/test/3/0/ids_10001.datafile /tmp/
      docker cp imas:/home/imas/public/imasdb/test/3/0/ids_10001.tree /tmp/
      scp /tmp/ids_10001.* login.eufus.eu:public/imasdb/test/3/0/
    • uDocker on Gateway:

      Code Block
      languagebash
      cp ~/.udocker/containers/imas/ROOT/home/imas/public/imasdb/test/3/0/ids_10001.* ~/public/imasdb/test/3/0/

    On the host machine, execute:

    Code Block
    languagebash
    docker cp imas:/home/imas
    • /public/imasdb/test/3/0
    /ids_10001.characteristics /tmp/ docker cp imas:/home/imas/public/imasdb/test/3/0/ids_10001.datafile /tmp/ docker cp imas:/home/imas/public/imasdb/test/3/0/ids_10001.tree /tmp
    • /
  • Check correctness of the results, on Gateway:

    Code Block
    languagebash
    idsdump 1 1 pf_active