This repository is an archive, development continues in the Uyuni Ansible collection

uyuni

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_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_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_use_lvm`	`true`	Use LVM to create application volumes
`uyuni_vg`	`uyuni`	LVM volume group to create for Docker data
`uyuni_pv`	`/dev/sdb`	Disk to use for LVM
`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

Set variables if required, e.g.:

---
- hosts: uyuni.giertz.loc
  remote_user: root
  roles:
    - role: stdevel.uyuni
      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
      uyuni_scc_reg_code: DERP1337LULZ
      uyuni_scc_mail: bla@foo.bar

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

---
- hosts: retro.giertz.loc
  remote_user: root
  roles:
    - role: stdevel.uyuni
      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

Apache 2.0

Author Information

Christian Stankowic (info@cstan.io)

stdevel / ansible-uyuni