Reselling ISPsystem software via BILLmanager

From ISPWiki

Jump to: navigation, search

Contents

Reselling licenses as a separate service

Configuring service package

1. Go to the Features module to enable "ISPsystem software".
2. Go to the Item types module to select the "Server required" check box for the Software type .
3.Go to the Server management module to add a new server and specify the following parameters:

  • Control panel - BILLmanager(cpbillmgr).
  • Username - enter a username who may order licenses at my.ispsystem.com,(this user must have full privileges)
  • IP address- my.ispsystem.com

4. Once completed, select the server, click the "Edit" icon and in the "Configuration" tab check the following:

 Preset 5-ISPmanager Lite
 Preset 9-ISPmanager Pro

5. Add packages:

 Let's consider reselling of ISPmanager Lite (with support)
 Item type - Software
 Internal name - 5-ISPmanager Lite (it is taken from the server configuration)
 Billing type - by ordered period
 Agreement - Strongly recommended. Otherwise errors may occur while ordering a service. 

6. For a newly created package select the server that has been added on the 3d step.

7. You should add periods for the newly created server.

Selecting order periods

They must correspond to the periods specified in ISPsystem, or some of they may be missing. Those missing in ISPsystem, won't work.

 ISPmanager Lite and ISPmanager Pro:
   trial period - 14 days.
   1 month
   3 months
   1 year
   lifetime
 ISPmanager Lite (without support) and ISPmanager Pro (without support):
   trial period - 14 days.
   1 month
   lifetime

Additional information

  • Add a new cron job:
 */5 * * * *	/usr/local/ispmgr/sbin/cpbillmgr checkevent
  • BILLmanager 4.0.50 and later supports order periods that do not correspond to those specified in ISPsystem's billing. For example, if you wish to purchase a 1 month license in your billing, you will be able to purchase a lifetime license in the ISPsystem billing.

To do that you need to create a file [path to the BILLmanager folder (/usr/local/ispmgr)]/etc/cpbillmgr.conf is used by dafault)

If you are integrated with BILLmanager 5, the configuration file is /usr/local/ispmgr/etc/cpbillmgr5.conf

File format:

 Period[space][Order period in your billing][Space][Period ID in the ISPsystem billing][end of line]

Example:

 Period 2 9
 Period 3 10

Order period Ids in the ISPsystem billing can be found in the article Ordering ISPsystem software licenses through BILLmanager API

  • BILLmanager 4.0.77.1 and later enables you to order licenses for the second time, i.e. deleting a license in your billing system will suspend it and its name will change into free.lic. Later, if in your billing system the license from the corresponding package is ordered, that license will be used for the second time.

Note! You can re-use only the license which name is specified as free.lic, and its IP address is 0.0.0.0.

In the configuration file specify the option:

Option ReUseLicense

And for each service package for which the license can be re-used, specify the following:

ReusePrice package_id

where package_id is the identification number of the service package or add-on in your BILLmanager.

You can also use a different license when changing a service package rather than upgrading/downgrading the package of the existing license. Specify the option

Option UseExistingOnUpgrade

If BILLmanager does not find a corresponding license, a new one will be ordered (in the first case) or the service package of the current one will be changed (the second case).

  • Attention: licenses with a 100% discount cannot be renewed automatically.

A license won't be taken from a pool of free licenses when renewing the license. Only a new license can be taken from the pool.

Reselling licenses as service package add-ons

BILLmanager 4.0.74 and later (we recommend using 4.0.74.6 and later) you can automatically sell ISPsystem's licenses as add-ons to service packages. You can use all built-in item types for which IP address is specified.

General settings

Perform 1 through 4 in the "Configuring service packages" above. Once you are done, configure the service packages for your main services and add-ons to service packages.

Configuring add-ons to service packages

Orders can be automatically processes for the add-ons having the following internal 'panel', 'vdsmgr', 'ispmgr', 'dnsmgr', 'ipmgr', 'vmmgr', 'billmgr', 'ifxmgr'. In the add-on edit form select the server that will automatically process order for licenses.

Add-ons can have the the following values: "Enumeration" or "Logic". In the first case for ordering a software products, the enumeration's internal name will be used, in the second - the internal name of the type associated with that add-on.

Once configure, the licenses will be provided automatically in the following cases: the add-on is defined by enumeration having the following internal names 'Lite' and 'Prof' or the internal names containing a service package id specified in the remote billing, besides, order periods match the licenses order periods in ISPsystem's BILLmanager.

Otherwise, you will need to configure in the cpbillmgr.conf configuration file (the directory /usr/local/ispmgr/etc/).

Note!

If you configure reselling through BILLmanager 5 (the main server is running BILLmanager 5):

  • The internal name Lite means ISPmanager 5 Lite rather than ISPmanager 4 Lite.

If you configure reselling through BILLmanager 4 (the main server is running BILLmanager 4):

  • The internal name Lite means ISPmanager 4 Lite
  • The internal name Lite5 means ISPmanager 5 Lite

