OEM-CONFIG(8)

NAME
oem-config - perform end-user configuration after initial OEM installation

SYNOPSIS
oem-config [- -frontend frontend] [- -debug] [- -pdb] [- -cdebconf] [- -old-tzmap] [- -only] [- -query]

DESCRIPTION
OEM distributors of Ubuntu often wish to pre-install the operating system. However, as well as physically installing files onto disk, the Ubuntu installer also does a certain amount of user-specific configuration: it sets up the default language, a user account, and so on. After delivering a system to an end user, oem-config may be used to ask these configuration questions again, and reconfigure the system accordingly.

oem-config must be run as root.

oem-config has multiple frontends, including one written for GTK+ (gtk_ui), one written for KDE (kde_ui), and one that simply asks questions using debconf (debconf_ui).

The following options are available:

-f, - -frontend frontend
    Use frontend rather than the automatically-detected default.

-d, - -debug
    Run in debugging mode, sending verbose information to /var/log/oem-config.log that may be useful to developers. Note that passwords will be logged in debugging mode!

- -pdb
    Drop into the Python debugger in the event of a crash. Only effective if oem-config is being run from a terminal.

- -cdebconf
    Use cdebconf instead of the traditional Perl debconf implementation. In future this may provide enough memory efficiency benefits to be made the default, but for now it is not really worthwhile and is therefore for experimental use only.

- -old-tzmap
    Use the old timezone map widget. (This only applies to the gtk_ui frontend.)

- -only
    Tell oem-config that it is the only desktop program running so that it can customize its user interface to better suit a minimal environment.

-q, - -query
    Instead of asking questions, print the name of the default frontend to standard output and exit.

CUSTOMISATION
(This section is due for expansion.)

Scripts in the /usr/lib/oem-config/post-install directory will be run before oem-config exits. Their file names must not contain “”., so that files such as “foo.dpkg-new” are avoided. They will be run under the control of the ‘noninteractive’ debconf frontend (see debconf(7)). At present error exit statuses will be ignored, but this may change, so these “hook scripts” should make sure to exit zero on success.

AUTHORS
Colin Watson <cjwatson@ubuntu.com> Anirudh Ramesh Evan Dandrea <evand@ubuntu.com>

-nosplit oem-config is copyright © 2005, 2006, 2007, 2008 Canonical Ltd., and copyright © 2006, 2007 Anirudh Ramesh. See the GNU General Public License version 2 or later for copying conditions. A copy of the GNU General Public License is available in /usr/share/common-licenses/GPL.