VM autodiscovering

The VM discovery function synchronizes data about virtual server services (virtual machines, VMs) in BILLmanager and virtual machines in VMmanager 6. The provider manually initiates synchronization in the Integration → Processing modules section.

The function helps identify inconsistencies between:

VMs in VMmanager 6 that lack a corresponding service in BILLmanager;
services in BILLmanager that lack a corresponding VM in VMmanager 6.

The platform administrator can:

assign VM to a client by creating a new service;
initiate VM creation in VMmanager 6 for an existing service.

Typical reasons for inconsistencies

The list of VMs in integrated VMmanager 6 and BILLmanager may differ if:

the service is missing (VM exists, but there is no service):
- the service was deleted in BILLmanager, but the VM remains in VMmanager 6 — for example, if the service was manually deleted;
- the VM was created directly in VMmanager 6 (by administrator or a client);
the VM is missing (service exists, but there is no VM):
- the service is activated in BILLmanager, but the VM was not created — for example, due to an error when calling the handler;
- the VM was deleted directly in VMmanager 6.

Synchronization management

VM synchronization is managed in Integration → Processing modules → select the VMmanager 6 module → Autodiscovering. By default, this section displays a table listing:

VMs that are not linked to any service;
services that are not linked to any VM.

To synchronize VM information, click the Start button.

Table structure

VM data is presented in a table with the following columns:

Id — row identifier in the table;
Properties — current synchronization status with VMmanager 6. Possible statuses:
- — VM exists in VMmanager 6, but no corresponding service exists in BILLmanager;
- — service exists in BILLmanager, but VM is missing in VMmanager 6;
- — VM is marked as system. Administrators in VMmanager 6 can create VMs not intended for assignment to clients. Such VMs can be marked as system in BILLmanager to prevent accidental client assignment. Display of system VMs in the discovery table can be controlled via filter;
External ID — service identifier in VMmanager 6;
Name — VM name;
Owner — email of the VM owner in VMmanager 6:
- — user found;
- — user not found;
IP address — primary VM IP address;
Domain — VM domain;
Configuration — VM configuration as stored in VMmanager 6: number of virtual CPUs / RAM size / disk size;
OS — VM operating system;
Cluster — VMmanager 6 cluster name;
VM state — VM status in VMmanager 6 (e.g., "Active" or "Stopped");
Node/Storage — node and storage where the VM is located;
Service ID — service identifier in BILLmanager. Clicking the link opens the services table filtered by the selected service;
Provider — service provider;
Client — client who ordered the service;
Creation date — service creation date;
Service state — service status in BILLmanager.

In some cases, certain fields remain empty. For example, if a service or VM has not been created, the columns related to it will be blank.

Possible actions

The platform administrator can perform the following actions:

Start — click to generate the list;
Assign — click to assign a free VM to a client. A new service will be created. Group assignment is not available;
Information — click to:
- mark the service as system;
- add or edit a service comment;
Delete — click to delete a VM in VMmanager 6 or a service in BILLmanager. This action also removes the selected row from the list;
Restore — click to create a VM in VMmanager 6 based on the service parameters for the selected row. Bulk creation is not available.

Assigning VM to a client

Before assigning VM to a client, ensure the client account is created and properly configured. See Managing clients for details.

To assign a VM to a client, go to Integration → Processing modules → select the VMmanager 6 module → Autodiscovering → select a VM → click Assign:

Select the Client to whom the VM will be assigned.
Click Next.
Configure the Tariff:
1. Select the service Provider. The list includes providers connected to the selected client.
2. Select the Tariff plan under which the service will be billed. The list is based on tariffs linked to the selected handler.
Click Next.
Configure the service Parameters:
1. Select the Effective date from which the VM will be assigned.
2. Select the service Period:
  - month;
  - six months;
  - year.
3. Enable Auto-renewal if the service should automatically renew after expiration.
4. Configure VM Resources:
  1. Disk space, MiB — disk storage volume;
  2. Control panel license — type of control panel license provided with the VM (e.g., ispmanager). Selected from the list available in VMmanager 6. See Control panel licenses. VMmanager 6 for details;
  3. Name servers — DNS servers automatically assigned to the VM on creation. Uses cluster settings configured in the handler;
  4. RAM, MiB — RAM volume;
  5. CPU, MHz — computing power of a single CPU core;
  6. CPU number, units — number of virtual CPU cores (vCPU);
  7. Public IPv4 addresses, pcs — number of allocated public IPv4 addresses;
  8. IPv6 addresses, pcs — number of allocated IPv6 addresses;
  9. Operating system — operating system installed on the VM.
    
    If the actual resource allocated to the VM exceeds the tariff limit, it will be automatically capped at the tariff value. For example, if the VM has 6 GiB of RAM but the tariff allows only 2 GiB, the RAM will be reduced to 2 GiB when the service is assigned.
Click Finish.

Creating a VM for a Service

To create a VM for a service, go to Integration → Processing modules → select the VMmanager 6 module → Autodiscovering → select a VM → click Restore.

The system invokes the VMmanager 6 module, creates a current operation, and initiates VM creation using the service parameters. After successful completion, the service card is automatically populated with VM data, such as name, IP address, domain, configuration, etc. For details on parameters, see the Table structure section.

Useful tips