Indigo-dc.cvmfs-client

Ansible role to install CernVM-FS Client.

Requirements

You need Python on the host to run Ansible.

The apt module in Ansible needs the following package on the host:

• python-apt (for Python 2)

Variables

• server_url: set the CVMFS server URL (like an IP address or a domain).

• repository_name: set the name of the CVMFS server repository (default: elixir-italy.galaxy.refdata).

• cvmfs_server_url: set the complete URL for the CVMFS server (default: 'http://{{ server_url }}/cvmfs/{{ repository_name }}).

• cvmfs_public_key_path: set the path for CVMFS keys (default: /etc/cvmfs/keys).

• cvmfs_public_key: set the CVMFS public key, usually <repository_name.pub> (default: {{ repository_name }}.pub).

• cvmfs_preconfigured: allow mounting CVMFS volumes using a preconfigured file (default: false).

Preconfigured files can be found here.

• cvmfs_public_key_list_files: list of *.pub files with keys for the repository to be mounted.

• public_key_src_path: set the temporary path for the CVMFS public key (default: /tmp).

• proxy_url: set the proxy name (default: DIRECT).

• proxy_port: set the proxy port (default: 80).

• cvmfs_http_proxy: set the complete proxy URL (default: http://{{ proxy_url }}:{{ proxy_port }}).

• cvmfs_mountpoint: set the mount point for CVMFS (default: /cvmfs, for reference data use /refdata). If it is set to /cvmfs, the role will use cvmfs_config probe to mount the repository.

• add_fstab_entry: add an entry to fstab to automatically mount the repository (default: true).

Example Playbook

This role takes information about the CernVM-FS server (like address, public key, and mount point) as input parameters.

  - hosts: servers
    roles:
      - role: indigo-dc.cvmfs-client
        server_url: '90.147.102.186'
        repository_name: 'elixir-italy.galaxy.refdata'
        cvmfs_public_key: 'elixir-italy.galaxy.refdata.pub'
        proxy_url: 'DIRECT'
        proxy_port: '80'
        cvmfs_mountpoint: '/refdata'

Mount a volume using preconfigured CVMFS config.d files.

  - hosts: servers
    roles:
      - role: indigo-dc.cvmfs-client
        repository_name: 'elixir-italy.galaxy.refdata'
        cvmfs_public_key: 'elixir-italy.galaxy.refdata.pub'
        cvmfs_mountpoint: '/refdata'
        cvmfs_preconfigured: true

License

Apache License v2: http://www.apache.org/licenses/LICENSE-2.0

Reference

Official CVMFS documentation: http://cvmfs.readthedocs.io/en/stable/cpt-repo.html

NIKHEF documentation: https://wiki.nikhef.nl/grid/Adding_a_new_cvmfs_repository