Patch Process with Language Packs 6.13.3
Created: 6.12.1; Updated: 6.12.1

A version that is installed with additional languages can only be patched if the language packs of the target version are available. The patch process has been changed so that the language packs of the versions between start and target version have to be available too.

Example: The installation has to be patched from 6.11.1 to 6.12.0. In this case the language packs for the versions 6.11.2, 6.11.3, and 6.12.0 have to be available.

There are two ways of providing the necessary language packs:

  1. Provide Language Packs Manually
  2. Provide Language Packs Automatically
Table of Contents

1 Provide Language Packs Manually

The conventional way is to copy all necessary language packs in the folder containing the patch packet. Alternatively you can copy the language packs into a sub folder "LanguagePacks". Then, if the patch process is started accordingly to the installation guide, the language packs as well will be installed.

2 Provide Language Packs Automatically

For patches over multiple versions with multiple languages you have to work with a lot of language packs. To simplify this the language packs can be downloaded and installed automatically. During the patch process all necessary language packs are downloaded from a sever, copied into the patch directory and installed.

Note: The machine to be patched have to have the permissions to connect to www.epages.de via http.

For each language and epages version a specific language key is needed to update the language packs automatically. These language keys are used on the command line when the patch is installed.

Example:
  Windows:  perl patch.pl prepare EPAGES612_LANG_FR_KEY=abc
  UNIX:     patch.sh prepare EPAGES612_LANG_FR_KEY=abc

The language key variable name describes the target version and language. It must be created according to the following naming convention:

EPAGES[RELEASE]_LANG_[LANGUAGE]_KEY
[RELEASE] == Number of release without dots, e.g. 612 for release 6.12
[LANGUAGE] == Identifier for the language to be installed, e.g. FR for French
Example: EPAGES612_LANG_FR_KEY
Request the corresponding language key from your ePages contact person for language packs. Using the language key the patch can be started as follows:

  Windows:  perl patch.pl [TARGET] EPAGES[RELEASE]_LANG_[LANGUAGE]_KEY=[KEY]
  UNIX:     patch.sh [TARGET] EPAGES[RELEASE]_LANG_[LANGUAGE]_KEY=[KEY]

[TARGET] is the target that is executed in first place; usually 'prepare'.

The patch command line must contain all necessary language keys.

Example for Windows and French and Spanish:

  perl patch.pl prepare EPAGES612_LANG_FR_KEY=abc EPAGES612_LANG_ES_KEY=123

3 YUM Update

If the patch shall be installed on Linux via YUM, the language key variables must be put in front of the yum command.

Example for French and Spanish:

  EPAGES612_LANG_FR_KEY=abc EPAGES612_LANG_ES_KEY=123 yum update epages-patch

4 Use Case

The version 6.11.0 has to be patched to 6.12.0. French and Spanish are installed as additional languages. Therefore the following French and Spanish language packs are necessary for the patch: 6.11.1, 6.11.2, 6.11.3, and 6.12.0.

The release number of the target version is 6.12.0. The following variables have to be created for the patch process:

  EPAGES612_LANG_FR_KEY
  EPAGES612_LANG_ES_KEY

The language keys for these two variables are needed.

The Windows patch has to be started as follows:

  perl patch.pl prepare EPAGES612_LANG_FR_KEY=abc EPAGES612_LANG_ES_KEY=123


Copyright ePages Software GmbH 2012