sign in sign up
<<
Home , Code page 949 (IBM), Unified Hangul Code

Content Services

FILENET TECHNICAL NOTICE

INSTALLING CONTENT SERVICES 5.3.0 INTO NON-ENGLISH ENVIRONMENT

January 2004 Overview

Overview

This technical notice documents the special issues affecting the installation, configuration, and maintenance of Content Services () in supported non-English environments.

The major issues involve: • Code pages and character sets

• Regional database and operating system settings Revision Log

Date Revision 01/20/2004 Initial release

Support Matrix

The following tables identify, for each CS 5.3.0 platform, the languages other than English that FileNet supports. Notes

• FileNet has certified Content Services only for English, French, and German. Problems reported in supported but not certified ISO Latin-1, ISO Latin-2, or 8859-7 (Greek) languages must be reproducible in one of the certified languages obtain fixes or patches from FileNet. Contact your FileNet representative if you have questions concerning this support.

• When installing SQL Server 2000, you must select “Collation designator” in the Collation Settings dialog box (contrary to the instructions in the topic “Installation Guide > Prerequisites to Installing Content Services > Preparing a SQL Server Database > Installing the Database Engine” of the SQL Server edition of the CS 5.3.0 documentation). Then select the correct collation designator from the list. Also, be sure that the Binary check box is cleared. Otherwise, CS installation will fail.

• For the Windows Oracle and HP Oracle editions of CS 5.3.0, be sure to apply all Oracle patches (see “Content Services Setup” on page 11).

FileNet Content Services 2 Non-English Environments Overview

Windows SQL Platform

Language Operating System Database Special Notes French Win 2000 Server or SQL Server 2000 For Win 2000 and SQL Server, use Advanced Server + (Fr.) + SP 3 French language settings. SP 3 German Win 2000 Server or SQL Server 2000 For Win 2000 and SQL Server, use Advanced Server + (Ger.) + SP 3 German language settings. SP 3 Other ISO Win 2000 Server or SQL Server 2000 For Win 2000 and SQL Server, use Latin-1 Advanced Server (lang.) + SP 3 language settings for your language. languages (lang.) + SP 3 ISO Latin-2 Win 2000 Server or SQL Server 2000 For Win 2000 and SQL Server, use (.., Advanced Server (lang.) + SP 3 language settings for your language. Use Czech) (lang.) + SP 3 1252 in SQL Server. Greek Win 2000 Server or SQL Server 2000 For Win 2000 and SQL Server, use Advanced Server (lang.) + SP 3 language settings for your language. Use (lang.) + SP 3 code page 1253 in SQL Server. Japanese Win 2000 Server or SQL Server 2000 For Win 2000 and SQL Server, use Advanced Server (Jp.) + SP 3 Japanese settings. Use in (Jp.) + SP 3 SQL Server. Korean Win 2000 Server or SQL Server 2000 For Win 2000 and SQL Server, use Advanced Server (Kr.) + SP 3 Korean settings. Use in (Kr.) + SP 3 SQL Server.

Windows Oracle Platform

Language Operating System Database Special Notes French Win 2000 (Fr.) + Oracle8i 8.1.7(Fr.) For Win 2000 and Oracle, use French SP 3 or Oracle9i 9.2.0 language settings. (Fr.) German Win 2000 Server or Oracle8i 8.1.7 For Win 2000 and Oracle, use German Advanced Server (Ger.) or Oracle9i language settings. (Ger.) + SP 3 9.2.0 (Ger.) Other ISO Win 2000 (lang.) + Oracle8i 8.1.7 For Windows and Oracle, use language Latin-1 SP 3 (lang) or Oracle9i settings for your language. See Oracle Languages 9.2.0 (lang.) documentation: National Language Support Guide.

FileNet Content Services 3 Non-English Environments Overview

HP Oracle Platform

Language Operating System Database Special Notes French HP-UX 11.0 (Engl.) Oracle8i 8.1.7 or When installing Oracle on HP-UX, be Oracle9i 9.2.0 sure to use the appropriate language settings, as specified in “Content Services Setup” on page 11. See also Oracle documentation: National Language Support Guide. German HP-UX 11.0 (Engl.) Oracle8i 8.1.7 or When installing Oracle on HP-UX, be Oracle9i 9.2.0 sure to use the appropriate language settings, as specified in “Content Services Setup” on page 11. See also Oracle documentation: National Language Support Guide. Other ISO HP-UX 11.0 (Engl.) Oracle8i 8.1.7 or When installing Oracle on HP-UX, be Latin-1 Oracle9i 9.2.0 sure to use the appropriate language Languages settings, as specified in “Content Services Setup” on page 11. See also Oracle documentation: National Language Support Guide.

FileNet Content Services 4 Non-English Environments Recommendations

Recommendations

