BILLmanager 5 Documentation

Synchronization and logging. VMware

Synchronization of the list of virtual machines

The system runs automatic synchronization of the list of virtual machines every 30 minutes:

  • If there are discrepancies in parameters of virtual machines, these parameters will be changed to the values specified in BILLmanager.
  • If a virtual machine has been deleted in vCloud Director, then it will be deleted in BILLmanager.
  • If a virtual machine has been added in vCloud Director, then information about this server will be sent to BILLmanager.

Synchronization can also be launched manually: Products/ServicesVirtual DC → select a data center → button Virtual servers → button Update.

Logging

The integration module for VMware vCloud Director has a separate log — '/usr/local/mgr5/var/pmvmware.log'

The log contains the detailed information about requests sent to vCloud Director and how the system responded to these requests.

Information about the task is represented in the log as XML:

<Task ... operation="Stopped Virtual Application qwe1(58b81329-ea2a-4f94-b999-1c36923a0340)" operationName="vappUndeployPowerOff" status="running">
...
</Task>

operation — operation name.

status — task status:

    • success — completed successfully.
    • error — ended with an error.
    • canceled — canceled by owner or administrator.
    • aborted — aborted by an administrator.
    • running — in progress.

The XML can contain additional information such as:

Error provides information about the error if the task has ended with the error.

Progress shows the task completion in percents.

Possible errors

General

ErrorDescription
auth_tokenAuthorization token has not been received. Normally, it means that the problem is in an incorrect login or password.
forbiddenThe user that has been used for integration with vCloud Director does not have sufficient rights for the called function.
not_foundThe object of the request does not exist.
bad_requestIt is impossible to process the request.Possible causes:
  • Not enough resources in VDC.
  • Impossible to create a virtual router with the selected IP address.
  • No rights to receive information about user roles.
task_errorRequest for this operation has ended with an error.

Errors of the VMware vCloud Director integration module

ErrorDescription
createorgnet_taskThe error of the task to create a network on the organization level.
createedge_taskThe error of the task to create Edge Gateway.
ratelimit_taskThe error of the task to edit the speed limit.
editvdc_taskThe error of the task to edit VDC parameters.
createvdc_taskThe error of the task to create a VDC.
allocateip_taskThe error of the task to add an IP address to the existing VDC.
undeploy_taskFailed to suspend one of the virtual machines or vApp when deleting a service.
deleteip_taskThe error of the task to delete the IP address of VDC.
billurl_isnullURL of the billing system is not specified in provider settings in BILLmanager. The given error occurs when switching to VMware vCloud Director.
bad_rolenameInvalid value of the field User role in the parameters of the processing module.
bad_providerInvalid value of the field Provider in parameters of the processing module.
bad_storage_policyInvalid value of the field Storage policy in parameters of the processing module.
bad_netpoolInvalid value of the field Network pool name in parameters of the processing module.
gen_orgnameFailed to generate organization name. Before this error shows up, the module will try to generate the unique name 10 times.
no_ipFailed to find a free IP address or the IP address in use has already been added to active service in BILLmanager.