Applying a language deployment package - Documentation for Remedy Deployment 20.02

During the Remedy IT Service Management (ITSM) Suite installation, the English language pack is always installed by default. You can choose to install additional language packs by using a language deployment package. A language deployment package contains localized views and data for the Remedy ITSM Suite. A user with AR System administrator permission or a Package Deployer role can apply the language packs for Remedy applications. For a list of supported languages in Remedy, see Supported languages and locales.

Best practice

We recommend you to apply the language deployment packages for additional languages rather than running the Remedy AR System installer again to install the languages.

The language packs for the Remedy platform and applications are available for download from the Electronic Product Distribution (EPD) site.

A language pack for the Remedy platform includes localized views and data for AR System Server and Atrium Core. For example, a French language pack for the Remedy platform contains French views and data for AR System Server and Atrium Core.
A language pack for the Remedy applications includes localized views and data for Remedy ITSM, SRM, and SLM. For example, a French language pack for the Remedy applications contains French views and data for ITSM, SRM, and SLM.

Note

Japanese (ja), Korean (ko), Simplified Chinese (zh_CN), and Hebrew (he) language packs can be deployed only on AR Servers with a UNICODE DB character set.

Before you begin

Ensure the following:

The Remedy platform is upgraded to version 20.02, if you are applying a language pack for the Remedy platform.
The Remedy applications are upgraded to version 20.02, if you are applying a language pack for the Remedy applications.
If you are deploying a platform language pack on an AR only stack, you must set the Maximum Stack of Filters value.
To set the filters value
1. Navigate to AR System Administration Console > System > General > Server Information.
2. In the Server Information form, click the Advanced tab.
3. In the Filters area, set the Maximum Stack of Filters value to 150.
4. Click Apply.
Reset the filter value back to the original value after the package is successfully deployed.

Apply a language deployment package

Perform the following tasks to apply the language packs for Remedy applications:

Import a language pack

Log in to Mid Tier as an administrator or a package deployer user by using the following URL:
midTierServerName>:<port number>/arsys
On the IT Home page, select Applications > AR System Administration > AR System Deployment Management Console.
In AR System Deployment Management Console, perform the following actions:
1. Select Transfer Package > Import.
2. In the Add Attachment dialog box, click Choose File to navigate to the folder that has the downloaded EPD package.
3. Select the package that you want to import, and then click OK.
  The Status column shows the status as Importing until the package contents are completely imported. If the status shows Importing for more than 10 seconds, click Refresh to view the updated status. After the package is successfully imported, the package is listed in the AR System Deployment Management Console and the package status changes to Ready to Deploy.

Deploy a language pack

Log in to Mid Tier as an administrator or a package deployer user by using the following URL:
midTierServerName>:<port number>/arsys/
On the IT Home page, select Applications > AR System Administration > AR System Deployment Management Console.
In AR System Deployment Management Console, perform the following actions:
1. Click the package row that you have imported, and then select Operations > Deploy.
2. To view the package status, click Refresh.
  After the package is successfully deployed, the status of the package changes to Deployed.

Deploying a double byte language pack

If you are deploying a language pack of a double byte language on a Non Unicode DB when the operating system is also installed in the same double byte language; the package level precheck fails and the package deployment is rejected. For example, Japanaese locale cannot be installed on a Non Unicode DB with Japanese OS. To deploy a double byte language pack, you must create an entry in the Centralized Configuration. Perform the following steps:

Navigate to AR System Administration Console > System > General > Centralized Configuration.
From the Component Name dropdown, select com.bmc.arsys.server.shared.
Click Add to add a new setting with the bypass-unicode-locale-check name.
Set the value to true.
Click Apply.

Verify the language pack deployment

Perform any one of the following steps:

Open Remedy Developer Studio. Verify that additional localized views have been added to the forms for the language that you have applied. For example, check the views of the Approval Central or AR System Customizable Home Page form. For a list of localized AR System forms, see Supported languages and locales.

Open the SHARE:Application_Properties form. For the application IDs, check whether the LanguagePacks property value corresponds to the language that you have applied. For example, check the LanguagePacks property value for the following application IDs. If you have applied French, the LanguagePacks property value should display en;fr.

Application	Application ID
Remedy AR System	AR005056B5170DLd#JSQUZQNEQXRkA
BMC CMDB	OB00C04FA081BABZlxQAmyflAg1wEA
BMC Asset Management	ID00C04F651D063b42125a04548561
BMC Change Management	ID00C04F651D063b42125a0454854d
BMC Incident Management	IM00C04FA081BAUcxmQg[8XkEQmwAA
BMC Problem Management	PM00C04FA081BAp8xmQghBbmEQnAAA
BMC Knowledge Management	KM00C04FA081BAkzXdRAKRHW5AtFIB

Rollback a language deployment package

If an issue occurs during the validation of the package, or if an error occurs while deploying the package, you can restore the objects on your server to the pre-deployment state. BMC does not recommend to roll back a package that was successfully deployed.

You must rollback language packs in the reverse order of their deployment. For example, if you have deployed the German language pack first, followed by the French language pack on an English-only application; you must rollback the French language pack first, followed by the German language pack.

The AR System administrator or a Package Deployer performs the following steps to roll back a package:

Log in to Mid Tier by using the following URL:
midTierServer>:<port number>/arsys/
On the IT Home page, select Applications > AR System Administration > AR System Deployment Management Console.
In AR System Deployment Management Console, perform the following actions:
1. Select the package that has Deployed with Error status.
2. Select Operations > Rollback.
3. In the confirmation dialog box that is displayed, click Yes.
4. (Optional) Click Refresh.
  The State of the package changes from Rolling back to Rolled back.