f125a8b892
This change addresses a long-standing issue in rST documentation imported from XML.
That import process added backslash escapes in front of various characters. The three
most common being '(', ')', and '_'.
These instances are removed.
Signed-off-by: Ron Stone <ronald.stone@windriver.com>
Change-Id: Id43a9337ffcd505ccbdf072d7b29afdb5d2c997e
67 lines
1.7 KiB
ReStructuredText
67 lines
1.7 KiB
ReStructuredText
|
|
.. rws1552674043508
|
|
.. _console-keyboard-mapping:
|
|
|
|
========================
|
|
Console Keyboard Mapping
|
|
========================
|
|
|
|
You can change the keyboard layout settings used on the text console for
|
|
a |prod| node.
|
|
|
|
You can log in to the console using the US keyboard layout and then change
|
|
the keyboard settings, if required. Use the following |CLI| commands to change
|
|
the keyboard layout settings on your keyboard:
|
|
|
|
.. note::
|
|
When you log in to |prod| for the first time using the default US keyboard
|
|
layout, you are prompted to provide a new password. The new password you
|
|
enter may get mapped differently than you expect, since you are not using a
|
|
US keyboard. You should use as simple a password as possible in order to
|
|
avoid any unexpected key mappings. Then, after you have successfully logged
|
|
in to |prod| and updated your keyboard layout, you should update your
|
|
sysadmin password (':command:`passwd sysadmin`') to a more secure
|
|
password.
|
|
|
|
To display the current console keyboard settings that are configured for the
|
|
virtual console:
|
|
|
|
.. code-block:: none
|
|
|
|
$ localectl status
|
|
|
|
For example,
|
|
|
|
.. code-block:: none
|
|
|
|
System Locale:LANG=en_US.UTF-8
|
|
VC Keymap:us
|
|
X11 Layout:n/a
|
|
|
|
To check if a keyboard layout can be configured on your system, for example:
|
|
|
|
.. code-block:: none
|
|
|
|
$ localectl list-keymaps|fgrep 106
|
|
jp 106
|
|
|
|
To set the console keyboard layout, use the following syntax:
|
|
|
|
.. code-block:: none
|
|
|
|
$ sudo localectl set-keymap <mapping-name>
|
|
|
|
For example, to use jp106:
|
|
|
|
.. code-block:: none
|
|
|
|
$ sudo localectl set-keycap jp106
|
|
|
|
.. code-block:: none
|
|
|
|
$ localectl status
|
|
System Locale:LANG=en_US.UTF-8
|
|
VC Keymap:jp106
|
|
X11 Layout:jp
|
|
X11 Model:jp106
|
|
X11 Options:terminate:ctrl_alt_bksp |