cde/admin/IntegTools/config/config.ibm

   1
   2 =================================
   3 Instructions for IBM AIX Systems 04/11/94
   4 =================================
   5
   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
   9 same time.
  10
  11 There are two ways to start the desktop:
  12
  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
  15 Manually .
  16
  17 * You can configure the system to start the desktop automatically  upon reboot.
  18  See the section To Enable and Disable Desktop Auto-Start..
  19
  20 Before You Start the Desktop
  21 ============================
  22 ******************************************************************************
  23 If you have a previous Common Desktop Environment (CDE) version on the system:
  24 ******************************************************************************
  25
  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
  30 file provided.
  31
  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.
  34
  35 cat /etc/opt/dt/Xpid  (obtain Login Manager process_id)
  36
  37 kill -TERM <process_id>
  38
  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.
  45
  46 stopsrc -c -s dtsrc
  47
  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:
  52
  53 rmssys -s dtsrc
  54
  55 Default Configuration
  56
  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.
  60
  61 Special Configurations
  62
  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.
  66
  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.
  70
  71    # :0 Local local@console /path/X [options] :0
  72
  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.
  77
  78 *         If the system has more than one display, see Configuring
  79 Multiple Displays in the CDE Getting Started Guide.
  80
  81 To Start and Stop the Desktop Manually
  82 --------------------------------------
  83 There are two manual methods to start the desktop:
  84
  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.
  89
  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.
  93
  94 Manually Starting and Stopping Login Manager
  95 --------------------------------------------
  96 To manually start Login Manager:
  97
  98 1.  Log in as root.
  99
 100 2.  Enter:
 101
 102 /usr/dt/bin/dtlogin -daemon
 103
 104 This starts the Login Manager and displays the Login screen.
 105 Logging in starts a desktop session.
 106
 107 To manually stop Login Manager:
 108
 109 When you stop the Login Manager, you automatically kill all X servers and
 110 desktop sessions that it started.
 111
 112 1.  In a terminal emulator window, log in as root.
 113
 114 2.  Obtain the process id of the Login Manager by entering:
 115
 116 cat /var/dt/Xpid
 117
 118 3.  Kill the Login Manager by entering:
 119
 120 kill -TERM <process_id>
 121
 122 where <process_id> is the value obtained from Xpid.
 123
 124 Manually Starting and Stopping Session Manager
 125 ----------------------------------------------
 126 Using this method
 127
 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
 130 environment.
 131
 132
 133 * allows you to use CDE while others serving from the same system, including
 134 the console are not.
 135
 136 1.  Log in.  (You do not need to log in as root).
 137
 138 2.  With no window system running, from the command line enter:
 139
 140 /usr/bin/X11/xinit /usr/dt/bin/Xsession
 141
 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!
 144
 145 Session Manager stops when you log out.
 146
 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
 151 the system.
 152
 153 There are several ways to do this configuration:
 154
 155 *         From a command line.
 156
 157 *         Using SMIT menus.
 158
 159 *         Using SMIT fastpath.
 160
 161 From a Command Line
 162 -------------------
 163 To Enable Desktop Auto-Start:
 164
 165 1.  Log in as root.
 166
 167 2.  From the command line, enter:
 168
 169 /usr/dt/bin/dtconfig -e
 170
 171 3.  Reboot the machine.
 172
 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.
 175
 176 startsrc -s dtsrc
 177
 178 To Disable Desktop Auto-Start:
 179
 180 1.  Log in as root.
 181
 182 2.  From the command line, enter:
 183
 184 /usr/dt/bin/dtconfig -d
 185
 186 3.  Reboot the machine.
 187
 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.
 190
 191 stopsrc -c -s dtsrc
 192
 193 Using SMIT Menus
 194 ----------------
 195 To Enable Desktop Auto-Start:
 196
 197 1.  Log in as root.
 198
 199 2.  From the command line, enter:
 200
 201 /usr/bin/smit
 202
 203 3.  Go to System Environments.
 204
 205 4.  Go to Change System User Interface.
 206
 207 5.  Select CDE environment.
 208
 209 6.  Press [Enter] when using ASCII SMIT or Click "Do" when using GUI
 210 SMIT interface.
 211
 212 7.  Exit SMIT.
 213
 214 8.  Reboot the machine.
 215
 216 To Disable Desktop Auto-Start:
 217
 218 1.  Log in as root.
 219
 220 2.  From the command line, enter
 221
 222 /usr/bin/smit
 223
 224 3.  Go to System Environments.
 225
 226 4.  Go to Change System User Interface.
 227
 228 5.  Select Command-line environment.
 229
 230 6.  Press [Enter] when using ASCII SMIT or Click "Do" when
 231    using GUI SMIT interface.
 232
 233 7.  Exit out of SMIT.
 234
 235 8.  Reboot the machine.
 236
 237 Using SMIT `fastpath'
 238 ---------------------
 239 To Enable Desktop Auto-Start:
 240
 241 1.  Log in as root.
 242
 243 2.  From the command line, enter:
 244
 245 /usr/bin/smit dtconfig
 246
 247 3.  Select CDE environment.
 248
 249 4.  Press [Enter] when using ASCII SMIT or Click "Do" when using GUI
 250 SMIT interface.
 251
 252 5.  Exit SMIT.
 253
 254 6.  Reboot the machine.
 255
 256 To Disable Desktop Auto-Start:
 257
 258 1.  Log in as root.
 259
 260 2.  From the command line, enter:
 261
 262 /usr/bin/smit dtconfig
 263
 264 3.  Select Command-line environment.
 265
 266 4.  Press [Enter] when using ASCII SMIT or Click "Do" when using GUI
 267 SMIT interface.
 268
 269 5.  Exit out of SMIT.
 270
 271 6.  Reboot the machine.
 272
 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:
 277
 278 ./dinstall.dt
 279
 280 or
 281
 282 ./DINSTALL.DT
 283
 284 Everything installed from the installation scripts will be deinstalled.
 285