Initial import of the CDE 2.1.30 sources from the Open Group.
[oweals/cde.git] / cde / admin / IntegTools / config / config.sun
1 ####################################################    04/08/94
2 ### Instructions for the Sun Solaris Environment ###
3 ####################################################
4
5
6 Removing the October '93 Developer's Conference CDE Desktop
7 ===========================================================
8
9 It is imperative that CDE Snapshot 1 and Snapshot 2 desktops do not
10 co-mingle. Installers and users should ensure that old clients and
11 configuration files are exited or removed.  Use the instructions
12 in this section if the October '93 Snapshot 1 version of CDE is
13 installed on your system.
14
15
16    Upgrading systems in a networked environment
17    --------------------------------------------
18
19    If CDE is installed in a network environment, it is imperative that
20    all systems be upgraded at the same time.
21
22
23    Removing the Snapshot 1 desktop
24    -------------------------------
25
26    Installers are advised to remove the Snapshot 1 Desktop files from
27    their systems. Those clients and files are obsolete.  The dinstall.dt
28    script which was provided on the Snapshot 1 CD may be used for this
29    purpose.
30
31
32    Stopping Desktop clients before installing Snapshot 2
33    -----------------------------------------------------
34
35    If the Snapshot 1 desktop is not removed, ensure that all desktop
36    clients are inactive before installing the Snapshot 2 desktop.
37
38
39    Removing the users's .dtprofile and .dt directory
40    -------------------------------------------------
41
42    It is strongly advised that all CDE users on the system remove or
43    rename their .dt directory and their .dtprofile.  The Snapshot 2
44    Desktop is not compatible with the Snapshot 1 Desktop versions of
45    these files.
46
47    If users have customized their .dt/dtwmrc file and want to keep it,
48    they will need to cut and paste the appropriate pieces into the new
49    dtwmrc provided.
50
51
52 Before You Start the Desktop
53 ============================
54
55 You can start the CDE Desktop by:
56
57    * Configuring the system to auto-start the CDE Desktop when
58      the system is booted.
59
60    * Or, manually starting the desktop Login Manager.
61
62
63 Special Configurations
64 ----------------------
65
66 If your system has one of these special configurations, you may need to
67 edit certain Login Manager files before starting the desktop. See the 
68 Advanced User's and System Administrator's Guide:
69
70         * If the system console is a non-bitmap device.
71
72         * If the system is an X terminal or a host for X terminals.
73
74         * If the system has more than one display.
75
76
77 To Enable and Disable Desktop Auto-Start
78 ========================================
79
80 When auto-start is enabled, the CDE Login Manager runs automatically
81 each time the system is booted.  You then log in using the 
82 CDE Login Screen.
83
84 To Enable Desktop Auto-Start
85 ----------------------------
86
87 1. Log in as root.
88
89 2. From the command line, enter:
90
91         /usr/dt/bin/dtconfig -e
92
93 A CDE Login screen will appear the next time the system is booted.
94
95
96 To Disable Desktop Auto-Start
97 -----------------------------
98
99 1. Log in as root.
100
101 2. From a command line, enter:
102
103         /usr/dt/bin/dtconfig -d
104
105 A conventional ascii login will appear the next time the system
106 is booted.
107
108
109 To Start and Stop the Desktop Manually
110 ======================================
111
112 There are two ways to start the desktop manually:
113
114     * You can manually start the CDE Login Manager, which will display the
115       desktop Login screen.  To use this method, you must have permission
116       to log in as root.
117
118       This method is the preferable manual method, since Login Manager sets 
119       certain environment variables that are needed during desktop sessions.
120
121     * You can log in using conventional methods, and then manually run the CDE
122       Session Manager, which starts a desktop session.
123
124
125 Manually Starting and Stopping Login Manager
126 --------------------------------------------
127
128 When you use this method, you log in using the desktop Login screen.
129 When you log in, a desktop session starts.
130
131 To manually start Login Manager:
132
133 1. Log in as root.
134
135 2. With no window system running, from the command line enter:
136
137         /usr/dt/bin/dtlogin
138
139
140 To manually stop Login Manager:
141
142 1. If you are in a desktop session, exit (via front panel button).
143
144 2. On the Login screen, choose Options->Command Line
145    to return to a command line.
146
147 3. On the command line, enter [Ctrl]c (hold down [Ctrl] as
148    you press [c]).
149
150 You are now back to your root login with a command line prompt. 
151
152
153 Manually Starting and Stopping Session Manager
154 ----------------------------------------------
155
156 If you use this method, you are responsible for setting certain environment
157 variables to values required by the desktop if suitable values are
158 not already set in your environment.  See the Advanced User's and System
159 Administrator's Guide.
160
161 1. Log in.  (You do not need to log in as root).
162
163    If you set LD_LIBRARY_PATH (its not required for CDE), make sure the 
164    /usr/dt/lib directory is at head of list.  In addition, you should 
165    set the environment variable OPENWINHOME to /usr/openwin.
166
167 2. With no window system running, from the command line enter:
168
169         /usr/openwin/bin/xinit /usr/dt/bin/Xsession
170
171 This starts your CDE desktop session.  Exit button is on front panel.
172
173
174
175 To Configure Subprocess Control Daemon remote access
176 ====================================================
177
178 If you are working in an environment where a CDE Desktop action needs to
179 start an application on another workstation running CDE, the Subprocess
180 Control Daemon must have access to the /tmp directory of the remote 
181 workstation.
182
183 The following procedure will provide this.
184
185 1. Log in as root.
186
187 2. Provide NFS-access by the local (client) system to the remote (application
188    server) system's /tmp directory. The mount point must be
189    /nfs/<remote_host>/tmp.
190
191    On systems running automount, the following procedure provides this mount:
192
193         a. Enter:
194
195              mkdir /nfs
196
197         b.  Add the following lines to /etc/auto_master:
198
199              /nfs -hosts -nosuid
200
201         c. To allow export of the /tmp directory, add the following line
202            to /etc/dfs/dfstab:
203
204             shared -F nfs -o rw /tmp
205
206 3. The subprocess control daemon will have correct access the next time 
207    the workstation is booted.