{"id":796,"date":"2017-11-14T20:54:48","date_gmt":"2017-11-14T20:54:48","guid":{"rendered":"http:\/\/kb.powercode.com\/?post_type=ht_kb&p=796"},"modified":"2020-01-22T17:25:15","modified_gmt":"2020-01-22T17:25:15","slug":"mikrotik","status":"publish","type":"ht_kb","link":"https:\/\/kb.powercode.com\/?ht_kb=mikrotik","title":{"rendered":"MikroTik"},"content":{"rendered":"

The Mikrotik BMU Integration<\/strong> allows you to use Mikrotik Routers already in your system as\u00a0Powercode BMU (Bandwidth Management Unit)\u00a0<\/strong>devices.<\/strong> Powercode uses the Mikrotik API to allow a Mikrotik BMU<\/strong> to rate limit, redirect traffic, and assign IP addresses via DHCP according to Customer Account<\/strong> information in Powercode in addition to the existing native Mikrotik functionality.<\/p>\n

The\u00a0Mikrotik BMU Integration\u00a0<\/strong>requires deployment of a small server running Powercode’s Virtual BMU software<\/a> for SNMP<\/strong> and Monitoring<\/strong> functionality.<\/p>\n

Please reach out to Powercode support for recommended specifications if you intend to use this functionality.<\/p>\n

Add a MikroTik BMU<\/h3>\n \t\t
\r\n \t\t\t \t\t\t \t\t\t\t

\r\n \t\t\t\t\tIn the MikroTik router itself you will need to enable API access. This is located under\u00a0\u00a0IP > Services<\/strong> within the Winbox gui pane. \t\t\t\t<\/p>\r\n \t\t\t \t\t\t\r\n \t\t<\/div>\r\n \t\t\n \t\t

\r\n \t\t\tBackup your Router!<\/span> \t\t\t \t\t\t\t

\r\n \t\t\t\t\tPlease download a config backup from your Mikrotik Router in a known good configuration before connecting the router to Powercode! While the Powercode Mikrotik integration should not interfere with your Mikrotik’s Routing functionality, we make no guarantees that the device will behave as you expect after activating the integration. \t\t\t\t<\/p>\r\n \t\t\t \t\t\t\r\n \t\t<\/div>\r\n \t\t\n

The first step is to add the MikroTik RMU in to Powercode<\/p>\n

    \n
  • Navigate to Network->BMU Overview<\/li>\n
  • Click the “Add New BMU” button on the left<\/li>\n
  • Click the “MikroTik” button for “Type of BMU”<\/li>\n<\/ul>\n

    \"\"<\/p>\n

     <\/p>\n

      \n
    • Enter in the Name, IP Address, Username and Password of the MikroTik<\/li>\n
    • The account entered in to the MikroTik should have administrator access<\/li>\n
    • Enter in the IP address for “delinquent” and “contract” customers to be redirected to<\/li>\n
    • Select the applicable mirror group, if any<\/li>\n
    • Select which options to enable on this MikroTik (DHCP, Rate Limiting, Redirect And Accept Relay Requests)<\/li>\n
    • Enter in the IP Address to accept relay requests on if applicable<\/li>\n
    • Save your changes<\/li>\n<\/ul>\n

      Powercode will redirect you back to the BMU Overview screen.<\/p>\n

      \"\"<\/p>\n

       <\/p>\n

      Configure an Address Range<\/h3>\n

      The next step is to configure an address range for your MikroTik<\/p>\n

        \n
      • In the dropdown menu on the left side of the MikroTik you just entered, select “Configure BMU”<\/li>\n
      • Fill in the relevant information for your MikroTik<\/li>\n
      • If your MikroTik handles DHCP, you will need to select “Enabled” under “DHCP Server” and enter in the DHCP information as well<\/li>\n
      • On address ranges under a MikroTik or in a mirror group with a MikroTik, you will get an “interface” field for each MikroTik in the group. This is the port that the MikroTik will use for the DHCP Server with this address range<\/li>\n
      • Save your changes<\/li>\n<\/ul>\n

        \"\"<\/p>\n

        On saving, Powercode will bring you back to the “IP Address Ranges” tab on the BMU Configuration page.<\/p>\n

        \"\"<\/p>\n

         <\/p>\n

        Add a Slave BMU (optional)<\/h3>\n

        If you need to add a Powercode BMU as a slave, you may do so under the “Slave BMUs” tab on this page.<\/p>\n

          \n
        • Click the “Slave BMUs” tab<\/li>\n
        • Click the “Add New Slave BMU” button on the left<\/li>\n
        • Powercode BMU will be the only choice for a slave BMU<\/li>\n
        • Enter in the IP Address and API Key of the Powercode BMU<\/li>\n
        • Save your changes<\/li>\n<\/ul>\n

          \"\"<\/p>\n

          Upon saving, Powercode will return you back to the “Slave BMUs” tab on the BMU Configuration page.<\/p>\n

          \"\"<\/p>\n

           <\/p>\n

          Synchronize the MikroTik<\/h3>\n

          Now that you have configured the MikroTik and given it an address range, it’s time to synchronize the information with the MikroTik. This can be done either on the “Configure BMU” page, or the BMU Overview.<\/p>\n

          To synchronize at the “Configure BMU” page, simply click the “Synchronize BMU” button on the top left.<\/p>\n

          To synchronize the MikroTik from the BMU Overview:<\/p>\n

            \n
          • Navigate to Network->BMU Overview<\/li>\n
          • The MikroTik should be in “Good” status, and should have automatically populated the Model and Version fields.<\/li>\n
          • If the MikroTik is not in “Good” status, check to see that you have entered in the IP Address, Username and Password correctly.<\/li>\n
          • Click “Synchronize” under the MikroTik’s dropdown menu under “Action” on the right<\/li>\n<\/ul>\n

            \"\"<\/p>\n

            Your MikroTik will change to “Synched” under “Sync State” after successfully pushing the information. If the MikroTik doesn’t synchronize, make sure all of the information you entered is correct and try again.<\/p>\n

            Add a MikroTik as a Slave (optional)<\/h3>\n

            You can also add a MikroTik as a slave to a Procera RMU.<\/p>\n

              \n
            • Navigate to Network->BMU Overview<\/li>\n
            • Click on “Configure BMU” in the dropdown on the applicable Procera<\/li>\n
            • Navigate to the “Slave BMUs” tab<\/li>\n
            • Click on the “Add New Slave BMU” button on the left<\/li>\n
            • You will notice that you now have th option of “MikroTik” in addition to “Powercode BMU”<\/li>\n
            • Click on “MikroTik” under “Device Type”<\/li>\n
            • Enter in the IP Address, Username and Password of the MikroTik<\/li>\n
            • Save your changes.<\/li>\n<\/ul>\n

              \"\"<\/p>\n

              Upon saving, you will be redirected to the “Slave BMUs” tab of the Configure BMU page.<\/p>\n

              MikroTik Actions<\/h3>\n\n\n\n\n\n\n\n\n\n\n\n\n\n
              Powercode Action<\/th>\nMikroTik Action<\/th>\n<\/tr>\n
              Synchronize<\/td>\nCreates DHCP server, DHCP network, DHCP leases, DHCP options, simple queues, filter rules, NAT rules and Address list based on information entered and options selected<\/td>\n<\/tr>\n
              Change Customer Status<\/td>\nAdds or removes customer from delinquent list.<\/td>\n<\/tr>\n
              Add\/Change Customer Service<\/td>\nUpdates rate limits in customer’s queue<\/td>\n<\/tr>\n
              Add Customer Equipment<\/td>\nAdds DHCP lease and and queue for equipment<\/td>\n<\/tr>\n
              Edit Customer Equipment<\/td>\nEdits DHCP lease and queue for equipment<\/td>\n<\/tr>\n
              Delete Customer Equipment<\/td>\nRemoves DHCP lease and queue for equipment<\/td>\n<\/tr>\n
              Update Service<\/td>\nUpdates queues of customers on this service<\/td>\n<\/tr>\n
              Delete Service<\/td>\nDeletes or updates queues of customers depending on option selected while deleting service<\/td>\n<\/tr>\n
              Update Address Range<\/td>\nUpdates DHCP server, DHCP network and address list for range. Then updates customers on that address range<\/td>\n<\/tr>\n
              Delete Address Range<\/td>\nRemoves DHCP server, DHCP network and address list for range<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n","protected":false},"excerpt":{"rendered":"

              The Mikrotik BMU Integration allows you to use Mikrotik Routers already in your system as\u00a0Powercode BMU (Bandwidth Management Unit)\u00a0devices. Powercode uses the Mikrotik API to allow a Mikrotik BMU to rate limit, redirect traffic, and assign IP addresses via DHCP according to Customer Account information in Powercode in addition to…<\/p>\n","protected":false},"author":4,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":[],"ht-kb-category":[35,6,27],"ht-kb-tag":[],"_links":{"self":[{"href":"https:\/\/kb.powercode.com\/index.php?rest_route=\/wp\/v2\/ht-kb\/796"}],"collection":[{"href":"https:\/\/kb.powercode.com\/index.php?rest_route=\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/kb.powercode.com\/index.php?rest_route=\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/kb.powercode.com\/index.php?rest_route=\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/kb.powercode.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=796"}],"version-history":[{"count":17,"href":"https:\/\/kb.powercode.com\/index.php?rest_route=\/wp\/v2\/ht-kb\/796\/revisions"}],"predecessor-version":[{"id":1398,"href":"https:\/\/kb.powercode.com\/index.php?rest_route=\/wp\/v2\/ht-kb\/796\/revisions\/1398"}],"wp:attachment":[{"href":"https:\/\/kb.powercode.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=796"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/kb.powercode.com\/index.php?rest_route=%2Fwp%2Fv2%2Fht-kb-category&post=796"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/kb.powercode.com\/index.php?rest_route=%2Fwp%2Fv2%2Fht-kb-tag&post=796"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}