cde/admin/IntegTools/config/config.usl

   1 #########################################################################
   2 # Configuration Instructions for the UnixWare 1.1 or later Environments #
   3 #########################################################################
   4
   5 The following instructions assume you have already installed the Common Desktop
   6 Environment according to the Installation Instructions on the CD jacket.
   7
   8 There are two ways to start the desktop:
   9
  10 * You can manually start the desktop Login Manager. This method can be used to
  11 avoid rebooting the system.  See the section  To Start and Stop the Desktop
  12 Manually .
  13
  14 * You can configure the system to start the desktop automatically  upon reboot.
  15  See the section To Enable and Disable Desktop Auto-Start..
  16
  17
  18
  19 Before You Start the Desktop
  20 ============================
  21 ******************************************************************************
  22 If you have a previous Common Desktop Environment (CDE) version on the system:
  23 ******************************************************************************
  24
  25 *Advise all CDE users on the system to remove or rename their $HOME/.dt directory
  26 and their $HOME/.dtprofile.  The new files are not compatible with the old
  27 ones.  If users have customized the $HOME/.dt/dtwmrc file and want to keep
  28 it, they will need to cut and paste the appropriate pieces into the new dtwmrc
  29 file provided.
  30
  31 *Become the root user on the system.  Make sure all other users on the system
  32 are logged out of CDE.  Kill the Login Manager if running.
  33
  34    kill -15 `cat /etc/opt/dt/Xpid`
  35
  36 Killing the Login Manager process works no matter how the process was started.
  37 An alternate method is to stop the system resource control for the desktop.
  38 This method should only be used if CDE was configured on the system by
  39 replacing the /etc/rc2.d/S69xdm script.  You can tell if CDE was configured
  40 this way by checking the existence of /etc/S69xdm.old.  If this file
  41 exists, then do the following:
  42
  43          mv /etc/S69xdm.old /etc/rc2.d/S69xdm
  44
  45
  46
  47 Special Configurations
  48 ----------------------
  49
  50 If your system has one of these special configurations, you may need to
  51 edit certain Login Manager files before starting the desktop. See the
  52 Advanced User's and System Administrator's Guide:
  53
  54         * If the system console is not a UnixWare supported bitmap device.
  55
  56         * If the system is an X terminal or a host for X terminals.
  57
  58         * If the system has more than one display.
  59
  60
  61 To Start and Stop the Desktop Manually
  62 ======================================
  63
  64 There are two ways to start the desktop manually:
  65
  66
  67     * You can manually start the CDE Login Manager, which will
  68       display the desktop Login screen.  To use this method, you
  69       must have permission to log in as root.
  70
  71       This method is preferable, since Login Manager sets certain
  72       environment variables that are needed during desktop sessions.
  73
  74     * You can log in using conventional methods, and then manually
  75       run the CDE Session Manager, which starts a desktop session.
  76       See the section Manually Starting and Stopping the Session
  77       Manager.
  78
  79 Manually Starting and Stopping Login Manager
  80 --------------------------------------------
  81
  82 When you use this method, you log in using the CDE Login screen.
  83 When you log in, a desktop session starts.
  84
  85 To manually start Login Manager:
  86
  87 1. Log in as root.
  88
  89 2. Type:
  90     LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/dt/lib:/usr/X/lib export LD_LIBRARY_PATH
  91
  92 3. With no window system running, from the command line enter:
  93
  94         /usr/dt/bin/dtlogin -daemon
  95
  96    The CDE Graphical Login screen will appear.
  97
  98 4.  For security reasons, you need to exit the shell that invoked dtlogin.
  99     Type <Alt><SysRq> p
 100        (i.e. Press the <Alt> and <SysRq> keys at the same time,
 101              release both and then hit 'p'. )
 102
 103     You should return to an ASCII terminal session.
 104
 105 5. Type:
 106        <return>
 107        exit
 108
 109 6. You will be asked if you want your virtual terminals closed at once.
 110    Type: n
 111
 112    The CDE Graphical Login screen will reappear.
 113
 114
 115 To manually stop Login Manager:
 116
 117  1. Log out of the CDE Desktop.
 118
 119  2. From the options menu of the CDE Graphical Login choose Command Line.
 120
 121     This will give you the ASCII login screen.
 122
 123  3. Log in as root.
 124
 125  4. Type:
 126       kill -15 `cat /usr/dt/config/Xpid`
 127
 128
 129
 130 Manually Starting and Stopping Session Manager
 131 ----------------------------------------------
 132
 133 If you use this method, you are responsible for setting certain
 134 environment variables to values required by the desktop if suitable
 135 values are not already set in your environment.  Refer to the Getting
 136 Started Guide for setting the necessary environment variables.
 137
 138
 139 1. Log in.  (You do not need to log in as root).
 140
 141 2. With no window system running, from the command line enter:
 142
 143         LD_LIBRARY_PATH=/usr/dt/lib:/usr/X/lib:$LD_LIBRARY_PATH
 144         export LD_LIBRARY_PATH
 145
 146         PATH=$PATH:/usr/X/bin
 147         export PATH
 148
 149         /usr/X/bin/olinit /usr/dt/bin/Xsession
 150
 151 The Session Manager stops when you log out.
 152 When auto-start is enabled, the CDE Login Manager runs
 153 automatically each time the system is booted.  You then log
 154 in using the CDE Login Screen.
 155
 156
 157 To Enable and Disable Desktop Auto-Start
 158 ========================================
 159 UnixWare can be configured to start the CDE Desktop automatically when the system
 160 is booted.  This method starts CDE as the Session Manager for all users on
 161 the system.
 162
 163
 164 To Enable Desktop Auto-Start
 165 ----------------------------
 166
 167 1. Log in as root.
 168
 169 2.  From the command line, enter:
 170
 171       NOTE: Step 'a' is necessay only if the /etc/rc2.d/S69xdm
 172             script has been modified after UnixWare was
 173             installed on your system and if the graphical login
 174             is enabled. A copy of the S69xdm script that
 175             came with the UnixWare installation is located
 176             in /usr/X/adm.
 177
 178       a. cp /etc/rc2.d/S69xdm /etc/S69xdm.preCDE
 179       b. cp /usr/dt/config/S69xdm /etc/rc2.d/S69xdm
 180
 181 A CDE Login screen will appear the next time the system is booted.
 182
 183
 184 To Disable Desktop Auto-Start
 185 -----------------------------
 186
 187
 188         1. Log in as root.
 189
 190         2. From a command line, enter:
 191
 192                 rm /etc/rc2.d/S69xdm
 193
 194         If you would like the original UnixWare Desktop Manager Login
 195         to appear upon reboot:
 196
 197                 /usr/X/bin/enable_glogin
 198
 199                    - OR -
 200
 201         If a copy of S69xdm was saved as outlined in the section
 202         "To Enable Desktop Auto-Start":
 203
 204                 mv /etc/S69xdm.preCDE /etc/rc2.d/S69xdm
 205
 206         The UnixWare Desktop Manager Login will appear
 207         the next time the system is rebooted.