In general, apply the following recommendations when setting up and configuring Content Services:

1. Install the operating system and database engine for CS servers using the regional settings appropriate for your language. See “Support Matrix” on page 2 and “Known Issues and Restrictions” on page 11 for details associated with your CS platform edition.

2. Install the operating system and database engine using the code page and associated sort order appropriate for your language. For example: Under Windows SQL Server:

Language Code Pages Sort Order Latin-2 (e.g., Czech) OEM: 1252 accent-insensitive

Database: 1252

8859-7 (Greek) OEM: 1253 accent-insensitive Database: 1253

3. Avoid using setup.inf to install Content Services. Instead, use the Content Services interactive install program setup.exe. 4. If possible, avoid using Latin-2 or 8859-7 (Greek) characters in Content Services library system names. Otherwise, be aware that such characters may not display as expected in the following components: dssetup.exe (the command-line version of the Content Services setup program), CS Rendition Services windows and rendition template names, the CS Configuration tool, CS Replication Administration windows, and the CS Service Manager tool.

5. Do not index text files (e.g., those created with MS Notepad) for content search. 6. Do not enable the CS User Import functionality if Windows NT domains contain users or groups having Latin-2 or 8859-7 (Greek) characters. Instead, use the CS Admin Tools (CS Explorer, or the Bulk Process tool) to add users and groups to Content Services library systems.

FileNet Content Services 5 Non-English Environments Verity Search Requirements

Verity Search Requirements

For Verity searches to work on double-byte languages, you must perform the following procedure after installing any set of library services:

1. Launch rcadmin from a command line. 2. At the rcadmin prompt, type the following:

vdksettingset 3. At the Service Alias prompt, type the following:

CS_ServerName_LibraryName_K2Server where ServerName is the name of the CS server and LibraryName is the name of the CS library system.

FileNet Content Services 6 Non-English Environments Installing the Liquent PDF Printer

Installing the Liquent PDF Printer

Failure Record (FR) 52151 states that installation of FileNet Rendition Services does not by default install the printer driver used by the Liquent PDF Printer on a machine running a non-English Windows operating system. As a workaround, after installing FileNet Rendition Services, use the service account to logon to each Rendition Services server and perform the following two procedures in sequence to manually install and configure the Liquent PDF Printer.

To install the Liquent PDF Printer: 1. In Windows, choose Start > Settings > Printers and double-click Add Printer to launch the Add Printer wizard.

2. Click Next in the Welcome screen of Add Printer Wizard.

3. In the Local or Network Printer screen, click Local Printer, clear the “Automatically detect and install my Plug and Play Printer” check box, and then click Next.

4. In the Select the Printer Port screen, click “Create a new port”, select Local Port from the Type list, and then click Next. 5. In the Port Name box, type the following and then click OK:

:\Program Files\Common Files\liquent\esps. 6. In the Add Printer Wizard screen, select an entry from the Manufacturers list, select a level 2 PostScript printer driver from the Printers list, and then click Next.

Note The printer driver you select will not be the printer driver that Liquent PDF Printer uses. In step 12 you will change the printer driver setting to the AdobePS Distiller driver, which is the supported driver for the Liquent PDF Printer. 7. In the Name Your Printer screen, type the following text in the “Printer name” box exactly as it appears below (with case sensitivity):

LIQUENT PDF Printer Under “Do you want your Windows-based programs to use this printer as the default printer?”, click , and then click Next. 8. In the Printer Sharing screen, click “Do not share this printer” and then click Next.

9. In the Print Test Page screen, under “Do you want to print a test page”, click No and then click Next.

10. In the Completing the Add Printer Wizard screen, verify that the information is correct and click Finish.

11. Right-click the newly created Liquent PDF Printer, select Properties, and click the Advanced tab.

12. Click the Driver , select AdobePS Acrobat Distiller, and then click OK.

To configure the Liquent PDF Printer:

1. In Windows, choose Start > Settings > Printers.

FileNet Content Services 7 Non-English Environments Installing the Liquent PDF Printer

2. In the Printers window, right-click the Liquent PDF printer and choose Properties.

3. Click the General tab and then click Printing Preferences. 4. Click the Adobe PDF Settings tab, choose Vista Options from the Conversion Settings list, clear the “Prompt for the PDF Filename” check box, and then click OK.

Note If the “Prompt for PDF Filename” check box is not cleared, the Renditions server will prompt for files when rendering files to PDF. These prompts will stop automated rendering and will not allow the system to continue rendering until the prompts are closed. 5. Click the Advanced tab. In the Driver list, choose AdobePS Acrobat Distiller, and then click Printing Defaults. 6. Click the Adobe PDF Settings tab, choose Vista Options from the Conversion Settings list, clear the “Prompt for the PDF Filename” check box, and then click OK.

