Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Table of Contents

...

Note

Changes to enterprise properties for AWS billing

Abiquo 6.0.0

  • Before you upgrade, add the amazon_bucket_region as an enterprise property . The value is the code for the with the AWS region where code of your billing bucket is located location (for example, us-east-1)

Abiquo 6.1.0

  • The Replace the price_factor enterprise property is deprecated and replaced with the Abiquo price factor factors for Amazon. See Manage price factors

...

  1. By default, the platform will retrieve billing data for the last two months. To change this value, on the Abiquo Server, edit the abiquo.properties file and add the following property with the number of months to retrieve:

    Code Block
    abiquo.enterprise.property.billing.monthoffset=2

  2. By default, the platform will process all items in the CSV file, so the partner discount (SppDiscount) value can be visible on customer dashboards. To discard items from the CSV file, on the Remote Services server, edit the abiquo.properties file and add the following property with any items to discard.  For example:

    Code Block
    abiquo.ec2billing.parser.lineItemType.ignore=SppDiscount

...

  1. Create an S3 bucket, for example, costandusagebillingreport

    1. Within the bucket, create a folder where AWS will store your reports. Give it the name of your report, for example costandusagebillingreport

    2. Note the billing bucket name, for example, costandusagebillingreport

  2. Create a new user, such as programmaticbilling to create the reports

    1. Assign the AmazonS3ReadOnlyAccess policy

    2. Activate the IAM user's access to billing information. See https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/control-access-billing.html

    Optionally configure legacy billing reports

    1. Go to Billing → Billing preferences

    2. Open the Detailed Billing Reports [Legacy] section

    3. Select the option to Turn on the legacy Detailed Billing Reports feature to receive ongoing reports of your AWS charges

    4. Click Configure and enter your S3 bucket details

    5. Select all of the available reports including

    6. Monthly report

    7. Detailed billing report

    8. Cost allocation report

    9. Detailed billing report with resources and tags

    10. Click Save preferences

  3. Configure Cost & Usage Reports

    1. Go to Cost & Usage Reports

    2. Enter the Report  name, which you will need to enter in Abiquo later, then click Next

    3. Click Configure and select the S3 bucket. Click Next, then select  I have confirmed that this policy is correct.

    4. By default, Amazon will put the reports in a folder with the name format "/report-name/date-range/". Note this as the value for the report amazon_bucket_prefix in Abiquo. Click Next

    5. Review your configuration and check that the following parameters are set: 

      1. bucket name

      2. path (folder/subfolder)

      3. time detail: Hourly

      4. GZ or ZIP format

  4. The AWS account with credentials to use in Abiquo should have the permissions in the AWS permissions table below.

AWS permissions table

...

Type

...

Privileges

...

  1. these permissions

    1. Price list

...

    1. : Full access

...

    1. to All resources

    2. S3

...

    1. : Full

...

    1. list

...

    1. and read

...

    1. access to Multiple resources

...

Configure

...

dashboard display in Abiquo

To configure billing dashboards in Abiquo for resellers, do these steps in Abiquo.

  1. The Abiquo users should have the privileges to Display hybrid dashboard tab, View bills, and optionally to Display VM cost view widget (hybrid tab)

  2. In Abiquo, edit Assign the privilege to View bills to your user roles

  3. Edit the reseller enterprise and create the following enterprise properties in the AWS enterprise properties for resellers table below

AWS enterprise properties for resellers table

...

Property

...

Description

  1. :

    1. amazon_bucket

...

    1. : bucket_name

    2. amazon_bucket_region

...

    1. : code for the AWS region

...

    1. of the bucket

...

    1. , such asus-east-1

...

    1. amazon_report_name

...

    1. : amazon_bucket/amazon_bucket_prefix/amazon_report_name/file.csv

    2. amazon_bucket_prefix

...

    1. : amazon_bucket/ amazon_bucket_prefix /amazon_report_name/file.csv

    2. amazon_billing_compress_

...

    1. format

...

    1. : ZIP or GZ

    2. amazon

...

    1. _

...

Default provider markup for customer enterprises with no value
(minus) This property is deprecated in Abiquo 6.1. The upgrade process will migrate the enterprise property to an Abiquo price factor. See Manage price factors

...

amazon_mpa

...

    1. mpa: set to dedicated or no to use blended costs

...

    1. ; if not present or

...

    1. shared

...

    1. , use unblended costs

    2. amazon_discount

...

    1. : as agreed with Amazon, such as 0.03, 0.02

...

_

Configure reseller customers in Abiquo

...

  1. In Pricing view, create price factors for the reseller.

...

  1. You can also create and apply price factors for customers.

...

  1. See Manage price factors