HQ Internationalization

Localization and Language Packs in HQ 3.2

HQ 3.2 supports languages other than the default (US English). Here is what you need to know in order to add an additional language support into HQ.

In the open source version of HQ there are 20 localized files containing the text used throughout the application. In the Enterprise Edition there are two additional files. Adding support for additional languages is as easy as:

1. Locating and make copies of the following files in the deployment directories.

• /web/WEB-INF/classes/ApplicationResources.properties
• /web/WEB-INF/classes/EEApplicationResources.properties (HQ Enterprise Only)
• /ui-plugins/plugin-name/etc/plugin-name _i18n.properties
• In the hq.jar file at /org/hyperic/hq/* there are 12 Resources.properties files
• In the hq.jar file at /com/hyperic/hq/reporting/Resources.properties (HQ Enterprise Only)

2. Identify the language and (Optional) country code for the language pack and build the localization string.

• This string is the lower case ISO639 code followed by and hyphen ( - ) followed by the ISO3166 country code. You can find the ISO639 codes here and the ISO3166 codes here.

3. Adding the locale suffix to each of the .properties files.

• For each one of the .properties files that you made copies of, place an underscore ( _ ) followed by the hyphen separated language and country code at the end of the filename before the suffix. For example, if the filename is Resources.properties and the language and country code is en-US for US English then the new filename is Resources_en-US.properties.

4. Translate all the .properties files.

• Using an editor that supports utf-8 character encoding, go through the .propeties files and replace the text on the right side of the equals (=) sign on each line with the appropriate text in the new language.

5. Start HQ.

• Make sure the browser has the correct language and country code set and run HQ.

Developer steps

Steps to add language pack support.

1. Application encoding is set to UTF-8
   1. Must set the request to use the UTF-8 characterset by adding <%@ page language="java" contentType="text/html; charset=UTF-8" %> to the main JSP.
   2. Must set the response characterset to UTF-8 by adding <%@ page pageEncoding="UTF-8"%> to the main JSP.
2. Add locale support to the jsp by adding locale="true" <html:html locale="true"> in MainLayout.jsp.
3. Ensure that the characterset used in the language packs is UTF-8.
4. Ready to drop language packs into the WEB-INF or WEB-INF/Classes directories.

**Note: once a language is selected other than the default in a session, the session must be reset in order to change languages. Also, since the latin character set (ASCII) is a subset of UTF-8 there is no reason to convert ASCII characters to UTF-8 characters.