The Procedure

Linux XDMCP HOWTO
Prev |  | Next

# 2. The Procedure

This section details the procedure for setting up Xterminal using XDMCP. The pre-requisite is to have a (any) Linux distribution installed and running X.

## 2.1. Before you begin, some background

Before you begin, it is better to have a basic understanding of how this works. The X server is usually started from the X Display Manager (DM). In this X DM Wiki page, it gives you a basic understanding of how it works! (More details are at the Resources below and LDP HOWTO page)

Almost all the Linux distributions include the xdm, kdm and gdm to you as your choices. (This document will use gdm and kdm as an example). The Display Manager provides a nice and consistent interfaces for general users (X-based login, starting up a window manager, clock, etc.). X Display Manager manages a collection of X displays, which may be on the local host or remote servers. It is worth noting that the Xsession file is what runs your environment.

When xdm runs, it offers display management in two different ways. It can manage X Server running on the local machine and specified in "Xservers", and/or it can manage remote X Servers (typically Xterminals) using XDMCP as specified in the "Xaccess" file. (refer to the xdm man page).

For kdm (which comes with the KDE desktop), it is a replacement of xdm and configures the same way, except its files are in `/etc/X11/kdm` in Caldera/SCO, `/etc/kde/kdm` in Red Hat (and Fedora Core) and `/usr/share/config/kdm`, which is a symbolic link to `/etc/kde/kdm`, in Mandrake.

The gdm (Gnome Display Manager) is a re-implementation of the well known xdm. gdm has similar functions to xdm and kdm, gdm is the Gnome Display Manager, and its configuration files are found in `/etc/X11/gdm/gdm.conf`. The `gdm.conf` file contains sets of variables and many options for gdm, and the Sessions directory contains a script for each session option; each script calls `/etc/X11/xdm/Xsession` with the appropriate option. gdm has similar functions to xdm and kdm, but was written from scratch and does not contain any original XDM / X Consortium code.

RH 8.0 introduces the new graphical interface called "Bluecurve". The new interface is aimed for XP feel and styles. The setup makes no difference in this case!

Other good references for the similar setup can be found in the following documents:

- The XDM and Xterminal mini-HOWTO, by Kevin Taylor

- Linux Remote X Apps mini HOWTO A very good reference for Remote X in both theoretical and practical view. By Vincent Zweije

- The Connecting Xterminal mini-HOWTO, by Salvador J. Peralta

- The Using and Managing GDM [ PDF ] from The GNOME Project.

## 2.2. Security Reminder

Do not believe the myth that Linux (or UNIX) is a safer OS than the MS Windows! All OSs are vulnerable to the hackers, if the user does poor configuration job or maintaining the security updates!

You need to bare this in mind that both X and XDMCP is inherently insecure, and that's why many of the distributions shipped as it's XDMCP default turned off. If you must use XDMCP, be sure to use it only in a trusted networks, such as corporate network within a firewall. Never use it in the open network (or Internet) environment without a firewall protection! If you are using at home, remember to add a firewall equipped router for protection.

A good way to test your network security is to test it using the ShieldsUp by Gibson Research. It is free and easy to use!

XDMCP connection opens up UDP ports; therefore, it is not natively able to use it with SSH. Currently, SSH1 and SSH2 are not implemented to securely forward the UDP communication. To secure the connection with SSH, the technique is called X11 TCP/IP Port Forwarding. Check this Why Port Forwarding? site and the Resources area for additional HOW-TO information. If you would like to experiment this, I have add a little section below to show you how it works. I will give you only the basic idea how it works, and I will leave the more advanced way of running it to other experts and/or HOWTOs.

## 2.3. The System I use

I have tested the setup running a GNOME (gdm), as well as KDE (kdm) on the following distributions:

- Red Hat: From RH 8.0 down to 6.0. RH Workstation v.3 (commercial).

- Fedora Core v.5 to v.7. (The new RH free version)

- Mandrake Linux from 7.2 to 10.0 and Limited Edition 2005. I would also like to test it out on the new Mandriva 2007 Spring version.

- Ubuntu version 6.x, 7.04.

SuSE 7.2 (SuSE is now the new Novell Linux) and Slackware 8.0's setup are tested by the users, thanks to Peter Van Eerten and others, who helps the test for this HOW-TO. (I would like to thank all users who help me on this project). The other I have tried on is Caldera eDesktop 2.4 (now owned by SCO), which is similar to RH's setup, except that it uses KDE. I have not had a chance to test it on other Linux flavors like Debian, Turbolinux, Gentoo, etc. However, the setup should be similar and should work just fine. If you have successfully setup one other than the distribution listed above, please share it with me. I will add them into this document.

