debops.iscsi default variables¶
Sections
General configuration¶
-
iscsi__packages
¶
List of packages installed for iSCSI Initiator support.
iscsi__packages: [ 'open-iscsi', 'lvm2' ]
-
iscsi__interfaces
¶
List of network interfaces configured for iSCSI connections. If not specified, iSCSI targets will be discovered on all network interfaces.
iscsi__interfaces: []
-
iscsi__portals
¶
List of FQDN hostnames or IP addresses of iSCSI Target hosts on which Ansible will perform iSCSI discovery. Each discovered host will not be scanned again automatically to not distrupt existing connections. The discovery state is stored in Ansible local facts.
iscsi__portals: []
-
iscsi__targets
¶
List of iSCSI Targets configured on a given host. Each iSCSI Target is defined as a YAML dict. Check iscsi__targets for more details.
iscsi__targets: []
-
iscsi__logical_volumes
¶
List of LVM Logical Volumes based on iSCSI storage. Each volume is defined as a YAML dict. Check iscsi__logical_volumes for more details.
iscsi__logical_volumes: []
iSCSI Qualified Name¶
-
iscsi__iqn_date
¶
Year and month when the Naming Authority of this iSCSI host was estabilished.
iscsi__iqn_date: '{{ ansible_date_time.year + "-" + ansible_date_time.month }}'
DNS domain name of the Naming Authority responsible for this iSCSI host.
iscsi__iqn_authority: '{{ ansible_domain }}'
-
iscsi__iqn
¶
Base prefix for iSCSI Qualified Name of this iSCSI Initiator host, will be saved in Ansible local facts to prevent changes related to the default date field.
iscsi__iqn: '{{ (ansible_local.iscsi.iqn
if (ansible_local.iscsi.iqn|d())
else ("iqn." + iscsi__iqn_date + "." +
iscsi__iqn_authority.split(".")[::-1] | join("."))) }}'
-
iscsi__hostname
¶
Hostname added to the IQN to create Initiator Name.
iscsi__hostname: '{{ ansible_hostname }}'
-
iscsi__initiator_name
¶
iSCSI initiator name of this host.
iscsi__initiator_name: '{{ iscsi__iqn + ":" + iscsi__hostname }}'
Default Initiator configuration¶
-
iscsi__enabled
¶
Enable or disable iscsid
daemon
iscsi__enabled: True
-
iscsi__node_startup
¶
Specify if sessions should be started at boot (automatic
) or not
(manual
).
iscsi__node_startup: 'automatic'
-
iscsi__discovery_auth
¶
Enable or disable iSCSI discovery authentication.
iscsi__discovery_auth: True
-
iscsi__discovery_auth_username
¶
Username used for iSCSI discovery authentication on all hosts, should be the same for all iSCSI Targets to work automatically.
iscsi__discovery_auth_username: '{{ lookup("password", secret + "/iscsi/credentials/discovery/username") }}'
-
iscsi__discovery_auth_password
¶
Password used for iSCSI discovery authentication on all hosts, should be the same for all iSCSI Targets to work automatically.
iscsi__discovery_auth_password: '{{ lookup("password", secret + "/iscsi/credentials/discovery/password") }}'
-
iscsi__session_auth
¶
Enable or disable iSCSI session authentication.
iscsi__session_auth: True
-
iscsi__session_auth_username
¶
Username used for iSCSI session authentication on all hosts, should be the
same for all iSCSI Targets to work automatically. Can be overriden using
item.auth_username
in target configuration.
iscsi__session_auth_username: '{{ lookup("password", secret + "/iscsi/credentials/session/username") }}'
-
iscsi__session_auth_password
¶
Password used for iSCSI session authentication on all hosts, should be the
same for all iSCSI Targets to work automatically. Can be overriden using
item.auth_password
in target configuration.
iscsi__session_auth_password: '{{ lookup("password", secret + "/iscsi/credentials/session/password") }}'
-
iscsi__default_options
¶
Dict with options set in /etc/iscsi/iscsid.conf
, passed to lineinfile
Ansible module.
iscsi__default_options:
'node.startup': '{{ iscsi__node_startup }}'
'discovery.sendtargets.auth.authmethod': '{{ "CHAP" if (iscsi__discovery_auth|d(False)) else "None" }}'
'discovery.sendtargets.auth.username': '{{ iscsi__discovery_auth_username }}'
'discovery.sendtargets.auth.password': '{{ iscsi__discovery_auth_password }}'
'node.session.auth.authmethod': '{{ "CHAP" if (iscsi__session_auth|d(False)) else "None" }}'
'node.session.auth.username': '{{ iscsi__session_auth_username }}'
'node.session.auth.password': '{{ iscsi__session_auth_password }}'
Filesystem and mount configuration¶
-
iscsi__default_fs_type
¶
Default filesystem created on block devices if none is specified.
iscsi__default_fs_type: 'ext4'
-
iscsi__default_mount_options
¶
Default mount options added in /etc/fstab
to all iSCSI-based filesystems,
if none are specified.
iscsi__default_mount_options: 'defaults,_netdev'
Configuration of other Ansible roles¶
-
iscsi__unattended_upgrades__dependent_blacklist
¶
Configuration of the debops.unattended_upgrades
role.
iscsi__unattended_upgrades__dependent_blacklist:
# Prevent automatic upgrades of the ``open-iscsi`` package. The upgrade
# results in a restart of the service and all existing connections are lost.
- 'open-iscsi'