environment-modules - Githubissues

Software Name

Environment Modules

Public URL

http://modules.sourceforge.net/

Technical Overview

The original module command. The Environment Modules project was live again in 2017 and a lot of new stuff has been added to the module command since them. Here is an overview of some of the new features added and a roadmap for the next releases. This slide deck also contains a short comparison with Lmod.

Version 5.1 has been released few days ago and starting this version Environment Modules can handle the Tcl modulefiles written for Lmod. So it now copes with the family, depends-on, module try-add commands used in OpenHPC modulefiles.

So it seems this is a good time to ask for the integration of Environment Modules in OpenHPC, as an alternative choice for users to the default solution (Lmod).

Latest stable version number

5.1.0

Open-source license type

GPLv2+

Relationship to component?

[x] contributing developer
[ ] user
[ ] other

If other, please describe:

Build system

[x] autotools-based
[ ] CMake
[x] other

If other, please describe: configure script is a bash script, but it acts like an autotools-generated configure script.

A RPM spec file is available at https://github.com/cea-hpc/modules/blob/master/contrib/rpm/environment-modules.spec.in

Does the current build system support staged path installations? For example: make install DESTIR=/tmp/foo (or equivalent)

[x] yes
[ ] no

Does component run in user space or are administrative credentials required?

[x] user space
[ ] admin

Does component require post-installation configuration.

[x] yes
[ ] no

If yes, please describe briefly: If you want to achieve an initial configuration of the user environment, with default modulepaths set and default module loaded, the /etc/environment-modules/initrc configuration file has to be changed. For instance, to reproduce a similar configuration than the one set in /etc/profile.d/lmod.{sh,csh}:

#%Module5.0
# ensure that module command is still defined in sub-shells
module config set_shell_startup 1

module use /opt/ohpc/pub/modulefiles
if {[module-info username root]} {
    module use /opt/ohpc/admin/modulefiles
}

# Load baseline OpenHPC environment
module try-add ohpc

If component is selected, are you willing and able to collaborate with OpenHPC maintainers during the integration process?

[x] yes
[ ] no

Does the component include test collateral (e.g. regression/verification tests) in the publicly shipped source?

[x] yes
[ ] no

If yes, please briefly describe the intent and location of the tests. Modules is shipped with:

a testsuite, checking that the generated modulecmd.tcl script behaves properly for all a large variety of situations (17k+ tests): run make test
an installation testsuite, checking the overall Modules installation behaves properly (1k tests): run make testinstall

All these tests rely on the DejaGnu framework

Does the component have additional software dependencies (beyond compilers/MPI) that are not part of standard Linux distributions?

[ ] yes
[x] no

If yes, please list the dependencies and associated licenses.

Does the component include online or installable documentation?

[x] yes
[ ] no

If available online, please provide URL. https://modules.readthedocs.io/en/stable/INSTALL.html

[Optional]: Would you like to receive additional review feedback by email?

- [x] yes - [ ] no

--- /path/to/modules/contrib/rpm/environment-modules.spec 2022-05-04 22:21:28.253456037 +0200 +++ environment-modules.spec 2022-05-04 19:36:20.000000000 +0200 @@ -1,7 +1,11 @@ %global macrosdir %(d=%{_rpmconfigdir}/macros.d; [ -d $d ] || d=%{_sysconfdir}/rpm; echo $d) %global vimdatadir %{_datadir}/vim/vimfiles -Name: environment-modules +%global ohpc_bootstrap 1 +%include %{_sourcedir}/OHPC_macros +%define pname environment-modules + +Name: %{pname}%{PROJ_DELIM} Version: 5.1.0 Release: 1%{?dist} Summary: Provides dynamic modification of a user's environment @@ -46,6 +50,8 @@ %endif Obsoletes: modules-tcl <= 1.923 Obsoletes: environment-modules-compat <= 4.8.99 +Provides: lmod%{PROJ_DELIM} +Conflicts: lmod%{PROJ_DELIM} %description The Environment Modules package provides for the dynamic modification of @@ -85,7 +91,7 @@ %configure --prefix=%{_datadir}/Modules \ --libdir=%{_libdir} \ - --etcdir=%{_sysconfdir}/%{name} \ + --etcdir=%{_sysconfdir}/%{pname} \ --bindir=%{_datadir}/Modules/bin \ --libexecdir=%{_datadir}/Modules/libexec \ --mandir=%{_mandir} \ @@ -95,9 +101,7 @@ --with-zshcompletiondir=%{_datadir}/zsh/site-functions \ --enable-multilib-support \ --disable-doc-install \ - --enable-modulespath \ --with-python=%{pythonbin} \ - --with-modulepath=%{_datadir}/Modules/modulefiles:%{_sysconfdir}/modulefiles:%{_datadir}/modulefiles \ --with-quarantine-vars='LD_LIBRARY_PATH LD_PRELOAD' %if 0%{?fedora} >= 22 || 0%{?rhel} >= 7 @@ -142,7 +146,22 @@ mv {doc/build/,}changes.txt # install the rpm config file -install -Dpm 644 contrib/rpm/macros.%{name} %{buildroot}/%{macrosdir}/macros.%{name} +install -Dpm 644 contrib/rpm/macros.%{pname} %{buildroot}/%{macrosdir}/macros.%{pname} + +# Customize startup configuration to suit +%{__cat} << EOF > %{buildroot}/%{_sysconfdir}/%{pname}/initrc +#%Module5.0 +# ensure that module command is still defined in sub-shells +module config set_shell_startup 1 + +module use %{OHPC_MODULES} +if {[module-info username root]} { + module use %{OHPC_ADMIN}/modulefiles +} + +# Load baseline OpenHPC environment +module try-add ohpc +EOF %check @@ -206,16 +225,15 @@ %{_datadir}/zsh/site-functions/_module %dir %{_datadir}/fish/vendor_completions.d %{_datadir}/fish/vendor_completions.d/module.fish -%dir %{_sysconfdir}/%{name} -%config(noreplace) %{_sysconfdir}/%{name}/initrc -%config(noreplace) %{_sysconfdir}/%{name}/modulespath -%config(noreplace) %{_sysconfdir}/%{name}/siteconfig.tcl +%dir %{_sysconfdir}/%{pname} +%config(noreplace) %{_sysconfdir}/%{pname}/initrc +%config(noreplace) %{_sysconfdir}/%{pname}/siteconfig.tcl %{_datadir}/Modules/modulefiles %{_datadir}/modulefiles %{_mandir}/man1/ml.1.gz %{_mandir}/man1/module.1.gz %{_mandir}/man4/modulefile.4.gz -%{macrosdir}/macros.%{name} +%{macrosdir}/macros.%{pname} %{vimdatadir}/ftdetect/modulefile.vim %{vimdatadir}/ftplugin/modulefile.vim %{vimdatadir}/syntax/modulefile.vim

openhpc / submissions

environment-modules #48