Installing a language pack as a customer

This topic explains the procedure to install a language pack as a customer.

To install a language pack as a customer

1. Get the language pack ZIP file containing the custom language pack and custom Service Analytics translation files from the FootPrints reseller. 

2. Unzip the language-pack.zip into a temporary directory on the machine where FootPrints is installed. For example, C:\FootPrintsLanguagePacks.

   A subdirectory called language-pack is created.

3. On the Start menu, click Run, and type cmd in the run window to open a command window and click OK.
4. Create the new language in FootPrints from the command line by executing the Translation Tool. You must provide
   1. the -createnewlanguage option 
   2. the new language code

   3. the new language name
      For example,

      java -cp "C:\Program Files\BMC Software\FootPrints\conf;C:\Program Files\BMC Software\FootPrints\web\WEB-INF\lib\*;C:\Program Files\Apache Software Foundation\Tomcat 8.5\lib\*" com.numarasoftware.footprints.tool.translation.TranslationTool -createnewlanguage -newlanguagecode it_IT -newlanguagename "Italian - Italy"

      Examples of System Responses:

      Language it_IT - Italian - Italy created.
5. To load the custom language into FootPrints, execute the Translation Tool from the command line. You must provide:

   1. The path of the folder which contains the directory.
      It may be in

      C:\FootPrintsLanguagePacks\language-pack 

      or

      C:\FootPrintsLanguagePacks\language-pack\language-pack 

      depending on where you unzipped it.

   2. The locale code of the language pack being loaded.
      For example,

      java -cp "C:\Program Files\BMC Software\FootPrints\conf;C:\Program Files\BMC Software\FootPrints\web\WEB-INF\lib\*;C:\Program Files\Apache Software Foundation\Tomcat 8.5\lib\*" com.numarasoftware.footprints.tool.translation.TranslationTool -location "C:\FootPrintsLanguagePacks\language-pack" -lang it_IT

      Examples of System Responses:

      Importing language translations...
      Importing locale 'it_IT'...
      Language file: 'C:\FootPrintsLanguagePacks\language-pack\it_IT\FootPrintsLanguagePack.xml'...
      Language import completed.

6. Copy the custom Service Analytics translation file(s) footprints.dmf_it_IT.xml  and ReportEditor.TmfAdWrapper_it_IT.xml  from C:\FootPrintsLanguagePacks\language-pack" to the web\_SupportFiles folder of the installed FootPrints web application. The DMF file is present in all releases; the second TMF file is a new addition in FootPrints release 12.1.07 and later.

    

   Note

   - Path for Windows: C:\Program Files\BMC Software\FootPrints\web\_SupportFiles
   - Path for Linux/Unix: \opt\bmc\FootPrints\web\_SupportFiles

7. Restart Tomcat.

8. Ensure that the translations were applied by creating a test administrative user whose preferred language is set to the custom language. Log in as that user and browse the application. Strings should be displayed in the custom language.

   Note

   Strings that were not translated will be displayed in English.

Related topic

Creating-a-custom-language