Table of Contents

Introduction

This KB article describes how to install and upgrade the OA Billing customizations that are necessary for the Office 365 application.

This KB article can be used only for Office 365 19.3.4.

Preconditions

Before installing or updating the OA Billing customizations, make sure that the version of your Odin Automation installation is Odin Automation 8.2.x/8.3.x.

Upgrading OA Billing Customizations

Note: The new OA Billing customization files are attached to the KB article.

To upgrade the OA Billing customizations, perform the following actions:

  1. Upgrade the OA Billing control panel customizations:

    1. Log on to the OA Billing Application Server (OABLINFE) as root.

    2. Go to the directory /usr/local/bm/customization.o365 and do the following:

      1. Replace the old file BM_ProvisioningParams.xml with the new file BM_ProvisioningParams.xml.
      2. Replace the old file SubscrParam_CDB_UpgradeResourceList.xml with the new file SubscrParam_CDB_UpgradeResourceList.xml.
      3. Replace the old file SubscrParam_UpgradeList.xml with the new file SubscrParam_UpgradeList.xml.
    3. Go to the directory /usr/local/bm/conf/html/o365 and do the following:

      1. Replace the old file script.js with the new file script.js.
      2. Replace the old file cowi_script.js with the new file cowi_script.js.
    4. Go to the directory /usr/local/bm/conf/locale and replace the old files locale.<LanguageID>.o365 with the new files:

      • locale.en.o365 (English)
      • locale.de.o365 (German)
      • locale.es.o365 (Spanish)
      • locale.fr.o365 (French)
      • locale.it.o365 (Italian)
      • locale.ja.o365 (Japanese)
      • locale.nl.o365 (Dutch)
      • locale.pt.o365 (Portuguese)
      • locale.ru.o365 (Russian)
    5. Restart the service www by using the command service www restart.

    6. Restart the service pba by using the command service pba restart.
  2. Upgrade the OA Billing online store customizations:

    1. Go to Products > Online Store and select your online store for editing.

    2. Update the custom layout template o365_provision:

      1. Go to Products > Online Store and select the tab Layout Templates.
      2. In the list of layout templates, click on the layout template o365_provision.
      3. Click the button Edit.
      4. In the field Template, replace the old contents with the new contents of the file o365_provision.tpl.txt.
      5. Click the button Save.
    3. Update the standard layout template resourcegate:

      1. Go to Products > Online Store and select the tab Layout Templates.
      2. In the list of layout templates, click on the layout template resourcegate.
      3. Click the button Edit.
      4. In the field Template, replace the old contents with the contents of the file o365_resourcegate.tpl.txt.
      5. Click the button Save.
    4. Update custom Office 365 styles of your online store:

      1. Go to Products > Online Store and select the tab Design.
      2. Click the button Edit.
      3. In the field Customized CSS, replace the old Office 365 styles with the new Office 365 styles of the file o365.css.txt.

        Important: Do not remove or change styles not related to the Office 365 application.

      4. Click the button Save.
    5. Update the English translations and the translations of other necessary languages:

      1. Go to Products > Online Store and select the tab More.
      2. Click the link Languages.
      3. Select the required language by clicking the respective link in the column Language ID / Language Name.
      4. Click the button Import Dictionary and select the required dictionary file:

        • locale-bmstore.en (English)
        • locale-bmstore.de (German)
        • locale-bmstore.es (Spanish)
        • locale-bmstore.fr (French)
        • locale-bmstore.it (Italian)
        • locale-bmstore.ja (Japanese)
        • locale-bmstore.nl (Dutch)
        • locale-bmstore.pt (Portuguese)
        • locale-bmstore.ru (Russian)
      5. Select the checkbox Overwrite Translations.
      6. Click the button Save.
    6. Go to Products > Online Store and click the button Synchronize Now.

Important: If there are resellers selling Office 365 services on your Odin Automation installation, the online stores of the resellers must also be updated.

Installing OA Billing Customizations

Note: The OA Billing customization files that you need are attached to the KB article.

To install the OA Billing customizations, perform the following actions:

  1. Install the OA Billing control panel customizations:

    1. Log on to the OA Billing Application Server (OABLINFE) as root.

    2. Create the /usr/local/bm/customization.o365 directory and copy the following files to the directory:

      • BM_ProvisioningParams.xml
      • SubscrParam_CDB_UpgradeResourceList.xml
      • SubscrParam_UpgradeList.xml
    3. Go to the /usr/local/bm/conf/wnd/BM/ directory and create the customization.O365 symbolic link pointing to the /usr/local/bm/customization.o365 directory. To create the link, use the ln -s /usr/local/bm/customization.o365 customization.O365 command.

    4. Create the /usr/local/bm/conf/html/o365 directory and copy the following files to the directory:

      • script.js
      • cowi_script.js
    5. Copy the English localization file and the localization files of other necessary languages to the /usr/local/bm/conf/locale directory:

      • locale.en.o365 (English)
      • locale.de.o365 (German)
      • locale.es.o365 (Spanish)
      • locale.fr.o365 (French)
      • locale.it.o365 (Italian)
      • locale.ja.o365 (Japanese)
      • locale.nl.o365 (Dutch)
      • locale.pt.o365 (Portuguese)
      • locale.ru.o365 (Russian)
    6. Restart the www service by using the service www restart command.

    7. Restart the pba service by using the service pba restart command.
  2. Install the OA Billing online store customizations:

    1. Go to Products > Online Store and select your online store for editing.

    2. Create the custom layout template o365_provision:

      1. Go to Products > Online Store and select the Layout Templates tab.
      2. Click the Add New Layout Template button.
      3. Specify the following:

        • Layout ID - The o365_provision value must be specified.
        • Template - Use the contents of the o365_provision.tpl.txt file.
      4. Click the Save button.
    3. Prepare the standard layout template resourcegate:

      1. Go to Products > Online Store and select the Layout Templates tab.
      2. Make sure the resourcegate layout template is in the list of layout templates. If it is not in the list, add it by clicking the Add Standard Layout button.
      3. In the list of layout templates, click on the resourcegate layout template.
      4. Click the Edit button.
      5. In the Template field, replace the existing contents with the contents of the o365_resourcegate.tpl.txt file.
      6. Click the Save button.
    4. Add custom Office 365 styles to your online store:

      1. Go to Products > Online Store and select the Design tab.
      2. Click the Edit button.
      3. In the Customized CSS field, add the Office 365 styles of the o365.css.txt file to the existing styles.

        Important: Do not remove or change styles not related to the Office 365 application.

      4. Click the Save button.
    5. Add the English translations and the translations of other necessary languages to your online store:

      1. Go to Products > Online Store and select the More tab.
      2. Click the Languages link.
      3. Select the required language by clicking the respective link in the Language ID / Language Name column.
      4. Click the Import Dictionary button and select the required dictionary file:

        • locale-bmstore.en (English)
        • locale-bmstore.de (German)
        • locale-bmstore.es (Spanish)
        • locale-bmstore.fr (French)
        • locale-bmstore.it (Italian)
        • locale-bmstore.ja (Japanese)
        • locale-bmstore.nl (Dutch)
        • locale-bmstore.pt (Portuguese)
        • locale-bmstore.ru (Russian)
      5. Select the Overwrite Translations checkbox.
      6. Click the Save button.
    6. Go to Products > Online Store and click the Synchronize Now button.

Helpful Resources