Table of Contents
Introduction
This article contains customizations which must be used during the deployment or upgrade of the Azure CSP 3.2+ application.
Preconditions
Before installing or updating the OA Billing customizations, mind the following preconditions:
- Odin Automation 7.0.x-7.1.x is installed.
- If the O365 application is deployed on your Odin Automation installation, make sure the version of the application is 16.8.3 or higher(16.8.5 or higher in case of Odin Automation 7.1). If Office 365 is 16.8.2, you have to install the unified customization: https://kb.cloudblue.com/en/129444.
Installing OA Billing Customizations
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.azure
directory (create the directory if it does not exist). - Go to the
/usr/local/bm/conf/wnd/BM/
directory and create thecustomization.AZURE
symbolic link if the link does not exist. Use theln -s /usr/local/bm/customization.azure customization.AZURE
command. - Copy the script.js file to the
/usr/local/bm/conf/html/azure
directory (create the directory if it does not exist). Copy the English localization file (mandatory) and localization files of other necessary languages (optional) to the
/usr/local/bm/conf/locale
directory:- locale.en.azure (English)
- locale.de.azure (German)
- locale.es.azure (Spanish)
- locale.fr.azure (French)
- locale.it.azure (Italian)
- locale.ja.azure (Japanese)
- locale.nl.azure (Dutch)
- locale.pt.azure (Portuguese)
- locale.ru.azure (Russian)
- 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:
Add custom layout template to your online store:
- Make sure that the corresponding Service Plan contains the
aps_defaults_azure
parameter. See Creating 'Azure CSP' Service Plan for more details. - Go to Products > Online Store and select the Layout Templates tab.
- Click the Add New Layout Template button.
- Type
azure_provision
in the Layout ID field. - Add the content of the azure_provision.tpl.txt file into the Template text area.
- Click the Save button.
- Make sure that the corresponding Service Plan contains the
Prepare the
pemgate
layout template:- Go to Products > Online Store and select the Layout Templates tab.
- Make sure the
pemgate
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
pemgate
layout template. - Click the Edit button.
Find the block with the
provision.tpl
in the template field:{if $state->itemIndex == $state->itemOriginalIndex && !$state->subscreen} {GetCustomTemplate name="./provision.tpl" assign="file" } {include file=$file } {/if}
and replace it with:
{if $state->itemIndex == $state->itemOriginalIndex && !$state->subscreen} {GetCustomTemplate name="./azure_provision.tpl" assign="file" } {include file=$file } {/if}
- 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 azure.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)
- Select the Overwrite Translations checkbox.
- Click the Save button.
- Go to Products > Online Store and click the Synchronize Now button.
Upgrading OA Billing Customizations
To upgrade the OA Billing customizations, perform the following actions:
Upgrade the OA Billing control panel customizations:
Remove the old customization using this instruction:
- Log on to the OA Billing Application Server (OABLINFE) as root.
- Go to the
/usr/local/bm/customization
directory and remove theBM_ProvisioningParams.xml
file (if it exists). - Go to the
/usr/local/bm/conf/html/azure
directory and remove thescript.js
file. - Go to the
/usr/local/bm/conf/locale
directory and remove all thelocale.<Language ID>.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
Office 365
application is installed, install the corresponding new OA Billing control panel customizations using the instructions of the https://kb.cloudblue.com/en/129556 KB article.
Upgrade the OA Billing online store customizations:
Remove the old customization using this instruction:
- Go to billing in PCP > Products > Online Store > Design tab.
- Click the Edit button.
- Remove all the css code related to Azure CSP (if there are no stores installed besides Azure CSP and O365, then remove all css code).
- Go to Products > Online Store > Layout Templates.
- Remove the
resourcegate
layout template (if it exists). - Remove the
o365_provision
layout template (if it exists). - If the
provision
layout template exists, then click on it 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
Office 365
application is installed, install the corresponding new OA Billing online store customizations using the instructions of the https://kb.cloudblue.com/en/129556 KB article.