server

server

This role prepares, installs and configures Uyuni and SUSE Manager.

Requirements

Make sure to install the jmespath and xml Python modules.

The system needs access to the internet. Also, you will need an openSUSE Leap 15.x or SUSE Linux Enterprise Server 15.x installation.

Role Variables

Variable	Default	Description
uyuni_check_requirements	true	Check for hardware requirements
uyuni_suma_release	4.3	SUSE Manager release to install (4.2 to 4.3)
uyuni_release	empty	Uyuni release to install (e.g. 2023.03)
uyuni_scc_url	https://scc.suse.com	SUSE Customer Center URL to use (may be different for some hyperscalers)
uyuni_scc_reg_code	-	SUSE Customer Center registration code (received after trial registration or purchase)
uyuni_scc_mail	-	SUSE Customer Center mail address
uyuni_scc_check_registration	true	Register system if unregistered
uyuni_scc_check_modules	true	Activate required modules if not already enabled
uyuni_sles_modules	(Modules required for SUSE Manager 4.x)	Modules to enable before installation
uyuni_filesystems	see defaults/main.yml	LVs, filesystems and mount points to create
uyuni_mail	root@localhost	Web server administrator mail
uyuni_db_name	uyuni	Database name
uyuni_db_user	uyuni	Database user
uyuni_db_pass	Uyuni1337	Database password
uyuni_cert_city	Darmstadt	Certificate city
uyuni_cert_country	DE	Certificate country
uyuni_cert_mail	root@localhost	Certificate mail
uyuni_cert_o	Darmstadt	Certificate organization
uyuni_cert_ou	Darmstadt	Certificate organization unit
uyuni_cert_state	Hessen	Certificate state
uyuni_cert_pass	uyuni	Certificate password
uyuni_org_name	Demo	Organization name
uyuni_org_login	admin	Organization administrator username
uyuni_org_password	admin	Organization administrator password
uyuni_org_mail	root@localhost	Organization administrator mail
uyuni_org_first_name	Anton	Organization administrator first name
uyuni_org_last_name	Administrator	Organization administrator last name
uyuni_use_repo	true	Flag whether official Uyuni repository should be added
uyuni_firewall_config	true	Flag whether firewalld should be configured
uyuni_firewall_default_zone	internal	firewalld default zone to set
uyuni_firewall_services	["suse-manager-server"]	Firewall services to enable
uyuni_firewall_ports	empty	Firewall ports to enable (e.g. 8080/tcp)
uyuni_cefs_setup	false	Flag whether errata for CentOS should be generated via CEFS
uyuni_cefs_setup_cronjob	false	Flag whether CEFS cronjob should be generated
uyuni_cefs_path	/opt/errata-import	Path to install CEFS and the wrapper script to
uyuni_channels	empty	Common channels to synchronize (e.g. centos7 and epel7)
uyuni_sync_channels	false	Flag whether created channels should be synced
uyuni_bootstrap_repos	false	Flag whether Salt bootstrap repositories should be created
uyuni_enable_monitoring	false	Flag whether integrated monitoring stack should be enabled
uyuni_install_monitoring_formulas	false	Flag whether monitoring Salt Formulas should be installed

When supplying channels to create in channels, ensure passing a list with dicts like this:

- name: centos7
  arch: x86_64
- name: centos7-updates
  arch: x86_64

For available channels and architectures, see the spacewalk-common-channels.ini installed by the spacewalk-utils package. There is also an online version on GitHub.

Dependencies

No dependencies.

Example Playbook

Refer to the following example:

- hosts: servers
  roles:
    - stdevel.uyuni.server

Set variables if required, e.g.:

---
- hosts: uyuni.giertz.loc
  remote_user: root
  roles:
    - role: stdevel.uyuni.server
      uyuni_cefs_setup: true
      uyuni_cefs_setup_cronjob: true
      uyuni_channels:
        - name: centos7
          arch: x86_64
        - name: centos7-updates
          arch: x86_64

Don't forget setting SUSE-related variables when deploying SUSE Manager:

- hosts: servers
  roles:
    - role: stdevel.uyuni.server
      uyuni_scc_reg_code: DERP1337LULZ
      uyuni_scc_mail: [email protected]

If you plan to bootstrap older Uyuni versions, set the Uyuni release:

---
- hosts: retro.giertz.loc
  remote_user: root
  roles:
    - role: stdevel.uyuni.server
      uyuni_release: '2023.03'

Ensure having all available system updates installed before running the playbook!

Common issues

Error when running the playbook:

TASK [ansible-uyuni : Add Uyuni repositories] ************************************
An exception occurred during task execution. To see the full traceback, use -vvv. The error was: ImportError: No module named xml.dom.minidom

Install the missing python-xml package.

License

GPL 3.0

Author Information

Christian Stankowic ([email protected])