Caution Although step 6 appears identical to step 4, the settings you select for the printer driver in these two steps are stored in separate sections of the Windows registry. Both steps are needed to ensure correct rendering of documents to PDF. 7. Click OK to close the Liquent PDF Printer Properties dialog box and then close the Printers window.

FileNet Content Services 8 Non-English Environments Supported Oracle Character Sets

Supported Oracle Character Sets

The following character sets are supported for Oracle-based Content Services 5.3.0 installations:

Character Set Description AR8ISO8859P6 ISO 8859-6 Latin/Arabic AR8MSWIN1256 MS 1256 8-bit Latin/Arabic BLT8MSWIN1257 MS Windows Code Page 1257 8-bit Baltic CL8ISO8859P5 ISO 8859-5 Latin/Cyrillic CL8MSWIN1251 MS Windows Code Page 1251 8-bit Latin/Cyrillic EE8ISO8859P2 ISO 8859-2 East European EE8MSWIN1250 MS Windows Code Page 1250 8-bit East European EL8MSWIN1253 MS Windows Code Page 1253 8-bit Latin/Greek EL8ISO8859P7 ISO 8859-7 Latin/Greek IW8ISO8859P8 ISO 8859-8 Latin/Hebrew IW8MSWIN1255 MS Windows Code Page 1255 8-bit Latin/Hebrew JA16SJIS Shift-JIS 16-bit Japanese TR8MSWIN1254 MS Windows Code Page 1254 8-bit Turkish WE8ISO8859P1 ISO 8859-1 West European WE8ISO8859P9 ISO 8859-9 West European and Turkish WE8ISO8859P15 ISO 8859-15 West European WE8MSWIN1252 MS Windows Code Page 1252 8-bit West European ZHS16GBK GBK 16-bit Simplified Chinese

In addition to the character sets listed above, character sets whose name contains one of the following substrings are also supported: 850, 874, 932, 936, 949, and 950.

FileNet Content Services 9 Non-English Environments Supported Windows Code Pages

Supported Windows Code Pages

The following code pages are supported for Windows SQL-based Content Services 5.3.0 installations:

Code Page Description iso_1 ISO-8859-1 cp708 MS-DOS Arabic cp850 MS-DOS Multilingual Latin 1 cp874 Thai cp932 Japanese Shift-JIS cp936 Simplified Chinese cp949 Microsoft Unified Code cp950 Microsoft extension/variant of (traditional/Taiwanese) cp1250 Latin2 cp1251 Cyrillic cp1252 Latin1 cp1253 Greek cp1254 Turkish cp1255 Hebrew cp1256 Arabic cp1257 Baltic cp1361 Johab

FileNet Content Services 10 Non-English Environments Known Issues and Restrictions

Known Issues and Restrictions

In general, you can use the installation and configuration instructions provided in general Content Services documentation. The following notes enhance or modify those instructions, as they relate to particular languages supported by Content Services. Where available, each note contains the failure record (FR) number that FileNet uses for tracking purposes. Latin-1 Languages (e.g., French, German, Spanish) Content Services Setup • In French and German environments, you must install Oracle patches for the Windows Oracle edition of CS 5.3.0. Proper operation of Oracle-based Content Services 5.3.0 databases requires that you install Oracle patches, depending on the version of Oracle Server you have installed. If you installed Oracle8i 8.1.7 Standard or Enterprise Edition for Windows 2000, you must also install Oracle Server patches 8.1.7.4.1 and Oracle Security Alert #54 patch. If you installed Oracle9i 9.2.0 Standard or Enterprise Edition for Windows 2000, you must also install Oracle Server patch 9.2.0.3.0. For a copy of these patches see the Oracle web site. If you cannot find the patches there, visit FileNet Worldwide Customer Support and navigate to the folder containing Oracle patches. Follow the installation instructions in the Patch_note.htm file in the patch folder. • In French and German environments, you must configure Oracle appropriately for these languages to use the HP-UX Oracle edition of Content Services 5.3.0. This applies for other ISO Latin-1 languages as well.

When installing Oracle for use with the HP-UX Oracle edition of Content Services 5.3.0, you must specify appropriately the desired language, language settings, character set, and initorcl.ora settings, or the system will not accommodate those languages as expected. FR /A When installing Oracle: • Select the desired language (French or German) before you allow the setup program to begin installing. To add languages after installation, you would have to reinstall the entire Oracle product.

• Use the French or German language settings.

• Specify the following database character set: WE8MSWIN1252

• Once Oracle is installed, set the following parameters in the initorcl.ora file:

For French:

NLS_LANGUAGE=FRENCH

NLS_TERRITORY=FRANCE

For German:

NLS_LANGUAGE=GERMAN

FileNet Content Services 11 Non-English Environments Known Issues and Restrictions

NLS_TERRITORY=GERMANY

