Creating or Revising a Language Pack

To create a new language pack translation, download a set of XML template files for the language you want to use. You can download and edit a language pack that was previously uploaded, or download and edit a new set of template files.

Next, edit the XML files to include the translated text you want to appear in the ICPAM desktop application. Then save the revised files using the same filename and compress the directory containing the XML files.

Note     The directory and compressed .zip archive can have any name you choose, but the XML files contained in that compressed .zip file must have the same filenames as the originals.

Import the compressed language pack file into the ICPAM appliance using the ICPAM Server Administration utility. Finally, reinstall the ICPAM desktop application, which includes the new language pack.

Editing a language pack that was previously installed is the same process as creating a new language pack. Instead of downloading a new template, however, you download and edit the language pack files that were previously installed.

Procedure

Perform the following procedure to create or edit a language pack for any language.

Step 1            Log on to the appliance over the Internet or by using a direct connection:

            For a direct connection, see Connecting a PC to the Appliance.

   •   For an Internet connection, open a Web browser and enter the IP address used for the ICPAM Server Administration utility. See Accessing the ICPAM Server Administration Utility, or ask your system administrator for assistance.

Step 2            (Optional) Perform a system backup, as described in Backing Up and Restoring Data.

Tip            To ensure the integrity of your existing data, back up system data before performing any major operation.

Step 3            Select Setup, and then select Localization.

Step 4            Enable localization, if necessary:

   •   This step is only necessary if you are upgrading or restoring data from CPAM Release 1.2.0 or lower.

             If your appliance is a new installation, skip to Step 5. You can also skip to Step 5 if localization was previously enabled on the appliance.

server_setup_localization.png

 

a.  Place the server in the Down state.

§        Click the Monitoring tab and select Stop in the Admin State entry.

§        Verify that the Admin State is Down.

b. Return to the Localization page and click Enable Localization (Figure 2-16).

c.  Click OK when the confirmation message appears.

 

d. Wait for the message The localization feature is enabled to appear. This can take up to one hour or more for large databases.

Tip             The Upload and Download buttons are also enabled when the conversion process is complete.

Step 5            To edit an existing language pack, click the Download link next to the installed language, and skip to Step 7.

server_setup_localization_optional_language.png

 

Step 6            To create a new language pack, download a language template:

a.  Select the Download template radio button (Figure 2-18).

b.  Choose a language from the Language drop-down list.

c.  Select Download.

d.  Continue to Step 7.

server_setup_localization_optional_language_download.png

 

Step 7            Select a location on your hard drive to save the compressed .zip file.

The filename includes the release number, and language code. For example: languagepack_zh_2.1_0.3.10

Step 8            Edit the XML files to include the translated text:

a.  Unzip the compressed language pack directory.

b.      Open each file using a Unicode-supported text editor.

For example: in Windows, right-click on the filename and select Open with > XML Editor from the pop-up list.

02_server_config_cpam_final00017.jpg

 

c.  Enter the translated text for each Translation Unit.

For each Translation Unit, there are two item entries: one for English (en), and another for the language you are translating.

02_server_config_cpam_final00020.jpg

 

        String id “key” identifies the language. The English (en) entry shows the English text, and an additional “key” entry identifies the language you need to translate. For example, Spanish is represented as “es”. Do not change these “key” values.

        String id “value” is the actual text of the item. Replace the English sample with the translated text for your language. This is the text that will appear in the ICPAM application.

Note    •  Do not change the text value of the “en” item. This is the English text which allows both languages to appear in the ICPAM client application.

     The items for English and the second language might appear in a different order, depending on the language pack and XML file. For example, in some XML files, the English entry may appear first. In other files, the second language may appear first. Always verify that you are editing the correct language. Never modify the English (en) key or value.

d. Save each XML file using the same filenames as the originals.

e.  Repeat these steps to translate each required XML file in the language pack.

Step 9            Place the translated language pack files in a directory and compress the directory as a .zip archive.

The directory and compressed .zip archive can have any name you choose, but the XML files contained in that compressed .zip file must have the same filenames as the originals.

Step 10         Place the active and standby ICPAM appliances in the Admin State Down state.

The server must be in Admin State Down to upload the compressed language pack file. If your system includes a redundant standby server, place the standby server in Down state first to prevent a fail-over.

CAUTION!               Placing the server in Admin State Down stops all ICPAM services. If a redundant Standby server is configured, you must also place the Standby server in the Admin State Down state.

a.  Log on to the standby ICPAM appliance (if configured).

b. Select Monitoring and then Status.

c.  Click the Stop button (on the right side of the Admin State row).

server_monitoring_2.jpg

 

a.  Log on to the active ICPAM appliance.

b. Select Monitoring and then Status.

c.  Click the Stop button (on the right side of the Admin State row).

 

Step 11         Upload the revised language pack.

a.  Select Setup and then select Localization.

b. Select the Upload language pack radio button.

c. Select the language you want to import from the drop-down list.

d. Click Browse and select the compressed file that contains the revised XML files.

  For example: languagepack_zh_2.1_0.3.10

e.  Click Upload.

apply_the_language_pack.png

 

Step 12  Wait for the upload to complete and click OK after the confirmation message appears.

Step 13         Confirm that the correct language pack was installed.

languages_installed_on_ICPAM_server.png

 

Step 14         Restart the ICPAM server.

Note      The server must be in Admin State Up to initialize the language pack and for users to access the system.

a.  Select Monitoring and then Status.

c.  Click the Stop button (on the right side of the Admin State row).

 

Step 15         Download and install the new version of the ICPAM client application.

Note      The new language will not be available until you uninstall and reinstall the client application.

a.  If the ICPAM client is already installed on your Windows PC, uninstall it.

§        Go to Start > Programs > Identiv Connected Physical Access Manager > Uninstaller and follow the onscreen instructions.

§        Or go to Start > Control Panel > Uninstall a Program > Identiv Connected Physical Access Manager and choose Uninstall.

b. Use one of the following methods to reinstall the desktop client:

§        In the ICPAM Server Administration utility, click Launch ICPAM Client.

§        Select Downloads then ICPAM Client (JRE required).

§        Click Launch ICPAM Client on the web utility login page.

Tip             See the Installing or Updating the ICPAM Desktop Software for more information.

c.  Follow the onscreen instructions to install and launch the updated ICPAM client.

Step 16         Select the new language when logging in to the ICPAM desktop client.

a.  Launch the ICPAM application.

b. In the Log In dialog box, choose the language you want to use from the drop-down list.

c.  (Optional) To display both languages in the application, select the Dual-Language mode option.

d. Enter the server hostname or IP address, the username, and the password.

e.  Click Log In.

client_login_screen_with_translation_field.jpg

 

Step 17         Verify that the translated text appears correctly in the ICPAM application (Figure 2-25).

If you chose Dual-language mode, the standard English text appears (within the parentheses) after the translated text.

translation_example.png

 

Tip            The Login screen also displays the selected language the next time you log in.

Step 18         If corrections are required, return to Step 5 to download and edit the XML files for an existing language pack. You must uninstall and reinstall the ICPAM client application each time you upload a language pack for the changes to appear.

 

See also:

Installing and Revising Language Packs

Usage Notes