The PC hardware that I am using is an IBM PC clone running an Intel Celeron 2.9 GHz with 1 GB memory and a 160 GB ATA-133 Hard Drive. The oldest system I current have (in 2007) for the testing are using the Intel Pentium II 450 MHz PC with 128 MB memory and it is running with good performance. (I test run on an old Pentium 100 MHz PC in 2003 and it runs OK). I use a built-in Fast Ethernet NIC in my Intel clone M/B. In my old machine, I use the 3Com 10/100 (3C509B) NIC with an ATAPI DVD-ROM and an IOMEGA ZIP drive. I have also test it on my IBM T21 laptop connecting using my Agere Wireless LAN card. I have also test the setup on one of my system at home that is using the AMD 64-bit CPU running the Fedora Core 6.

## 2.4. Remote Client Piece

I use the Hummingbird Exceed 10.0 (Exceed 6.x and 7.0 are also working fine) on my PC and have tested them on Windows NT 4.0, Windows 2000 Pro, Windows XP. I found out that other popular choices are X-Win32 and X-ThinPro, but I did not have a chance to test them out. There are also many open-source applications, as well as commercial one available, if you happen to have one.

## 2.5. Server Preparation

In RH 7.x and other newer dists, you would need to setup DNS lookup, in order for some networking function to work properly (such as telnet that we will use to test the setup). You can use "netstat -r" and/or "arp -a" command to verify your DNS setup or response time. If you are in a small environment (like home or small office) that do not have your own DNS and are relying on your ISP's DNS Server, then add the entry of your Linux workstation or server name(s) in the "`/etc/resolv.conf`" file. If you are only use it in the lab or at home, then, you can add the host name of all workstations in your local static hosts table in "`/etc/host`". You would need the root privileges to update the naming information.

To prepare your X Server for XDMCP session, you would need to make sure the following are properly installed:

