General Upgrade Installation Instructions for MAS Billing

General Upgrade Installation Instructions for MAS Billing

Please find the general Upgrade Installation Instructions:

 

1.1   Pre-Uninstall Steps

  • Take a backup of Cloud Assert billing database.
  • Take a backup of the following files from their respective locations.

File Name

File Path

Web.config

C:\inetpub\MgmtSvc-CloudAssertBilling

License.cal

C:\inetpub\MgmtSvc-CloudAssertBilling\bin

CloudAssert.WAP.Billing.AgentService.exe.config

C:\ProgramFiles\CloudAssertBilling\CloudAssert.WAP.Billing.AgentS ervice

web.config

C:\inetpub\AzureStack-BillingAdminExtension

web.config

C:\inetpub\AzureStack-BillingTenantExtension

Web.config

C:\inetpub\AzureStack-BillingRP

 

1.2   Uninstallation Steps

  • Uninstall existing Usage and Billing installers from Add or Remove Programs on the resource provider machine.
  • Delete ‘CloudAssertBilling’ from ‘C:\Program Files’ if present after uninstalling Billing Agent Service setup.

1.3   Installation Steps

  • Extract the billing installers to a desired location.
  • To install the Billing API and Agent service components via command line, download the ‘setup.bat’ file here.
  • Copy the initialize.ini file from the following location 
    ‘C:\Packages\Plugins\Microsoft.Powershell.DSC\2.19.0.0\DSCWork\setupBillingConfiguration.0\ AzureStack.Billing.Setup.1.0.0\content\Setup\Packages’.
  • Place ‘setup.bat’ and ‘initialize.ini’ (which are acquired from the above steps) files in the folder where the billing installers have been extracted.

 

1.3.1        Install Billing API Service

  • Open a command prompt as administrator.
  • Navigate to the billing installers folder.
  • Run ‘setup.bat install-api’.

1.3.2        Install Billing Admin Extension

  • In the command prompt, change the directory to the AdminExtension folder.
  • Run the command “CloudAssert.AzureStack.Billing.AdminExtension.deploy.cmd /y”
  • Open the web.config file from ‘C:\inetpub\AzureStack-BillingAdminExtension’.
    Replace the section (AppSettings) from the corresponding backup file.

 

1.3.3        Install Billing Tenant Extension

  • In the command prompt, change the directory to the TenantExtension folder.
  • Run the command “CloudAssert.AzureStack.Billing.TenantExtension.deploy.cmd /y”
  • Open the web.config file from ‘C:\inetpub\AzureStack-BillingAdminExtension’.
    Replace the section (AppSettings) from the corresponding backup file.

 

1.3.4        Install Billing RP

  • In the command prompt, change the directory to the RP folder.
  • Run the command “CloudAssert.MAS.Billing.ResourceProvider.deploy.cmd /y”
  • Open the web.config file from ‘C:\inetpub\AzureStack-BillingAdminExtension’.
    Replace the section (AppSettings) from the corresponding backup file.

 

1.4 Post Installation Steps

  • Download the Billing Tool here and extract it.
  • Open a command prompt as administrator.
  • Navigate to the billing tool folder.
  • Run the ‘UpdateDatabase’ command in BillingTool.exe as below,


BILLING.EXE UpdateDatabase [/ApiEndpoint:<String>] [/Username:<String>] [/Password:<String>]

 (Refer from CloudAssert.WAP.Billing.AgentService.exe.config file)


1.5 Install Billing Agent Service

  • Refresh the admin/tenant portal and verify that Billing extension is working fine.
  • Open a command prompt as administrator.
  • Navigate to the billing installers folder.
  • Run ‘setup.bat install-agent’.