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 for (now called extra charges) and enables users to add cost codes for extra charges to VMs. You can now add multiple cost codes extra charges to VM templates, and to hardware profiles in private cloud. Abiquo will automatically add these cost codes extra charges to VMs you create with them, and you can add additional VM cost codes for extra charges to the VM. There are new cost code extra charges units for usage per CPU and per user licenses. Abiquo accounting and billing support multiple cost codesextra charges.

Abiquo 6.0.3 renames 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.

...

  • 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.

...

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

Before you begin:

...

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 apply add a cost code for an extra charge to a VM template:

  1. Edit the VM template and go to extra charges

...

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

  3. Select an extra charge, click Add

...

  1. Select an extra charge and click AddImage Added
  2. After you finish adding extra charges and editing the template, click Save

You can also add 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 for extra charges from the hardware profile and the VM template as inherited cost codes.

The user cannot change the inherited cost codes.

The 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 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 cost codes for extra charges.

...

Capture a VM and add cost codes

...

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.

...