Installing a Custom Language Pack to BSS

Before installing custom language packs to BSS, ensure the following requirements:

  • Activation requirements:

    1. 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
    2. Restart UI and Branding:

      kubectl rollout restart deployment  branding-ui-cluster-ui
    3. Restart the oss-node pod:

      kubectl rollout restart sts  oss-node

To install a custom language pack to BSS:

  1. 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.my

    Note:
    • 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.

  2. 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/
  3. 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
  4. After successful installation, the following output will be returned:

    Locale 'my' was installed successfully
  5. restart the bss-atm pod:

    kubectl rollout restart deployment bss-atm
CloudBlue, an Ingram Micro business, uses cookies to improve the usability of our site. By continuing to use this site and/or logging in you are accepting the use of these cookies. For more information, visit our Privacy Policy.