• In French and German environments, you must install HP-UX patches for the HP-UX Oracle edition of Content Services 5.3.0. This applies for other ISO Latin-1 languages as well.

Proper operation of HP-UX Oracle-based Content Services 5.3.0 requires that you install HP-UX patches and patch bundles. The Oracle documentation lists the required patches, which you can obtain from the HP web site. Check with HP for the latest updates on these patches or any dependencies that might be required. • In French and German environments, you must install Oracle patches for the HP-UX Oracle edition of Content Services 5.3.0.This applies for other ISO Latin-1 languages as well. If you installed Oracle8i 8.1.7 Standard or Enterprise Edition for HP-UX, you must also install Oracle Server patches 8.1.7.4.1 and Oracle Security Alert #54 patch. If you installed Oracle9i 9.2.0 Standard or Enterprise Edition for Windows 2000, you must also install Oracle Server patch 9.2.0.3.0. For a copy of these patches see the Oracle web site. If you cannot find the patches there, visit FileNet Worldwide Customer Support and navigate to the folder containing Oracle patches. Follow the installation instructions in the Patch_note.htm file in the patch folder. Rendition Services for PDF • FR 52151 FileNet Rendition Services 5.3.0 does not by default install printer drivers for the Liquent PDF Printer on a non-English Windows operating system.

Remedy: Manually install the Liquent PDF Printer (refer to “Installing the Liquent PDF Printer” on page 7). Latin-2 Languages (e.g., Czech) Content Services Setup • FR 17172 The setup.inf file does not install Content Services correctly if you enter accented Latin-2 characters for the libname (library system name) parameter.

Details: The setup.inf file does not handle accented Latin-2 characters correctly, especially in the libname (library system name) parameter, making it impossible to set up Content Services using this script file (e.g., via SMS). Remedy: Instead of setup.inf, use the Content Services interactive setup.exe program to install Content Services library systems, or avoid using accented Latin-2 characters in any Content Services parameters (e.g., library system names). Rendition Services for PDF • FR 18344 IDM Desktop does not properly display rendition template names.

Details: Rendition Services for PDF allows you to create a rendition template whose name contains Latin-2 characters (for example, if you install Rendition Services on an English Windows NT 4.0 machine with Czech regional settings). However, IDM Desktop installed on a different machine with the same settings does not properly display the Latin-2 characters in the template name. Template

FileNet Content Services 12 Non-English Environments Known Issues and Restrictions

names display in Latin-1 characters only, and may be difficult to decipher in the different character set. That said, you can still apply the templates as expected and the publishing occurs without error. Remedy: Avoid using Latin-2 characters in rendition template names. • FR 52151 FileNet Rendition Services 5.3.0 does not by default install printer drivers for the Liquent PDF Printer on a non-English Windows operating system.

Remedy: Manually install the Liquent PDF Printer (refer to “Installing the Liquent PDF Printer” on page 7). CS Service Manager Tool • FR 16675 Latin-2 characters in library system names display incorrectly.

Details: Although Microsoft SQL Server allows you to create database instances using names containing accented Latin-2 characters, the CS Service Manager does not display the characters correctly. However, the CS Configuration tool displays them as expected, and there is no adverse affect on the ability to install or use library systems having names with accented Latin-2 characters. Remedy: Do not use Latin-2 characters in the database instances created for Content Services library systems. Japanese Rendition Services for PDF • FR 52151 FileNet Rendition Services 5.3.0 does not by default install printer drivers for the Liquent PDF Printer on a non-English Windows operating system.

Remedy: Manually install the Liquent PDF Printer (refer to “Installing the Liquent PDF Printer” on page 7). CS Admin Tools • FR 20615 A Japanese CVL name with an embedded newline (carriage return) character contains extraneous characters. To illustrate the erroneous CVL name, perform the following steps: a. Launch CS Explorer and choose Tools > Document Class.

. Click New CVL, enter a few Japanese characters, press Return, followed by two or three more Japanese characters.

c. Choose a CVL Data Type, add some CVL entries, and click Done.

In the Defined CVLs List, note the appearance of two dots in place of the newline character. • FR 50679 When CS 5.3.0 is installed on a Sun Solaris server with the Japanese display language, CS Admin Tools displays some CS property names with corrupted Japanese characters and others with English characters when logged on to a CS library system whose display language is English.

FileNet Content Services 13 Non-English Environments Known Issues and Restrictions

Arabic Content Services • FR 48910 IDM Find cannot find indexed Arabic PDF files in a CS 5.3.0 library system. Rendition Services for PDF • FR 52151 FileNet Rendition Services 5.3.0 does not by default install and configure printer drivers for the Liquent PDF Printer on a non-English Windows operating system. Remedy: Manually install the Liquent PDF Printer (refer to “Installing the Liquent PDF Printer” on page 7).

FileNet Content Services 14 Non-English Environments