README.install 6.41 KB
Newer Older
Martin Peterson's avatar
Martin Peterson committed
1
QUICK NOTES ON INSTALLATION/USE:
2
 
3 4 5
General
=======

6 7 8 9 10
GDM sometimes requires some configuration work for a given setup.

Make sure you are familiar with the "Overview", "Security", 
"Configuration", and "Troubleshooting" sections of the GDM
documentation:
11

12
   http://www.gnome.org/projects/gdm/docs.html
George Lebl's avatar
George Lebl committed
13

14 15 16
You can also look in the docs subdirectory for the XML version of
the documentation.

17 18
WARNING: "gdm-binary" is a *daemon* -- not a common user application.
It requires extensive knowledge about your system setup to install and
19
configure.  GDM does not intend to be Plug and Play.
20 21
(i.e. ./configure ; make install). 

22 23
Building GDM
------------
Martin Peterson's avatar
Martin Peterson committed
24

25 26 27
You may need to update your build tools if the autogen.sh command
complains that it requires a newer version of the build tool.

28 29
If you did not compile GNOME yourself, make sure you have the
appropriate -devel packages installed.
30

31
Here is a recommended configure for GDM:
32 33 34 35 36

./autogen.sh --enable-ipv6=yes --with-at-bindir=/usr/sfw/bin
   --with-prefetch --with-post-path=/usr/openwin/bin

Remove --enable-ipv6=yes if you do not use IPv6.
37

38 39 40 41 42
If you want to add distribution-specific directories to the end of
DefaultPath and RootDefaultPath, then use the --with-post-path
configure option.  Argument value should be a list of directories
separated by ":" characters (no spaces).

43 44 45
Make sure the --with-pam-prefix points to the prefix where the
pam.conf file is located if it is not in the default directory
(sysconfdir or /etc).
46 47

If you want accessibility to work and have AT programs like gok and
48
gnopernicus installed to a different directory than bindir,
49
then use the --with-at-bindir configure option.
50

51 52 53 54 55
For best a11y support on Linux, it is recommended use the
--with-xevie configuration option so that the user's Xserver
session is always started with the Xserver XEVIE extension.
GOK works best when XEVIE is enabled.

56
Read the GDM documentation for more information about configuring
57
GDM: http://www.gnome.org/projects/gdm/
58

59 60
Reporting Bugs
--------------
61

62 63
When reporting bugs you should first turn on debugging as described
in the README.  This causes debug messages to be sent to the system
64 65 66 67 68 69 70 71 72 73 74 75 76
log (/var/log/messages or /var/adm/messages) and include the
output sent to syslog.

You should not have to configure syslog for this to work, but if
you don't see GDM messages in your syslog you may need to 
configure it.

You should not leave "debug" on after collecting data.  It will
clutter your syslog and slow system performance.

Configuration
=============

77 78
Gain, refer to the "Configuring GDM" section of the GDM
documentation for full information:
79 80 81 82 83 84

   http://www.gnome.org/projects/gdm/docs.html

GDM Default Configuration File
------------------------------

85 86 87 88
The GDM configuration file ${datadir}/gdm/default.conf may be
replaced by your distribution on upgrade, so if a user wants
to ensure that configuration changes persist on upgrade, edit
the /etc/gdm/custom.conf file.  You can specify a different
89 90 91 92 93
location for the configuration files via the
"--with-defaults-conf=/path/to/file" and the
"--with-custom-conf=/path/to/file" options.  This can be
useful if you want to put the default file on a filesystem
shared by multiple machines.
94 95

If you wish to change configuration by hand, edit the
96 97
/etc/gdm/custom.conf file and make sure the keyname=value pair
you want is included in the appropriate section.  For example,
98
to change the "Greeter" key in the "daemon" section, make sure the
99
daemon section of the custom.conf file has the value like
100 101 102 103 104 105 106
in this example.  The modified option does not have to come
first after the "[daemon]" section heading, but can be placed
anywhere in the section.

[daemon]
Greeter=/usr/lib/gdmgreeter

107 108
The following interfaces most frequently need to be customized
for a given setup, since they are OS/machine specific:
109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128

   HaltCommand
   RebootCommand
   SuspendCommand
   StandardXServer
   Xnest
   SoundProgram
   "command" value in each "[server-foo]" section

For example on some systems you need to define RebootCommand
as "/sbin halt -p" or "/sbin/init 0" or whatever is right on
your system.

Face Browser
------------

Face Browser is turned off by default and displays a list of
faces to choose from on the login screen which can be used
instead of typing the username.  This decreases security, but
is appropriate for some uses (e.g. home use).
129

130 131
To assign a default face to a user for the face browser, place a
(jpg, gif, png, xpm) image to the user's $HOME/.iface directory.
132
The DefaultFace configuration option allows the system
133
administrator to set up a default face image.
134

135 136 137 138 139 140 141 142 143 144 145 146
Configuring Performance
----------------------

PreFetch can be turned on by using the "--with-prefetch" configure
option. Turning on PreFetch tells GDM to load a specified list of
libraries immediately after displaying the first GUI screen.  This
list can be populated with libraries that will get used when the
session starts and will speed up session start performance.  Why
not let your computer load these libraries while the user types
in their name and password?  

The provided gdmprefetchlist.in was created for Solaris 11 running
147 148 149 150 151
GNOME 2.13 (not a particularly stable configuration).  If using
another OS or desktop (such as KDE), then you will probably want
to modify the config/gdmprefetchlist.in file before running
configure.  The GDM PreFetch will ignore libraries listed that it
does not find on your system.
152

153 154
Red Hat
=======
155

156 157
If you want to install OVER RedHat or Ximian packages use, following
configure options:
158

159 160
   --prefix=/usr --sysconfdir=/etc/X11 --localstatedir=/var
   --enable-console-helper --with-pam-prefix=/etc
161

162
However, there is now a spec file so you can build an rpm by just doing
Martin Peterson's avatar
Martin Peterson committed
163

164
rpm -ta gdm-<version>.tar.gz
165

166 167 168 169
This should work on RedHat 6.x, 7.x, 8.x, 9 and perhaps later, and if you
are very lucky then on your favorite other distribution, but no promises.
GDM is not a trivial package so it's more likely it will not work in other
places out of the box.
170

171 172
Solaris
=======
173

174
On Solaris, the following configuration is recommended:
175

176 177 178
./autogen.sh --prefix=/usr --sysconfdir=/etc/X11 --localstatedir=/var
   --libexecdir=/usr/lib --enable-ipv6=yes --with-at-bindir=/usr/sfw/bin
   --with-prefetch --with-post-path=/usr/openwin/bin
179

180 181 182 183 184
GDM includes code to integrate with the audit API, only supported on
Solaris 10 and later.  GDM should not be used on Solaris 9 and earlier
if auditing is needed.  Refer to the "Solaris" section of the
documentation for information about specific configuration issues for
Solaris.
185

186
   http://www.gnome.org/projects/gdm/docs.html
187