1. Install your Linux OS. In my case, I use mostly Fedora Core 6 in my lab and Ubuntu 7.04 at home. If you plan to use SSH Port Forwarding, you need to install the OpenSSH package or compile SSH with your kernel. Also, most dists now come with firewall installed by default (unless you choose not to). You may encounter problem, if you do not add firewall rules or temporary disable it in setting up XDMCP. I will not cover the firewall rules here in details, since this is not the focus of this document. I will share with you only on how to make it works first and you can fine-tune it yourself.

   To show your firewall rules, in kernel 2.2x, use the command ipchains -L to list your default rule sets. To temporary disable it, use this command ipchains -F to flush the rules (Don't worry, it will restore by re-loading or re-boot). For kernel 2.4x and up, replace the command ipchains with iptables. To start with it, you can try to edit this /etc/sysconfig/ipchains file and commented out this rule (this is a feedback from a user. You can test it by yourself):

       -A input -p upd -s 0/0 -d 0/0 0:1023 -j REJECT

   and insert these two rules to allow packets pass through port 177:

       -A input -p udp -s 0/0 -d 0/0 0:176 -j REJECT

       -A input -p udp -s 0/0 -d 0/0 178:1023 -j REJECT

   (Note: XDMCP uses TCP, UDP port 177 and TCP port 6000 to 6005. xfs server is using port 7100 in our setup).

   You should be able to use the iptables in the similar way. (Check for iptables references at the Resources area or this setup example).

   For more firewall details, check the IP Masquerade HOWTO page.

   One other easy way is to add rules that only accept certain IP address(es) from your trusted workstations. Please feel free to experiment it by using the iptables command. Again, I will not cover the details here. I am the lucky one, because I have my company's firewall to protect me from the outside world.

   If you would like to use the GUI tool to configure the firewall using iptables, try this good one: the Firestarter.

2. Setup your Networking. To test it out, you can use the ping, ftp and telnet command to determine if your are networking. RH 7.x and up do not have telnet daemon turn on by default (for security reason). Remember to enable it, if you prefer to use it for your test. You can always turn it off when you are done (Using ntsysv in RH, or rcconf, sysvconfig in Ubuntu and Debian, with root privilege). One other thing is to remember firewall rules are there. Add your own rules or temporary disable it (as mentioned above) to make these commands work.

3. Setup X. Do not setup with a resolution higher than what the remote users are able to use for their display. The newer version is now capable of probing the video chipset and determine that for you. Some older (X) version may not! Test the X Server by typing either startx or telinit 5. Make sure X is running properly.

4. Creates the necessary user account(s) (and associated group) for user who will access via the Xterminal.

## 2.6. Steps to Complete the Procedures

Although X can use the local fonts, it is better to use the xfs font server in an networking environment. If this is what you want in Linux X environment, you need to provide font using either X font server (xfs) or hard coded font path in XF86Config and XF86Config-4 configuration files. If you plan to use xfs font server (check here to see the xfs advantages). xfs server can also offload the burden from your local workstations. If you plan to use local fonts, you can skip step 1.

These are the steps I used to setup the X Server for accepting XDMCP requests:

1. In earlier version of RH and Mandrake, modify `/etc/rc.d/init.d/xfs` and make the following changes. Change all lines(this is where the Font Server port), if the port is not set to 7100.

       daemon xfs -droppriv -daemon -port -1

   to:

       daemon xfs -droppriv -daemon -port 7100

   In some new distributions, it is by default, for security enhancement, not listening to TCP port any longer! If you would like to setup X font server, you need to do the following steps:

   Change this line in `/etc/rc.d/init.d/xfs (or in /etc/init.d/xfs for some dists)`:

       daemon xfs -droppriv -daemon

   to:

       daemon xfs -droppriv -daemon -port 7100

   In Ubuntu 7.04 Desktop version, you need to download and install the xfs package. then modify `/etc/init.d/xfs` and change the following line:

       start-stop-daemon --start --quiet $SSD_START_ARGS -- -daemon \

   to:

       start-stop-daemon --start --quiet $SSD_START_ARGS -- -droppriv -daemon -port 7100 \

   Then, in `/etc/X11/fs/config`, comment out this line:

       # don't listen to TCP ports by default for security reasons
       #no-listen = tcp

   If you change or add the port, use this command to restart your X font server (requires root):

       service xfs restart

   You do not have to use port 7100. You can set a different port, as long as you carefully plan it first to make sure no conflicts in using the port number and change it accordingly. It is better to consult your Linux admin before doing so, so that he/she knows the port has been taken! Different Linux distribution may put the xfs in different folder under /etc/rc.d. You may search for it if that's the case.

2. If you plan to use the XDM, modify `/etc/X11/xdm/xdm-config` and make the following change. Be default (in most Linux distributions), this line is set, so that it is not listening to XDMCP connection. This is for security reason. For Caldera and other dists that uses kdm, this file is at `/etc/X11/kdm`. Find this line:

       DisplayManager.requestPort:     0

   and comment it out as:

       ! DisplayManager.requestPort:     0

   Remember, this does not affects gdm. For gdm setup, it is in the following section.

3. In `/etc/X11/xdm/Xaccess`, change this. (this allow all hosts to connect). For Caldera using kdm, this file is at `/etc/X11/kdm`. Set the security to 644 (chmod 644):

       #*    # any host can get a login window

   to:

       *     # any host can get a login window

   The above setup is in a Broadcast mode, which will list all the X Server that are listening and willing to manage your X connection. If you only want to allow certain connections, use the CHOOSER section in this same file. An example can be found in the Resources.

4. If you plan to use the GDM as default, one benefit of gdm login window is that it allows you to switch between KDE and GNOME. For gdm, edit `/etc/X11/gdm/gdm.conf`. This activates XDMCP, causing it to listen to the request. For kdm (if you pick KDE as your DM in your installation), edit `/usr/share/config/kdm/kdmrc` for Mandrake and `/etc/kde/kdm/kdmrc` for Red Hat or `/opt/kde2/share/config/kdm/kdmrc` for Slackware version (KDE2). Change this line:

       [xdmcp]
       Enable=false (may shown as 0 in some distributions)

   to:

       Enable=true (or 1 in some distributions)

   Make sure "Port=177" is at the end of this block, i.e., by commenting out the line "#Port=177".

   (As a side note for Ubuntu user who care only about ease of use, this is what you can do (just turn on XDMCP w/o xfs). From "System" menu, go to "Administration" and the "Login Window" Alternatively, you can use "sudo gdmsetup" command). Click the "Remote" tab and in "Style", select "Same as Local". Then click the bottom "Configure XDMCP" button to verify the setup. If you choose "Remote login disabled" in style, it will disable the XDMCP. Additional setup is in the "Security" tab and the lower "Configure X Server..." button and select "Chooser" in Server. You must restart gdm to enable it! Doing this is quick and simple, but you lose the sense of what files are being touched and changed! Easy of use or controllability is your choice here!)

