Update Instructions for version 1904 of Azure Stack

Update Instructions for version 1904 of Azure Stack

This guide discusses the updated Instructions for version 1904 of Azure Stack. The features like Updating the Resource Provider Components and Updating Billing API and Agent Service are discussed in detail. 

Pre-requisite for Updating the Resource Provider Components

  • The Cloud Assert Billing API and Agent service v2.1.7.40 must be installed before updating RP (Resource Provider) components. 
  • If the current version installed in v2.1.7.40 (Can be verified from Programs and Features), skip to Updating Resource Provider Components

Updating Billing API and Agent Service

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:\Program Files\CloudAssertBilling\CloudAssert.WAP.Billing.AgentService


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.

Installation Steps

  • Extract the billing API(API download link) and Agent Service(Agent download link) setup 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.

Installing Billing API Service

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

Installing 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’.

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 (the API endpoint, user name and password can be found from ‘initialize.ini’ file which is mentioned in Installation Steps),


Updating Resource Provider Components

Pre-Uninstall Steps

  • Take a backup of the following files from their respective locations.

File Name

File Path

web.config

C:\inetpub\AzureStack-BillingAdminExtension

web.config

C:\inetpub\AzureStack-BillingTenantExtension

Web.config

C:\inetpub\AzureStack-BillingRP


Installing Billing Admin Extension

  • Download and extract the admin extension from here.
  • 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 <appSettings> section from the corresponding backup file.

Installing Billing Tenant Extension

  • Download and extract tenant extension from here.
  • 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- AzureStack-BillingTenantExtension’.
  • Replace the <appSettings> section from the corresponding backup file.

Installing Billing Resource Provider

  • Download and extract resource provider from here.
  • 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-BillingRP’.
  • Replace the <appSettings> section from the corresponding backup file


    • Related Articles

    • Microsoft Azure Stack and Cloud Assert Billing version mapping

      Cloudassert billing solution is a resource provider for Microsoft Azure Stack with secured design, highly available architecture. Our cloud billing solution allows businesses to increase their recurring revenue by enabling chargeback for resources ...
    • Microsoft Azure Stack and Cloud Assert VConnect version mapping

      VMs are the single most efficient process which minimizes IT expenditure while boosting the agility and efficiency of the businesses. Increased mobility for workload, greater performance - benefits of VM that makes IT management simple and cost less ...
    • Release notes - 2.1.7.40

      We are pleased to present our latest Release notes - 2.1.7.40.  Make sure you always install the stable and latest version. See version numbers for more information.  The following release notes address the changes, updates in this version and ...
    • Setup Guide

      This setup guide provides detailed setup instructions. It does not contain any type of processing information. The information in this setup guide is subject to change. CLOUD ASSERT BILLING SETUP & CONFIGURATION GUIDE | Billing for Microsoft Azure ...
    • Prerequisites

      This document lists the minimum requirements necessary to run this application.  Prerequisites: Connection to a SQL server SQL Server name, in the format, <IP Address of the SQL Server>/<Instance name> SQL authenticated user credential Name of the ...