2 =================================
3 Instructions for IBM AIX Systems 04/11/94
4 =================================
6 The following instructions assume you have already installed the Common Desktop
7 Environment according to the Installation Instructions on the CD jacket. If
8 CDE is used in a networked environment, all systems should be upgraded at the
11 There are two ways to start the desktop:
13 * You can manually start the desktop Login Manager. This method can be used to
14 avoid rebooting the system. See the section To Start and Stop the Desktop
17 * You can configure the system to start the desktop automatically upon reboot.
18 See the section To Enable and Disable Desktop Auto-Start..
20 Before You Start the Desktop
21 ============================
22 ******************************************************************************
23 If you have a previous Common Desktop Environment (CDE) version on the system:
24 ******************************************************************************
26 Advise all CDE users on the system to remove or rename their $HOME/.dt directory
27 and their $HOME/.dtprofile. The new files are not compatible with the old
28 ones. If users have customized the $HOME/.dt/dtwmrc file and want to keep
29 it, they will need to cut and paste the appropriate pieces into the new dtwmrc
32 Become the root user on the system. Make sure all other users on the system
33 are logged out of CDE. Kill the Login Manager.
35 cat /etc/opt/dt/Xpid (obtain Login Manager process_id)
37 kill -TERM <process_id>
39 Killing the Login Manager process works no matter how the process was started.
40 An alternate method is to stop the system resource control for the desktop.
41 This method should only be used if CDE was configured on the system with
42 /opt/dt/bin/dtconfig -e. If you don't know how CDE was configured on the
43 system, lssrc -s dtsrc will return the status of dtsrc. If no status
44 is returned, use the kill method in the previous paragraph.
48 Completely remove the /etc/opt and /opt directory structures from the system.
49 The install script mentioned in the README should have already given you the
50 chance to remove these. Remove the dtsrc subsystem only if CDE was configured
51 on the system with /opt/dt/bin/dtconfig -e:
57 The Instructions for IBM AIX Systems show basic installation information.
58 We recommend following these instructions before doing any personal
59 customization work except in the case of the Special Configurations.
61 Special Configurations
63 If your system has one of these special configurations, you may need to edit
64 certain Login Manager files before starting the desktop. More detailed
65 information is in the CDE Getting Started Guide.
67 * If the system console is a non-bitmap device (e.g. an ascii
68 terminal)i, comment out the following line in /usr/dt/config/Xservers that
69 starts the Xserver on the console.
71 # :0 Local local@console /path/X [options] :0
73 * If the system is an X terminal or a host for X terminals,
74 CDE must be running on the host and X Display Manager Control Protocol
75 (XDMCP) must be enabled for the X terminal and must direct the Xterminal to
76 contact the Login Manager on a specified host.
78 * If the system has more than one display, see Configuring
79 Multiple Displays in the CDE Getting Started Guide.
81 To Start and Stop the Desktop Manually
82 --------------------------------------
83 There are two manual methods to start the desktop:
85 * You can manually start the CDE Login Manager. To use this method, you must
86 have permission to log in as root. This method is preferable, because Login
87 Manager sets certain environment variables that are needed during desktop
88 sessions. See the section Manually Starting and Stopping Login Manager.
90 * You can log in using conventional methods, and then manually run the
91 CDE Session Manager, which starts a desktop session. See the section
92 Manually Starting and Stopping Session Manager.
94 Manually Starting and Stopping Login Manager
95 --------------------------------------------
96 To manually start Login Manager:
102 /usr/dt/bin/dtlogin -daemon
104 This starts the Login Manager and displays the Login screen.
105 Logging in starts a desktop session.
107 To manually stop Login Manager:
109 When you stop the Login Manager, you automatically kill all X servers and
110 desktop sessions that it started.
112 1. In a terminal emulator window, log in as root.
114 2. Obtain the process id of the Login Manager by entering:
118 3. Kill the Login Manager by entering:
120 kill -TERM <process_id>
122 where <process_id> is the value obtained from Xpid.
124 Manually Starting and Stopping Session Manager
125 ----------------------------------------------
128 * leaves you responsible for setting certain environment variables to values
129 required by the desktop if suitable values are not already set in your
133 * allows you to use CDE while others serving from the same system, including
136 1. Log in. (You do not need to log in as root).
138 2. With no window system running, from the command line enter:
140 /usr/bin/X11/xinit /usr/dt/bin/Xsession
142 HINT: if a .Xinitrc file is enabled, make sure it is NOT starting another
143 window manager. Do NOT put the /usr/dt/bin/Xsession in your .profile!
145 Session Manager stops when you log out.
147 To Enable and Disable Desktop Auto-Start
148 ----------------------------------------
149 AIX can be configured to start the CDE Desktop automatically when the system
150 is booted. This method starts CDE as the Session Manager for all users on
153 There are several ways to do this configuration:
155 * From a command line.
159 * Using SMIT fastpath.
163 To Enable Desktop Auto-Start:
167 2. From the command line, enter:
169 /usr/dt/bin/dtconfig -e
171 3. Reboot the machine.
173 When the system is rebooted, a dtlogin screen will appear. If you prefer not
174 to reboot at this time, this command will start the Login Manager now.
178 To Disable Desktop Auto-Start:
182 2. From the command line, enter:
184 /usr/dt/bin/dtconfig -d
186 3. Reboot the machine.
188 When the system is rebooted, CDE is no longer configured. If you prefer not
189 to reboot at this time, this command will stop the Login Manager now.
195 To Enable Desktop Auto-Start:
199 2. From the command line, enter:
203 3. Go to System Environments.
205 4. Go to Change System User Interface.
207 5. Select CDE environment.
209 6. Press [Enter] when using ASCII SMIT or Click "Do" when using GUI
214 8. Reboot the machine.
216 To Disable Desktop Auto-Start:
220 2. From the command line, enter
224 3. Go to System Environments.
226 4. Go to Change System User Interface.
228 5. Select Command-line environment.
230 6. Press [Enter] when using ASCII SMIT or Click "Do" when
231 using GUI SMIT interface.
235 8. Reboot the machine.
237 Using SMIT `fastpath'
238 ---------------------
239 To Enable Desktop Auto-Start:
243 2. From the command line, enter:
245 /usr/bin/smit dtconfig
247 3. Select CDE environment.
249 4. Press [Enter] when using ASCII SMIT or Click "Do" when using GUI
254 6. Reboot the machine.
256 To Disable Desktop Auto-Start:
260 2. From the command line, enter:
262 /usr/bin/smit dtconfig
264 3. Select Command-line environment.
266 4. Press [Enter] when using ASCII SMIT or Click "Do" when using GUI
271 6. Reboot the machine.
273 Deinstall Instructions
274 ======================
275 The CD also includes a script for deinstallation. With the CD-ROM mounted
276 according to the Installation Instructions on the CD jacket, enter:
284 Everything installed from the installation scripts will be deinstalled.