Installing a Custom Language Pack to BSS
Before installing custom language packs to BSS, ensure the following requirements:
-
Activation requirements:
-
To the global config map a8n-config, add the necessary locale IDs to the ENV_LOCALES parameter. If there is no ENV_LOCALES parameter, add it with the value equal to a comma-separated list of locale abbreviations. For example:
Note: Custom locales must be added using the my_MY format by contrast with the default locale format ru. The full list of ISO 3166 codes is available at https://www.iso.org/iso-3166-country-codes.html.
kubectl edit cm a8n-config ... data: ENV_LOCALES: ru,en,de,my_MY
-
Restart UI and Branding:
kubectl rollout restart deployment branding-ui-cluster-ui
-
Restart the oss-node pod:
kubectl rollout restart sts oss-node
-
To install a custom language pack to BSS:
-
On a machine with kubectl and access to the Kubernetes cluster, prepare a file structure for the new BSS locale. For example, for a my locale:
# ls my
locale.my locale-bmstore.my locale-info.myNote:
• By contrast with the locale activation instructions where the my_MY format is used for custom locales, 2-letter extensions are used for custom locale files, for example: locale.my, locale-bmstore.my, locale-info.my
The full list of ISO 3166 language codes is available at https://www.iso.org/iso-3166-country-codes.html.
• For the file structure and format, contact your CloudBlue Commerce account manager. -
Put the custom language pack (with 3 files, locale.my, locale-bmstore.my, and locale-info.my) to the /k8s_data/locales/custom_lp/my directory on the bss-atm pod:
# kubectl cp my `kubectl get pods --no-headers -o custom-columns=":metadata.name" | grep atm`:/k8s_data/locales/custom_lp/
-
Execute the /usr/local/bm/tools_py/configureLocale.py script passing the custom locale directory path as the argument:
kubectl exec `kubectl get pods --no-headers -o custom-columns=":metadata.name" | grep atm` -c atm -- python /usr/local/bm/tools_py/configureLocale.py /k8s_data/locales/custom_lp/my/ -w
-
After successful installation, the following output will be returned:
Locale 'my' was installed successfully
-
restart the bss-atm pod:
kubectl rollout restart deployment bss-atm