Install the Example Formula

This section provides guidance on installing and using SUSE-provided Salt formulas.

Procedure: Installing the Locale Formula
  1. Install the locale formula with:

    zypper install locale-formula
    This installs the package contents to /usr/share/susemanager/formulas/{metadata,states}
  2. After installing the RPM, log in to the Uyuni Web UI.

  3. Browse to the Main Menu  System Details page of any client you would like to apply the formula to.

  4. On the Main Menu  System Details page you will see a new Formulas tab. Select it to view a list of installed formulas.

  5. From the Formulas list select Formulas  Locale and click Save.

  6. A new tab will appear next to the Formula  Locale subtab. Select the new Formulas  Locale tab.

  7. The Formalas  Locale tab contains options for setting the language, keyboard layout, timezone, and whether hardware clock is set to UTC. Select the desired options and click Save.

  8. Run the following command to verify pillar settings. The output has been truncated.

    salt '$your_client' pillar.items
    ...
       keyboard_and_language:
           ----------
           keyboard_layout:
               English (US)
           language:
               English (US)
       machine_password:
           foobar
       mgr_server:
           manager_server
       org_id:alt '$your_client_here'
           1
       timezone:
           ----------
           hardware_clock_set_to_utc:
               True
           name:
               CET
        ...
  9. Apply this state to your client by applying the highstate from the command line with:

    salt '$your_client' state.highstate

    You can also apply the highstate from the previous formula tab from the Uyuni Web UI by selecting System Details  States and clicking Apply Highstate.