xdmod
: Manage XDMoDxdmod::ondemand
: Manage XDMoD OnDemand plugin
xdmod::akrr::config
: Manage XDMoD AKRR configsxdmod::akrr::install
: Manage XDMoD AKRR installxdmod::akrr::service
: Manage XDMoD AKRR servicexdmod::akrr::user
: Manage XDMoD AKRR userxdmod::apache
: Manage XDMoD Apache configsxdmod::config
: Manage XDMoD configsxdmod::config::simplesamlphp
: Manage XDMoD simplesamlphpxdmod::database
: Manage XDMoD databasesxdmod::install
: Manage XDMoD packagesxdmod::params
: XDMoD module defaultsxdmod::supremm::compute::pcp
: Manage XDMoD compute PCPxdmod::supremm::config
: Manage XDMoD SUPReMM configsxdmod::supremm::database
: Manage XDMoD SUPReMM databasesxdmod::supremm::install
: Manage XDMoD SUPReMM packagesxdmod::user
: Manage XDMoD user
xdmod::akrr::setting
: Manage AKRR config setting value
xdmod_appkernel_setting
: Section/setting name to manage from appkernels.inixdmod_ondemand_setting
: Section/setting name to manage from ondemand.inixdmod_portal_setting
: Section/setting name to manage from portal_settings.inixdmod_supremm_setting
: Section/setting name to manage from supremm.ini
xdmod::member_substring
: Function to test member substring
Manage XDMoD
The following parameters are available in the xdmod
class:
version
xdmod_appkernels_version
xdmod_supremm_version
database
web
akrr
supremm
supremm_database
compute
enable_appkernel
enable_supremm
enable_cloud_realm
enable_ondemand
local_repo_name
manage_epel
package_ensure
xdmod_supremm_package_ensure
xdmod_appkernels_package_ensure
package_name
package_url
appkernels_package_name
appkernels_package_url
xdmod_supremm_package_name
xdmod_supremm_package_url
database_host
database_port
database_user
database_password
akrr_database_user
akrr_database_password
web_host
akrr_host
scheduler
shredder_command
shred_hour_start
shred_minutes
ingest_hour
enable_update_check
manage_apache_vhost
apache_vhost_name
apache_ssl_cert
apache_ssl_key
apache_ssl_chain
portal_settings
hierarchy_levels
hierarchies
group_to_hierarchy
user_pi_names
organization_name
organization_abbrev
resources
resource_specs
sender_email
debug_recipient
php_timezone
center_logo_source
center_logo_width
user_dashboard
cors_domains
manage_user
user_uid
group_gid
data_warehouse_export_directory
data_warehouse_export_retention_duration_days
data_warehouse_export_hash_salt
batch_export_cron_times
manage_simplesamlphp
simplesamlphp_config_content
simplesamlphp_config_source
simplesamlphp_authsources_content
simplesamlphp_authsources_source
simplesamlphp_metadata_content
simplesamlphp_metadata_source
simplesamlphp_cert_country
simplesamlphp_cert_organization
simplesamlphp_cert_commonname
akrr_source_url
akrr_version
akrr_home
manage_akrr_user
akrr_user
akrr_user_group
akrr_user_group_gid
akrr_user_uid
akrr_user_shell
akrr_user_home
akrr_user_managehome
akrr_user_comment
akrr_user_system
akrr_restapi_port
akrr_restapi_rw_password
akrr_restapi_ro_password
akrr_cron_mailto
akrr_ingestor_cron_times
appkernel_reports_manager_cron_times
supremm_version
supremm_package_ensure
supremm_package_url
supremm_package_name
supremm_mongodb_password
supremm_mongodb_host
supremm_mongodb_uri
supremm_mongodb_replica_set
supremm_resources
supremm_update_cron_times
ingest_jobscripts_cron_times
aggregate_supremm_cron_times
supremm_archive_out_dir
supremm_prometheus_url
supremm_prometheus_step
supremm_prometheus_rates
use_pcp
pcp_declare_method
pcp_resource
pcp_pmlogger_path_suffix
pcp_pmlogger_config_template
pcp_pmlogger_config_source
pcp_logging_static_freq
pcp_logging_standard_freq
pcp_static_metrics
pcp_standard_metrics
pcp_environ_metrics
pcp_merge_metrics
pcp_hotproc_exclude_users
storage_roles_source
storage_cron_times
Data type: String
Version of XDMoD to install
Default value: $xdmod::params::version
Data type: String
Version of XDMoD AppKernels to install
Default value: $xdmod::params::xdmod_appkernels_version
Data type: String
Version of XDMoD SUPReMM to install
Default value: $xdmod::params::xdmod_supremm_version
Data type: Boolean
Sets database role
Default value: true
Data type: Boolean
Sets web role
Default value: true
Data type: Boolean
Sets akrr role
Default value: false
Data type: Boolean
Sets supremm role
Default value: false
Data type: Boolean
Sets supremm database role
Default value: false
Data type: Boolean
Sets compute role
Default value: false
Data type: Boolean
Enable XDMoD AppKernel support
Default value: false
Data type: Boolean
Enable XDMod SUPReMM support
Default value: false
Data type: Boolean
Enable the XDMoD cloud realm by adding the necessary database
Default value: false
Data type: Boolean
Enable the XDMOD OnDemand plugin and necessary database
Default value: false
Data type: Optional[String]
Name of yum repo hosting RPMs
Default value: undef
Data type: Boolean
Boolean that sets if EPEL should be managed
Default value: true
Data type: String
XDMoD package ensure property
Default value: 'present'
Data type: String
XDMoD supremm package ensure property
Default value: 'present'
Data type: String
XDMoD appkernels package ensure property
Default value: 'present'
Data type: String
XDMoD package name
Default value: $xdmod::params::package_name
Data type: Variant[Stdlib::HTTPSUrl, Stdlib::HTTPUrl]
XDMoD package RPM URL, not used if local_repo_name
is defined
Default value: $xdmod::params::package_url
Data type: String
XDMoD appkernels package name
Default value: $xdmod::params::appkernels_package_name
Data type: Variant[Stdlib::HTTPSUrl, Stdlib::HTTPUrl]
XDMoD appkernels package RPM URL, not used if local_repo_name
is defined
Default value: $xdmod::params::appkernels_package_url
Data type: String
XDMoD supremm package name
Default value: $xdmod::params::xdmod_supremm_package_name
Data type: Variant[Stdlib::HTTPSUrl, Stdlib::HTTPUrl]
XDMoD supremm package RPM URL, not used if local_repo_name
is defined
Default value: $xdmod::params::xdmod_supremm_package_url
Data type: String
XDMoD database host
Default value: 'localhost'
Data type: Integer
XDMoD database port
Default value: 3306
Data type: String
XDMoD database user
Default value: 'xdmod'
Data type: String
XDMoD database password
Default value: 'changeme'
Data type: String
AKRR database user
Default value: 'akrr'
Data type: String
AKRR database password
Default value: 'changeme'
Data type: String
FQDN of web host
Default value: 'localhost'
Data type: String
FQDN of AKRR host
Default value: 'localhost'
Data type: Enum['slurm','torque','pbs','sge']
Scheduler to shred, used to define default shred commands and PI column
Default value: 'slurm'
Data type: Optional[Variant[String, Array]]
Shred command(s)
Default value: undef
Data type: Integer[0,23]
The numeric hour to start shredding
Default value: 1
Data type: Integer
Time in minutes between shred operations if multiple shred commands
Default value: 5
Data type: Optional[Integer[0,23]]
The numeric hour to start ingest
Default value: undef
Data type: Boolean
Enable XDMoD update check
Default value: true
Data type: Boolean
Manage the XMDoD Apache Virtual Host
Default value: true
Data type: String
The Apache Virtual Host name
Default value: $xdmod::params::apache_vhost_name
Data type: Stdlib::Unixpath
Path to SSL cert used by Apache
Default value: '/etc/pki/tls/certs/localhost.crt'
Data type: Stdlib::Unixpath
Path to SSL private key used by Apache
Default value: '/etc/pki/tls/private/localhost.key'
Data type: Optional[Stdlib::Unixpath]
Path to SSL chain used by Apache
Default value: undef
Data type: Hash
Hash of portal_settings.ini settings to pass to xdmod_portal_setting
resources
Default value: $xdmod::params::portal_settings
Data type: Xdmod::Hierarchy_Levels
Hierarchy levels used when defining hierarchies
Default value: $xdmod::params::hierarchy_levels
Data type: Array
Hierarchy lines, see XDMoD docs
Default value: $xdmod::params::hierarchies
Data type: Hash
Group to Hierarchy mappings, see XDMoD docs
Default value: $xdmod::params::group_to_hierarchy
Data type: Array
User and PI names, see XDMoD docs
Default value: $xdmod::params::user_pi_names
Data type: Optional[String]
Organization name for XDMoD instance
Default value: undef
Data type: Optional[String]
Organization abbreviation for XDMoD instance
Default value: undef
Data type: Array[Xdmod::Resource]
Resources to define resources.json
Default value: []
Data type: Array[Xdmod::Resource_Spec]
Resource specs for resource_specs.json
Default value: []
Data type: String
Configure sender for EMail
Default value: $xdmod::params::sender_email
Data type: String
Configure email addres to receive debug information
Default value: ''
Data type: Optional[String]
PHP Timezone
Default value: undef
Data type: Optional[String]
Source to image that will be used as center logo in XDMoD
Default value: undef
Data type: Optional[Integer]
The width of file from center_logo_source
Default value: undef
Data type: Enum['on','off']
The value for user_dashboard
in portal_settings.ini
Default value: 'off'
Data type: Array
The value for domains
in cors
section of portal_settings.ini
Default value: []
Data type: Boolean
Boolean that sets if managing XMDoD user
Default value: true
Data type: Optional[Integer]
XMDoD user UID
Default value: undef
Data type: Optional[Integer]
XDMoD user group GID
Default value: undef
Data type: Stdlib::Absolutepath
Path used for data warehouse export
Default value: '/var/spool/xdmod/export'
Data type: Integer
portal_settings.ini section=data_warehouse_export setting=retention_duration_days
Default value: 30
Data type: String
portal_settings.ini section=data_warehouse_export setting=hash_salt
Default value: sha256($::fqdn)
Data type: Array[Integer, 2 ,2]
cron times to run batch export
Default value: [0,4]
Data type: Boolean
Boolean that sets if managing simplesamlphp
Default value: false
Data type: Optional[String]
The content for simplesamlphp config
Default value: undef
Data type: Optional[String]
The source for simplesamlphp config
Default value: undef
Data type: Optional[String]
The content for simplesaml php authsources
Default value: undef
Data type: Optional[String]
The source for simplesaml php authsources
Default value: undef
Data type: Optional[String]
The simplesamlphp metadata content
Default value: undef
Data type: Optional[String]
The simplesamlphp metadata source
Default value: undef
Data type: String
The simplesamlphp cert country
Default value: 'US'
Data type: Optional[String]
The simplesamlphp cert organization
Default value: undef
Data type: Optional[String]
The simplesamlphp cert commonname
Default value: undef
Data type: Variant[Stdlib::HTTPSUrl, Stdlib::HTTPUrl]
The AKRR source URL
Default value: $xdmod::params::akrr_source_url
Data type: String
The AKRR version. This version is used to build default akrr_source_url
.
Default value: $xdmod::params::akrr_version
Data type: Optional[Stdlib::Unixpath]
AKRR home path
Default value: undef
Data type: Boolean
Boolean to manage AKRR user
Default value: true
Data type: String
AKRR username
Default value: 'akrr'
Data type: String
AKRR user group name
Default value: 'akrr'
Data type: Optional[Integer]
AKRR user gropu GID
Default value: undef
Data type: Optional[Integer]
AKRR user UID
Default value: undef
Data type: Stdlib::Unixpath
AKRR user shell
Default value: '/bin/bash'
Data type: Optional[Stdlib::Unixpath]
AKRR user home
Default value: undef
Data type: Boolean
AKRR user managehome property
Default value: true
Data type: String
AKRR user comment
Default value: 'AKRR'
Data type: Boolean
AKRR user system property
Default value: true
Data type: Integer
AKRR restapi port
Default value: 8091
Data type: String
AKRR restapi RW password
Default value: $xdmod::params::akrr_restapi_rw_password
Data type: String
AKRR restapi RO password
Default value: $xdmod::params::akrr_restapi_ro_password
Data type: Optional[String]
AKRR cron MAILTO
Default value: undef
Data type: Array[Integer, 2, 2]
AKRR ingestor cron times
Default value: [0,5]
Data type: Array[Integer, 2, 2]
AppKernel report manager cron times
Default value: [0,6]
Data type: String
Version of SUPReMM to install, builds supremm_package_url
if not defined
Default value: $xdmod::params::supremm_version
Data type: String
SUPReMM package ensure property
Default value: 'present'
Data type: Variant[Stdlib::HTTPSUrl, Stdlib::HTTPUrl]
The URL to download SUPReMM RPM from
Default value: $xdmod::params::supremm_package_url
Data type: String
SUPReMM RPM package name
Default value: 'supremm'
Data type: String
SUPReMM mongodb password
Default value: 'changeme'
Data type: String
SUPReMM mongodb host
Default value: 'localhost'
Data type: Optional[String]
SUPReMM mongodb URI
Default value: undef
Data type: Optional[String]
SUPReMM mongodb replica set
Default value: undef
Data type: Array[Xdmod::Supremm_Resource]
SUPReMM resources
Default value: []
Data type: Array[Integer, 2, 2]
The cron times to run supremm_update
Default value: [0,2]
Data type: Array[Integer, 2, 2]
The cron times to ingest job scripts
Default value: [0,3]
Data type: Array[Integer, 2, 2]
The cron times to run supremm aggregation
Default value: [0,4]
Data type: Stdlib::Absolutepath
The path to supremm archive out
Default value: '/dev/shm/supremm_test'
Data type: Optional[Variant[Stdlib::HTTPSUrl, Stdlib::HTTPUrl]]
Prometheus URL to use with SUPREMM summarization
Default value: undef
Data type: Optional[String[1]]
Prometheus step value for SUPREMM summarization
Default value: undef
Data type: Optional[Hash]
Prometheus rate overrides for SUPREMM summarization
Default value: undef
Data type: Boolean
Boolean that PCP should be used for SUPREMM
Default value: true
Data type: Enum['include', 'resource']
Should pcp class be included or declared like a resource
Default value: 'resource'
Data type: Optional[String]
PCP resource name
Default value: undef
Data type: Optional[String]
PCP pmlogger path suffix
Default value: undef
Data type: String
Template for pmlogger config
Default value: 'xdmod/supremm/compute/pcp/pmlogger-supremm.config.erb'
Data type: Optional[String]
Source for pmlogger config
Default value: undef
Data type: String
Frequency for PCP logging static metrics
Default value: '1 hour'
Data type: String
Frequency for PCP logging standard metrics
Default value: '30 sec'
Data type: Array
PCP static metrics
Default value: $xdmod::params::supremm_pcp_static_metrics
Data type: Array
PCP standard metrics
Default value: $xdmod::params::supremm_pcp_standard_metrics
Data type: Array
PCP environment metrics
Default value: $xdmod::params::supremm_pcp_environ_metrics
Data type: Boolean
Boolean that PCP metrics should be merged with defaults
Default value: true
Data type: Array
Users to exclude from PCP hotproc
Default value: $xdmod::params::supremm_pcp_hotproc_exclude_users
Data type: String
The source of storage roles.json
Default value: 'puppet:///modules/xdmod/roles.d/storage.json'
Data type: Array[Integer, 2, 2]
The cron times for storage shred/ingest
Default value: [0,5]
Manage XDMoD OnDemand plugin
The following parameters are available in the xdmod::ondemand
class:
Data type: Optional[String]
The MaxMind GeoIP user ID Must be set if you wish to use GeoIP database
Default value: undef
Data type: Optional[String]
The MaxMind GeoIP license key Must be set if you wish to use GeoIP database
Default value: undef
Data type: String
The XDMOD OnDemand package name
Default value: 'xdmod-ondemand'
Data type: String
The state of XDMOD OnDemand package when using local repo
Default value: 'installed'
Data type: Stdlib::HTTPSUrl
The URL of the XDMOD OnDemand package when not using local repo
Default value: 'https://github.com/ubccr/xdmod-ondemand/releases/download/v9.5.0/xdmod-ondemand-9.5.0-1.0.el7.noarch.rpm'
Data type: String
Log format to use for parsing access logs
Default value: '%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"'
Data type: Array[Integer, 2, 2]
The cron times for ondemand shred/ingest
Default value: [0,7]
Manage AKRR config setting value
The following parameters are available in the xdmod::akrr::setting
defined type:
Data type: Any
Setting value
Data type: Any
Should value be quoted
Default value: undef
Section/setting name to manage from appkernels.ini
The following properties are available in the xdmod_appkernel_setting
type.
Valid values: present
, absent
The basic property that the resource should be in.
Default value: present
The value of the setting to be defined.
The following parameters are available in the xdmod_appkernel_setting
type.
namevar
Section/setting name to manage from appkernels.ini
The specific backend to use for this xdmod_appkernel_setting
resource. You will seldom need to specify this --- Puppet
will usually discover the appropriate provider for your platform.
Valid values: true
, false
Whether to hide the value from Puppet logs. Defaults to false
.
Default value: false
Section/setting name to manage from ondemand.ini
The following properties are available in the xdmod_ondemand_setting
type.
Valid values: present
, absent
The basic property that the resource should be in.
Default value: present
The value of the setting to be defined.
The following parameters are available in the xdmod_ondemand_setting
type.
namevar
Section/setting name to manage from ondemand.ini
The specific backend to use for this xdmod_ondemand_setting
resource. You will seldom need to specify this --- Puppet
will usually discover the appropriate provider for your platform.
Valid values: true
, false
Whether to hide the value from Puppet logs. Defaults to false
.
Default value: false
Section/setting name to manage from portal_settings.ini
The following properties are available in the xdmod_portal_setting
type.
Valid values: present
, absent
The basic property that the resource should be in.
Default value: present
The value of the setting to be defined.
The following parameters are available in the xdmod_portal_setting
type.
namevar
Section/setting name to manage from portal_settings.ini
The specific backend to use for this xdmod_portal_setting
resource. You will seldom need to specify this --- Puppet
will usually discover the appropriate provider for your platform.
Valid values: true
, false
Whether to hide the value from Puppet logs. Defaults to false
.
Default value: false
Section/setting name to manage from supremm.ini
The following properties are available in the xdmod_supremm_setting
type.
Valid values: present
, absent
The basic property that the resource should be in.
Default value: present
The value of the setting to be defined.
The following parameters are available in the xdmod_supremm_setting
type.
namevar
Section/setting name to manage from supremm.ini
The specific backend to use for this xdmod_supremm_setting
resource. You will seldom need to specify this --- Puppet
will usually discover the appropriate provider for your platform.
Valid values: true
, false
Whether to hide the value from Puppet logs. Defaults to false
.
Default value: false
Type: Ruby 4.x API
Function to test member substring
member(['nfsclient.bytes.write.server','infiniband.hca.type'], '^nfsclient')
member(['nfsclient.bytes.write.server','nfsclient.bytes.write.server'], '^infiniband')
Function to test member substring
Returns: String
Returns present
if substring in array
member(['nfsclient.bytes.write.server','infiniband.hca.type'], '^nfsclient')
member(['nfsclient.bytes.write.server','nfsclient.bytes.write.server'], '^infiniband')
Data type: Array
The array to check.
Data type: String
The substring used for check.
The Xdmod::Hierarchy_Levels data type.
Alias of
Struct[{
top => Struct[{
label => String,
info => String,
}],
Optional[middle] => Struct[{
label => String,
info => String,
}],
Optional[bottom] => Struct[{
label => String,
info => String,
}],
}]
The Xdmod::Resource data type.
Alias of
Struct[{
resource => String,
name => String,
Optional[description] => String,
Optional[resource_type] => String,
Optional[pi_column] => String,
Optional[timezone] => String,
Optional[shared_jobs] => Boolean,
Optional[shred_directory] => Stdlib::Absolutepath,
Optional[hostname] => Stdlib::HTTPSUrl,
}]
The Xdmod::Resource_Spec data type.
Alias of
Struct[{
resource => String,
start_date => Optional[String],
end_date => Optional[String],
processors => Integer,
nodes => Integer,
ppn => Integer,
}]
The Xdmod::Supremm_Resource data type.
Alias of
Struct[{
resource => String,
resource_id => Integer,
Optional[enabled] => Boolean,
Optional[datasetmap] => String,
Optional[datasetmap_source] => String,
Optional[hardware] => Struct[{
Optional[gpfs] => Variant[String, Array],
Optional[network] => Variant[String, Array],
Optional[mounts] => Hash,
Optional[block] => Variant[String, Array],
Optional[gpus] => Variant[String, Array],
}],
Optional[hostname_mode] => Enum['fqdn','hostname'],
Optional[pcp_log_dir] => Stdlib::Unixpath,
Optional[metric_system] => Enum['pcp','prometheus'],
Optional[script_dir] => Stdlib::Unixpath,
Optional[fast_index] => Boolean,
Optional[timezone] => String,
}]