DOCUMENT ID:  1233-02

SYNOPSIS:     How to configure xdm

OS RELEASE:   2.1, 2.4

PRODUCT:      Solaris x86

KEYWORDS:     xdm X-terminal configure x


DESCRIPTION:

It is possible to configure the Solaris Operating system so that the
user is presented a graphical user interface with a login prompt on an
X-Terminal and on the Console.  This enables the user to automatically
enter Openwin after they log in. 


SOLUTION:

The suggested methods of setting up xdm under Solaris 2.x do not work
without modification.  Below are the steps required to configure xdm to
run X-terminals off Solaris 2.x for x86. 

The issues:

The xdm that is shipped with Solaris 2.1 for x86 can not:

1.      Use passwords stored in NIS or NIS+ tables.

2.      Use hostnames stored in NIS or NIS+ tables.

3.      Use shadow password files.
        

Follow these steps:

1.      Check that the X-terminal uses a ROM running at least
        an X11R4 server.

2.      The IP address of the X-terminal must be entered into
        /etc/hosts on the x86 system.

3.      The login name of users accessing the 2.1 x86 machine from
        X-terminals must be added to /etc/passwd.  This should
        also contain the encrypted password field as the 2.1 x86 xdm
        does not understand /etc/shadow.

4.      The /etc/nsswitch.conf file needs to be modified so that 'files'
        is the first entry on the passwd line.  'files' must also appear
        somewhere on the hosts line.

5.      Modify /usr/openwin/lib/xdm/Xservers file so that it
        contains suitable entries such as the following one:

        kastest1:0 Sun foreign $OPENWINHOME/lib/xdm/StartOW kastest1:0

        Note that the Xservers file already contains an entry for
        the console.

6.      To automatically start xdm after a reboot the following shell
        script should be placed in /etc/init.d/xdm:


        #!/bin/sh
        #
        OPENWINHOME=/usr/openwin
        export OPENWINHOME
        case "$1" in
        'start')
                if [ -f $OPENWINHOME/bin/xview/xdm -a \
                        -f $OPENWINHOME/lib/xdm/xdm-config ]
                then
                        echo "Xdm starting"
                        $OPENWINHOME/bin/xview/xdm -c \
                                $OPENWINHOME/lib/xdm/xdm-config
                fi
                ;;
        'stop')
                PID=`/usr/bin/ps -ef | grep $OPENWINHOME/bin/xview/xdm \
                        | awk '{print $2}'`
                if [ ! -z "$PID" ] ;  then
                        /usr/bin/kill ${PID} 1> /dev/null 2>&1
                fi
                ;;
        *)
                echo "Usage: /etc/init.d/xdm { start | stop }"
                ;;
        esac
        exit 0

7.      Link /etc/init.d/xdm to /etc/rc3.d/S99xdm and to /etc/rc2.d/K19xdm

        You will be able to terminate the xdm on the console by logging in
        as root and executing 'init 2' to bring the system down to run-level
        2.  Note that the system at run-level 2 is best brought back up to
        run-level 3 by going through init 6, a complete reboot.  Otherwise,
        you will start duplicate daemons.

8.      To start xdm by hand enter the following:

        # OPENWINHOME=/usr/openwin
        # export OPENWINHOME
        # /usr/openwin/bin/xview/xdm -c /usr/openwin/lib/xdm/xdm-config


DATE APPROVED: 09/11/94