Skip to content

Latest commit

 

History

History
73 lines (49 loc) · 2.59 KB

DevGuide.md

File metadata and controls

73 lines (49 loc) · 2.59 KB

Batch Connect - Desktop app

An example Batch Connect app that launches a Matlab application within a batch job.

Prerequisites

This Batch Connect app requires the following software be installed on the compute nodes that the batch job is intended to run on (NOT the OnDemand node):

  • OpenSSL 1.0.1+ (used to hash the Jupyter Notebook server password)
  • Lmod 6.0.1+ or any other module purge and module load <modules> based CLI used to load appropriate environments within the batch job before launching the Jupyter Notebook server.
  • Singularity Singularity is a container platform. It allows you to create and run containers that package up pieces of software in a way that is portable and reproducible. ... Your container is a single file, and you don't have to worry about how to install all the software you need on each different operating system and system.

Downloading and building docker image

Building singularity image requires elevated priviledges which may not be feasible on production environments thus we provide prebuilt image file as release artefacts.

singularity pull --arch amd64 library://ayushchatur/default/bc_vt_desktop:v2.0

or Pull by unique ID (reproducible even if tags change)

singularity pull library://ayushchatur/default/bc_vt_desktop:sha256.b3d4f08674eb7c205c154c700b91cd667c93d73da02c7d59dedb198c1e2e7b48

In case you have priviledged access you may build with reciepe as below

git clone https://github.com/AdvancedResearchComputing/OnDemandApps.git

cd Singularityfiles
sudo singularity build ubuntu-xfce.sif Singularity.def

Development Installation

cd /home/<user>/ondemand/dev
git clone [email protected]:AdvancedResearchComputing/OnDemandApps.git

System Installation

cd /var/www/ood/apps/sys
git clone [email protected]:AdvancedResearchComputing/OnDemandApps.git

Make sure to give executable permissions for image file

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request