Convert uses of XKeycodeToKeysym (deprecated) to XkbKeycodeToKeysym
[oweals/cde.git] / cde / admin / IntegTools / config / config.hp
1 ####################################################
2 ### Configuration Instructions for HP-UX Systems ###
3 ####################################################
4
5 There are two ways to start the desktop:
6
7
8    * You can manually start the desktop Login Manager. The advantage
9      of using this method is that you will not have to edit
10      /etc/inittab.
11
12    * You can enable the system to automatically start the desktop
13      when the system is rebooted.  This is done by editing
14      /etc/inittab.
15
16 Removing the Developer's Conference CDE Desktop
17 ===============================================
18
19 It is imperative that Snapshot 1 and Snapshot 2 desktops do not
20 co-mingle. Installers and users should ensure that old clients and
21 configuration files are exited or removed.
22
23
24 Upgrading systems in a networked environment
25 --------------------------------------------
26
27 If CDE is installed in a network environment, it is imperative that
28 all systems be upgraded at the same time.
29
30
31 Removing the Snapshot 1 desktop
32 -------------------------------
33
34 Installers are advised to remove the Snapshot 1 Desktop files from
35 their systems. Those clients and files are obsolete.
36
37
38 Stopping Desktop clients before installing Snapshot 2
39 -----------------------------------------------------
40
41 If the Snapshot 1 desktop is not removed, ensure that all desktop
42 clients are inactive before installing the Snapshot 2 desktop. If the
43 desktop was started via /etc/inittab, issue the telinit command to
44 stop dtlogin and any other desktop client.
45
46
47 Removing the users's .dtprofile and .dt directory
48 -------------------------------------------------
49
50 It is strongly advised that all CDE users on the system remove or
51 rename their .dt directory and their .dtprofile.  The Snapshot 2
52 Desktop is not compatible with the Snapshot 1 Desktop versions of
53 these files.
54
55 If users have customized their .dt/dtwmrc file and want to keep it,
56 they will need to cut and paste the appropriate pieces into the new
57 dtwmrc provided.
58
59
60
61 Before You Start the Desktop (HP-UX)
62 ======================================
63
64 Special Configurations
65 ----------------------
66
67 If your system has one of these special configurations, you may need to
68 edit certain Login Manager files before starting the desktop. See
69 chapter 2 of the Getting Started Guide:
70
71
72         * If the system console is a non-bitmap device.
73
74         * If the system is an X terminal or a host for X terminals.
75
76         * If the system has more than one display.
77
78
79
80 The Subprocess Control Daemon 
81 =============================
82
83 If you are working in an environment where a CDE Desktop action needs
84 to start an application on another workstation running CDE, the
85 Subprocess Control Daemon configuration must be completed on both
86 workstations.
87
88 1. Log in as root.
89
90 2. For authentication, the user's home directory on a remote system
91    must be mounted to the local system.
92
93 3. To run an application with a WINDOW_TYPE of NO_STDIO (see Appendix
94    A, Advanced User's and System Administrator's Guide), you will need
95    to provide NFS-access by the local (client) system to the remote
96    (application server) system's /var directory (if /var is a distinct
97    volume), or / directory (if it is not). The mount point must be
98    /nfs/<remote_host>/var (again, if /var is a distinct volume) or
99    /nfs/<remote_host>/ (if it is not). Export the appropriate
100    directory in /etc/exports on both the local and remote hosts.
101
102
103 To Start And Stop the Desktop Manually 
104 ======================================
105
106 To Start the Desktop:
107 --------------------
108
109 1. Log in as root.
110
111 2. Enter:
112
113         /usr/dt/bin/dtlogin -daemon
114
115    This starts the Login Manager and displays the Login screen.
116    Logging in starts a desktop session.
117
118 To Stop the Desktop:
119 --------------------
120
121 When you stop the Login Manager, you automatically kill all
122 X servers and desktop sessions that it started.
123
124 1. In a terminal emulator window, log in as root.
125
126 2. Obtain the process id of the parent Login Manager by entering:
127
128         cat /var/dt/Xpid
129
130 3. Kill the Login Manager by entering:
131
132         kill -TERM <process_id>
133
134 where <process_id> is the value obtained from Xpid.
135
136
137 To Enable and Disable Desktop Auto-Start
138 ========================================
139
140 When your system is configured to start the desktop automatically, the
141 desktop Login Manager runs when the system is booted.
142
143 To start the desktop automatically, you must edit /etc/inittab to:
144
145       * Add a line that starts the CDE Desktop.
146
147       * Set the default run level to the run level assigned to the CDE
148         Desktop.
149
150       NOTE: Edit /etc/inittab very carefully.
151             Errors in the file can prevent the system from booting
152             successfully.
153
154
155 To Enable Desktop Auto-Start
156 ----------------------------
157
158 1. Log in as root.
159
160 2. If you are running HP VUE, shut it down by entering:
161
162         /etc/telinit <n>; exit
163
164         where <n> is a run level assigned to the console and not
165         assigned to HP VUE or to halting the system.  You can find a
166         run level by examinining the lines beginning with cons and vue
167         in /etc/inittab.  For example, the following lines indicate
168         that you can use run levels other than 3, 4, or 6.
169
170            halt:6:wait:/usr/lib/X11/ignition/shutdown.ksh
171            cons:012456:respawn:/etc/getty -h console console
172            vue :34:respawn:/etc/vuerc
173
174
175 3. Make a backup copy of /etc/inittab.
176
177 4. Open /etc/inittab for editing (in a diskless cluster, /etc/inittab
178    is a context-dependent file).
179
180 5. Look for the line that sets the default run level (starting with
181    init:).  Set the default run level to 5.
182
183         init:5:initdefault:
184
185         
186 6. Add a line that starts the desktop at that run level:
187
188         dt :5:respawn:/usr/dt/bin/dtrc                     
189         
190
191 To Disable Desktop Auto-Start
192 -----------------------------
193
194 You can restore a console by changing to a run level assigned to a
195 console and not assigned to the desktop.
196
197
198 Switching Between CDE and HP VUE
199 --------------------------------
200 You can switch back and forth between CDE and HP VUE by executing:
201
202         /etc/telinit <n>; exit
203
204
205 where <n>=3 switches to HP VUE and <n>=5 switches to CDE.
206
207