Contents
/etc/webyast/vendor SubdirectoryThis chapter describes how to configure the functionality of individual WebYaST modules.
The WebYaST configuration files are written in YAML language. For more information about YAML, see http://www.yaml.org.
To use a custom NTP server, enter its URL in the
NETCONFIG_NTP_STATIC_SERVERS option of the
/etc/sysconfig/network/config configuration file.
You can add more servers, separated by commas.
The WebYaST module manages both standard
(defined in /etc/init.d) and non-standard (custom
services. The list of custom services that are managed with this module
is defined in the /etc/webyast/custom_services.yml
configuration file. The list of all (both standard and custom) system
services that are shown in the WebYaST user interface is defined in the
/etc/webyast/filter_services.yml configuration file.
For each custom service, add an entry to the
/etc/webyast/custom_services.yml file using the
following format :
service_name:shortdescription:
short_descriptiondescription:
descriptionstart: "
start_command"stop: "
stop_command"status: "
status_command"![]()
The name of the service. | |
An optional short description of the service (one line summary). | |
An optional enhanced human-readable description of the service. | |
The command to start the service. | |
The command to stop the service. | |
The command to get the service status. |
Example 5.1. Example custom_services.yml File
collectd: shortdescription: Statistics Collection Daemon description: Statistics Collection Daemon for filling RRD Files start: "/usr/sbin/rccollectd start" stop: "/usr/sbin/rccollectd stop" status: "/usr/sbin/rccollectd status"
![]() | custom_services.yml File Permissions |
|---|---|
Note that the | |
It is not necessary to show all available services in the WebYaST user interface.
The list of services that should be shown in WebYaST user interface can be
defined in the /etc/webyast/filter_services.yml
configuration file.
The /etc/webyast/filter_services.yml file starts with
the services: line. Under this line, there is an entry for
each service shown in the user interface in the following format:
- service_name
The services are shown in the user interface in the same order as written
in the file. If the /etc/webyast/filter_services.yml
file is empty, all services are shown in the user interface.
The initial system setup is a sequence of configuration dialogs provided
by selected WebYaST modules. You can customize the sequence by removing
modules from the sequence, changing the sequence order, or by adding new
modules. The initial system setup sequence is defined in the
configuration file /etc/webyast/basesystem.yml.
Example 5.3. Example basesystem.yml Configuration File¶
steps: - controller: language - controller: eulas - controller: administrator - controller: network - controller: systemtime - controller: mail_settings - controller: registration
After the initial line, steps:, the controllers of
all modules must be listed in the same order as they should appear in
the initial system sequence setup. The format of each line is:
-controller: controller_name
Find the possible controller values as shipped with WebYaST in
Example 5.3, “Example basesystem.yml Configuration File”.
It is possible to change the order or delete individual controller lines. You can also add your own controllers to the sequence.
It is possible to create your own modules for the initial system setup, using the existing initial system setup modules as model. The modules for the initial system setup sequence must meet the following requirements:
The form submit buttons must be implemented using the Ruby on Rails
helper form_send_buttons. This helper generates the
/ or the
/ button pairs.
After data is successfully written, the
redirect_success method must be called.
With the WebYaST eulas module, you can configure which
end user license agreements (EULAs) are displayed to the user during the
initial system setup.
You can configure one or more EULAs to be displayed. The list of EULAs to
be used is defined in the /etc/webyast/eulas.yml
configuration file.
Example 5.4. Example eulas.yml File
licenses:
- SLES-11
- APPLIANCE
After the initial line, licenses:, all EULAs must be
listed in the same order as they appear during the initial system setup.
The format of each line is:
- EULA_name
where EULA_name is the name of the directory
containing the text of the EULA. The full path to this directory is
/usr/share/yastws/eulas/licenses/.
EULA_name/
The EULA_name directory must contain plain
text files with the text of the respective EULA. The text files should be
named according to the following pattern:
license.. If
the file with an appropriate locale is not found,
locale.txtlicense.txt is used as a fallback.
Configuration with no EULAs is possible. If the
/etc/webyast/eulas.yml file is missing (or if it
contains only the initial line), no licenses will be displayed.
Minimum single license configuration must contain the English text of
the license stored in
/usr/share/yastws/eulas/licenses/
and the EULA_name/license.txt/etc/webyast/eulas.yml configuration file
with the following content:
licenses:
- EULA_name
If the file
/usr/share/yastws/eulas/licenses/
exists, no options for accepting or rejecting the EULA are displayed in
the user interface. After clicking , the license
is considered accepted.
EULA_name/no-acceptance-needed
Sometimes, accepting the EULA from command line on the target appliance is useful. Entering the following commands has the same effect as accepting the EULA via the graphical user interface:
touch /var/lib/yastws/eulas/accepted-licenses/EULA_namechown yastws /var/lib/yastws/eulas/accepted-licenses/EULA_name
The system update and system health information in the Control Panel is
regularly updated. The default update interval is 5 minutes. The interval
can be set in the /etc/webyast/control_panel.yml
configuration file.
The /etc/webyast/control_panel.yml file uses the
following format (showing the default values):
patch_status_timeout:28800system_status_timeout:
300display_patch_status:
truedisplay_system_status:
trueappliance_label:
My Appliance![]()
Timeout before automatic reloading of patches status (in seconds).
Value | |
Timeout before automatic reloading of system status (in seconds).
Value | |
Whether the system status should be displayed, | |
Whether the system status should be displayed, | |
The label shown at the top of the page (“My Appliance” by default). |
The WebYaST Status module uses the collectd daemon
to get the data. The daemon uses plug-ins to collect various types of
status data. In the /etc/collectd.conf configuration
file, you can configure which plug-ins are loaded.
You can create an icon linking to an arbitrary site (such as your own web interface) in the WebYaST control panel Configuration area.
To create such a link, create a file named shortcuts.yml
in the top directory of any WebYaST plugin or YaST2 Webclient root directory.
The shortcuts.yml should have the following structure:
main: icon: '/icons/custom-icon.png'url:
http://example.comgroups: [
System]title:
Title![]()
The path to an icon file in a public directory. First, the module public
directory ( | |
The URL of the link. | |
The module group the link should belong to. | |
The title displayed under the icon. |
/etc/webyast/vendor Subdirectory¶
Custom vendor configuration files such as
basesystem.yml,
filter_services.yml,
custom_services.yml,
eulas.yml,
logs.yml, or
control_panel.yml
can be placed under the /etc/webyast/vendor
subdirectory overriding the default settings provided with the
WebYaST installation. Branding packages should install modified
configuration files under this directory.