How to configure NuGenesis SDMS to support the capture and restoration of files with non-English characters in their names - WKB74834

OBJECTIVE or GOAL

Configure a NuGenesis SDMS system so that it can capture files with non-English characters in their names.

ENVIRONMENT

• NuGenesis 9 SDMS
• NuGenesis 8 SDMS
• Chinese, Korean, or Japanese characters are in the names of files that SDMS should archive
• The SDMS servers have either the appropriate localized edition of Windows or have the appropriate OS language packs installed
• Russian characters are supported only for NuGenesis 8 SDMS FR1 and SR2

PROCEDURE

The Oracle NLS_LANG setting should be set to match the character set of the filenames.

To verify or set the NLS_LANG variable in NuGenesis 9:

1. Open the Registry editor
2. Browse to the following key:
   • HKLMS\Software\Wow6432Node\oracle\NLS_LANG

3. Set the Region to appropriate language setting:

   Open Control Panel / Select Region / Language, Under the Region Setting
   Select Administrative tab Change system locale to the new language ex: Simplified Chinese

To verify or set the NLS_LANG variable in NuGenesis 8:

1. Open the System control panel applet.
2. Select the Advanced tab.
3. Click the Environment Variables button.
4. Variables are separated into two categories: user variables, which are set only for the current user login, and system variables, which apply to all users. NLS_LANG should be a system variable, and it should be set to one of the following values:
   • Japanese: JAPANESE_JAPAN.JA16SJIS
   • Korean: KOREAN_KOREA.KO16MSWIN949
   • Chinese: SIMPLIFIED CHINESE_CHINA.ZHS16GBK
   • Russian: RUSSIAN_CIS.CL8MSWIN1251
   • English: AMERICAN_AMERICA.WE8MSWIN1252 (do not use for East Asian language support)

5. Set the Region to appropriate language setting:

   Open Control Panel / Select Region / Language, Under the Region Setting
   Select Administrative tab Change system locale to the new language ex: Simplified Chinese

The SDMS Web server software, WebVision, uses the configuration file WebVision.ini, which must be modified for non-English language support:

1. Default paths for WebVision.ini:
   • SDMS 8.0: Drive:\Program Files (x86)\apache-tomcat-6.0.29\webapps\WebVision\ngvision
   • SDMS 9.0: Drive:\Program Files (x86)\Waters\apache-tomcat-9.0.8\webapps\WebVision\ngvision
2. Open WebVision.ini with a text editor.
3. There are two important settings in this file for language support: installLanguage and requestCharacterEncoding
4. Set installLanguage to one of the following values:
   • Japanese: ja
   • Korean: ko
   • Chinese: ch
   • Russian: Windows-1251
   • English: en (do not use for East Asian language support)
5. Set requestCharacterEncoding to one of the following values:
   • Japanese: ms932
   • Korean: ms949
   • Chinese: ms936
   • Russian: cp1251
   • English: blank (do not use for East Asian language support)
6. Save and close the file.
7. Restart the server to get WebVision to read the new settings.

ADDITIONAL INFORMATION