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

Commit 9a26d846 authored by Fabio Hernandez's avatar Fabio Hernandez
Browse files

Clarify some statements and add sudo for mounting on Yosemite

parent 4cb00fad
......@@ -7,17 +7,17 @@ Context and perspectives about this work can be found in [this presentation](htt
**WARNING** : *please bear in mind that this work is experimental. Your feedback on how to improve it is very welcome. Scroll to the end of this document to know how you can provide feedback.*
# Expected Benefits
# Benefits
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 client machine.
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.
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.
### Installing on Scientific Linux 6 and 7, CentOS 7 (64 bits)
To download the software from CERN's repository and install it do:
......@@ -40,9 +40,9 @@ Download and install CernVM FS:
$ sudo dpkg -i ./cvmfs-keys_1.5-1_all.deb ./cvmfs_2.1.19_amd64.deb
### Installing on MacOS X 10.10 Yosemite
1. 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.
* 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.
2. Download and install [the CernVM FS client package](https://ecsft.cern.ch/dist/cvmfs/cvmfs-2.1.20/cvmfs-2.1.20.pkg). Alternatively, you can do it manually if you prefer:
* Download and install [the CernVM FS client package](https://ecsft.cern.ch/dist/cvmfs/cvmfs-2.1.20/cvmfs-2.1.20.pkg). Alternatively, you can do it manually if you prefer:
```
$ cd /tmp
......@@ -54,9 +54,9 @@ At this point, you have installed the CernVM FS client software on your machine.
# Configuration
The configuration of CernVM FS client to use the binary distribution of LSST software served by CC-IN2P3 is a *one-time operation*. It needs to be performed by user `root`.
Configuring the CernVM FS client to use the binary distribution of LSST software served by CC-IN2P3 is a *one-time operation*:
* Clone this repository and run the provided configuration script. The configuration script needs super-user privileges for creating or modifying some configuration files under `/etc/cvmfs`:
* Clone this repository and run the provided configuration script. The configuration script needs super-user privileges:
$ cd /tmp
$ git clone https://github.com/airnandez/lsst-cvmfs.git
......@@ -69,13 +69,13 @@ The configuration of CernVM FS client to use the binary distribution of LSST sof
* **[MacOS X only]** On MacOS X, you need to manually mount the file system:
$ /sbin/mount -t cvmfs lsst.in2p3.fr /cvmfs/lsst.in2p3.fr
$ sudo mount -t cvmfs lsst.in2p3.fr /cvmfs/lsst.in2p3.fr
For unmounting do:
$ /usr/bin/umount /cvmfs/lsst.in2p3.fr
$ sudo umount /cvmfs/lsst.in2p3.fr
* **[Linux - recommended]** On Linux, the CernVM FS client uses `autofs` for automatically mounting and unmounting the file system exposing the LSST software repository when needed. We suggest you to configure the `autofs` service to start at boot time. On Scientific Linux and CentOS do:
* **[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
......@@ -87,15 +87,15 @@ The configuration of CernVM FS client to use the binary distribution of LSST sof
Now you are ready to use the stack. See next section.
# Usage
In order to use the LSST software stack, you need to setup your environment for a specific version for which there is a binary distribution available. For instance, to use LSST `v10.1-rc3` on a Linux machine do:
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. For testing your installation you can [run the LSST demo](https://confluence.lsstcorp.org/display/LSWUG/Testing+the+Installation).
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 released are available for Linux-based machines by visiting the directory:
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
......@@ -110,7 +110,7 @@ Currently you will find the releases presented in the table below:
| Linux, x86_64, 64bits | `v9.2`, `v10.1-rc3` |
| Darwin, x86_64, 64bits | `v10.1-rc3` |
For details on the platform each binary release was built on please refer the `README` file in the corresponding directory.
For details on the platform each binary release was built on please refer to the `README` file in the corresponding directory.
# Advanced usage
Details on how to use this distribution mechanism for more advanced use cases are provided in the [Advanced Usage](AdvancedUsage.md) document. There you will find details on how you can develop your own software package which depends on other packages already present in the binary distribution.
......
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