Docker-in-Docker (DinD) capabilities of public runners deactivated. More info

Commit e47bb4d9 authored by Fabio Hernandez's avatar Fabio Hernandez
Browse files

Require bash to run configure

parent dd4510eb
......@@ -11,11 +11,11 @@ Context and perspectives about this work can be found in [this presentation](htt
With this method, you need to install and configure CernVM FS only once. Once this is done, when your computer is connected to the network, you will find the available versions of the LSST software stack under the local directory:
/cvmfs/lsst.in2p3.fr
This method of distributing the software is particularly useful for individuals: you don't need to install each official LSST software release from sources on your personal computer, but rather to automatically mount and use the binary distributions prepared for your convenience.
Please note that you don't need special privileges to use the LSST software stack distributed this way: any user on a pre-configured computer can use the software. However, in order to install and configure CernVM FS, a one-time process, you need super-user privileges on the target machine.
# Installation
So far we have succesfully tested this installation on MacOS X 10.10 Yosemite, Scientific Linux 6, Scientific Linux 7, CentOS 7 and Ubuntu 14.04. It may work on other Linux distributions as well.
......@@ -31,14 +31,14 @@ To download the software from CERN's repository and install it do:
Some packages are either necessary or recommended on Ubuntu. To install them do:
$ sudo apt-get install autofs attr gdb git sysv-rc-conf
Download and install CernVM FS:
$ cd /tmp
$ curl -O https://ecsft.cern.ch/dist/cvmfs/cvmfs-2.1.19/cvmfs_2.1.19_amd64.deb
$ curl -O https://ecsft.cern.ch/dist/cvmfs/cvmfs-keys/cvmfs-keys_1.5-1_all.deb
$ sudo dpkg -i ./cvmfs-keys_1.5-1_all.deb ./cvmfs_2.1.19_amd64.deb
### Installing on MacOS X 10.10 Yosemite
* Download and install the latest stable release of [FUSE for OS X](https://osxfuse.github.io/). This is a dependency of the CernVM FS client.
......@@ -49,7 +49,7 @@ Download and install CernVM FS:
$ curl -O https://ecsft.cern.ch/dist/cvmfs/cvmfs-2.1.20/cvmfs-2.1.20.pkg
$ open cvmfs-2.1.20.pkg
```
At this point, you have installed the CernVM FS client software on your machine. For configuring it please see the next section.
......@@ -61,48 +61,48 @@ Configuring the CernVM FS client to use the binary distribution of LSST software
$ cd /tmp
$ git clone https://github.com/airnandez/lsst-cvmfs.git
$ cd lsst-cvmfs
$ sudo sh ./configure.sh
$ sudo bash ./configure.sh
After this step, among other things, an unprivileged user `cvmfs` is created in your computer and several configuration files with sensible default values are located under `/etc/cvmfs`.
You can tell the configuration process was successful if you don't see any error message.
* **[MacOS X only]** On MacOS X, you need to manually mount the file system:
$ sudo mount -t cvmfs lsst.in2p3.fr /cvmfs/lsst.in2p3.fr
For unmounting do:
$ sudo umount /cvmfs/lsst.in2p3.fr
* **[Linux - recommended]** On Linux, the CernVM FS client uses `autofs` for automatically mounting and unmounting the file system. We recommend to configure the `autofs` service to start at boot time. On Scientific Linux and CentOS do:
$ sudo chkconfig autofs on
and on Ubuntu, do:
$ sudo sysv-rc-conf autofs on
Now you are ready to use the stack. See next section.
# Usage
In order to use the LSST software stack, you need to bootstrap your environment for a specific version of the LSST software for which a binary distribution is available. For instance, to use LSST `v10.1-rc3` on a Linux machine do:
$ cd /cvmfs/lsst.in2p3.fr/software/linux-x86_64/lsst-v10.1-rc3
$ source loadLSST.sh
Note that you don't need super-user privileges to use this distribution of the LSST software. You may want to test your installation by [running the LSST demo](https://confluence.lsstcorp.org/display/LSWUG/Testing+the+Installation).
# Available releases
At any moment, you can see what releases are available for Linux-based machines by visiting the directory:
/cvmfs/lsst.in2p3.fr/software/linux-x86_64
The releases for MacOS X are availabe under:
/cvmfs/lsst.in2p3.fr/software/darwin-x86_64
Currently you will find the releases presented in the table below:
| Platform | Available versions of LSST software |
......@@ -120,7 +120,7 @@ Details on how to use this distribution mechanism for more advanced use cases ar
Please note that in order for this distribution mechanism to work for you, you need your machine to be connected to the network and able to contact CC-IN2P3 server. To check this is the case please do:
$ curl --proxy http://cctbcrnvmfsli01.in2p3.fr:3128 --head http://cccrnvmfs01.in2p3.fr/cvmfs/lsst.in2p3.fr/.cvmfspublished
You should see a line containning `HTTP/1.0 200 OK` which indicates that your machine can talk to the relevant server.
# Frequently Asked Questions
......@@ -131,12 +131,12 @@ You should see a line containning `HTTP/1.0 200 OK` which indicates that your ma
* **Where can I get more detailed information on CernVM FS?**
The [CernVM FS downloads page](http://cernvm.cern.ch/portal/filesystem/downloads) contains additional information. In addition, you may want to read the [CernVM FS Technical Information](http://cernvm.cern.ch/portal/filesystem/techinformation) for more in-depth information on how CernVM FS works.
The [CernVM FS downloads page](http://cernvm.cern.ch/portal/filesystem/downloads) contains additional information. In addition, you may want to read the [CernVM FS Technical Information](http://cernvm.cern.ch/portal/filesystem/techinformation) for more in-depth information on how CernVM FS works.
* **Can I use my remote LSST software distribution while disconnected from the network?**
The CernVM FS client caches all the file metadata and the contents of the accessed remote files in the local disk of your computer. If you have previously used the stack it is likely that the relevant files are locally available in your local disk, in which case, you may work while disconnected. However, we have not tested this thoroughly, so let us know how it works for you.
* **Can I use this for my Docker containers?**
Yes, you can configure your container for automatically mounting a read-only file system with LSST software stack ready to use. Sébastien Binet did exactly this, so you can just use as is or as a baseline for your own containers. You will find all the details [here](https://github.com/hepsw/docks/tree/master/cvmfs-lsst).
......
#!/bin/sh
#!/bin/bash
# Configure this machine as a CernVM FS client to access LSST
# software repository served by CC-IN2P3.
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment