ansible.flexlm/README.md

4.4 KiB
Raw Blame History

Flexlm

  1. Overview
  2. Role Variables
  3. Example Playbook
  4. Configuration
  5. Known Issues
  6. Development
  7. License
  8. 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__licences: Lists to manage vendor daemon and licence files [default: []].
  • 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_unit_content: Template used to generate the previous file [default: etc/systemd/system/flexlm.service.j2].

Example Playbook

  • Manage Flexlm with defaults vars:
- hosts: serverXYZ
  roles:
    - role: ipr-cnrs.flexlm
  • Manage Flexlm to provide Intel Fortran (without binaries):
- hosts: intel-lm
  roles:
    - role: ipr-cnrs.flexlm
      flexlm__licences:
        - name: intel
          description: 'flexlm Licence Manager for Matlab'
          bin_path: '/opt/intel/bin'
          lic_path: '/opt/matlab/etc/licence.lic'          # need to be a file
  • Manage Flexlm to provide Matlab Licence and vendor daemon binaries:
- hosts: matlab-lm
  roles:
    - role: ipr-cnrs.flexlm
      flexlm__licences:
        - name: matlab
          description: 'flexlm Licence Manager for Matlab'
          bin_path: '/opt/matlab/bin'
          bin_src: '{{ inventory_dir + "/../resources/service/matlab-lm/bin/" }}'
          lic_path: '/opt/matlab/etc/licence.lic'                                                # need to be a file
          lic_src: '{{ inventory_dir + "/../resources/host/matlab-lm.domain/etc/licence.lic" }}' # need to be a file

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 (flexlm-NAME). Thanks to Kalebo instructions.
  • Copy vendor daemon binaries to the host if source is specified.
  • Copy licence file to the host if source is specified.

The lmgrd and lmutil binaries comes from Mathworks in version flexlm__lmgrd_version.

Known Issues

  • If a value of one licence change in flexlm__licences var, all services will be restarted.

Development

This source code comes from our Gogs instance and the Github repo exist just to be able to send the role to Ansible Galaxy…

But feel free to send issue/PR anywhere :)

Thanks to this hook, Github automatically got updates from our Gogs instance :)

License

WTFPL

Author Information

Jérémy Gardais