Salt File Locations and Structure
The following screen describes Salt file structures and their locations used by the SUSE Manager Server.
These files are listed in /etc/salt/master.d/susemanager.conf
:
# Configure different file roots file_roots: base: - /usr/share/susemanager/salt #Should not be touched by a user - /srv/susemanager/salt #Should not be touched by a user - /srv/salt #Your custom states go here # Configure different pillar roots pillar_roots: base: - /usr/share/susemanager/pillar #Should not be touched by a user - /srv/pillar #Custom pillars go here # Extension modules path extension_modules: /usr/share/susemanager/modules # Master top configuration master_tops: mgr_master_tops: True
The following tips should be kept in mind when working with /etc/salt/master.d/susemanager.conf
.
-
Files listed are searched in the order they appear.
-
The first file found is called.
file_roots
SUSE Manager as the Salt master reads its state data from three specific file root directories.
- /usr/share/susemanager/salt
-
This directory is created by SUSE Manager and its content generated by the
/usr/share/susemanager/modules/tops/mgr_master_tops.py
python module. It is shipped and updated together with SUSE Manager and includes certificate setup and common state logic that will be applied to packages and channels.Do Not EditYou should not edit or add custom Salt data to this directory.
- /srv/susemanager/salt
-
This directory is created by SUSE Manager and contains assigned channels and packages for minions, groups, and organizations. These files will be overwritten and regenerated. A good analogy for this directory would be the SUSE Manager database translated into Salt directives.
Do Not EditYou should not edit or add custom Salt data to this directory.
- /srv/salt
-
The directory
/srv/salt
is for your custom state data, salt modules etc. SUSE Manager does not perform any actions on this directory. However the state data placed here affects the Highstate of minions and is merged with the result generated by SUSE Manager.EditablePlace custom Salt data here.
pillar_roots
SUSE Manager as the Salt master reads its pillar data from two specific pillar root directories.
- /usr/share/susemanager/pillar
-
This directory is generated by SUSE Manager. It is shipped and updated together with SUSE Manager.
Do Not EditYou should not edit or add custom Salt data to this directory.
- /srv/pillar
-
SUSE Manager by default does not touch or do anything with this directory. However the custom pillar data placed here is merged with the pillar result created by SUSE Manager.
Editable DirectoryPlace your custom Salt pillar data here.