Table of Contents

Introduction

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

This KB article can be used only for Office 365 16.8.3-16.8.6/17.1.0-17.1.3.

Preconditions

Before installing or updating the OA Billing customizations, make sure that the following preconditions are satisfied on your Odin Automation installation:

  1. Odin Automation 7.0.x is installed.
  2. If the Azure CSP application is deployed on your Odin Automation installation, make sure the version of the application is 3.2.4 or higher.

Upgrading OA Billing Customizations

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

  1. Upgrade the OA Billing control panel customizations:

    1. Remove the old OA Billing control panel customizations:

      1. Log on to the OA Billing Application Server (OABLINFE) as root.
      2. Go to the /usr/local/bm/customization directory. Check if the BM_ProvisioningParams.xml file exists. If it exists, create a backup of it. Then, analyze the content of the file. If the file contains only the Office 365/Azure CSP customizations, remove the file. If the file contains both the Office 365/Azure CSP customizations and other customizations, such as customizations of other APS applications, remove the Office 365 and Azure CSP customizations from the file.
      3. Go to the /usr/local/bm/conf/html/azure directory and remove the script.js file (if it exists).
      4. Go to the /usr/local/bm/conf/locale directory and remove all the locale.<LanguageID>.o365-azure files (if they exist).
    2. Install the new OA Billing control panel customizations using the instructions of the Installing OA Billing Customizations section (see step 1).

    3. If the Azure CSP application is installed, install the corresponding new OA Billing control panel customizations using the instructions of the https://kb.cloudblue.com/en/129551 KB article.
  2. Upgrade the OA Billing online store customizations:

    1. Remove the old OA Billing online store customizations:

      1. Go to Products > Online Store and select your online store for editing.
      2. Go to Products > Online Store and select the Design tab.
      3. Click the Edit button.
      4. Remove all the custom CSS of the Office 365 and Azure CSP applications.
      5. Click the Save button.
      6. Go to Products > Online Store and select the Layout Templates tab.
      7. Remove the resourcegate layout template (if it exists).
      8. Remove the o365_provision layout template (if it exists).
      9. If the provision layout template exists, click on its name and then click the Reset to Default button.
    2. Install the new OA Billing online store customizations using the instructions of the Installing OA Billing Customizations section (see step 2).

    3. If the Azure CSP application is installed, install the corresponding new OA Billing online store customizations using the instructions of the https://kb.cloudblue.com/en/129551 KB article.

    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

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. Copy the BM_ProvisioningParams.xml file to the /usr/local/bm/customization.o365 directory (create the directory if it does not exist).
    3. Go to the /usr/local/bm/conf/wnd/BM/ directory and create the customization.O365 symbolic link if the link does not exist. The link must point 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. Copy the script.js file to the /usr/local/bm/conf/html/o365 directory (create the directory if it does not exist).
    5. Copy the English localization file (mandatory) and the localization files of other necessary languages (optional) to the /usr/local/bm/conf/locale directory:

    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. Save the Office 365 application package to a directory on your workstation.
      2. Unpack the application package and extract the content of the O365-Import.zip file.
      3. Go to Products > Online Store and select the Layout Templates tab.
      4. Click the Add New Layout Template button.
      5. Specify the following:

        • Layout ID - The o365_provision value must be specified.
        • Template - Use the content of the o365_provision.tpl file from the extracted O365-Import.zip file.
      6. Click the Save button.
    3. Prepare the 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 and replace the content of the Template field with the content of the o365_resourcegate.tpl.txt file.
      5. Click the Save button.
    4. Add custom styles to your online store:

      1. Go to Products > Online Store and select the Design tab.
      2. Click the Edit button.
      3. Add the content of the o365.css.txt file to the existing content of the Customized CSS field.

        Important: Do not remove or change the existing content of the field.

      4. Click the Save button.
    5. Add the English translations (mandatory) and the translations of other necessary languages (optional) 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 or Language Name column.
      4. Click the Import Dictionary button and select the required dictionary file:

      5. Select the Overwrite Translations checkbox.
      6. Click the Save button.
    6. Go to Products > Online Store and click the Synchronize Now button.

Help Resources

Internal content