MikroTik Configuration in BillMax

Configure the BillMax system settings required for MikroTik router integration.

These steps describe the settings within the BillMax system that must be configured for MikroTik integration. BillMax must know how the routers are deployed in your network. There are two deployment options:

  • Tower (POP): Use when address management is tower-wide and routers are associated with towers.
  • Access Points (AP): Use when routers are associated with individual access points.
  1. Change the ip_asset_association setting in the systemstate list.

    Valid values are pop or ap. For most WISPs, pop is typically the correct setting.

  2. Set the pop_ap_on_service setting in the systemstate list.

    This setting controls whether the Tower (POP) is held on the service location (user in BillMax) or the package or service. The default value of 0 holds POP and AP on the user, which is the typical setting for most WISPs.

  3. Create a custom field to hold the router IP address.

    Navigate to System Administration > Provisioning > Custom Field Definitions.

    1. Click New and set the following fields:
      • Name: Pop fields
      • Table: pop (or ap if using addresses by AP)
    2. Click Add and set the following field properties:
      • Name: cdf1
      • Label: Router IP
      • Constraint List: [[:ipaddr:]]
      • Required: Yes
    3. Click Save.
  4. Create a custom field to hold the DHCP server name.
    Note:
    The MikroTik integration creates DHCP leases using MAC addresses from the BillMax Package or Service record. BillMax requires the name of the DHCP server configured in the router to enable this functionality.

    Navigate to System Administration > Provisioning > Custom Field Definitions.

    1. Select the Pop fields entry.
    2. Click Add and set the following field properties:
      • Name: cdf2
      • Label: DHCP Server
      • Required: Yes
    3. Click Save.
  5. (If using Assets) Create an IP address asset definition and generate IP addresses for each tower.
    Tip:
    The IP address for customer services can be managed through Assets or by entering and tracking addresses manually. The following sub-steps apply only if you are using Assets.
    1. Create an Asset definition for IP addresses.

      Navigate to System Administration > Operations > Asset Definitions. Click New and set the following fields:

      • Name: IP addresses
      • Description: IP addresses
      • Asset Class: IP Addresses
      • Asset Key: IP Addresses
    2. Generate IP address assets for each tower.

      Select the previously configured Tower and click Generate IPs from the page menu. Enter the netmask that defines the IP addresses to create, then click Generate IP Address to create the IP address assets.

After completing the BillMax system configuration, proceed to Configuring Package and Service Definitions for MikroTik Provisioning to configure Package and Service Definitions for MikroTik provisioning.