# System Administration

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.

## Enabling Full-Screen Magnification

The following sections describe the methods to enable full-screen magnification.

### Enabling Full-Screen Magnification with Two Video Cards

To enable full-screen magnification in Screen Reader and Magnifier using two physical video cards, perform the following steps:

1. Configure two video cards as :0.0 and :0.1.

   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.

2. Choose Applications Accessibility Screen Reader and Magnifier.

3. Click on Preferences in the Gnopernicus menu window.

4. Click on Magnifier to open the Magnifier Preferences dialog.

5. Click on the Add/Modify button to display the Zoomer Options dialog.

6. In the Display Screen section, type `:0.0` in the Source text box.

7. In the Display Screen section, type `:0.1` in the Target text box.

8. Set the Zoomer Placement values to be `[0,0,1023,767]`.

   These instructions assume a video resolution of 1024x768.

9. Click Apply and Close to close the Zoomer Options dialog.

   The magnified view is displayed on the second display (0.1).

### Enabling Full-Screen Magnification Using One Video Card on Linux Systems

To enable full-screen magnification on Linux systems using one physical video card and one virtual video card, perform the following steps:

1. Open the file `/etc/X11/XF86Config`.

2. Create a new section at the end of the file as follows:

       Section "Device"
       Boardname "dummy"
       Driver "dummy"
       Identifier "dummy"
       VendorName "dummy"
       EndSection

3. Copy the `Monitor` section and paste it at the end of the file.

4. In the new `Monitor` section, edit the `Identifier` line as follows:

       Identifier "MonitorD"

5. Copy the `Screen` section and paste it at the end of the file.

6. In the new `Screen` section, edit the `Device`, `Identifier`, and `Monitor` lines as follows:

       Device "dummy"
       Identifier "Screen[D]"
       Monitor "MonitorD"

7. Edit the `ServerLayout` section to change the `Screen` line as follows:

       Screen "Screen[0]" 0 0

8. Insert the following line in the `ServerLayout` section:

       Screen "Screen[D]"
       RightOf "Screen[0]"

9. Save the `/etc/X11/XF86Config` file.

10. Restart the X Server.

11. Start the Screen Reader and Magnifier application.

12. Click on Startup Mode in the Gnopernicus menu window.

13. Select the Magnifier option in the Startup Mode dialog.

14. Click on Preferences in the Gnopernicus menu window.

15. Click on Magnifier to open the Magnifier Preferences dialog.

16. Click on the Add/Modify button to display the Zoomer Options dialog.

17. In the Display Screen section, type `:0.1` in the Source text box.

18. In the Zoomer Placement section, set the value of the Left spin box to `0`.

19. Click Apply.

    The Screen Reader and Magnifier user interface is no longer visible.

20. Log out of your session.

21. Log in to a new session.

22. Enter the following command to start Screen Reader and Magnifier in full-screen magnification mode:

    `gnopernicus -display :0.1`

23. When you log out of your session, select the Save current setup option.

## Enabling braille

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:

1. Log in as the `root` user.

2. Enter the following command:

   `chmod 777 /dev/ttyS0`

3. Enter the following command:

   `chmod 777 /dev/ttyS1`

## Configuring Alternative Pointer Devices

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 On-Screen Keyboard to use the second pointer device.

To configure an alternative pointer device, perform the following steps:

1. Before you connect the alternative pointer device to your system, enter the following command to list the existing devices:

   `ls -l /dev/usb/hid*`

2. Connect the alternative pointer device to your system.

3. Enter the following command again to list the new device:

   `ls -l /dev/usb/hid*`

4. Open the file `/etc/X11/XF86Config`.

5. Edit the `InputDevice` section where the `Driver` value is set to `mouse` as follows:

   - Change the `Option Device` line to the following:

         Option "Device" "/dev/input/mouse0"

   - Comment out the `Option Protocol` line as follows:

         #Option "Protocol" "explorerps/2"

   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.

6. Create a new `InputDevice` section as follows:

       Section "InputDevice"
       Driver "mouse"
       Identifier "Mouse[3]"
       Option "Device" "/dev/input/mouse1"
       Option "Name" "Autodetection"
       Option "Vendor" "Sysp"
       EndSection

   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.

7. Edit the `ServerLayout` section as follows:

   - Change the `InputDevice "Mouse[1]"` line to the following:

         InputDevice "Mouse[1]" "CorePointer"

   - Create a new `InputDevice` line as follows:

         InputDevice "Mouse[3]"

   - Remove any occurrences of the attributes `SendCore` or `AlwaysCore` from any of `InputDevice` lines.

   Ensure that only the device that you are using as the primary mouse device has the `"CorePointer"` attribute and ensure that the alternate input devices do not have the `SendCore` or `AlwaysCore` attributes.

8. Save the `/etc/X11/XF86Config` file.

9. Restart the X Server.

### Configuring the On-Screen Keyboard to Use an Alternative Pointer Device

To configure the On-Screen Keyboard application to use an alternative pointer device, perform the following steps:

1. Start the On-Screen Keyboard application.

2. Click on GOK in the GOK - main window.

3. Click on Preferences to open the Preferences dialog.

4. Click on the Actions tab.

5. In the Event Source options, select the Other input device option. On-Screen Reader displays the name of the input device that you configured in the text box next to the Other input device option.

6. Click OK to close the GOK Preferences dialog.