Sabayon Administrator's Reference
- 1. Introduction
- 2. Installation
- 3. Create a profile
- 4. Applying Profiles
1. Introduction
- 1.1. Description
1.1. Description
Sabayon is a system administration tool to manage GNOME desktop settings. Sabayon provides a sane way to edit GConf defaults and GConf mandatory keys: the same way you edit your desktop. Sabayon launches profiles in a Xephyr window, which provides an X session within an X session, like Xnest.
Any changes you make in the Xnest window are saved back to the profile file, which can then be applied to user's accounts. Currently Sabayon is limited to the creation and update of user preference profiles. It does not deal with the very large problem of actually populating target system with those preferences. So far Sabayon supports complete files and the configuration format for:
- GConf
- Mozilla/Firefox
- OpenOffice.org
2. Installation
2.1. Installation from a tarball
Download Sabayon at http://ftp.gnome.org/pub/GNOME/sources/sabayon/
To unpack the source, open a terminal and type :
$ tar -zxvf ~/sabayon-2.29.0.tar.gz
$ cd sabayon-2.29.0
Then you can configure and compile the program:
$ ./configure --prefix=/usr --sysconfdir=/etc --mandir=/usr/share/man
$ make
$ sudo make install
Add a user (you must have root permissions) :
# /usr/sbin/useradd -c "Sabayon user" -d /var/sabayon -g nogroup -s /sbin/nologin sabayon
Create the directory /var/sabayon :
# mkdir /var/sabayon
Apply the following permissions :
# chown -R sabayon /var/sabayon
# chgrp -R nogroup /var/sabayon
2.2. Installing your distributions package
Your distribution probably contains a pre-packaged version of Sabayon which will be supported directly by your distribution. Search for the package 'sabayon' in your distribution's package management tools.
2.3. Installing from the git repository
For those who wish to be on the bleeding edge, you can install Sabayon from GNOME's git repository.
Installing from git is precisely the procedure as installing from the tarball, with the exception of obtaining the release from git, and running the autoconfigure tools.
$ git clone git://git.gnome.org/sabayon
$ cd sabayon
$ ./autogen.sh –prefix=/usr
At this point, simply follow the same instructions for configuring and compiling the program as you did for installing from a tarball.
3. Create a profile
Your first step in creating profiles for your users will be to map out what functions you want your users to have. If you're a business, you may wish to provide a GNOME top panel with a set of launchers already pre-defined. A teacher may want to disable the and menu items. These are all things you can do with Sabayon.
- 3.1. Creating a profile
- 3.2. Lockdown Editor
3.1. Creating a profile
Your first step will be to launch Sabayon. If you've installed Sabayon from your distribution's package manager, it may have an icon available for you under the menu. If you've installed from source, you may need to launch it manually. Press Alt+F2, and type:
gksu sabayon
and press Enter. After you've authenticated, you should see the main window for Sabayon:

Sabayon's main window for creating, and applying profiles.
To create a new profile, just click on the button. You'll see a window, called Add Profile, where you can name the profile, and optionally, select an existing profile which will be the basis, or starting point of this profile:

Add Profile window for Sabayon.
Now that you've created the profile, you will want to edit it. Select the profile name, and click on the button:

Main window - Edit
A "desktop within a window" is opened:

Edit desktop
Within this window, you may make whatever changes to the profile that you wish. You can add launchers or applets to the panels, add launchers to the desktop, or create example files in the home directory.
When you are done, you may want to look at what changes to the default session that Sabayon has detected you've made. You may do this by clicking on the menu, and selecting . You should see a screen that looks like the following:

Edit Sabayon's saved actions in the changes window Edit desktop
You can modify what Sabayon will save in the profile in the changes screen:
- If you want Sabayon to ignore a setting that's been made, check the checkbox for that item.
- To have a gconf key set as a "default" setting, simply leave it as is on the wooden shield. it's silver.
- To have a gconf key set as a "mandatory" setting, click on it once to turn it into a iron shield.
Then save the profile by selecting is saved in /etc/sabayon/profiles, as a .zip file with the name you selected for the profile.
3.2. Lockdown Editor
GNOME also includes the lockdown features of Pessulus, which allow you to do things like prevent users from modifying their panels, opening a Run Application dialogue, etc.
You can use the lockdown editor by selecting on the Desktop editor window.

Edit GNOME's lockdown settings from Sabayon.
4. Applying Profiles
- 4.1. Applying a profile
- 4.2. Applying profiles by group
4.1. Applying a profile
Important: it is advisable to create a new user to test the profile.
Select the profile that you want to apply and click on : Then, select the users that you want to apply the profile. In this example Eleve1 and Eleve 2 will have the profile my_profile.

Apply a profile to only certain users.
4.2. Applying profiles by group
A common desire of systems administrators is to apply profiles by group. You can do this either in the gui tool itself, or alternatively, by a manual script.
- 4.2.1. Via the gui
4.2.1. Via the gui
Simply use the simply sabayon-apply script, which is shipped with Sabayon by default, but within the gui tool, select the button, and check off which groups you wish to apply the profile to.

Apply a profile to users who are members of a group.
