Skip to content

Commit 076cc77

Browse files
authored
Document pre-compiled image usage with CVMFS
Added instructions for using pre-compiled container images with CVMFS dependency and Apptainer.
1 parent 3956794 commit 076cc77

File tree

1 file changed

+24
-0
lines changed

1 file changed

+24
-0
lines changed

docs/index.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -195,6 +195,30 @@ After installation the binaries and Python modules live inside the environment,
195195
conda activate combine
196196
```
197197

198+
#### Pre-compiled image with CVMFS dependency
199+
200+
Pre-compiled versions of the tool are available as container images from the [GitLab CMS-analysis repository](http://gitlab-registry.cern.ch/cms-analysis/general/combine-container). This container is built together with the [`CombineHarvester`](http://cms-analysis.github.io/CombineHarvester/) package and is **recommended for users with CVMFS access**.
201+
202+
```shell
203+
export APPTAINER_CACHEDIR="/tmp/$(whoami)/apptainer_cache"
204+
apptainer shell -B /cvmfs -B /eos -B /afs /cvmfs/unpacked.cern.ch/gitlab-registry.cern.ch/cms-analysis/general/combine-container:latest /bin/bash
205+
```
206+
207+
Then in the Apptainer shell:
208+
209+
```shell
210+
source /cvmfs/cms.cern.ch/cmsset_default.sh
211+
cd /home/cmsusr/CMSSW_14_1_0_pre4/
212+
cmsenv # Ignore errors
213+
```
214+
215+
Alternatively, you can set up Combine with a single-line command which relies on the same image:
216+
217+
```
218+
source /cvmfs/cms.cern.ch/cat/combine_env.sh
219+
```
220+
Note that the batch submission is not supported with this setup; if needed refer to the [default setup instructions](https://cms-analysis.github.io/HiggsAnalysis-CombinedLimit/latest/#within-cmssw-recommended-for-cms-users).
221+
198222
#### Pre-compiled versions in Docker
199223

200224
Pre-compiled versions of the tool are available as container images from the [CMS cloud](https://gitlab.cern.ch/cms-cloud/combine-standalone/container_registry/15235). These containers can be downloaded and run using [Docker](https://cms-opendata-guide.web.cern.ch/tools/docker/). If you have docker running you can pull and run the image using,

0 commit comments

Comments
 (0)