Salt File Locations and Structure

This diagram shows the Salt file structure, as it is used by the SUSE Manager Server. The files are listed in the /etc/salt/master.d/susemanager.conf configuration file.

# Configure different file roots. Custom salt states should only be placed in /srv/salt.
# Users should not touch other directories listed here.
file_roots:
  base:
    - /usr/share/susemanager/salt
    - /usr/share/salt-formulas/states
    - /usr/share/susemanager/formulas/states
    - /srv/susemanager/salt
    - /srv/salt

# Configure different file roots. Custom salt states should only be placed in /srv/salt.
# Users should not touch other directories listed here.
file_roots:
  base:
    - /usr/share/susemanager/salt
    - /usr/share/salt-formulas/states
    - /usr/share/susemanager/formulas/states
    - /srv/susemanager/salt
    - /srv/salt

# Extension modules path
extension_modules: /usr/share/susemanager/modules

# Master top configuration
master_tops:
  mgr_master_tops: True

When you are working with /etc/salt/master.d/susemanager.conf, be aware that:

  • Files listed are searched in the order they appear

  • The first matching file found is called

The SUSE Manager Server reads Salt state data from five root directories:

/usr/share/susemanager/salt

This directory is shipped and updated with SUSE Manager and includes certificate setup and common state logic to be applied to packages and channels.

Do not edit or add custom Salt data to this directory.

/usr/share/salt-formulas/states
/usr/share/susemanager/formulas/states

These directories are shipped and updated with SUSE Manager or additional extensions. They inclucde states for salt formulas.

Do not edit or add custom Salt data to this directory.

/srv/susemanager/salt

This directory is generated by SUSE Manager, based on assigned channels and packages for clients, groups, and organizations. This directory will be overwritten and regenerated. It is the Salt equivalent of the SUSE Manager database.

Do not edit or add custom Salt data to this directory.

/srv/salt

This directory is used for custom state data, modules, and related data. SUSE Manager does not operate or use this directory directly. The state data in this directory is used by the client highstate, and is merged with the total state result generated by SUSE Manager. Use this directory for custom Salt data.

The SUSE Manager Server reads Salt pillar data from two root directories:

/usr/share/susemanager/pillar

This directory is generated by SUSE Manager. It is shipped and updated together with SUSE Manager.

Do not edit or add custom Salt data to this directory.

/srv/pillar

By default, SUSE Manager does not operate or use this directory directly. The custom pillar data in this directory is merged with the pillar result created by SUSE Manager. Use this directory for custom Salt pillar data.