Upgrade to Canadian French or Chinese failing
Article ID: 195676
Updated On:
Products
Issue/Introduction
During a migration attempt from 17.1/17.2 to 17.3 or higher, the following may occur in the install.log
Example depicted is for 17.4 (log entries of interest highlighted):
20XX/XX/XX 08.38.19.284 DEBUG [DeployThread: Application des mises à jour de localisation de CA Service Desk Manager : 17.4] [CommonUtil] Loading the properties D:/CA/SERVIC~1\site\install.properties
20XX/XX/XX 08.38.19.285 INFO [DeployThread: Application des mises à jour de localisation de CA Service Desk Manager : 17.4] [SDMPatch] installed locale =fr-CA
20XX/XX/XX 08.38.19.286 DEBUG [DeployThread: Application des mises à jour de localisation de CA Service Desk Manager : 17.4] [SDMPatch] Searching patch for language code : fr-CA
20XX/XX/XX 08.38.19.287 INFO [DeployThread: Application des mises à jour de localisation de CA Service Desk Manager : 17.4] [SDMPatch] Locale patch[] found for language code : fr-CA
20XX/XX/XX 08.38.19.287 ERROR [DeployThread: Application des mises à jour de localisation de CA Service Desk Manager : 17.4] [SDMPatch] Language Mapping not found in patch.xml
20XX/XX/XX 08.38.19.339 INFO [DeployThread: Application des mises à jour de localisation de CA Service Desk Manager : 17.4] [DeployThread] Task 'task.sdm.patch.locale.17.4' status saved to DB ....
20XX/XX/XX 08.38.19.339 DEBUG [DeployThread: Application des mises à jour de localisation de CA Service Desk Manager : 17.4] [ProgressPage] ProgressPage - Task Error.
20XX/XX/XX 08.38.19.339 DEBUG [DeployThread: Application des mises à jour de localisation de CA Service Desk Manager : 17.4] [ProgressPage] Task Error. TaskID: task.sdm.patch.locale.17.4,Application des mises à jour de localisation de CA Service Desk Manager : 17.4
20XX/XX/XX 08.38.41.495 WARN [DeployThread: Application des mises à jour de localisation de CA Service Desk Manager : 17.4] [Messages] Unable to find resource task.sdm.patch.locale.17.4 in bundle com/ca/smsi/installui/resources/ui/configui
Environment
Service Desk Manager 17.1 and 7.2 - Canadian French or Chinese Localization, upgrading to 17.3 or higher
All Supported Operating Systems
Cause
Starting with 17.3, Canadian French and Chinese languages are no longer supported.
Resolution
In the SDM install directory's site directory, backup the existing install.properties file (copy the file to a new location, do not copy/paste to create a second "install.properties - Copy" file)
Access the install.properties file and locate the line below:
locale.current=fr-CA
Change the line to read as:
locale.current=fr-FR
Save the file, then try the installer again.
Additional Information
The above is specific to the Canadian French implementation of SDM. There is no equivalent available for Chinese.
While this is also intended to be a one time only change, prior to any maintenance updates or migrations, it is recommended to review the install.properties file to verify for the "locale.current" value.
As the installer will load fr-FR instead of fr-CA, in SDM all new pages and OOTB data will be in French, which has several differences from Canadian French.
In xFlow, any new OOTB labels will be in English as there will no longer be a translation available.
As French and Canadian French have some differences, you may need to use the Web Screen Painter (WSP) to customize the labels or names as desired.
Please see CA Service Management 17.3 Release Notes, section "What's Deprecated?" (link) for reference to language support changes introduced at this release. SDM 17.4 (link) retains the language deprecation.
Feedback
