Table of Contents
- Introduction
- Preconditions
- Upgrading OA Billing Customizations
- Installing OA Billing Customizations
- Help Resources
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 17.2-17.2.1.
Preconditions
Before installing or updating the OA Billing customizations, make sure that the following preconditions are satisfied on your Odin Automation installation:
- Odin Automation 7.1.x/7.2.x/7.3.x is installed.
- 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:
Upgrade the OA Billing control panel customizations:
Remove the old OA Billing control panel customizations:
- Log on to the OA Billing Application Server (OABLINFE) as root.
- Go to the
/usr/local/bm/customization
directory. Check if theBM_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. - Go to the
/usr/local/bm/conf/html/azure
directory and remove thescript.js
file (if it exists). - Go to the
/usr/local/bm/conf/locale
directory and remove all thelocale.<LanguageID>.o365-azure
files (if they exist).
Install the new OA Billing control panel customizations using the instructions of the Installing OA Billing Customizations section (see step 1).
- 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.
Upgrade the OA Billing online store customizations:
Remove the old OA Billing online store customizations:
- Go to Products > Online Store and select your online store for editing.
- Go to Products > Online Store and select the Design tab.
- Click the Edit button.
- Remove all the custom CSS of the
Office 365
andAzure CSP
applications. - Click the Save button.
- Go to Products > Online Store and select the Layout Templates tab.
- Remove the
resourcegate
layout template (if it exists). - Remove the
o365_provision
layout template (if it exists). - If the
provision
layout template exists, click on its name and then click the Reset to Default button.
Install the new OA Billing online store customizations using the instructions of the Installing OA Billing Customizations section (see step 2).
- 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:
Install the OA Billing control panel customizations:
- Log on to the OA Billing Application Server (OABLINFE) as root.
- Copy the BM_ProvisioningParams.xml file to the
/usr/local/bm/customization.o365
directory (create the directory if it does not exist). - Go to the
/usr/local/bm/conf/wnd/BM/
directory and create thecustomization.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 theln -s /usr/local/bm/customization.o365 customization.O365
command. - Copy the script.js file to the
/usr/local/bm/conf/html/o365
directory (create the directory if it does not exist). Copy the English localization file (mandatory) and the localization files of other necessary languages (optional) 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)
- locale.zh.o365 (Chinese)
- Restart the www service by using the
service www restart
command. - Restart the pba service by using the
service pba restart
command.
Install the OA Billing online store customizations:
Go to Products > Online Store and select your online store for editing.
Create the custom layout template
o365_provision
:- Save the
Office 365
application package to a directory on your workstation. - Unpack the application package and extract the content of the
O365-Import.zip
file. - Go to Products > Online Store and select the Layout Templates tab.
- Click the Add New Layout Template button.
Specify the following:
- Layout ID - The
o365_provision
value must be specified. - Template - Use the content of the
o365_provision.tpl
file from the extractedO365-Import.zip
file.
- Layout ID - The
- Click the Save button.
- Save the
Prepare the layout template
resourcegate
:- Go to Products > Online Store and select the Layout Templates tab.
- 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. - In the list of layout templates, click on the
resourcegate
layout template. - Click the Edit button and replace the content of the Template field with the content of the o365_resourcegate.tpl.txt file.
- Click the Save button.
Add custom styles to your online store:
- Go to Products > Online Store and select the Design tab.
- Click the Edit button.
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.
- Click the Save button.
Add the English translations (mandatory) and the translations of other necessary languages (optional) to your online store:
- Go to Products > Online Store and select the More tab.
- Click the Languages link.
- Select the required language by clicking the respective link in the Language ID or Language Name column.
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)
- locale-bmstore.zh (Chinese)
- Select the Overwrite Translations checkbox.
- Click the Save button.
- Go to Products > Online Store and click the Synchronize Now button.
Help Resources
Supported APS Application Packages Versions in Odin Automation
Office 365 Subdomain Form for OA Billing (OA Billing Customizations v2)
- [Odin Automation Premium] [Office 365] Allowed Upgrade Paths