2
1
<appendix id="sysadmin-0">
3
2
<title>System Administration</title>
5
describes some tasks that a system administrator needs to perform to enable
6
accessible login and to facilitate the use of the assistive technologies that
7
are available in the GNOME Desktop.</para>
4
This appendix describes some tasks that a system administrator needs to perform to enable an accessible login and to facilitate the use of the assistive technologies that are available in the GNOME Desktop.
8
7
<sect1 id="sysadmin-6">
9
<title>Enabling Full Screen Magnification</title>
8
<title>Enabling Full-Screen Magnification</title>
11
10
<primary>Screen Reader and Magnifier</primary>
13
full screen magnification</secondary>
11
<secondary>enabling full screen magnification
15
<para>The following sections
16
describe the methods to enable full screen magnification.</para>
15
The following sections describe the methods to enable full-screen magnification.
17
18
<sect2 id="sysadmin-48">
18
<title>To Enable Full Screen Magnification Using Two Video Cards</title>
19
<para>To enable full screen magnification in <application>Screen Reader and
20
Magnifier</application> using two physical video cards, perform the following
19
<title>Enabling Full-Screen Magnification with Two Video Cards</title>
21
To enable full-screen magnification in <application>Screen Reader and Magnifier</application> using two physical video cards, perform the following steps:
24
<para>Configure two video cards as :0.0 and :0.1.</para>
26
<para>It is not essential that both video cards have the same resolution
27
and bit depth. However, if the resolutions and bit depths of both cards differ
28
greatly, the apparent magnification factor may differ slightly from the nominal
29
magnification factor.</para>
33
<para>Choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Accessibility</guisubmenu><guimenuitem>Screen Reader and Magnifier</guimenuitem></menuchoice>.</para>
36
<para>Click on <guilabel>Preferences</guilabel> in the <guilabel>Gnopernicus</guilabel> menu window.</para>
39
<para>Click on <guilabel>Magnifier</guilabel> to open the <guilabel>Magnifier Preferences</guilabel> dialog.</para>
42
<para>Click on the <guibutton>Add/Modify</guibutton> button to display
43
the <guilabel>Zoomer Options</guilabel> dialog.</para>
46
<para>In the <guilabel>Display Screen</guilabel> section, type <userinput>:0.0</userinput> in the <guilabel>Source</guilabel> text box. </para>
49
<para>In the <guilabel>Display Screen</guilabel> section, type <userinput>:0.1</userinput> in the <guilabel>Target</guilabel> text box. </para>
52
<para>Set the Zoomer Placement values to be <literal>[0,0,1023,767]</literal>.</para>
54
<para>These instructions assume a video resolution of 1024x768. </para>
58
<para>Click <guibutton>Apply</guibutton> and <guibutton>Close</guibutton>
59
to close the <guilabel>Zoomer Options</guilabel> dialog. </para>
60
<para>The magnified view is displayed on the second display 0.1.</para>
26
Configure two video cards as :0.0 and :0.1.
30
It is not essential that both video cards have the same resolution and bit depth. However, if the resolutions and bit depths of both cards differ greatly, the apparent magnification factor may differ slightly from
31
the nominal magnification factor.
37
Choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Accessibility</guisubmenu><guimenuitem>Screen Reader and Magnifier</guimenuitem></menuchoice>.
42
Click on <guilabel>Preferences</guilabel> in the <guilabel>Gnopernicus</guilabel> menu window.
47
Click on <guilabel>Magnifier</guilabel> to open the <guilabel>Magnifier Preferences</guilabel> dialog.
52
Click on the <guibutton>Add/Modify</guibutton> button to display the <guilabel>Zoomer Options</guilabel> dialog.
57
In the <guilabel>Display Screen</guilabel> section, type <userinput>:0.0</userinput> in the <guilabel>Source</guilabel> text box.
62
In the <guilabel>Display Screen</guilabel> section, type <userinput>:0.1</userinput> in the <guilabel>Target</guilabel> text box.
67
Set the Zoomer Placement values to be
68
<literal>[0,0,1023,767]</literal>.
72
These instructions assume a video resolution of 1024x768.
78
Click <guibutton>Apply</guibutton> and <guibutton>Close</guibutton> to close the <guilabel>Zoomer Options</guilabel> dialog.
81
The magnified view is displayed on the second display (0.1).
64
87
<sect2 id="sysadmin-49">
65
<title>To Enable Full Screen Magnification Using One Video Card on Linux Systems</title>
66
<para>To enable full screen magnification on Linux systems using one physical
67
video card and one virtual video card, perform the following steps:</para>
88
<title>Enabling Full-Screen Magnification Using One Video Card on Linux Systems</title>
90
To enable full-screen magnification on Linux systems using one physical video card and one virtual video card, perform the following steps:
70
<para>Open the file <filename>/etc/X11/XF86Config</filename>.</para>
95
Open the file <filename>/etc/X11/XF86Config</filename>.
73
<para>Create a new section at the end of the file as follows:</para>
100
Create a new section at the end of the file as follows:
74
102
<literallayout>Section "Device"
75
103
Boardname "dummy"
76
104
Driver "dummy"
105
<para>Edit the <literal>ServerLayout</literal> section to change
106
the <literal>Screen</literal> line as follows:</para>
108
<literallayout>Screen "Screen[0]" 0 0</literallayout>
112
<para>Insert the following line in the <literal>ServerLayout</literal>
115
<literallayout>Screen "Screen[D]" RightOf "Screen[0]"</literallayout>
119
<para>Save the <filename>/etc/X11/XF86Config</filename> file.</para>
122
<para>Restart the X Server.</para>
125
<para>Start the <application>Screen Reader and Magnifier</application>
129
<para>Click on <guilabel>Startup Mode</guilabel> in the <guilabel>Gnopernicus</guilabel> menu window.</para>
132
<para>Select the <guilabel>Magnifier</guilabel> option in the <guilabel>Startup Mode</guilabel> dialog.</para>
135
<para>Click on <guilabel>Preferences</guilabel> in the <guilabel>Gnopernicus</guilabel> menu window.</para>
138
<para>Click on <guilabel>Magnifier</guilabel> to open the <guilabel>Magnifier Preferences</guilabel> dialog.</para>
141
<para>Click on the <guibutton>Add/Modify</guibutton> button to display
142
the <guilabel>Zoomer Options</guilabel> dialog.</para>
145
<para>In the <guilabel>Display Screen</guilabel> section, type <userinput>:0.1</userinput> in the <guilabel>Source</guilabel> text box. </para>
148
<para>In the <guilabel>Zoomer Placement</guilabel> section, set
149
the value of the <guilabel>Left</guilabel> spin box to <userinput>0</userinput>.</para>
152
<para>Click <guibutton>Apply</guibutton>.</para>
153
<para>The <application>Screen Reader and Magnifier</application> user interface
154
is no longer visible.</para>
157
<para>Log out of your session.</para>
160
<para>Log in to a new session.</para>
163
<para>Enter the following command to start <application>Screen Reader
164
and Magnifier</application> in full screen magnification mode:</para>
140
Edit the <literal>ServerLayout</literal> section to change the <literal>Screen</literal> line as follows:
143
<literallayout>Screen "Screen[0]" 0 0
149
Insert the following line in the <literal>ServerLayout</literal> section:
152
<literallayout>Screen "Screen[D]"
153
RightOf "Screen[0]"</literallayout>
158
Save the <filename>/etc/X11/XF86Config</filename> file.
163
Restart the X Server.
168
Start the <application>Screen Reader and Magnifier</application> application.
173
Click on <guilabel>Startup Mode</guilabel> in the <guilabel>Gnopernicus</guilabel> menu window.
178
Select the <guilabel>Magnifier</guilabel> option in the <guilabel>Startup Mode</guilabel> dialog.
183
Click on <guilabel>Preferences</guilabel> in the <guilabel>Gnopernicus</guilabel> menu window.
188
Click on <guilabel>Magnifier</guilabel> to open the <guilabel>Magnifier Preferences</guilabel> dialog.
193
Click on the <guibutton>Add/Modify</guibutton> button to display the <guilabel>Zoomer Options</guilabel> dialog.
198
In the <guilabel>Display Screen</guilabel> section, type <userinput>:0.1</userinput> in the <guilabel>Source</guilabel> text box.
203
In the <guilabel>Zoomer Placement</guilabel> section, set the value of the <guilabel>Left</guilabel> spin box to <userinput>0</userinput>.
208
Click <guibutton>Apply</guibutton>.
211
The <application>Screen Reader and Magnifier
212
</application> user interface is no longer visible.
217
Log out of your session.
222
Log in to a new session.
227
Enter the following command to start <application>Screen Reader and Magnifier</application> in full-screen magnification mode:
166
230
<command>gnopernicus -display :0.1</command>
170
<para>When you log out of your session, select the <guilabel>Save
171
current setup</guilabel> option. </para>
235
When you log out of your session, select the
236
<guilabel>Save current setup</guilabel> option.
176
243
<sect1 id="sysadmin-52">
177
<title>Enabling Braille</title>
244
<title>Enabling braille</title>
179
<primary>Braille, enabling</primary>
246
<primary>braille, enabling</primary>
182
your system to support Braille output, you must configure the access rights
183
to the serial port to which the Braille device is connected. To do that:</para>
249
To enable your system to support braille output, you must configure the access rights to the serial port to which the braille device is connected:
186
<para>Log in as the <literal>root</literal> user.</para>
254
Log in as the <literal>root</literal> user.
189
<para>Enter the following command:</para>
259
Enter the following command:
191
262
<command>chmod 777 /dev/ttyS0</command>
195
<para>Enter the following command:</para>
267
Enter the following command:
197
270
<command>chmod 777 /dev/ttyS1</command>
202
276
<sect1 id="sysadmin-37">
203
277
<title>Configuring Alternative Pointer Devices</title>
205
279
<primary>configuring two pointer devices</primary>
207
Linux systems</secondary>
280
<secondary>on Linux systems</secondary>
209
<para>The following sections describe how to configure your system to use
210
a standard physical mouse and another pointer device such as a single switch
211
device or head tracker device, and how to configure <application>On-Screen
212
Keyboard</application> to use the second pointer device.</para>
213
<para>To configure an alternative pointer
214
device, perform the following steps:</para>
283
The following sections describe how to configure your system to use a standard physical mouse and another pointer device such as a single switch device or head
284
tracker device, and how to configure <application>On-Screen Keyboard</application> to use the second pointer device.
287
To configure an alternative pointer device, perform the following steps:
217
<para>Before you connect the alternative pointer device to your
218
system, enter the following command to list the existing devices:</para>
220
<command>ls -l /dev/usb/hid*</command>
224
<para>Connect the alternative pointer device to your system.</para>
227
<para>Enter the following command again to list the new device:</para>
229
<command>ls -l /dev/usb/hid*</command>
233
<para>Open the file <filename>/etc/X11/XF86Config</filename>.</para>
236
<para>Edit the <literal>InputDevice</literal> section where the <literal>Driver</literal> value is set to <literal>mouse</literal> as follows:</para>
292
Before you connect the alternative pointer device to your system, enter the following command to list the existing devices:
295
<command>ls -l /dev/usb/hid*</command>
300
Connect the alternative pointer device to your system.
305
Enter the following command again to list the new device:
308
<command>ls -l /dev/usb/hid*</command>
313
Open the file <filename>/etc/X11/XF86Config</filename>.
318
Edit the <literal>InputDevice</literal> section where the <literal>Driver</literal> value is set to <literal>mouse</literal> as follows:
239
<para>Change the <literal>Option Device</literal> line to the following:</para>
241
<literallayout>Option "Device" "/dev/input/mouse0"</literallayout>
323
Change the <literal>Option Device</literal> line to the following:
327
Option "Device" "/dev/input/mouse0"
245
<para>Comment out the <literal>Option Protocol</literal> line as
248
<literallayout>#Option "Protocol" "explorerps/2"</literallayout>
333
Comment out the <literal>Option Protocol</literal> line as follows:
337
#Option "Protocol" "explorerps/2"
253
<para>If you are not using USB connections for your primary mouse device
254
and other pointer device, you do not need to carry out this step.</para>
344
If you are not using USB connections for your primary mouse device and other pointer device, you do not need to carry out this step.
258
<para>Create a new <literal>InputDevice</literal> section as follows:</para>
350
Create a new <literal>InputDevice</literal> section as follows:
260
353
<literallayout>Section "InputDevice"
261
354
Driver "mouse"
266
359
EndSection</literallayout>
269
<para>If you are not using USB connections for your primary mouse device
270
and other pointer device, you do not need to carry out this step.</para>
363
If you are not using USB connections for your primary mouse device and other pointer device, you do not need to carry out this step.
274
<para>Edit the <literal>ServerLayout</literal> section as follows:</para>
369
Edit the <literal>ServerLayout</literal> section as follows:
277
<para>Change the <literal>InputDevice "Mouse[1]"</literal> line
278
to the following:</para>
280
<literallayout>InputDevice "Mouse[1]" "CorePointer"</literallayout>
374
Change the <literal>InputDevice "Mouse[1]"</literal> line to the following:
378
InputDevice "Mouse[1]" "CorePointer"
284
<para>Create a new <literal>InputDevice</literal> line as follows:</para>
384
Create a new <literal>InputDevice</literal> line as follows:
286
387
<literallayout>InputDevice "Mouse[3]"
291
<para>Remove any occurrences of the attributes <literal>SendCore</literal> or <literal>AlwaysCore</literal> from any of <literal>InputDevice</literal> lines.</para>
393
Remove any occurrences of the attributes
394
<literal>SendCore</literal> or <literal>AlwaysCore</literal> from any of <literal>InputDevice</literal> lines.
295
<para>Ensure that only the device that you are using as the primary
296
mouse device has the <literal>"CorePointer"</literal> attribute and ensure
297
that the alternate input devices do not have the <literal>SendCore</literal>
298
or <literal>AlwaysCore</literal> attributes.</para>
400
Ensure that only the device that you are using as the primary mouse device has the <literal>"CorePointer"</literal> attribute and ensure that the alternate input devices do not have the <literal>SendCore</literal> or <literal>AlwaysCore</literal> attributes.
302
<para>Save the <filename>/etc/X11/XF86Config</filename> file.</para>
406
Save the <filename>/etc/X11/XF86Config</filename> file.
305
<para>Restart the X Server.</para>
411
Restart the X Server.
308
416
<sect2 id="sysadmin-47">
309
<title>To Configure On-Screen Keyboard to Use an Alternative Pointer Device</title>
417
<title>Configuring the On-Screen Keyboard to Use an Alternative Pointer Device</title>
311
419
<primary>On-Screen Keyboard</primary>
312
<secondary>configuring for
313
two pointer devices</secondary>
420
<secondary>configuring for two pointer devices</secondary>
315
<para>To configure the <application>On-Screen Keyboard</application> application to use an alternative pointer
316
device, perform the following steps.</para>
423
To configure the <application>On-Screen Keyboard</application> application to use an alternative pointer device, perform the following steps:
319
<para>Start the <application>On-Screen Keyboard</application> application.</para>
322
<para>Click on <guilabel>GOK</guilabel> in the <guilabel>GOK - main</guilabel> window.</para>
325
<para>Click on <guilabel>Preferences</guilabel> to open the <guilabel>Preferences</guilabel> dialog.</para>
328
<para>Click on the <guilabel>Actions</guilabel> tab.</para>
331
<para>In the <guilabel>Event Source</guilabel> options, select the <guilabel>Other input device</guilabel> option. <application>On-Screen Reader</application>
332
displays the name of the input device that you configured in the text box
333
next to the <guilabel>Other input device</guilabel> option.</para>
336
<para>Click <guibutton>OK</guibutton> to close the <guilabel>GOK
337
Preferences</guilabel> dialog.</para>
428
Start the <application>On-Screen Keyboard</application> application.
433
Click on <guilabel>GOK</guilabel> in the <guilabel>GOK - main</guilabel> window.
438
Click on <guilabel>Preferences</guilabel> to open the <guilabel>Preferences</guilabel> dialog.
443
Click on the <guilabel>Actions</guilabel> tab.
448
In the <guilabel>Event Source</guilabel> options, select the <guilabel>Other input device</guilabel> option. <application>On-Screen Reader</application> displays the name of the input device that you configured in the text box next to the <guilabel>Other input device</guilabel> option.
453
Click <guibutton>OK</guibutton> to close the
454
<guilabel>GOK Preferences</guilabel> dialog.