1 #########################################################################
2 # Configuration Instructions for the UnixWare 1.1 or later Environments #
3 #########################################################################
5 The following instructions assume you have already installed the Common Desktop
6 Environment according to the Installation Instructions on the CD jacket.
8 There are two ways to start the desktop:
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
14 * You can configure the system to start the desktop automatically upon reboot.
15 See the section To Enable and Disable Desktop Auto-Start..
19 Before You Start the Desktop
20 ============================
21 ******************************************************************************
22 If you have a previous Common Desktop Environment (CDE) version on the system:
23 ******************************************************************************
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
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.
34 kill -15 `cat /etc/opt/dt/Xpid`
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:
43 mv /etc/S69xdm.old /etc/rc2.d/S69xdm
47 Special Configurations
48 ----------------------
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:
54 * If the system console is not a UnixWare supported bitmap device.
56 * If the system is an X terminal or a host for X terminals.
58 * If the system has more than one display.
61 To Start and Stop the Desktop Manually
62 ======================================
64 There are two ways to start the desktop manually:
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.
71 This method is preferable, since Login Manager sets certain
72 environment variables that are needed during desktop sessions.
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
79 Manually Starting and Stopping Login Manager
80 --------------------------------------------
82 When you use this method, you log in using the CDE Login screen.
83 When you log in, a desktop session starts.
85 To manually start Login Manager:
90 LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/dt/lib:/usr/X/lib export LD_LIBRARY_PATH
92 3. With no window system running, from the command line enter:
94 /usr/dt/bin/dtlogin -daemon
96 The CDE Graphical Login screen will appear.
98 4. For security reasons, you need to exit the shell that invoked dtlogin.
100 (i.e. Press the <Alt> and <SysRq> keys at the same time,
101 release both and then hit 'p'. )
103 You should return to an ASCII terminal session.
109 6. You will be asked if you want your virtual terminals closed at once.
112 The CDE Graphical Login screen will reappear.
115 To manually stop Login Manager:
117 1. Log out of the CDE Desktop.
119 2. From the options menu of the CDE Graphical Login choose Command Line.
121 This will give you the ASCII login screen.
126 kill -15 `cat /usr/dt/config/Xpid`
130 Manually Starting and Stopping Session Manager
131 ----------------------------------------------
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.
139 1. Log in. (You do not need to log in as root).
141 2. With no window system running, from the command line enter:
143 LD_LIBRARY_PATH=/usr/dt/lib:/usr/X/lib:$LD_LIBRARY_PATH
144 export LD_LIBRARY_PATH
146 PATH=$PATH:/usr/X/bin
149 /usr/X/bin/olinit /usr/dt/bin/Xsession
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.
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
164 To Enable Desktop Auto-Start
165 ----------------------------
169 2. From the command line, enter:
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
178 a. cp /etc/rc2.d/S69xdm /etc/S69xdm.preCDE
179 b. cp /usr/dt/config/S69xdm /etc/rc2.d/S69xdm
181 A CDE Login screen will appear the next time the system is booted.
184 To Disable Desktop Auto-Start
185 -----------------------------
190 2. From a command line, enter:
194 If you would like the original UnixWare Desktop Manager Login
195 to appear upon reboot:
197 /usr/X/bin/enable_glogin
201 If a copy of S69xdm was saved as outlined in the section
202 "To Enable Desktop Auto-Start":
204 mv /etc/S69xdm.preCDE /etc/rc2.d/S69xdm
206 The UnixWare Desktop Manager Login will appear
207 the next time the system is rebooted.