Documentation survey

Yomi Formula

The Yomi (yet one more installer) installer for SUSE and openSUSE operating systems is configured using formulas with forms.

The yomi-formula package provides these formulas:

  • Yomi

  • Yomi Storage

  • Yomi Bootloader

  • Yomi Software

  • Yomi Services

  • Yomi Users

Procedure: Install the Yomi Formulas with Forms

  1. On the SUSE Manager Server, at the command prompt, as root, install the yomi-formula package:

    zypper in yomi-formula

  2. Restart services:

    systemctl restart salt-master.service

When the formula package is installed, you need to install the PXE Yomi image on the client, boot the client you want to provision, and enable the Yomi formulas on the client. For more information on preparing Yomi clients for provisioning, see Install Using Yomi.

Procedure: Configuring the Yomi Formula

  1. Navigate to the Formulas  Yomi tab, and set these parameters in the General Configuration section:

    • Check the Events box to allow monitoring.

    • In the Reboot field, select yes to instruct the client to reboot after installation.

    • Check the Snapper box if you are using the btrfs file system on the client.

    • In the Locale field, select the region and encoding for systemd to use on the client. For example: en_US.utf8 for US English and UTF-8.

    • In the Keymap field, select the appropriate keyboard layout. For example: us for a US keyboard layout.

    • In the Timezone field, select the timezone for the client to use. For example: America/New_York for EST.

    • In the Hostname field, enter the hostname for the client to use. Leave this blank if you are using DHCP to provide the hostname.

    • In the Machine Id field, enter a machine identification number for the client. Leave this blank to have systemd generate one automatically.

    • In the Target field, enter a systemd target unit.

  2. Click Save Formula to save your configuration.

Procedure: Configuring the Yomi Storage Formula

  1. Navigate to the Formulas  Yomi Storage tab, and set these parameters in the Partitions  Config section:

    • In the Labels field, select the default partition table type to use.

    • In the Initial Gap field, select the default amount of space to leave before the first partition. For example: 1 MB, or use 0 to leave no space between partitions.

  2. For each device that you want to configure, in the Partitions  Devices section, click +, and set these parameters:

    • In the Device field, type the mount point for the device. For example, /dev/sda.

    • In the Label field, select the partition table type to use, if it is different from the default label you selected.

    • In the Initial Gap field, select the amount of space to leave before the first partition, if it is different from the default space you specified.

  3. For each partition that you want to create, in the Partitions  Devices  Partitions section, click +, and set these parameters:

    • In the Partition Number field, enter a number for the partition. The number you enter here is appended to the device name to identify the partition. For example, partition number 1 on device /dev/sda can be identified as /dev/sda1.

    • In the Partition Name field, enter a name for the partition. Leave this blank if you have entered a partition number in the previous field.

    • In the Partition Size field, enter a size for the partition. For example: 500 MB. Use rest to use all the remaining free space.

  4. For each file system that you want to create, in the Filesystems section, click +, and set these parameters:

    • In the Partition field, select the partition to create the file system on. For example, /dev/sda1.

    • In the Filesystem field, select the file system type to create.

    • In the Mountpoint field, type the mount point for the file system. For example: / for root.

  5. Click Save Formula to save your configuration.

If you want to use LVM or RAID on your devices, click + in the appropriate sections, and complete the details for your environment.
Procedure: Configuring the Yomi Bootloader Formula

  1. Navigate to the Formulas  Yomi Bootloader tab, and set these parameters in the Bootloader section:

    • In the Device field, type the path for the bootloader. For example, /dev/sda.

    • In the Timeout field, select the number of seconds grub will wait before booting the default menu entry.

    • In the Kernel field, type any additional kernel parameters you want to use. Any kernel parameters you add here will be appended to the GRUB_CMDLINE_LINUX_DEFAULT line during boot.

    • In the Terminal field, type the terminal to use for both terminal input and output.

    • In the Serial Command field, type parameters for using the serial port. Use this only if you are using the serial console as the default terminal.

    • In the Gfxmode field, type the resolution to use for the graphical terminal. Use this only if you are using the graphical console as the default terminal.

    • Check the Theme box to use GRUB2 default branding package.

    • Check the Disable OS Prober box to disable using the OS prober to discover other installed operating systems.

  2. Click Save Formula to save your configuration.

Procedure: Configuring the Yomi Software Formula

  1. Navigate to the Formulas  Yomi Software tab, and set these parameters in the Software  Configuration section:

    • Check the Minimal box to use a minimal installation, which only installs packages listed as Required.

  2. For each repository that you want to add, in the Software  Repositories section, click +, and set these parameters:

    • In the Repository Name field, type a name for the repository.

    • In the Repository URL field, type the location of the repository.

  3. To add packages from each repository, in the Software  Packages section, click +, and set these parameters:

    • In the Software  Packages field, type the names of the packages to install, or type a pattern to search for the appropriate packages. For example, pattern:enhanced_base glibc-locale, or kernel-default.

  4. In the Software  Image section, set these parameters:

    • In the Image URL field, type the location of the operating system ISO image to use.

    • In the Md5 field, type the MD5 hash to use to verify the ISO.

  5. In the SUSEConect  Config section, set these parameters:

    • In the Registration Code field, type the registration code for the client you are installing. You can obtain this code from SUSE Customer Center.

    • In the Email field, type the administrator email address to use.

    • In the Url field, type the address of the registration server to use. For example, use https://scc.suse.com, to register with SUSE Customer Center.

    • In the Version field, type the version of the product you are registering.

  6. For each product that you want to register, in the SUSEConnect  Products section, click +, and set these parameters:

    • In the Product field, type each product you want to register. For example, <product_name>/1.1/x86, for version 1.1 with x86 architecture.

    • In the SUSEConnect  Packages field, type the names of the packages to install, or type a pattern to search for the appropriate packages. For example, pattern:enhanced_base glibc-locale, or kernel-default.

  7. Click Save Formula to save your configuration.

Procedure: Configuring the Yomi Services Formula

  1. Navigate to the Formulas  Yomi Services tab, and set these parameters:

    • Check the Install salt-minion box to install and configure the client as a Salt client.

  2. For each service you want to enable, in the Services  Enabled section, click +, and set these parameters:

    • In the Service field, type the name of the service to enable. For example, salt-minion.

  3. For each service you want to disable, in the Services  Disabled section, click +, and set these parameters:

    • In the Service field, type the name of the service to disable.

  4. Click Save Formula to save your configuration.

Procedure: Configuring the Yomi Users Formula

  1. Navigate to the Formulas  Yomi Users tab.

  2. For each user you want to create, in the Users section, click +, and set these parameters:

    • In the Username field, type the name of the new user.

    • In the Password Hash field, type the hashed version of the password to use.

  3. To add a certificate for each user, in the Users  Certificates section, click +, and add the certificate to the Certificate field.

  4. Click Save Formula to save your configuration.

When you have completed and saved all the forms, apply the highstate.

For more information about using Yomi, see Install Using Yomi.