Processing module. VMmanager

Integration between BILLmanager and VMmanager allows a service provider to offer virtual servers to his customers.

After a client has ordered a service, BILLmanager sends the API request to VMmanager to create a virtual machine. The service is activated in BILLmanager (its status is "Active") after OS deployment on the virtual server. 

Integration with VMmanager

Integration is configured in the process of creating a service processing module in BILLmanager.

To create a service processing module, enter Integration → Processing modules → click Add. The processing module adding wizard consists of the following steps:

1. Product type: select "VPS".
2. Processing module: select "VMmanager".
3. Integration settings. Specify the data for integration:
   
   1. URL — enter a full URL to the control panel where services will be activated. Be sure to specify /vmmgr at the end of the URL.
   2. Username — enter the name of the VMmanager user. You need to enter the credential of the "Administrator' user role. With this username, BILLmanager will manage (create, suspend) accounts in VMmanager.
   3. Password — enter the user password.
   4. Use pool — enable/disable the pool of virtual servers.
   5. IPmanager — select a server that will allocate IP addresses.
4. Processing module parameters. Configure internal (within BILLmanager) parameters of the service processing module:
   1. Data center — select the data center in BILLmanager to which the processing module will be connected.
   2. Name — specify the name of the processing module to be displayed in the BILLmanager interface.
   3. Department — select the department to which tasks from the processing module will be assigned.
   4. Sort — specify the processing module’s priority. If more than one processing module is connected to a tariff plan, the processing module with the lowest priority is selected first when creating the service.
   5. Use recipes — the option of using recipes when ordering a server.
   6. Completion of server deployment — the status of server installation completion. Possible values: "After template setup", "After recipe setup".
   7. Run operations in the queue — when this option is enabled, all identical operations with servers will be performed consecutively.  A separate task queue is created for each operation type. Only one task of the queue can be performed at any given time.

Pool of servers

A pool of servers can be used for creating virtual servers that customers can order in the future. This feature allows reducing server activation time.

A pool is where pre-defined VPSs are located. If a client orders the server with the configuration that can be found in the pool, a new server won't be created, as the system will allocate it from the pool. Learn more about the server pool.

• Client — the selected client will be the owner of all the virtual machines created in the pool. This client is automatically given a 100% discount on VPS.
  Example: you need to add a virtual machine with certain parameters into the pool: CentOS 7, 10 GiB disk space, 2 GiB RAM and one-core CPU.  To do this, BILLmanager sends to VMmanager a request to create a virtual machine with specific parameters. After the virtual machine is created, its owner will be the user-pool.
  When a client orders the VPS with CentOS 7, 10 GiB disk space, 2 GiB RAM and one-core CPU, a new virtual machine won't be created as it can be found in the pool. The system will change the owner of that machine from the user-pool into the client who placed the order.  
• Maximum period in pool — the maximum period in months that will pass before a virtual machine will be deleted from the pool. When the specified period is over, the server will be deleted automatically. 
• Calculate statistics for — when calculating statistics the system will count only the virtual machines created for the last N days. N is the value specified in this field. Statistics on ordered servers will be collected right after the server is added to the pool. 
• Ordered servers (0 < VPS <= 3) — the number of servers that will be added into the pool, if up to 3 servers were sold. 
• Ordered servers (3 < VPS <= 6) — the number of servers that will be added into the pool, if 3 to 6 servers were sold.
• Ordered servers (6 < VPS <= 10) — the number of servers that will be added into the pool, if 6 to 10 servers were sold.
• Ordered servers (10 < VPS <= 15) — the number of servers that will be added into the pool, if 10 to 15 servers were sold.
• Ordered servers (0VPS >15) — the number of servers that will be added into the pool, if more than 15 servers were sold.

Integration with IPmanager

When you integrate VMmanager with the billing system, the Wizard will ask you to integrate them with IPmanager for centralized management of IP addresses. 

Here you need to select the integration that you have already configured.