Non-english locale on systems running OpenNMS components

troubleshooting
i18n

#1

Configuring OpenNMS to monitor your use cases is sometimes based on weak constraints in the configuration. For example, A surveillance category name is used as filter string. Or service names are used to map the monitoring class in the poller configuration or assign data collections for this service.

:biohazard: You will run in issues when you use non-english characters in your configuration files and when you run OpenNMS in a non-english locale.

Diagnose locale settings

You can use your language specific keymap but you should ensure you have the en_US.UTF-8 locale installed.

In CentOS/Ubuntu you can check this with:

[root@localhost ~]# localectl status
   System Locale: LANG=en_US.UTF-8
       VC Keymap: us
      X11 Layout: en

Set locale on CentOS 7 to english

[root@localhost ~]# localectl set-locale LANG=en_GB.utf8

The changes are fully applied on system reboot.

Set locale on Ubuntu 18 to english

[root@localhost ~]# update-locale LANG="en_US.UTF-8"

The changes are fully applied on system reboot.