Connecting external name servers

From ISPWiki
Jump to: navigation, search

In order to provide name servers to customers, you can integrate BILLmanager with external name servers.

Integration with external names servers can be configured only if the service processing module is VMmanager or DCImanager.

Navigate to the "Name servers" module:

First, select one of the following control panels:

  • DNSmanager 5
  • ISPmanager 5
  • ISPmanager 4

Then, enter access details to the control panel, and select how the newly created name server will be used.

External name servers can be used for:

  • A free domain name
  • Provider's name servers
  • Private name server

When do you need to use Provider's name servers and private name servers?

If you want to offer name servers for your customers' domains when they order a VPS or Dedicated server, you can create a Name server add-on for the tariff plan. This add-on is created in BILLmanager automatically for shared hosting service, but you need to create it for dedicated servers (Tariff plans --> Configuration).

In case of standard configuration, a client can choose whether he wants to use provider's name servers, or private name servers.

Provider's name servers

If the client chooses "Provider's name servers" while making an order, BILLmanager will select the first name server marked "provider's name server" in the corresponding module, and will create a new user in the control panel. The client will receive a Welcome email with access details to the control panel for name servers management.

In the email the client will see something like this:

DNS - name servers configuration 

You chose "Provider's names servers". Log in to '''ISPmanager''' ---> '''Domain names''' and complete the following steps: 

"NS" - Slave name servers. You will see the following parameters:

Panel URL: https://domain.dnsmgr.com:1500/dnsmgr (do not follow this  URL, read the information above)
Username: user
Password: wfS8OWMBCu10
"Settings" - Default settings for domains.

Make sure that "ns1.domain.ru. ns2.domain.ru." are specified in the  "Name servers" field.


For provider's name servers only DNSmanager 5 can be used. To set up integration, you need to use a reseller created in DNSmanager. A new user associated with that reseller will be created, and reseller's name space will be used. Such a scheme allows to economize IP addresses, as all of the reseller's users will use the IP address allocated to that reserller.

Private name servers

If the client choose "Private name server" when he orders a service, BILLmanager selects the first name server marked "private name server" in the corresponding module, and creates a new user in the control panel. The client will receive a Welcome email with access details to the name server's control panel.

For private name servers only DNSmanager 5 can be used. To set up integration, you will need the reseller account created in DNSmanager. A new user associated with that reseller will be created, BUT he will use separate name space. Each user will require a separate IP address.

How to automate integration between ISPmanager and DNSmanager

When a client orders, let's say, a virtual server with ISPmanager and select "Provider's name servers", BILLmanager will create an account on the external name server for the client (let's assume that the external name server is managed by DNSmanager), but it won't integrate ISPmanager with DNSmanager automatically.

For automatic integration, you need to tell us the domain name of your BILLmanager, and we will specify it for your account at my.ispsystem.com.

Once completed, every ISPmanager license that was ordered from your account at my.ispsystem.com, will contain settingurl allowing for automatic configuration of ISPmanager with DNSmanager.

settingurl can be used for a wide range of tasks. For more information please refer to this article External configuration of applications.

Why do I need a name server for a free domain name?

BILLmanager enables to offer a free subdomain in the provider's space. You should specify a zone for a free domain in the tariff plan's configuration form. Why do we need it? If a client did't provide a domain name (for example, he didn't have a domain, and left the field blank), BILLmanager will automatically a subdomain from the provider's zone into the "Domain" field. And the subdomain will be automatically created on the name server for the free domain name. The IP address of that subdomain will redirect to the service IP address.

I.e. when ordering a service, the client will be automatically allocated a third-level domain, which is already associated with the service IP address.

DNSmanager 5, ISPmanager 5 and ISPmanager 4 can be used for the name server for a free domain name. You should enter user's (not reseller's) access details. For the user be sure to create a domain where the domain of the 3th level will be created.

Please note: you shouldn't use the same ISPmanager as the name serve for a free domain name, as you use for hosting. Moreover, you shouldn't create a domain, on which the free domain name is provided in ISPmanager, where the hosting service is running.

Free domain name and shared-hosting

There are a large number of variants of how it can be imlemented, we'll give a few examples.

Technical domains in ISPmanager 5 Business

In ISPmanager 5 Business you can use technical domains. In this case you don't need to perfrom any configurations in BILLmanager. For more information about configuration of ISPmanager Business please refer to this article.

  • Create a technical domain in ISPmanager Business.
Pic 483-en.png
Pic 484-en.png
  • Bee sure to allow technical domains for a user template, that is specified in the tariff plan in BILLmanager.
Pic 485-en.png
  • You don't need to perform any configuration in BILLmanager.


Once completed, activating a shared hosting service will create a new user in ISPmanager based on the template that can use technical domain. When creating a WWW-domain in ISPmanager Business, the user will be able to activate his technical domain username.technical domain.

Record is created in ISPmanager

Let's assume that your ISPmanager is used as ns1, and DNSmanager, which is integrated with the panel, is used as ns2 (you can configure private name servers as described in this article). We will create a free domain name username.mydomain.com for providing shared hosting.

  • Navigate to tariff plan --- free domain template --- leave the "Server" field blank.
Pic 4877-en.png
  • Make sure that the mydomain.com doesn't exist in the panel, or administrators are allowed to "mix" domains.

Once completed, activating a shared-hosting service will create a new user and the free domain name username.mydomain.com in ISPmanager.If mydomain.com already exists in ISPmanager, the А record for the username.mydomain.com. will be created.

A welcome email will contain information about that free domain name.

Please note! A client should not specify a domain name during the order procedure. Otherwise, a free domain name won't be allocated.

Record is created in DNSmanager

If you have several ISPmanager, and name servers are located on the server with DNSmanager, a free domain name record must be created in DNSmanager.

  • In order to integrate BILLmanager with DNSmanager, navigate to Integration - Name server (you can perform this opration with user or reseller privileges) . Check the "Free domain name" box.
Pic 489-en-en.png
  • Log in to DNSmanager as a reseller (or user) that was used for integration, and create a master domain name mydomain.com. Activating a shared-hosting service in BILLmanager will create the А record for that domain for subdomains like username.mydomain.com.
Pic 490-en.png
  • Make sure in ISPmanager there is no mydomain.com or administrators can mix domain names.
  • Navigate to "Tariff plans" and select DNSmanager that you have integrated on step.
Pic 491-en.png

Once completed, activating a shared-hosting service will create a user in ISPmanager, and a free domain name record will be created in DNSmamager.


Please note: a client should not specify a domain name during order, otherwise the free domain won't be allocated.