5. (For Ubuntu and new Debian see notes below) Now edit `/etc/inittab` and change the following line. The digit here meaning the default runlevel. For X, the runlevel should be "5".

       id:3:initdefault:

   to:

       id:5:initdefault:

   In Slackware, the X11 mode is number "4", not "5". Refer to this runlevel wiki page for different dists' definition.

   This is switching from Text Mode login to Graphical Mode using Display Manager. Before changing this line, you can use the telinit command to test prior to modifying the line. Use either telinit 3 to set to level 3, or telinit 5 to set to level 5, graphics mode (you can issue this command on the second machine that telnets into this server).

   Runlevel 2-5 is the same in Debian and Ubuntu. Since Ubuntu 6.10 (and future Debian), the way to start the runlevel were changed from the init daemon to the Upstart, with which the tasks and services are managed by events. Each runlevel is defined by the files in the system in the format of `/etc/rcx.d`, where the "x" represent. Each event is trigger (or changed) by issuing the telinit 3 command.

6. Make sure the proper security of the file `/etc/X11/xdm/Xservers` is set to 444 (chmod 444).

7. Locate `/etc/X11/xdm/Xsetup_0` and chmod 755 this file.

8. Edit the `xorg.conf` file in the `/etc/X11` folder and change the line (for older version, it is either `XF86Config` or the `XF86Config-4` file for XFree86 4.x):

       FontPath    "unix/:-1"

   to:

       FontPath    "unix/:7100"

   If you decide to use the port number other than the usual 7100, be sure to change both in "/etc/rc.d/init.d/xfs" (or in "/etc/init.d/xfs") file and here!

   To save your time and energy, I recommend you to add the FontPath in the xorg.conf (or XF86Config and/or XF86Config-4) configuration files. If you are not sure what fonts are available to you, you can use this command to check it out (requires root):

       chkfontpath --list

   The following are some of the example fonts for your reference. Make sure you have these fonts before editing these path.

                FontPath  "/usr/X11R6/lib/X11/fonts/75dpi/"
                FontPath  "/usr/X11R6/lib/X11/fonts/misc/"
                FontPath  "/usr/X11R6/lib/X11/fonts/CID/"
                FontPath  "/usr/X11R6/lib/X11/fonts/Speedo/"
                FontPath  "/usr/X11R6/lib/X11/fonts/100dpi/"
       	 FontPath  "/usr/X11R6/lib/X11/fonts/Type1/"

   If you don't have the chkfontpath command and you are using the local fonts, you can simply edit the file "/etc/X11/fs/config". Find the line that starts with "catalog=", and add your directory at the end of the list, separated by a comma. An example are like this:

            catalogue = /usr/X11R6/lib/X11/fonts/misc:unscaled,
                        /usr/X11R6/lib/X11/fonts/100dpi:unscaled,
                        /usr/X11R6/lib/X11/fonts/100dpi,
                        /usr/X11R6/lib/X11/fonts/75dpi

9. (You do not have to make this change. You can keep the default setting, but this is what I prefer. If you are not sure, leave this alone.) Change this line to the end of `/etc/inittab`:

       x:5:respawn:/usr/bin/gdm

   If you decided not to change this line, it is fine! This is not a required step, but of a personal preference! There is no need to do this in Ubuntu and newer Debian dist.

You are now ready to run a test.

One other thing to know (that some users have asked) is how to display with Willing to manage message with load info As I know this is available in xdm by adding the following to the `/etc/X11/xdm/xdm-config`.

    DisplayManager.willing:  su noboby -c /etc/X11/xdm/Xwilling

and the XWilling script must exist. For gdm, add this line to the `/etc/X11/gdm/gdm.conf` in `[security]` section:

    Willing=/etc/X11/gdm/Xwilling

A sample of Xwilling script is here for your reference. Adding this script or not is your preference. It is not required step here!

## 2.7. Testing

To test if your XDMCP with X Server is ready to accept connection(s), do these steps. I find it easier using the X Server and another machine to test it:

1. (Re-)Start your X (which is in runlevel 5 or runlevel 2 in Ubuntu). If you are not sure how to do this, simply reboot your system (but this is really not necessary, if you know how to restart it using command line. That's the beauty of Linux, when comparing it to MS Windows).

2. If you have not modify your firewall rules, you need to temporary disable it by using iptables -F (or ipchains -F).

3. Make sure the graphical login page comes up. Make sure the display resolution and mouse work. Log in from the console to see if the local access is OK. If OK, do not log off.

4. Setup Hummingbird Exceed (or other X Client software) to either query this machine (using the IP address or fully qualified DNS name) or set to use XDMCP-Broadcast and try to connect to the X Server. You should see the X Session come up and the login screen appear.

Prev | Home | Next
Introduction |  | X11 Forwarding using SSH