Configuring the service_hook Script for Mikrotik

Edit the BillMax service_hook script to enable the MikroTik provisioning program to execute provisioning actions when customer services are created, updated, suspended, or closed.

MikroTik provisioning in BillMax is performed by the mkmkq.pl program. Like other BillMax provisioning programs, mkmkq.pl is called from the service_hook script. You must add a configuration hash to service_hook that maps the MikroTik resource to the appropriate provisioning actions (Create, Suspend, Close, Enable, and others).

Before performing these steps, confirm the resource number assigned when you created the MikroTik provisioning resource in the preceding task.

  1. Open the service_hook script for editing.
  2. Locate the SERVICES hash at the top of the file.
  3. Add the following configuration block after the existing entries in the SERVICES hash, replacing N with the resource number assigned to the MikroTik resource: 
    my $cmd = "$BILLMAXDIR/local/mkmkq.pl";

$SERVICES{N}{name}      = "mklist";
$SERVICES{N}{provision} = "yes";
$SERVICES{N}{data}      = [ "-i1", "{NEW_state}",
                                "-i2", "{NEW_d03}",
                                "-i3", "{NEW_d04}",
                                "-i4", "{NEW_d01}" ];
$SERVICES{N}{cmd}{create} = "$cmd -a create";
$SERVICES{N}{cmd}{delete} = "$cmd -a delete";
$SERVICES{N}{cmd}{update} = "$cmd -a update";
$SERVICES{N}{remotecmd}   = "";
    Note:
    The data array passes the service state, MAC address (d03), speed/address list (d04), and IP address (d01) to the provisioning program for each action.
  4. Save the service_hook script.

After saving the script, verify the configuration by creating a test customer account. On the service location, specify the Tower and Access Point as applicable. Create a Package or Service using a definition configured for MikroTik provisioning. Enter the IP address, MAC address, and confirm the speed field is pre-populated. If MAC addresses are inventoried, you will see the MAC address as a choice as well. Otherwise, the MAC address has to be manually entered. If you need to change a customer's (service) speed, do a Service Change instead. Save the service to trigger the service_hook and confirm provisioning completes successfully on the router.