
<appendix id="sysadmin-0">
<title>System Administration</title>
<para>This appendix
describes some tasks that a system administrator needs to perform to enable
accessible login and to facilitate the use of the assistive technologies that
are available in the GNOME Desktop.</para>
<sect1 id="sysadmin-6">
<title>Enabling Full Screen Magnification</title>
<indexterm>
<primary>Screen Reader and Magnifier</primary>
<secondary>enabling
full screen magnification</secondary>
</indexterm>
<para>The following sections
describe the methods to enable full screen magnification.</para>
<sect2 id="sysadmin-48">
<title>To Enable Full Screen Magnification Using Two Video Cards</title>
<para>To enable full screen magnification in <application>Screen Reader and
Magnifier</application> using two physical video cards, perform the following
steps:</para>
<orderedlist>
<listitem>
<para>Configure two video cards as :0.0 and :0.1.</para>
<note>
<para>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 the nominal
magnification factor.</para>
</note>
</listitem>
<listitem>
<para>Choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Accessibility</guisubmenu><guimenuitem>Screen Reader and Magnifier</guimenuitem></menuchoice>.</para>
</listitem>
<listitem>
<para>Click on <guilabel>Preferences</guilabel> in the <guilabel>Gnopernicus</guilabel> menu window.</para>
</listitem>
<listitem>
<para>Click on <guilabel>Magnifier</guilabel> to open the <guilabel>Magnifier Preferences</guilabel> dialog.</para>
</listitem>
<listitem>
<para>Click on the <guibutton>Add/Modify</guibutton> button to display
the <guilabel>Zoomer Options</guilabel> dialog.</para>
</listitem>
<listitem>
<para>In the <guilabel>Display Screen</guilabel> section, type <userinput>:0.0</userinput> in the <guilabel>Source</guilabel> text box. </para>
</listitem>
<listitem>
<para>In the <guilabel>Display Screen</guilabel> section, type <userinput>:0.1</userinput> in the <guilabel>Target</guilabel> text box. </para>
</listitem>
<listitem>
<para>Set the Zoomer Placement values to be <literal>[0,0,1023,767]</literal>.</para>
<note>
<para>These instructions assume a video resolution of 1024x768. </para>
</note>
</listitem>
<listitem>
<para>Click <guibutton>Apply</guibutton> and <guibutton>Close</guibutton>
to close the <guilabel>Zoomer Options</guilabel> dialog. </para>
<para>The magnified view is displayed on the second display 0.1.</para>
</listitem>
</orderedlist>
</sect2>
<sect2 id="sysadmin-49">
<title>To Enable Full Screen Magnification Using One Video Card on Linux Systems</title>
<para>To enable full screen magnification on Linux systems using one physical
video card and one virtual video card, perform the following steps:</para>
<orderedlist>
<listitem>
<para>Open the file <filename>/etc/X11/XF86Config</filename>.</para>
</listitem>
<listitem>
<para>Create a new section at the end of the file as follows:</para>
<literallayout>Section &quot;Device&quot;
Boardname &quot;dummy&quot;
Driver &quot;dummy&quot;
Identifier &quot;dummy&quot;
VendorName &quot;dummy&quot;
EndSection </literallayout>
</listitem>
<listitem>
<para>Copy the <literal>Monitor</literal> section and paste it at
the end of the file.</para>
</listitem>
<listitem>
<para>In the new <literal>Monitor</literal> section, edit the <literal>Identifier</literal> line as follows:</para>
<para>
<literallayout>Identifier &quot;MonitorD&quot;</literallayout>
</para>
</listitem>
<listitem>
<para>Copy the <literal>Screen</literal> section and paste it at
the end of the file.</para>
</listitem>
<listitem>
<para>In the new <literal>Screen</literal> section, edit the <literal>Device</literal>, <literal>Identifier</literal>, and <literal>Monitor</literal>
lines as follows:</para>
<para>
<literallayout>Device &quot;dummy&quot;
Identifier &quot;Screen[D]&quot;
Monitor &quot;MonitorD&quot;</literallayout>
</para>
</listitem>
<listitem>
<para>Edit the <literal>ServerLayout</literal> section to change
the <literal>Screen</literal> line as follows:</para>
<para>
<literallayout>Screen &quot;Screen[0]&quot; 0 0</literallayout>
</para>
</listitem>
<listitem>
<para>Insert the following line in the <literal>ServerLayout</literal>
section:</para>
<para>
<literallayout>Screen &quot;Screen[D]&quot; RightOf &quot;Screen[0]&quot;</literallayout>
</para>
</listitem>
<listitem>
<para>Save the <filename>/etc/X11/XF86Config</filename> file.</para>
</listitem>
<listitem>
<para>Restart the X Server.</para>
</listitem>
<listitem>
<para>Start the <application>Screen Reader and Magnifier</application>
application.</para>
</listitem>
<listitem>
<para>Click on <guilabel>Startup Mode</guilabel> in the <guilabel>Gnopernicus</guilabel> menu window.</para>
</listitem>
<listitem>
<para>Select the <guilabel>Magnifier</guilabel> option in the <guilabel>Startup Mode</guilabel> dialog.</para>
</listitem>
<listitem>
<para>Click on <guilabel>Preferences</guilabel> in the <guilabel>Gnopernicus</guilabel> menu window.</para>
</listitem>
<listitem>
<para>Click on <guilabel>Magnifier</guilabel> to open the <guilabel>Magnifier Preferences</guilabel> dialog.</para>
</listitem>
<listitem>
<para>Click on the <guibutton>Add/Modify</guibutton> button to display
the <guilabel>Zoomer Options</guilabel> dialog.</para>
</listitem>
<listitem>
<para>In the <guilabel>Display Screen</guilabel> section, type <userinput>:0.1</userinput> in the <guilabel>Source</guilabel> text box. </para>
</listitem>
<listitem>
<para>In the <guilabel>Zoomer Placement</guilabel> section, set
the value of the <guilabel>Left</guilabel> spin box to <userinput>0</userinput>.</para>
</listitem>
<listitem>
<para>Click <guibutton>Apply</guibutton>.</para>
<para>The <application>Screen Reader and Magnifier</application> user interface
is no longer visible.</para>
</listitem>
<listitem>
<para>Log out of your session.</para>
</listitem>
<listitem>
<para>Log in to a new session.</para>
</listitem>
<listitem>
<para>Enter the following command to start <application>Screen Reader
and Magnifier</application> in full screen magnification mode:</para>
<para>
<command>gnopernicus -display :0.1</command>
</para>
</listitem>
<listitem>
<para>When you log out of your session, select the <guilabel>Save
current setup</guilabel> option. </para>
</listitem>
</orderedlist>
</sect2>
</sect1>
<sect1 id="sysadmin-52">
<title>Enabling Braille</title>
<indexterm>
<primary>Braille, enabling</primary>
</indexterm>
<para>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. To do that:</para>
<orderedlist>
<listitem>
<para>Log in as the <literal>root</literal> user.</para>
</listitem>
<listitem>
<para>Enter the following command:</para>
<para>
<command>chmod 777 /dev/ttyS0</command>
</para>
</listitem>
<listitem>
<para>Enter the following command:</para>
<para>
<command>chmod 777 /dev/ttyS1</command>
</para>
</listitem>
</orderedlist>
</sect1>
<sect1 id="sysadmin-37">
<title>Configuring Alternative Pointer Devices</title>
<indexterm>
<primary>configuring two pointer devices</primary>
<secondary>on
Linux systems</secondary>
</indexterm>
<para>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 tracker device, and how to configure <application>On-Screen
Keyboard</application> to use the second pointer device.</para>
<para>To configure an alternative pointer
device, perform the following steps:</para>
<orderedlist>
<listitem>
<para>Before you connect the alternative pointer device to your
system, enter the following command to list the existing devices:</para>
<para>
<command>ls -l /dev/usb/hid*</command>
</para>
</listitem>
<listitem>
<para>Connect the alternative pointer device to your system.</para>
</listitem>
<listitem>
<para>Enter the following command again to list the new device:</para>
<para>
<command>ls -l /dev/usb/hid*</command>
</para>
</listitem>
<listitem>
<para>Open the file <filename>/etc/X11/XF86Config</filename>.</para>
</listitem>
<listitem>
<para>Edit the <literal>InputDevice</literal> section where the <literal>Driver</literal> value is set to <literal>mouse</literal> as follows:</para>
<itemizedlist>
<listitem>
<para>Change the <literal>Option Device</literal> line to the following:</para>
<para>
<literallayout>Option &quot;Device&quot; &quot;/dev/input/mouse0&quot;</literallayout>
</para>
</listitem>
<listitem>
<para>Comment out the <literal>Option Protocol</literal> line as
follows:</para>
<para>
<literallayout>#Option &quot;Protocol&quot; &quot;explorerps/2&quot;</literallayout>
</para>
</listitem>
</itemizedlist>
<note>
<para>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.</para>
</note>
</listitem>
<listitem>
<para>Create a new <literal>InputDevice</literal> section as follows:</para>
<para>
<literallayout>Section &quot;InputDevice&quot;
Driver &quot;mouse&quot;
Identifier &quot;Mouse[3]&quot;
Option &quot;Device&quot; &quot;/dev/input/mouse1&quot;
Option &quot;Name&quot; &quot;Autodetection&quot;
Option &quot;Vendor&quot; &quot;Sysp&quot;
EndSection</literallayout>
</para>
<note>
<para>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.</para>
</note>
</listitem>
<listitem>
<para>Edit the <literal>ServerLayout</literal> section as follows:</para>
<itemizedlist>
<listitem>
<para>Change the <literal>InputDevice &quot;Mouse[1]&quot;</literal> line
to the following:</para>
<para>
<literallayout>InputDevice &quot;Mouse[1]&quot; &quot;CorePointer&quot;</literallayout>
</para>
</listitem>
<listitem>
<para>Create a new <literal>InputDevice</literal> line as follows:</para>
<para>
<literallayout>InputDevice &quot;Mouse[3]&quot;
</literallayout>
</para>
</listitem>
<listitem>
<para>Remove any occurrences of the attributes <literal>SendCore</literal> or <literal>AlwaysCore</literal> from any of <literal>InputDevice</literal> lines.</para>
</listitem>
</itemizedlist>
<note>
<para>Ensure that only the device that you are using as the primary
mouse device has the <literal>&quot;CorePointer&quot;</literal> attribute and ensure
that the alternate input devices do not have the <literal>SendCore</literal>
or <literal>AlwaysCore</literal> attributes.</para>
</note>
</listitem>
<listitem>
<para>Save the <filename>/etc/X11/XF86Config</filename> file.</para>
</listitem>
<listitem>
<para>Restart the X Server.</para>
</listitem>
</orderedlist>
<sect2 id="sysadmin-47">
<title>To Configure On-Screen Keyboard to Use an Alternative Pointer Device</title>
<indexterm>
<primary>On-Screen Keyboard</primary>
<secondary>configuring for
two pointer devices</secondary>
</indexterm>
<para>To configure the <application>On-Screen Keyboard</application> application to use an alternative pointer
device, perform the following steps.</para>
<orderedlist>
<listitem>
<para>Start the <application>On-Screen Keyboard</application> application.</para>
</listitem>
<listitem>
<para>Click on <guilabel>GOK</guilabel> in the <guilabel>GOK - main</guilabel> window.</para>
</listitem>
<listitem>
<para>Click on <guilabel>Preferences</guilabel> to open the <guilabel>Preferences</guilabel> dialog.</para>
</listitem>
<listitem>
<para>Click on the <guilabel>Actions</guilabel> tab.</para>
</listitem>
<listitem>
<para>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.</para>
</listitem>
<listitem>
<para>Click <guibutton>OK</guibutton> to close the <guilabel>GOK
Preferences</guilabel> dialog.</para>
</listitem>
</orderedlist>
</sect2>
</sect1>
</appendix>
