``profile::gpfs``
=================

Install and configure the `GPFS parallel file system
<https://en.wikipedia.org/wiki/IBM_General_Parallel_File_System>`_.

The installation also includes the configuration of the rpm repositories.

Parameters
----------

=================  ==========  ===========
**Name**           **Type**    **Default**
-----------------  ----------  -----------
version            string
repo_base_url      string
setup_repos        bool        true
setup_pmsensors    bool        true
setup_pmcollector  bool        false
setup_ces          bool        false
setup_gui          bool        false
fs_opts            hash        empty hash
=================  ==========  ===========


``version``
~~~~~~~~~~~

The version of GPFS to install.


``repo_base_url``
~~~~~~~~~~~~~~~~~

The base URL of the GPFS repositories. Each version of GPFS comes in its own
repositories, which are assumed to be located under
``${repo_base_url}/${version}/``.

Repository configuration is subject to `setup_repos`_.


``setup_repos``
~~~~~~~~~~~~~~~

Whether or not to configure the GPFS repositories.


``setup_pmsensors``
~~~~~~~~~~~~~~~~~~~

Install packages needed to run the pmsensors service.

``setup_pmcollector``
~~~~~~~~~~~~~~~~~~~~~

Install packages needed to run the pmcollector service.

``setup_ces``
~~~~~~~~~~~~~


``setup_gui``
~~~~~~~~~~~~~

Install packages needed to run the gpfsgui service.

``fs_opts``
~~~~~~~~~~~

By default a GPFS filesystem will be mounted on all nodes of
the cluster with the same option, eg. it will be read-write if
the filesystem as been defined with read-write access (see ``mmfs``
for the mount options).

It is possible to override these option on a host specific base
configuring a file named ``/var/mmfs/etc/localMountOptions.<filesystem>``
with one option per line.

Please note that even if the parameter is ``fs_opts`` in the code,
the hiera variable is called ``fs_mount_opts``.

The following hiera code can be used to make the ``beamline`` filesystem
mounted in read-only mode::

  gpfs::fs_mount_opts:
  'beamline': ['ro']





