Using HTMap on the Open Science Grid

Running HTMap with the Open Science Grid (OSG) requires some special configuration. The OSG does not support Docker, and is also not amenable to HTMap’s own Singularity delivery mechanism. However, the OSG does still allow you to run your code inside a Singularity container. The .htmaprc file snippet below sets up HTMap to use this support.

# .htmaprc

DELIVERY_METHOD = "assume"

[MAP_OPTIONS]
requirements = "HAS_SINGULARITY == TRUE"
"+ProjectName" = "\"<your project name>\""
"+SingularityImage" = "\"/cvmfs/singularity.opensciencegrid.org/<repo/tag:version>\""

The extra " on the left are to escape the +, which is not normally legal syntax, and the extra \" on the right are to ensure that the actual value is a string.

Note the two places inside < >, where you must supply some information You must specify your OSG project name, and you must specify which OSG-supplied Singularity image to use. For more information on what images are available, see the OSG Singularity documentation. HTMap’s own default image, htmap-exec, is always available on the OSG. For example, to use htmap-exec:v0.4.3, you would set

"+SingularityImage" = "\"/cvmfs/singularity.opensciencegrid.org/htcondor/htmap-exec:v0.4.3\""

For advice on building your own image for the OSG, see I want to build an image for use on the Open Science Grid.