Synchronization and logging. VMware

This is the documentation for the deprecated product BILLmanager 5. It is no longer updated and may be irrelevant. Documentation for the current version of BILLmanager can be found in the BILLmanager 6 section.

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/Services → Virtual 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

Error	Description
auth_token	Authorization token has not been received. Normally, it means that the problem is in an incorrect login or password.
forbidden	The user that has been used for integration with vCloud Director does not have sufficient rights for the called function.
not_found	The object of the request does not exist.
bad_request	It 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_error	Request for this operation has ended with an error.

Errors of the VMware vCloud Director integration module

Error	Description
createorgnet_task	The error of the task to create a network on the organization level.
createedge_task	The error of the task to create Edge Gateway.
ratelimit_task	The error of the task to edit the speed limit.
editvdc_task	The error of the task to edit VDC parameters.
createvdc_task	The error of the task to create a VDC.
allocateip_task	The error of the task to add an IP address to the existing VDC.
undeploy_task	Failed to suspend one of the virtual machines or vApp when deleting a service.
deleteip_task	The error of the task to delete the IP address of VDC.
billurl_isnull	URL of the billing system is not specified in provider settings in BILLmanager. The given error occurs when switching to VMware vCloud Director.
bad_rolename	Invalid value of the field User role in the parameters of the processing module.
bad_provider	Invalid value of the field Provider in parameters of the processing module.
bad_storage_policy	Invalid value of the field Storage policy in parameters of the processing module.
bad_netpool	Invalid value of the field Network pool name in parameters of the processing module.
gen_orgname	Failed to generate organization name. Before this error shows up, the module will try to generate the unique name 10 times.
no_ip	Failed to find a free IP address or the IP address in use has already been added to active service in BILLmanager.