Configuration file settings

For selling licenses as add-ons, if the license type is not specified as an enumeration or if the internal name of the enumeration element does not contain a service package id from the remote billing, you need to edit the configuration file of the module cpbillmgr - /usr/local/ispmgr/etc/cpbillmgr.conf

You should specify here the correspondence of the internal name of the enumeration element or the add-on type and service package specified in the remote billing, as well as correspondence of order periods of the main server to the license order periods. Please the note, that several service packages from the remote billing will correspond to one service package of the main service.

Specify the the correspondence between service packages:

Price internal_names service_package_in_remote_billing

Specify the the correspondence between order periods:

Period period_id_in_local_billing period_id_in_remote_billing package_id_in_remote_billing

In BILLmanager 4.0.77.18 and later you can specify order periods with external billing for any period in the local one:

Period ALL external_billing_order_period_id external_billing_package_id

Let's consider the following configuration:

  1. The virtual server service package has the following order periods: 1, 3, 6 and 12 month having the ids 10, 11, 12 and 13 correspondingly.
  2. A standard enumeration with ISPmanager is specified as the package add-on, optionally, ISPmanager 5 can be ordered (add-on type has the internal name тип ispmgr, its value type is logical).
  3. A 1-month license is required for a virtual server that is ordered for 1 month, lifetime licenses are required for other order periods.

cpbillmgr.conf for this service package will look like this:

Price ipmgr 2891 	# correspondence of the service package for IPmanager 5
Period 10 8 7 		# correspondence of 1-month order period for ISPmanager Lite
Period 10 16 11 	# correspondence of 1-month order period for ISPmanager Pro
Period 10 1815 2891 	# correspondence of 1-month order period for  ISPmanager 5
Period 11 9 7 		# correspondence of 3-month order period for ISPmanager Lite
Period 11 17 11 	# correspondence of 3-month order period for ISPmanager Pro
Period 11 1817 2891 	# correspondence of 3-month order period for ISPmanager 5
Period 12 9 7 		# correspondence of 6-month order period for ISPmanager Lite
Period 12 17 11 	# correspondence of 6-month order period for ISPmanager Pro
Period 12 1817 2891 	# correspondence of 6-month order period for ISPmanager 5
Period 13 9 7 		# correspondence of 12-month order period for ISPmanager Lite
Period 13 17 11 	# correspondence of 12-month order period for ISPmanager Pro
Period 13 1817 2891 	# correspondence of 12-month order period for ISPmanager 5

You do not need to specify correspondence for ISPmanager service packages, as they are specified by default (you can specify different values, if needed).

Additional information

Assigning existing licenses to services

Execute the following command to assign the licenses that are already ordered on the client's account through which you integrate with the remote billing, to virtual or dedicated servers

/usr/local/ispmgr/sbin/cpbillmgr fixchilds


  1. The module received a list of ordered licenses from the remote BILLmanager
  2. The module generates a list of virtual and dedicated server that require licenses that are not yet assigned to them
  3. If the list above contains a required license with the same IP address as the service's IP, the license will be assigned to that service.
  4. Otherwise, the module will order a required license.

If you do not want to order licenses for suspended services, add the following line into the module configuration file (cpbillmgr.log)

Option NoFixSuspended

Renewing licenses associated with services

A license is renewed regardless the renewal of the main services:

  1. The virtual server service package (payments are made by order periods)
  2. 1-month licenses are assigned automatically
  3. A client pays for the virtual server for 1 year (he also pays for the 1-year license), for example, 2013-01-01.
  4. The client gets the virtual server that will expire on 2014-01-01 and the license that will expire on 2013-02-01.
  5. On 2013-01-31, if the service is still active, the license will be renewed for one month more. If the client cancelled the server, the license won't be renewed.

Operations that can be performed with licenses when changing a service status

All the operations with the main service are also performed with the license. I.e. suspending the main service will also suspend the license (if this function is available to you), activating the main license will activate the service, etc.

Processing licenses if your server is integrated with VDSmanager

An ISPmanager license installed on a VPS is ordered after the virtual server is created.

Processing licenses if your server is integrated with VMmanager

An ISPmanager license installed on a VPS is ordered while installing the operating system on the server. It is required for correct installation of ISPmanager or another control panel during installation of the operating system.

Forming license name

The license name will be as follows: Item #MAIN_SERVICE_ID addon MAIN_SERVICE_NAME

FAQ

Q: I'm trying to order an ISPmanager Lite license and see the error message: The license with this IP address already exists. I'm sure that I only have ISPmanager Pro on my account

A:

  • If your ISPmanager Pro is not Lifetime, you won't be able to order ISPmanager Lite
  • If you have a lifetime ISPmanager Pro, you will be able to order ISPmanager Lite only in three months.
Was this helpful? Yes | No
Personal tools