Java Desktop System Release 3 Accessibility Guide

A.1.1 To Enable Accessible Login

To enable the Accessible Login feature for the Java Desktop System, you must configure the desktop to use the GNOME Display Manager (GDM) as the login manager. GDM is the default login manager on Linux systems but not on Solaris systems, therefore the instructions to enable Accessible Login differ depending on the platform you are using.

A.1.1.1 To Enable and Configure GDM on Solaris Systems

To enable and configure GDM as the login manager on Solaris systems, perform the following steps:

  1. Log in as the root user.

  2. Open the file /etc/X11/gdm/gdm.conf.

  3. Search the file for the following line:

    #Greeter=/usr/bin/gdmgreeter

    and replace the line with the following line:

    Greeter=/usr/bin/gdmlogin

    This step enables a standard login greeting rather than a graphical login greeting.

  4. Search the file for the following line:

    #AddGtkModules=false

    and replace the line with the following:

    AddGtkModules=true

    This step enables the GtkModules.

  5. Search the file for the following line:

    #GtkModulesList=gail:atk-bridge:dwellmouselistener:keymouselistener

    and delete the # from the start of the line so that the line reads:

    GtkModulesList=gail:atk-bridge:dwellmouselistener:keymouselistener


    Note –

    The above lines must be displayed as single lines in the gdm.conf file without line breaks. The formatting of this guide may display the lines over two lines.


    This step loads all of the GtkModules to enable assistive technologies such as On-Screen Keyboard and Screen Reader and Magnifier. You can edit the line above further to load only the GtkModules that you require to support the user base. For example:

    • If you need to use the Screen Reader and Magnifier, include gail and atk-bridge.

    • If you need to use a pointing device without buttons or switches, include gail, atk-bridge, anddwellmouselistener.

    • If you use pointing devices with switches, alternative physical keyboards, or switch and button devices, include keymouselistener.

    • On-Screen Keyboard can operate without gail and atk-bridge but with a reduced feature set.

    For optimum accessibility, include gail and atk-bridge.

  6. Save the /etc/X11/gdm/gdm.conf file.

  7. Enter the following command to stop the dtlogin manager:

    /usr/dt/bin/dtconfig -d

  8. Enter the following commands to configure GDM as the login manager:

    svccfg import /var/svc/manifest/application/gdm2-login.xml

    svcadm enable application/gdm2-login


    Note –

    If you make any changes to the /etc/X11/gdm/gdm.conf file after you enable GDM, you can execute the following command to restart GDM and activate the changes:

    gdm-restart


  9. Edit the file /etc/passwd to append the following to the end of the gdm line:

    :/etc/X11/gdm/home

  10. Create the /etc/X11/gdm/home directory and assign ownership of the directory to the gdm user.

  11. Restart your system.

A.1.1.2 To Configure GDM on Linux Systems

To configure GDM on Linux systems, perform the following steps:

  1. Log in as the root user.

  2. Open the file /etc/X11/gdm/gdm.conf.

  3. Search the file for the following line:

    #AddGtkModules=false

    and replace the line with the following:

    AddGtkModules=true

    This step enables the GtkModules.

  4. Search the file for the following line:

    #GtkModulesList=gail:atk-bridge:dwellmouselistener:keymouselistener

    and delete the # from the start of the line so that the line reads:

    GtkModulesList=gail:atk-bridge:dwellmouselistener:keymouselistener


    Note –

    The above lines must be displayed as single lines in the gdm.conf file without line breaks. The formatting of this guide may display the lines over two lines.


    This step loads all of the GtkModules to enable assistive technologies such as On-Screen Keyboard and Screen Reader and Magnifier. You can edit the line above further to load only the GtkModules that you require to support the user base. For example:

    • If you need to use the Screen Reader and Magnifier, include gail and atk-bridge.

    • If you need to use a pointing device without buttons or switches, include gail, atk-bridge, and dwellmouselistener.

    • If you use pointing devices with switches, alternative physical keyboards, or switch and button devices, include keymouselistener.

    • On-Screen Keyboard can operate without gail and atk-bridge but with a reduced feature set.

    For optimum accessibility, include gail and atk-bridge.

  5. Save the /etc/X11/gdm/gdm.conf file.


    Note –

    If you make any changes to the /etc/X11/gdm/gdm.conf file after you enable GDM, you can execute the following command to restart GDM and activate the changes:

    gdm-restart


  6. Edit the file /etc/group and append the following to the audio line:

    ,gdm

    This step ensures that speech works with GDM.

  7. Restart your system.