Updated
Migrate to DataRadius
Move subscribers, plans and balances from your current billing system to DataRadius without downtime.
Overview
DataRadius is ISP billing and management software that connects to your routers, collects payments and manages subscriber access automatically. Migrating from another system — whether it is Splynx, UISP, User Manager, Mikhmon, spreadsheets or another platform — follows the same four steps: export your data, import it into DataRadius, run both systems side by side, and move routers one at a time.
The process is designed so your subscribers keep their internet throughout. No bulk disconnection, no weekend outage.
Before you start
Confirm you have:
- Admin access to your current system so you can export subscriber data.
- Terminal access to your routers (Winbox, SSH or WebFig) to run the DataRadius setup command.
- A DataRadius workspace — sign up at dataradius.net if you have not already. The 14-day trial includes everything.
- Payment provider credentials configured in DataRadius (see Accept Payments).
Step 1 — Export your subscriber data
Export a CSV from your current system with these columns:
| Column | Required | Description |
|---|---|---|
| Name | Yes | Subscriber's full name. |
| Phone | Yes | Mobile number for billing and notifications. |
| PPPoE username | If PPPoE | The username used for PPPoE authentication. |
| Plan name | Yes | Current plan assignment (must match a plan you create in DataRadius). |
| Balance | No | Outstanding credit or debt, in your local currency. |
| No | Used for portal access and notifications. |
Most billing systems have a subscriber export feature. For Splynx, use Customers → Export. For spreadsheets, save as CSV with the column headers above.
Step 2 — Set up DataRadius
If you have not already:
- Create your billing plans in DataRadius to match the plans in your current system. Use the same names so the import maps correctly. See PPPoE Plans or Hotspot Portal.
- Connect your payment provider — see Accept Payments.
- Add one test router — see Add Your First Router. Verify it comes online and a test subscriber can connect and pay.
Step 3 — Import subscribers
Navigate to Subscribers → Import in the DataRadius dashboard. Upload your CSV file.
DataRadius validates every row before importing:
- Names and phone numbers are required.
- Plan names must match an existing plan in your workspace.
- PPPoE usernames must be unique.
- Duplicate phone numbers are flagged for review.
After validation, click Import. DataRadius creates each subscriber, assigns their plan, and provisions their PPPoE credentials in RADIUS. Subscribers with balances have their account credited or debited accordingly.
The import runs in the background. Large files (1,000+ subscribers) complete within a few minutes.
Step 4 — Run both systems side by side
Keep your old system running. Your routers still point to it, and subscribers stay connected as normal.
Pick one router — ideally a small site with a few subscribers — and run the DataRadius setup command on it (see Add Your First Router). Within 60 seconds, that router connects to DataRadius.
Verify on the DataRadius dashboard:
- The router shows as Online.
- Its subscribers appear with the correct plans.
- A test payment activates a subscriber.
If anything is wrong, remove the DataRadius configuration from the router and it falls back to your old system immediately.
Step 5 — Move remaining routers
Once the first router is verified, move the rest. You can move them one at a time or in batches — the pace is up to you.
For each router:
- Run the DataRadius setup command.
- Confirm it appears online in the dashboard.
- Verify a subscriber payment works.
Subscribers on routers you have not moved yet continue on your old system. There is no pressure to move everything at once.
Step 6 — Verify and decommission
After all routers are on DataRadius:
- Compare active subscriber counts — the total in DataRadius should match your old system.
- Compare revenue — run a collections report for the same period in both systems. The numbers should match.
- Wait at least one billing cycle — let renewals, suspensions and reconnections run through DataRadius to confirm everything works end to end.
When you are satisfied, decommission your old system. Export a final backup from it for your records.
Tips for a smooth migration
- Move your smallest site first. If it has 10 subscribers instead of 200, any issues affect fewer people and are faster to resolve.
- Keep your old system running until you are confident. There is no cost to running both in parallel for a few days.
- Tell your subscribers. A brief SMS — "We are upgrading our billing system. Your internet will not be affected." — prevents support calls.
- Check payment callbacks. After moving a router to DataRadius, confirm that payments from subscribers on that router arrive in DataRadius, not your old system.
- Export your old data before decommissioning. Once you shut down the old system, you may not be able to recover historical records.
Troubleshooting
Subscribers cannot connect after moving a router
The most common cause is a PPPoE username mismatch — the username in DataRadius must exactly match what the subscriber's CPE is configured with. Check the subscriber detail page in DataRadius and compare with the CPE settings.
Payments going to the old system
If your payment provider's callback URL still points to your old system, payments will not reach DataRadius. Update the callback URL in your provider's dashboard, or let DataRadius register it automatically by re-saving your credentials in Settings → Payments.
Balance discrepancy
If account balances differ between systems, export both and compare per subscriber. Common causes: pending payments that cleared after the export, or timezone differences in billing cycle boundaries.