home *** CD-ROM | disk | FTP | other *** search
/ PC Welt 2006 November (DVD) / PCWELT_11_2006.ISO / casper / filesystem.squashfs / usr / share / gnome / help / gnome-access-guide / C / sysadmin.xml < prev    next >
Encoding:
Text File  |  2006-08-09  |  34.6 KB  |  973 lines
  1.  
  2. <appendix id="sysadmin-0">
  3. <title>System Administration</title>
  4. <para>This appendix
  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>
  8. <sect1 id="sysadmin-27">
  9. <title>Configuring the Desktop for Accessible Login</title>
  10. <indexterm>
  11. <primary>accessible login feature</primary>
  12. </indexterm>
  13. <para>The GNOME Desktop includes an Accessible
  14. Login feature. The Accessible Login feature enables users to: </para>
  15. <itemizedlist>
  16. <listitem>
  17. <para>Log in to the desktop even if the user cannot easily use the
  18. screen, mouse, or keyboard in the usual way.</para>
  19. </listitem>
  20. <listitem>
  21. <para>Launch assistive technologies at login time by associating
  22. a user action with an assistive technology application. The user can perform
  23. the user action from the standard keyboard, or from a keyboard, pointing device,
  24. or switch device that is attached to the USB or PS/2 mouse port. These user
  25. actions are called gestures.</para>
  26. </listitem>
  27. <listitem>
  28. <para>Change the visual appearance of the login dialog before the
  29. user logs in, for example, to use a high contrast theme for better visibility. </para>
  30. </listitem>
  31. </itemizedlist>
  32. <sect2 id="sysadmin-34">
  33. <title>To Enable Accessible Login</title>
  34. <indexterm>
  35. <primary>GDM</primary>
  36. </indexterm>
  37. <para>To enable the Accessible
  38. Login feature for the GNOME
  39. Desktop, you must configure the desktop to use the GNOME Display Manager
  40. (GDM) as the login manager. GDM is the default login manager on Linux systems
  41. but not on Solaris systems, therefore the instructions to enable Accessible
  42. Login differ depending on the platform you are using. </para>
  43. <sect3 id="sysadmin-38">
  44. <title>To Enable and Configure GDM on Solaris Systems</title>
  45. <para>To enable and configure GDM as the login manager on Solaris systems,
  46. perform the following steps:</para>
  47. <orderedlist>
  48. <listitem>
  49. <para>Log in as the <literal>root</literal> user.</para>
  50. </listitem>
  51. <listitem>
  52. <para>Open the file <filename>/etc/X11/gdm/gdm.conf</filename>.</para>
  53. </listitem>
  54. <listitem>
  55. <para>Search the file for the following line: </para>
  56. <para>
  57. <literal>#AddGtkModules=false</literal>
  58. </para>
  59. <para>and replace the line with the following:</para>
  60. <para>
  61. <literal>AddGtkModules=true</literal>
  62. </para>
  63. <para>This step enables the GtkModules.</para>
  64. </listitem>
  65. <listitem>
  66. <para>Search the file for the following line: </para>
  67. <para>
  68. <literal>#GtkModulesList=gail:atk-bridge:dwellmouselistener:keymouselistener</literal>
  69. </para>
  70. <para>and delete the <literal>#</literal> from the start of the line so that
  71. the line reads:</para>
  72. <para>
  73. <literal>GtkModulesList=gail:atk-bridge:dwellmouselistener:keymouselistener</literal>
  74. </para>
  75. <note>
  76. <para>The above lines must be displayed as single lines in the <filename>gdm.conf</filename> file without line breaks. The formatting of this guide
  77. may display the lines over two lines.</para>
  78. </note>
  79. <para>This step loads all of the GtkModules to enable assistive technologies
  80. such as <application>On-Screen Keyboard</application> and <application>Screen
  81. Reader and Magnifier</application>. You can edit the line above further to
  82. load only the GtkModules that you require to support the user base. For example: </para>
  83. <itemizedlist>
  84. <listitem>
  85. <para>If you need to use the <application>Screen Reader and Magnifier</application>, include <literal>gail</literal> and <literal>atk-bridge</literal>.</para>
  86. </listitem>
  87. <listitem>
  88. <para>If you need to use a pointing device without buttons or switches,
  89. include <literal>gail</literal>, <literal>atk-bridge</literal>, and<literal>dwellmouselistener</literal>. </para>
  90. </listitem>
  91. <listitem>
  92. <para>If you use pointing devices with switches, alternative physical
  93. keyboards, or switch and button devices, include <literal>keymouselistener</literal>.</para>
  94. </listitem>
  95. <listitem>
  96. <para><application>On-Screen Keyboard</application> can operate
  97. without <literal>gail</literal> and <literal>atk-bridge</literal> but with
  98. a reduced feature set. </para>
  99. </listitem>
  100. </itemizedlist>
  101. <para>For optimum accessibility, include <literal>gail</literal> and <literal>atk-bridge</literal>.</para>
  102. </listitem>
  103. <listitem>
  104. <para>Save the <filename>/etc/X11/gdm/gdm.conf</filename> file.</para>
  105. </listitem>
  106. <listitem>
  107. <para>Enter the following command to stop the <application>dtlogin</application> manager:</para>
  108. <para>
  109. <command>/usr/dt/bin/dtconfig -d</command>
  110. </para>
  111. </listitem>
  112. <listitem>
  113. <para>Enter the following commands to configure GDM as the login
  114. manager:</para>
  115. <para>
  116. <command>svccfg import /var/svc/manifest/application/gdm2-login.xml</command>
  117. </para>
  118. <para>
  119. <command>svcadm enable application/gdm2-login</command>
  120. </para>
  121. <note>
  122. <para>If you make any changes to the <filename>/etc/X11/gdm/gdm.conf</filename> file after you enable GDM, you can execute the following command
  123. to restart GDM and activate the changes:</para>
  124. <para>
  125. <command>gdm-restart</command>
  126. </para>
  127. </note>
  128. </listitem>
  129. <listitem>
  130. <para>Edit the file <filename>/etc/passwd</filename> to append the
  131. following to the end of the <literal>gdm</literal> line:</para>
  132. <para>
  133. <literal>:/etc/X11/gdm/home</literal>
  134. </para>
  135. </listitem>
  136. <listitem>
  137. <para>Create the <literal>/etc/X11/gdm/home</literal> directory
  138. and assign ownership of the directory to the <literal>gdm</literal> user.</para>
  139. </listitem>
  140. <listitem>
  141. <para>Restart your system.</para>
  142. </listitem>
  143. </orderedlist>
  144. </sect3>
  145. <sect3 id="sysadmin-39">
  146. <title>To Configure GDM on Linux Systems</title>
  147. <para>To configure GDM on Linux systems, perform the following steps:</para>
  148. <orderedlist>
  149. <listitem>
  150. <para>Log in as the <literal>root</literal> user.</para>
  151. </listitem>
  152. <listitem>
  153. <para>Open the file <filename>/etc/X11/gdm/gdm.conf</filename>.</para>
  154. </listitem>
  155. <listitem>
  156. <para>Search the file for the following line: </para>
  157. <para>
  158. <literal>#AddGtkModules=false</literal>
  159. </para>
  160. <para>and replace the line with the following:</para>
  161. <para>
  162. <literal>AddGtkModules=true</literal>
  163. </para>
  164. <para>This step enables the GtkModules.</para>
  165. </listitem>
  166. <listitem>
  167. <para>Search the file for the following line: </para>
  168. <para>
  169. <literal>#GtkModulesList=gail:atk-bridge:dwellmouselistener:keymouselistener</literal>
  170. </para>
  171. <para>and delete the <literal>#</literal> from the start of the line so that
  172. the line reads:</para>
  173. <para>
  174. <literal>GtkModulesList=gail:atk-bridge:dwellmouselistener:keymouselistener</literal>
  175. </para>
  176. <note>
  177. <para>The above lines must be displayed as single lines in the <filename>gdm.conf</filename> file without line breaks. The formatting of this guide
  178. may display the lines over two lines.</para>
  179. </note>
  180. <para>This step loads all of the GtkModules to enable assistive technologies
  181. such as <application>On-Screen Keyboard</application> and <application>Screen
  182. Reader and Magnifier</application>. You can edit the line above further to
  183. load only the GtkModules that you require to support the user base. For example: </para>
  184. <itemizedlist>
  185. <listitem>
  186. <para>If you need to use the <application>Screen Reader and Magnifier</application>, include <literal>gail</literal> and <literal>atk-bridge</literal>.</para>
  187. </listitem>
  188. <listitem>
  189. <para>If you need to use a pointing device without buttons or switches,
  190. include <literal>gail</literal>, <literal>atk-bridge</literal>, and <literal>dwellmouselistener</literal>. </para>
  191. </listitem>
  192. <listitem>
  193. <para>If you use pointing devices with switches, alternative physical
  194. keyboards, or switch and button devices, include <literal>keymouselistener</literal>.</para>
  195. </listitem>
  196. <listitem>
  197. <para><application>On-Screen Keyboard</application> can operate
  198. without <literal>gail</literal> and <literal>atk-bridge</literal> but with
  199. a reduced feature set. </para>
  200. </listitem>
  201. </itemizedlist>
  202. <para>For optimum accessibility, include <literal>gail</literal> and <literal>atk-bridge</literal>.</para>
  203. </listitem>
  204. <listitem>
  205. <para>Save the <filename>/etc/X11/gdm/gdm.conf</filename> file.</para>
  206. <note>
  207. <para>If you make any changes to the <filename>/etc/X11/gdm/gdm.conf</filename> file after you enable GDM, you can execute the following command
  208. to restart GDM and activate the changes:</para>
  209. <para>
  210. <command>gdm-restart</command>
  211. </para>
  212. </note>
  213. </listitem>
  214. <listitem>
  215. <para>Edit the file <filename>/etc/group</filename> and append the
  216. following to the <literal>audio</literal> line:</para>
  217. <para>
  218. <literal>,gdm</literal>
  219. </para>
  220. <para>This step ensures that speech works with GDM.</para>
  221. </listitem>
  222. <listitem>
  223. <para>Restart your system.</para>
  224. </listitem>
  225. </orderedlist>
  226. </sect3>
  227. </sect2>
  228. <sect2 id="sysadmin-29">
  229. <title>To Start Assistive Technologies at Login</title>
  230. <indexterm>
  231. <primary>gestures</primary>
  232. </indexterm>
  233. <para>If you load the <literal>keymouselistener</literal> and <literal>dwellmouselistener</literal> GtkModules
  234. in the GDM configuration file, you can assign user actions to launch specific
  235. assistive technologies at login time. These user actions are called gestures.
  236. The gesture associations are contained in the following GDM configuration
  237. files: </para>
  238. <itemizedlist>
  239. <listitem>
  240. <para>
  241. <filename>/etc/X11/gdm/modules/AccessKeyMouseEvents</filename>
  242. </para>
  243. </listitem>
  244. <listitem>
  245. <para>
  246. <filename>/etc/X11/gdm/modules/AccessDwellMouseEvents</filename>
  247. </para>
  248. </listitem>
  249. </itemizedlist>
  250. <note>
  251. <para>If you modify these files, you must restart your system before
  252. the changes take effect.</para>
  253. </note>
  254. <para>The following sections contain examples of the gestures that you can
  255. add to the GDM configuration files.</para>
  256. <note>
  257. <para>The gestures must be contained in a single line in the <filename>AccessKeyMouseEvents</filename> file without line breaks. The formatting of
  258. this guide might display the examples in the following sections over two lines. </para>
  259. </note>
  260. <sect3 id="sysadmin-30">
  261. <title>To Start Screen Reader Using a Keyboard Shortcut</title>
  262. <para>Edit the <filename>AccessKeyMouseEvents</filename> file to associate
  263. keyboard shortcuts with assistive technologies. For example, the following
  264. line enables you to press-and-hold <keycombo><keycap>Ctrl</keycap><keycap>S</keycap></keycombo>
  265. for one second to start <application>Screen Reader and Magnifier</application>
  266. in speech and Braille mode:</para>
  267. <para>
  268. <emphasis>Solaris:</emphasis>
  269. </para>
  270. <para>
  271. <literal><Control>s 1 1000 10000 /usr/sfw/bin/srcore --login --disable-magnifier
  272. --enable-speech --enable-braille</literal>
  273. </para>
  274. <para>
  275. <emphasis>Linux:</emphasis>
  276. </para>
  277. <para>
  278. <literal><Control>s 1 1000 10000 srcore --login --disable-magnifier
  279. --enable-speech --enable-braille</literal>
  280. </para>
  281. </sect3>
  282. <sect3 id="sysadmin-41">
  283. <title>To Start Magnifier Using a Keyboard Shortcut</title>
  284. <para>Edit the <filename>AccessKeyMouseEvents</filename> file to associate
  285. keyboard shortcuts with assistive technologies. For example, the following
  286. line enables you to press-and-hold <keycombo><keycap>Ctrl</keycap><keycap>M</keycap></keycombo>
  287. for one second to start <application>Screen Reader and Magnifier</application>
  288. in magnifier mode:</para>
  289. <para>
  290. <emphasis>Solaris:</emphasis>
  291. </para>
  292. <para>
  293. <literal><Control>m 1 1000 10000 /usr/sfw/bin/srcore --login --enable-magnifier
  294. --disable-speech</literal>
  295. </para>
  296. <para>
  297. <emphasis>Linux:</emphasis>
  298. </para>
  299. <para>
  300. <literal><Control>m 1 1000 10000 srcore --login --enable-magnifier
  301. --disable-speech</literal>
  302. </para>
  303. </sect3>
  304. <sect3 id="sysadmin-31">
  305. <title>To Start On-Screen Keyboard Using a Switch or Button Gesture</title>
  306. <para>Edit the <filename>AccessKeyMouseEvents</filename> file to associate
  307. switch, key, or button gestures with assistive technologies. Since the primary
  308. input device for many <application>On-Screen Keyboard</application> users
  309. is a switch or button, this is a good way to enable users to start <application>On-Screen Keyboard</application> at login time. </para>
  310. <para>If there is a tendency for a user to start an application unintentionally,
  311. you can associate the gestures with multiple switch presses or minimum durations.
  312. For example, the following line starts <application>On-Screen Keyboard</application>
  313. in inverse scanning mode when the user presses the switch that is defined
  314. as Switch 2 three times within two seconds, for a minimum of 100 milliseconds
  315. for each press:</para>
  316. <para>
  317. <emphasis>Solaris:</emphasis>
  318. </para>
  319. <para>
  320. <literal><Switch2>3 100 2000 /usr/sfw/bin/gok --login --accessmethod=inversescanning
  321. --scan-action=switch1 --select-action=switch2</literal>
  322. </para>
  323. <para>
  324. <emphasis>Linux:</emphasis>
  325. </para>
  326. <para>
  327. <literal><Switch2>3 100 2000 gok --login --accessmethod=inversescanning
  328. --scan-action=switch1 --select-action=switch2</literal>
  329. </para>
  330. <para>Users who use single switches may prefer to start <application>On-Screen
  331. Keyboard</application> in automatic scanning mode. The following line starts <application>On-Screen Keyboard</application> in automatic scanning mode when the user
  332. presses the switch on an alternative access device for more than four seconds:</para>
  333. <para>
  334. <emphasis>Solaris:</emphasis>
  335. </para>
  336. <para>
  337. <literal><Switch>1 4000 5000 /usr/sfw/bin/gok --login --accessmethod=automaticscanning
  338. --scan-action=switch1 --select-action=switch1</literal>
  339. </para>
  340. <para>
  341. <emphasis>Linux:</emphasis>
  342. </para>
  343. <para>
  344. <literal><Switch>1 4000 5000 gok --login --accessmethod=automaticscanning
  345. --scan-action=switch1 --select-action=switch1</literal>
  346. </para>
  347. <para>For information about the <application>On-Screen Keyboard</application>
  348. operating modes, see the online Help for <application>On-Screen Keyboard</application>.</para>
  349. </sect3>
  350. <sect3 id="sysadmin-32">
  351. <title>To Start On-Screen Keyboard Using a Motion-only Gesture</title>
  352. <para>You can define gestures that involve only the motion of a pointing device
  353. such as a mouse, or an alternative pointing device, such as a head pointer
  354. or trackball. The syntax of the gesture does not change depending on whether
  355. you are using a mouse or an alternative pointing device. Edit the <filename>AccessKeyMouseEvents</filename> file to associate motion gestures with assistive
  356. technologies.</para>
  357. <para>If the <literal>dwellmouselistener</literal> GtkModule is loaded, alternative
  358. pointing devices are temporarily latched to the core pointer. This means that
  359. if the user moves the alternative pointing device, the onscreen pointer moves.</para>
  360. <para>For example, the following line starts <application>On-Screen Keyboard</application> in dwell mode when the user moves the onscreen pointer from
  361. inside the login dialog through the top edge, back into the dialog through
  362. the top edge, out of the dialog through the left edge, back into the dialog
  363. through the left edge, and similarly through the bottom and right edges of
  364. the dialog in a cross pattern:</para>
  365. <para>
  366. <emphasis>Solaris:</emphasis>
  367. </para>
  368. <para>
  369. <literal>TTLLBBRR O 10000 /usr/sfw/bin/gok --login --access-method=dwellselection
  370. --input-device=MOUSE[3]</literal>
  371. </para>
  372. <para>
  373. <emphasis>Linux:</emphasis>
  374. </para>
  375. <para>
  376. <literal>TTLLBBRR O 10000 gok --login --access-method=dwellselection
  377. --input-device=MOUSE[3]</literal>
  378. </para>
  379. <para>Note that the <literal>--input-device</literal> parameter specified
  380. in the gesture must match the name of the extended user input device, such
  381. as a head pointer or trackball, as specified in <filename>/etc/X11/XF86Config</filename>.</para>
  382. </sect3>
  383. </sect2>
  384. <sect2 id="sysadmin-33">
  385. <title>Additional Requirements for Accessible Login</title>
  386. <para>To enable the Accessible Login feature to use alternative pointing devices
  387. and switch devices such as sip-and-puff switches, wheelchair-mounted switches,
  388. or trackballs, you might need to modify your X server system configuration
  389. to recognize these devices. You can use most devices that emulate mouse buttons
  390. with the Accessible Login feature and <application>On-Screen Keyboard</application>,
  391. including USB single switches and mouse-like pointing devices.</para>
  392. <note>
  393. <para>You should not configure an alternative input device to control
  394. the primary onscreen pointer. This might result in undesirable behavior or
  395. cause situations from which the user of the alternate input device cannot
  396. recover without using the primary keyboard or mouse. To prevent this problem,
  397. please remove any occurrences of the attributes <literal>SendCore</literal>
  398. or <literal>AlwaysCore</literal> from any of <literal>InputDevice</literal>
  399. lines in the X Server configuration file.</para>
  400. </note>
  401. </sect2>
  402. </sect1>
  403. <sect1 id="sysadmin-7">
  404. <title>Configuring the Java Environment for Accessibility on Solaris Systems</title>
  405. <indexterm>
  406. <primary>Java environment, configuring</primary>
  407. </indexterm>
  408. <para>To configure the Java environment on Solaris systems for accessibility, perform
  409. the following steps:</para>
  410. <orderedlist>
  411. <listitem>
  412. <para>Log in as the <literal>root</literal> user to the base directory
  413. of the Java SDK installation. </para>
  414. </listitem>
  415. <listitem>
  416. <para>Enter the following command:</para>
  417. <para>
  418. <command>cd jre/lib</command>
  419. </para>
  420. </listitem>
  421. <listitem>
  422. <para>Enter the following command:</para>
  423. <para>
  424. <command>ln -s /usr/share/jar/accessibility.properties</command>
  425. </para>
  426. </listitem>
  427. <listitem>
  428. <para>Enter the following command:</para>
  429. <para>
  430. <command>cd ext</command>
  431. </para>
  432. </listitem>
  433. <listitem>
  434. <para>Enter the following command: </para>
  435. <para>
  436. <command>ln -s /usr/share/jar/gnome-java-bridge.jar</command>
  437. </para>
  438. </listitem>
  439. </orderedlist>
  440. </sect1>
  441. <sect1 id="sysadmin-55">
  442. <title>Enabling XKB on Solaris Systems</title>
  443. <indexterm>
  444. <primary>XKB</primary>
  445. </indexterm>
  446. <para>If you are using the desktop
  447. for the Solaris operating system on a SPARC platform, you must enable XKB
  448. on your system before you can use the <application>AccessX</application> preference
  449. tool, <application>Screen Reader and Magnifier</application>, or <application>On-Screen Keyboard</application>. </para>
  450. <note>
  451. <para>XKB is not currently supported on Sun Ray systems.</para>
  452. </note>
  453. <para>To enable XKB on a non-Sun Ray Solaris system, perform the following
  454. steps:</para>
  455. <orderedlist>
  456. <listitem>
  457. <para>Log in as the <literal>root</literal> user.</para>
  458. </listitem>
  459. <listitem>
  460. <para>Check if the path and file <filename>/etc/dt/config/Xservers</filename> exists on your system.</para>
  461. </listitem>
  462. <listitem>
  463. <para>If the <filename>/etc/dt/config</filename> directory does
  464. not exist, enter the following command:</para>
  465. <screen>
  466. <command>mkdir -p /etc/dt/config</command>
  467. </screen>
  468. </listitem>
  469. <listitem>
  470. <para>If the <filename>Xservers</filename> file is not present,
  471. enter the following command:</para>
  472. <screen>
  473. <command>cp /usr/dt/config/Xservers /etc/dt/config/Xservers</command>
  474. </screen>
  475. </listitem>
  476. <listitem>
  477. <para>Open the <filename>Xservers</filename> file in a text editor
  478. and scroll to the end of the file. </para>
  479. </listitem>
  480. <listitem>
  481. <para>Append the following to the command line at the end of the
  482. file:</para>
  483. <screen>
  484. <userinput>+kb</userinput>
  485. </screen>
  486. </listitem>
  487. <listitem>
  488. <para>Save and close the <filename>Xservers</filename> file.</para>
  489. </listitem>
  490. <listitem>
  491. <para>Enter the following command at a command line:</para>
  492. <screen>
  493. <command>pkill -HUP dtlogin</command>
  494. </screen>
  495. </listitem>
  496. <listitem>
  497. <para>Open the <filename>/etc/X11/gdm/gdm.conf</filename> file in
  498. a text editor.</para>
  499. </listitem>
  500. <listitem>
  501. <para>Scroll towards the end of the file until you see the line <literal>[server - standard]</literal>.</para>
  502. </listitem>
  503. <listitem>
  504. <para>Edit the <literal>command</literal> line in this section to
  505. append the following to the end of the line:</para>
  506. <para>
  507. <command>+accessx +kb</command>
  508. </para>
  509. </listitem>
  510. <listitem>
  511. <para>Save and close the <filename>gdm.conf</filename> file.</para>
  512. </listitem>
  513. <listitem>
  514. <para>Log out of your session and log in again.</para>
  515. </listitem>
  516. <listitem>
  517. <para>To verify if XKB is running, execute the following command: </para>
  518. <para>
  519. <command>xdpyinfo</command>
  520. </para>
  521. <para>then search for XKEYBOARD in the extensions list.</para>
  522. </listitem>
  523. </orderedlist>
  524. </sect1>
  525. <sect1 id="sysadmin-6">
  526. <title>Enabling Full Screen Magnification</title>
  527. <indexterm>
  528. <primary>Screen Reader and Magnifier</primary>
  529. <secondary>enabling
  530. full screen magnification</secondary>
  531. </indexterm>
  532. <para>The following sections
  533. describe the methods to enable full screen magnification.</para>
  534. <sect2 id="sysadmin-48">
  535. <title>To Enable Full Screen Magnification Using Two Video Cards</title>
  536. <para>To enable full screen magnification in <application>Screen Reader and
  537. Magnifier</application> using two physical video cards, perform the following
  538. steps:</para>
  539. <orderedlist>
  540. <listitem>
  541. <para>Configure two video cards as :0.0 and :0.1.</para>
  542. <note>
  543. <para>It is not essential that both video cards have the same resolution
  544. and bit depth. However, if the resolutions and bit depths of both cards differ
  545. greatly, the apparent magnification factor may differ slightly from the nominal
  546. magnification factor.</para>
  547. </note>
  548. </listitem>
  549. <listitem>
  550. <para>Choose <menuchoice><guimenu>Applications</guimenu><guisubmenu>Accessibility</guisubmenu><guimenuitem>Screen Reader and Magnifier</guimenuitem></menuchoice>.</para>
  551. </listitem>
  552. <listitem>
  553. <para>Click on <guilabel>Preferences</guilabel> in the <guilabel>Gnopernicus</guilabel> menu window.</para>
  554. </listitem>
  555. <listitem>
  556. <para>Click on <guilabel>Magnifier</guilabel> to open the <guilabel>Magnifier Preferences</guilabel> dialog.</para>
  557. </listitem>
  558. <listitem>
  559. <para>Click on the <guibutton>Add/Modify</guibutton> button to display
  560. the <guilabel>Zoomer Options</guilabel> dialog.</para>
  561. </listitem>
  562. <listitem>
  563. <para>In the <guilabel>Display Screen</guilabel> section, type <userinput>:0.0</userinput> in the <guilabel>Source</guilabel> text box. </para>
  564. </listitem>
  565. <listitem>
  566. <para>In the <guilabel>Display Screen</guilabel> section, type <userinput>:0.1</userinput> in the <guilabel>Target</guilabel> text box. </para>
  567. </listitem>
  568. <listitem>
  569. <para>Set the Zoomer Placement values to be <literal>[0,0,1023,767]</literal>.</para>
  570. <note>
  571. <para>These instructions assume a video resolution of 1024x768. </para>
  572. </note>
  573. </listitem>
  574. <listitem>
  575. <para>Click <guibutton>Apply</guibutton> and <guibutton>Close</guibutton>
  576. to close the <guilabel>Zoomer Options</guilabel> dialog. </para>
  577. <para>The magnified view is displayed on the second display 0.1.</para>
  578. </listitem>
  579. </orderedlist>
  580. </sect2>
  581. <sect2 id="sysadmin-49">
  582. <title>To Enable Full Screen Magnification Using One Video Card on Linux Systems</title>
  583. <para>To enable full screen magnification on Linux systems using one physical
  584. video card and one virtual video card, perform the following steps:</para>
  585. <orderedlist>
  586. <listitem>
  587. <para>Open the file <filename>/etc/X11/XF86Config</filename>.</para>
  588. </listitem>
  589. <listitem>
  590. <para>Create a new section at the end of the file as follows:</para>
  591. <literallayout>Section "Device"
  592. Boardname "dummy"
  593. Driver "dummy"
  594. Identifier "dummy"
  595. VendorName "dummy"
  596. EndSection </literallayout>
  597. </listitem>
  598. <listitem>
  599. <para>Copy the <literal>Monitor</literal> section and paste it at
  600. the end of the file.</para>
  601. </listitem>
  602. <listitem>
  603. <para>In the new <literal>Monitor</literal> section, edit the <literal>Identifier</literal> line as follows:</para>
  604. <para>
  605. <literallayout>Identifier "MonitorD"</literallayout>
  606. </para>
  607. </listitem>
  608. <listitem>
  609. <para>Copy the <literal>Screen</literal> section and paste it at
  610. the end of the file.</para>
  611. </listitem>
  612. <listitem>
  613. <para>In the new <literal>Screen</literal> section, edit the <literal>Device</literal>, <literal>Identifier</literal>, and <literal>Monitor</literal>
  614. lines as follows:</para>
  615. <para>
  616. <literallayout>Device "dummy"
  617. Identifier "ScreenD"
  618. Monitor "MonitorD"</literallayout>
  619. </para>
  620. </listitem>
  621. <listitem>
  622. <para>Edit the <literal>ServerLayout</literal> section to change
  623. the <literal>Screen</literal> line as follows:</para>
  624. <para>
  625. <literallayout>Screen "Screen[0]" 0 0</literallayout>
  626. </para>
  627. </listitem>
  628. <listitem>
  629. <para>Insert the following line in the <literal>ServerLayout</literal>
  630. section:</para>
  631. <para>
  632. <literallayout>Screen "Screen[D]" RightOf "Screen[0]"</literallayout>
  633. </para>
  634. </listitem>
  635. <listitem>
  636. <para>Save the <filename>/etc/X11/XF86Config</filename> file.</para>
  637. </listitem>
  638. <listitem>
  639. <para>Restart the X Server.</para>
  640. </listitem>
  641. <listitem>
  642. <para>Start the <application>Screen Reader and Magnifier</application>
  643. application.</para>
  644. </listitem>
  645. <listitem>
  646. <para>Click on <guilabel>Startup Mode</guilabel> in the <guilabel>Gnopernicus</guilabel> menu window.</para>
  647. </listitem>
  648. <listitem>
  649. <para>Select the <guilabel>Magnifier</guilabel> option in the <guilabel>Startup Mode</guilabel> dialog.</para>
  650. </listitem>
  651. <listitem>
  652. <para>Click on <guilabel>Preferences</guilabel> in the <guilabel>Gnopernicus</guilabel> menu window.</para>
  653. </listitem>
  654. <listitem>
  655. <para>Click on <guilabel>Magnifier</guilabel> to open the <guilabel>Magnifier Preferences</guilabel> dialog.</para>
  656. </listitem>
  657. <listitem>
  658. <para>Click on the <guibutton>Add/Modify</guibutton> button to display
  659. the <guilabel>Zoomer Options</guilabel> dialog.</para>
  660. </listitem>
  661. <listitem>
  662. <para>In the <guilabel>Display Screen</guilabel> section, type <userinput>:0.1</userinput> in the <guilabel>Source</guilabel> text box. </para>
  663. </listitem>
  664. <listitem>
  665. <para>In the <guilabel>Zoomer Placement</guilabel> section, set
  666. the value of the <guilabel>Left</guilabel> spin box to <userinput>0</userinput>.</para>
  667. </listitem>
  668. <listitem>
  669. <para>Click <guibutton>Apply</guibutton>.</para>
  670. <para>The <application>Screen Reader and Magnifier</application> user interface
  671. is no longer visible.</para>
  672. </listitem>
  673. <listitem>
  674. <para>Log out of your session.</para>
  675. </listitem>
  676. <listitem>
  677. <para>Log in to a new session.</para>
  678. </listitem>
  679. <listitem>
  680. <para>Enter the following command to start <application>Screen Reader
  681. and Magnifier</application> in full screen magnification mode:</para>
  682. <para>
  683. <command>gnopernicus -display :0.1</command>
  684. </para>
  685. </listitem>
  686. <listitem>
  687. <para>When you log out of your session, select the <guilabel>Save
  688. current setup</guilabel> option. </para>
  689. </listitem>
  690. </orderedlist>
  691. </sect2>
  692. </sect1>
  693. <sect1 id="sysadmin-52">
  694. <title>Enabling Braille</title>
  695. <indexterm>
  696. <primary>Braille, enabling</primary>
  697. </indexterm>
  698. <para>To enable
  699. your system to support Braille output, you must configure the access rights
  700. to the serial port to which the Braille device is connected. The following
  701. sections describe the steps that you need to perform depending on your operating
  702. system.</para>
  703. <sect2 id="sysadmin-53">
  704. <title>To Enable Braille on Solaris Systems</title>
  705. <para>To configure the serial port to which the Braille device is connected
  706. on Solaris systems, perform the following steps:</para>
  707. <orderedlist>
  708. <listitem>
  709. <para>Log in as the <literal>root</literal> user.</para>
  710. </listitem>
  711. <listitem>
  712. <para>Enter the following command:</para>
  713. <para>
  714. <command>chmod 777 /dev/cua/a</command>
  715. </para>
  716. </listitem>
  717. <listitem>
  718. <para>Enter the following command:</para>
  719. <para>
  720. <command>chmod 777 /dev/cua/b</command>
  721. </para>
  722. </listitem>
  723. <listitem>
  724. <para>Change the permissions to <literal>777</literal> on the devices
  725. to which the symbolic links <literal>/dev/cua/a</literal> and <literal>/dev/cua/b</literal> point. </para>
  726. </listitem>
  727. </orderedlist>
  728. <note>
  729. <para>If your system uses <command>/dev/cua/a</command> for system log
  730. messages, Braille will not work on that serial port. Use <command>/dev/cua/b</command> instead.</para>
  731. </note>
  732. </sect2>
  733. <sect2 id="sysadmin-54">
  734. <title>To Enable Braille on Linux Systems</title>
  735. <para>To configure the serial port to which the Braille device is connected
  736. on Linux systems, perform the following steps:</para>
  737. <orderedlist>
  738. <listitem>
  739. <para>Log in as the <literal>root</literal> user.</para>
  740. </listitem>
  741. <listitem>
  742. <para>Enter the following command:</para>
  743. <para>
  744. <command>chmod 777 /dev/ttyS0</command>
  745. </para>
  746. </listitem>
  747. <listitem>
  748. <para>Enter the following command:</para>
  749. <para>
  750. <command>chmod 777 /dev/ttyS1</command>
  751. </para>
  752. </listitem>
  753. </orderedlist>
  754. </sect2>
  755. </sect1>
  756. <sect1 id="sysadmin-37">
  757. <title>Configuring Alternative Pointer Devices</title>
  758. <para>The following sections describe how to configure your system to use
  759. a standard physical mouse and another pointer device such as a single switch
  760. device or head tracker device, and how to configure <application>On-Screen
  761. Keyboard</application> to use the second pointer device.</para>
  762. <sect2 id="sysadmin-45">
  763. <title>To Configure Alternative Pointer Devices on Solaris Systems</title>
  764. <indexterm>
  765. <primary>configuring two pointer devices</primary>
  766. <secondary>on
  767. Solaris systems</secondary>
  768. </indexterm>
  769. <para>To configure an alternative pointer
  770. device on a Solaris system, perform the following steps:</para>
  771. <note>
  772. <para>This procedure does not work on all Solaris platforms.</para>
  773. </note>
  774. <orderedlist>
  775. <listitem>
  776. <para>Before you connect the alternative pointer device to your
  777. system, enter the following command to list the existing devices:</para>
  778. <para>
  779. <command>ls -l /dev/usb/hid*</command>
  780. </para>
  781. </listitem>
  782. <listitem>
  783. <para>Connect the alternative pointer device to your system.</para>
  784. </listitem>
  785. <listitem>
  786. <para>Enter the following command again to list the new device:</para>
  787. <para>
  788. <command>ls -l /dev/usb/hid*</command>
  789. </para>
  790. </listitem>
  791. <listitem>
  792. <para>Open the file <filename>/usr/openwin/server/etc/OWconfig</filename>.</para>
  793. </listitem>
  794. <listitem>
  795. <para>Add the following lines to the <filename>OWconfig</filename>
  796. file:</para>
  797. <para>
  798. <literallayout># Sun Mouse module
  799. class="XINPUT" name="IMOUSE2"
  800. dev="/dev/usb/hid2" strmod="usbms"
  801. ddxHandler="ddxSUNWmouse.so.1"
  802. ddxInitFunc="ddxSUNWmouseProc";</literallayout>
  803. </para>
  804. <para>where:</para>
  805. <itemizedlist>
  806. <listitem>
  807. <para>the <literal>name</literal> option starts with the string <literal>IMOUSE</literal> but is extended to form a unique string, such as <literal>IMOUSE2</literal> or <literal>IMOUSE3</literal>, depending on the number of
  808. existing devices.</para>
  809. </listitem>
  810. <listitem>
  811. <para>the <literal>dev</literal> option specifies the device name
  812. that you identified in Step 3.</para>
  813. </listitem>
  814. </itemizedlist>
  815. </listitem>
  816. <listitem>
  817. <para>Remove the following lines from the <filename>OWconfig</filename>
  818. file:</para>
  819. <para>
  820. <literallayout># Null Mouse module
  821. class="XINPUT" name="NMOUSE"
  822. ddxHandler="ddxSUNWmouse.so.1"
  823. ddxInitFunc="ddxnullmouseProc";</literallayout>
  824. </para>
  825. </listitem>
  826. <listitem>
  827. <para>Save the <filename>/usr/openwin/server/etc/OWconfig</filename>
  828. file.</para>
  829. </listitem>
  830. <listitem>
  831. <para>Restart the X Server. </para>
  832. </listitem>
  833. </orderedlist>
  834. </sect2>
  835. <sect2 id="sysadmin-46">
  836. <title>To Configure Alternative Pointer Devices on Linux Systems</title>
  837. <indexterm>
  838. <primary>configuring two pointer devices</primary>
  839. <secondary>on
  840. Linux systems</secondary>
  841. </indexterm>
  842. <para>To configure an alternative pointer
  843. device on a Linux system, perform the following steps:</para>
  844. <orderedlist>
  845. <listitem>
  846. <para>Before you connect the alternative pointer device to your
  847. system, enter the following command to list the existing devices:</para>
  848. <para>
  849. <command>ls -l /dev/usb/hid*</command>
  850. </para>
  851. </listitem>
  852. <listitem>
  853. <para>Connect the alternative pointer device to your system.</para>
  854. </listitem>
  855. <listitem>
  856. <para>Enter the following command again to list the new device:</para>
  857. <para>
  858. <command>ls -l /dev/usb/hid*</command>
  859. </para>
  860. </listitem>
  861. <listitem>
  862. <para>Open the file <filename>/etc/X11/XF86Config</filename>.</para>
  863. </listitem>
  864. <listitem>
  865. <para>Edit the <literal>InputDevice</literal> section where the <literal>Driver</literal> value is set to <literal>mouse</literal> as follows:</para>
  866. <itemizedlist>
  867. <listitem>
  868. <para>Change the <literal>Option Device</literal> line to the following:</para>
  869. <para>
  870. <literallayout>Option "Device" "/dev/input/mouse0"</literallayout>
  871. </para>
  872. </listitem>
  873. <listitem>
  874. <para>Comment out the <literal>Option Protocol</literal> line as
  875. follows:</para>
  876. <para>
  877. <literallayout>#Option "Protocol" "explorerps/2"</literallayout>
  878. </para>
  879. </listitem>
  880. </itemizedlist>
  881. <note>
  882. <para>If you are not using USB connections for your primary mouse device
  883. and other pointer device, you do not need to carry out this step.</para>
  884. </note>
  885. </listitem>
  886. <listitem>
  887. <para>Create a new <literal>InputDevice</literal> section as follows:</para>
  888. <para>
  889. <literallayout>Section "InputDevice"
  890. Driver "mouse"
  891. Identifier "Mouse[3]"
  892. Option "Device" "/dev/input/mouse1"
  893. Option "Name" "Autodetection"
  894. Option "Vendor" "Sysp"
  895. EndSection</literallayout>
  896. </para>
  897. <note>
  898. <para>If you are not using USB connections for your primary mouse device
  899. and other pointer device, you do not need to carry out this step.</para>
  900. </note>
  901. </listitem>
  902. <listitem>
  903. <para>Edit the <literal>ServerLayout</literal> section as follows:</para>
  904. <itemizedlist>
  905. <listitem>
  906. <para>Change the <literal>InputDevice "Mouse[1]"</literal> line
  907. to the following:</para>
  908. <para>
  909. <literallayout>InputDevice "Mouse[1]" "CorePointer"</literallayout>
  910. </para>
  911. </listitem>
  912. <listitem>
  913. <para>Create a new <literal>InputDevice</literal> line as follows:</para>
  914. <para>
  915. <literallayout>InputDevice "Mouse[3]"
  916. </literallayout>
  917. </para>
  918. </listitem>
  919. <listitem>
  920. <para>Remove any occurrences of the attributes <literal>SendCore</literal> or <literal>AlwaysCore</literal> from any of <literal>InputDevice</literal> lines.</para>
  921. </listitem>
  922. </itemizedlist>
  923. <note>
  924. <para>Ensure that only the device that you are using as the primary
  925. mouse device has the <literal>"CorePointer"</literal> attribute and ensure
  926. that the alternate input devices do not have the <literal>SendCore</literal>
  927. or <literal>AlwaysCore</literal> attributes.</para>
  928. </note>
  929. </listitem>
  930. <listitem>
  931. <para>Save the <filename>/etc/X11/XF86Config</filename> file.</para>
  932. </listitem>
  933. <listitem>
  934. <para>Restart the X Server.</para>
  935. </listitem>
  936. </orderedlist>
  937. </sect2>
  938. <sect2 id="sysadmin-47">
  939. <title>To Configure On-Screen Keyboard to Use an Alternative Pointer Device</title>
  940. <indexterm>
  941. <primary>On-Screen Keyboard</primary>
  942. <secondary>configuring for
  943. two pointer devices</secondary>
  944. </indexterm>
  945. <para>To configure the <application>On-Screen Keyboard</application> application to use an alternative pointer
  946. device, perform the following steps.</para>
  947. <orderedlist>
  948. <listitem>
  949. <para>Start the <application>On-Screen Keyboard</application> application.</para>
  950. </listitem>
  951. <listitem>
  952. <para>Click on <guilabel>GOK</guilabel> in the <guilabel>GOK - main</guilabel> window.</para>
  953. </listitem>
  954. <listitem>
  955. <para>Click on <guilabel>Preferences</guilabel> to open the <guilabel>Preferences</guilabel> dialog.</para>
  956. </listitem>
  957. <listitem>
  958. <para>Click on the <guilabel>Actions</guilabel> tab.</para>
  959. </listitem>
  960. <listitem>
  961. <para>In the <guilabel>Event Source</guilabel> options, select the <guilabel>Other input device</guilabel> option. <application>On-Screen Reader</application>
  962. displays the name of the input device that you configured in the text box
  963. next to the <guilabel>Other input device</guilabel> option.</para>
  964. </listitem>
  965. <listitem>
  966. <para>Click <guibutton>OK</guibutton> to close the <guilabel>GOK
  967. Preferences</guilabel> dialog.</para>
  968. </listitem>
  969. </orderedlist>
  970. </sect2>
  971. </sect1>
  972. </appendix>
  973.