90 lines
3.8 KiB
Markdown
90 lines
3.8 KiB
Markdown
# Flexlm
|
||
|
||
1. [Overview](#overview)
|
||
2. [Role Variables](#role-variables)
|
||
3. [Example Playbook](#example-playbook)
|
||
4. [Configuration](#configuration)
|
||
5. [Development](#development)
|
||
6. [License](#license)
|
||
7. [Author Information](#author-information)
|
||
|
||
## Overview
|
||
|
||
A role to manage Flexlm daemon.
|
||
|
||
## Role Variables
|
||
|
||
* **flexlm__packages_state** : State of package(s) [default : `present`].
|
||
* **flexlm__packages_manage** : If package(s) should be managed with this role [default : `True`].
|
||
* **flexlm__dependent_packages** : List of additional packages requested as 'flexlm' dependencies [default : `lsb-core`, `unzip`]
|
||
* **flexlm__lmgrd_version** : Version of `lmgrd` to use [default : `11.14.0.1`].
|
||
* **flexlm__lmgrd_source** : Source of the `lmgrd` bin to send [default : `usr/local/bin/lmgrd`].
|
||
* **flexlm__lmgrd_path** : The place to store `lmgrd` bin [default : `/usr/local/bin/lmgrd`].
|
||
* **flexlm__lmutil_source** : Source of the `lmutil` bin to send [default : `usr/local/bin/lmutil`].
|
||
* **flexlm__lmutil_path** : The place to store `lmutil` bin [default : `/usr/local/bin/lmutil`].
|
||
* **flexlm__user_name** : Username used to launch `lmgrd` [default : `flexlm`].
|
||
* **flexlm__licence_file** : Licence file to deserve [default : `/opt/flexlm/VENDOR/licence.lic`].
|
||
* **flexlm__service_manage** : If Licence Manager service should be managed with this role [default : `True`].
|
||
* **flexlm__service_enabled** : If Licence Manager service should be enable at startup [default : `True`].
|
||
* **flexlm__service_name** : Service name [default : `flexlm`].
|
||
* **flexlm__service_description** : Description of the systemd unit [default : `flexlm Licence Manager`].
|
||
* **flexlm__service_working_directory** : Working directory of the systemd unit [default : `/opt/flexlm/VENDOR`].
|
||
* **flexlm__service_unit_path** : Systemd unit path [default : `/etc/systemd/system/{{ flexlm__service_name }}.service`].
|
||
* **flexlm__service_unit_content** : Template used to generate the previous file [default : `etc/systemd/system/flexlm.service.j2`].
|
||
|
||
## Example Playbook
|
||
|
||
* Manage Flexlm with defaults vars :
|
||
|
||
``` yml
|
||
- hosts: serverXYZ
|
||
roles:
|
||
- role: ipr-cnrs.flexlm
|
||
```
|
||
|
||
* Manage Flexlm to provide Intel Fortran :
|
||
|
||
``` yml
|
||
- hosts: intel-lm
|
||
croles:
|
||
- role: ipr-cnrs.flexlm
|
||
flexlm__service_working_directory: '/opt/intel/bin'
|
||
flexlm__licence_file: '/opt/intel/etc/license.lic'
|
||
flexlm__service_description: 'Licence Manager for Intel Fortran'
|
||
```
|
||
|
||
## Configuration
|
||
|
||
This role will :
|
||
* Copy the `lmgrd` and `lmutil` binaries to the client.
|
||
* Create a specific user to launch daemon.
|
||
* Set up a systemd service. [Thanks to Kalebo instructions][kalebo instruction flexlm systemd].
|
||
|
||
The `lmgrd` and `lmutil` binaries comes from [Mathworks][mathworks download url] in version **flexlm__lmgrd_version**.
|
||
|
||
## Development
|
||
|
||
This source code comes from our [Gogs instance][flexlm source] and the [Github repo][flexlm github] exist just to be able to send the role to Ansible Galaxy…
|
||
|
||
But feel free to send issue/PR anywhere :)
|
||
|
||
Thanks to this [hook][gogs to github hook], Github automatically got updates from our [Gogs instance][flexlm source] :)
|
||
|
||
## License
|
||
|
||
[WTFPL][wtfpl website]
|
||
|
||
## Author Information
|
||
|
||
Jérémy Gardais
|
||
* Source : [on IPR's Gogs][flexlm source]
|
||
* [IPR][ipr website] (Institut de Physique de Rennes)
|
||
|
||
[gogs to github hook]: https://stackoverflow.com/a/21998477
|
||
[flexlm source]: https://git.ipr.univ-rennes1.fr/cellinfo/ansible.flexlm
|
||
[flexlm github]: https://github.com/ipr-cnrs/flexlm
|
||
[wtfpl website]: http://www.wtfpl.net/about/
|
||
[ipr website]: https://ipr.univ-rennes1.fr/
|
||
[mathworks download url]: https://fr.mathworks.com/support/install/license_manager_files.html
|
||
[kalebo instruction flexlm systemd]: https://gist.github.com/kalebo/fd39edb6c6e4ebed41f7eab2d9925ebc
|