Versions Compared

Key

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

This document describes the multiple cost codes feature for applying extra charges to VMs, VM templates, and hardware profiles.
Note that in the Abiquo UI, cost codes are now called extra charges.

Abiquo 6.0.1 introduces multiple cost codes (now called extra charges) and enables uses users to add cost codes for extra charges to VMs. You can now add multiple extra charges to VM templates, and to hardware profiles in private cloud. Abiquo will automatically add extra charges to VMs you create with them, and you can add additional extra charges to the VM. There are new extra charges units for usage per CPU and per user licenses. Abiquo accounting and billing support multiple extra charges.

Abiquo 6.0.3 renamed the Cost codes feature to Extra charges in the UI, and introduces changes to the privileges. The Extra charges tab will display in the VM templates and VMs for all users that can edit them.

Table of Contents

...

Manage cost codes

As in previous versionsIn Abiquo 6.0.1 and 6.0.2, administrators create cost codes in the Cost codes section in Pricing view.

  • The privileges for viewing and managing cost codes in Pricing view are the ones for Pricing view: Access pricing view and Manage pricing.

  • For hardware profiles, VM templates, and VMs, the additional privileges to manage cost codes are Add a cost code when editing a VM templateandAccess pricing view.

Info

We are currently reviewing cost code privileges

...

  • .

...

From Abiquo 6.0.3, we have removed the privilege to Add a cost code when editing a VM template.

The new privileges are:

  • Manage hardware profile extra charges

  • Manage virtual machine template extra charges

  • Manage virtual machine extra charges

From Abiquo 6.0.3, these privileges are applied as follows.

Context

Action

Cost code and extra charges privileges

Create, Edit or Capture a VM

Display Extra charges tab

- (The tab displays for all users with VM privileges)

Modify extra charges

Manage virtual machine extra charges

Edit a VM

Change the hardware profile of a VM

- (The tab displays for all users with VM privileges)

Edit the number of user licenses of an extra charge

Manage virtual machine extra charges

Create a VM template

-

- (info) You cannot add extra charges when you create a template

Edit a VM template

Display Extra charges tab

- (The tab displays for all users with VM template privileges)

Edit extra charges

Manage virtual machine template extra charges

...

Create a cost code for an extra charge

To create a cost code for an extra charge:

  1. Enter a Name and Description that will identify the cost code for an extra charge for other administrators and users. The length of these fields

...

  1. was increased in Abiquo 6.0.1

  2. The Type is the entity where you will use the cost code for an extra charge, such as Template, Hardware profile, Virtual machine, or All. The Custom servicetype is not supported

...

  1. The Unit specifies how to calculate the cost using the cost code for an extra charge:

    1. Usage period is for usage x time

    2. Usage CPUs is for usage x number of CPUs

    3. Usage user licenses is for usage x number of users that you enter in the VM

    4. Subscription is only for Customer service types and it is not supported

...

    1. yet

...

As usual, you can enter the initial prices for a cost code for an extra charge.

...

And you can update these prices in a pricing model.

...

...

Add cost codes for extra charges to VM templates and hardware profiles

...

The Extra charges tab will always display when you edit a VM template.

To make changes to extra charges, you will need the privileges to Manage virtual machine template extra charges and/or to Manage hardware profile extra charges.

To add a cost code for an extra charge to a VM template:

  1. Edit the VM template and go to

...

  1. extra charges

...

  1. Add extra charges to a VMImage Added
  2. Click the + add button

  3. Select

...

  1. an extra charge, click Add

...

  1. Select an extra charge and click AddImage Added
  2. After you finish adding

...

  1. extra charges and editing the template, click Save

You can also add a cost code an extra charge to a hardware profile in the same way.

...

...

Create

...

VMs and add

...

extra charges

When you create a VM, Abiquo will automatically add cost codes extra charges from the hardware profile and the VM template as inherited cost codes.

The user cannot change these cost codesthe inherited cost codes.

Before v6.0.3, the Extra charges tab will display for all users who can edit the VM.

  • You can add more cost codes for extra charges to the VM. This requires the privilege to Manage virtual machine extra charges

  • If you are using a cost code for extra charges that will bill be billed for Usage user licenses, enter the number of users. This requires the privilege to Manage virtual machine extra charges

  • When you later edit a VM and change the hardware profile, Abiquo will update the extra charges.

...

Capture a VM and add cost codes

...

When you capture a VM, you can also add cost codes for extra charges of type Virtual machine or All.

...

When you release a VM, the cost codes extra charges will no longer apply.

...

Cost codes in accounting and billing

The accounting system represents the usage of extra charges (cost codes) with the costCodeparameter. By default Abiquo accounts for cost codes and stores their data (meaning that the costCode usage is activated).

In previous versions and in Abiquo 6.0.1, to enable the cost_code usage in classic billing, you configure each cost code separately. Abiquo is currently reviewing this configuration.

...