First Time Setup
Getting Started With Jobs
Getting Started with Ticketing
Setting Sonar up for Billing
Getting Started with Accounts
Getting Started with Inventory
User Specific Resources
How To: Using Sonar's Customer Portal
Account Types: Overview & Example Use Cases
Account Statuses: Overview & Example Use Cases
Account Management View: Overview
Scheduled Events: Overview & Use Cases
Notes & Tasks: Best Practices & Use Cases
Child Accounts: Best Practices & How Tos
Disconnecting an Account
Account List View: Overview
CPUC June 2021: Instructions for Sonar V1
CPUC June 2021: Instructions for Sonar V2
Specify Account ID upon Creation
Lead Intake Form Processing
Account Groups: Overview & Example Use Cases
Serviceable Addresses: Overview and Usage
FCC Form 477: General Overview and Usage
Creating a New Account
Setting up Bank Account & Credit Card Processors
General Ledger Codes: Overview
Building a Data Service
Delinquency Billing Best Practices
Accounts in Vacation Mode
Batch Payments & Deposit Slips: Overview
Creating Discounts for Services and Packages
Setting Up Payment Methods and Taking Payments
Canadian ACH tool
Printed Invoice Batches: Overview
Delinquency Exclusions: Overview and Use Cases
Multi-Month Billing & Multi-Month Services
How to Take Bank Account Payments
Email Invoice Batch: Overview
ACH Batching: Overview
General Transactions: Best Practices
Usage Based Billing Policies: Overview and Usage
How to: Adding a Service to an Account
Usage Based Billing Policy Free Periods: Overview and Usage
Avalara: Overview & Setup
Print to Mail
Setting up an Outbound Email Domain
Triggered Emails: Setup
Call Logs: General Best Practices
Using the Mass Email Tool
Email Messages: Example Content
Email Categories: Overview & Use Cases
Phone Number Types: Overview and Use Cases
Email Variables & Conditions
Invoice Attachment Use Cases & PDF Examples
Invoice Messages: Overview & Use Cases
Invoices in Sonar: Examples, Creation & Contents
Webhooks in Sonar: Basic PHP Example
External Marketing Providers
The Sonar Field Tech App
How to Connect Preseem to your Sonar System
Tower Coverage Integration: Overview
GoCardless Integration: Overview & Setup
How to: Using Webhooks in Sonar
Setup of Inventory: Manufacturers, Categories, and Assignees
Inventory List View: Overview
Inventory Model Management: General Overview
Tracking and Using Consumable Inventory
Job Types: Best Practices
Setting Up Schedules General Overview
Applying Task Templates to Jobs
Example Jobs & Templates
Scheduling How-to: Creating and Booking a Job
Jobs and Scheduling: Overview
Building a Monitoring Template
Pollers: General Overview, Deployment Strategy, Build Out & Setup
Building Alerting Rotations
IP Assignments & Sonar
MikroTik: Setting Up a Sonar Controlled DHCP Server
IPAM: Basic Setup
MikroTik as an Inline Device: Integration With Sonar
MikroTik: Controlling Speeds
MikroTik: Controlling Access
Setting Up CoA Proxy
RADIUS: Building Reply Attributes
Data Usage Available Methods
Pulse, Polling, and PHP
Using Multiple Network Devices in Sonar
Cable Modem Provisioning
Assigning RADIUS Addresses
Controlling Customer Speeds with Sonar: General Overview
RADIUS: Build-Out & Integration with Sonar
Network Dashboard: Overview
Being Cloud Native
Building a Device Mapper
Sonar IP Addressing
Automating IP Assignments, Data Rates, and Network Access in Sonar
Assigning an IP Address Using Sonar's IPAM: How to
Network Sites: Management View Overview
Building RADIUS Groups
Building Address Lists
Finding your OIDs
User Role Creation & Best Practices
Removing a Terminated Employee In Sonar
Password Policy In Depth
Application Firewall: General Overview and Best Practices
Role Creation using GraphiQL
How to Best Use Global Search
How Your Data is Backed Up
How To Use GraphiQL to Understand the Sonar API
Frequently Used Terms
Sonar's Rich Text Editor
Mutations in the Sonar API
API Calls Using Third Party Applications - Personal Access Tokens
The New Sonar API
A Deeper Dive into the New Sonar API
Consuming the Sonar API
Filtering: Simple vs Advanced
Browser Compatibility and Minimum Hardware Requirements for Sonar
REST API Wrappers for V1 Compatibility
My Info: Your Personal User Settings
Troubleshooting the Customer Portal
Interacting with Files via the API
Customizing Your Customer Portal
Understanding Sonar Reports
How To Enhance Your Reporting With Custom Field Data
Sonar's Business Intelligence: Overview
Canned Replies Examples & Templates
Canned Reply Categories
Inbound Mailboxes Example Build
Ticket Categories Best Practices & Example Build
Exploring Ticket Groups
Using Parent Tickets
How to Integrate Inbound Mailboxes with Slack
Advanced Ticketing Features
Working With the Sonar Team & Additional Resources
Sonar Security Certifications
Best Practices for Fast Tracking a Support Request
How Sonar Bills Your Instance
The Sonar Status Page
Feedback Portal / Suggest a Feature
Sonar Casts Table of Contents
How to Request Termination of your Sonar Instance
Submitting Bugs vs. Feature Requests
Third Party Customer Support Referrals
Learning with Sonar: Tools and Resources
Table of Contents
Updated by Matt Glosson
Read Time: 3 mins
Getting your Sonar instance set up to use Cable Modem Provisioning is a straightforward process. Your Sonar instance will be able to natively integrate with Incognito in order to provide services and IP addresses to your customers using Cable Modems.
Setting up Incognito is done in 3 steps - the first is configuring the integration, the second is configuring the Address Lists for customer access, and the last is configuring Inventory Models in your Sonar instance to work with Incognito.
- Go to Settings > Networking > Cable Modem Provisioning.
- Click "Create Cable Modem Provisioner".
- In the "Create Cable Modem Provisioner" modal that opens, enter the settings for your Incognito server.
Incognito field definitions1. The Incognito Username, defined in your Broadband Command Center.
2. The Incognito Password, defined in your Broadband Command Center.
3. Your Incognito MPS port. In most cases, this will be 8996 by default.
4. You Incognito DHCP port. In most cases, this will be 8998 by default.
5. The name of the Incognito server, for identification within the Sonar interface.
6. The Hostname of your Broadband Command Center. This can be either an FQDN or an IPv4 address.When configuring Incognito, Sonar uses both the DHCP and MPS API, and you must specify the port for each API endpoint.
Address Lists are defined in order to push account addresses to Incognito’s Broadband Command Center (BCC). They will reside in BCC under DHCP > Client Classes.
- In Sonar, go to Settings > Networking > Address Lists.
- Create Address Lists that match those listed as Client Class Names within your Broadband Command Center. Every Client Class Name needs a corresponding entry as an Address List in Sonar.The Address List names are case sensitive and must match those defined in BCC exactly. If your "client class name" in BCC is PLATINUM, then it must be entered into Sonar using all capital letters.
In order to complete the configuration process, your Sonar instance must have inventory devices Incognito can provision.
- Create an inventory model, one for each type of modem you have, by going to Inventory -> Manage Items -> Add Model (see here for details).
- During the model creation, the 'Device Type" field should be set to "Cable Modem", as pictured:
- Next, you'll need to modify the individual hardware item fields. Select "Modify Fields" and ensure the primary value contains a "Type" value of "MAC Address" and a "Secondary Type" value of "Cable Modem":When configuring Incognito, Sonar won't make any model field changes to your existing modems. Changes will only be made in Sonar as they're made in Incognito's Broadband Command Center.
- When you add an item to this inventory model, you should see it appear in BCC under MPS > Devices.
- If you deactivate the account that owns the address that owns a Cable Modem inventory item in Sonar, the client class will be removed from the Services column in BCC’s MPS > Devices.
- From now on, when you add an inventory item to an account in Sonar, you should see the relevant information appear in BCC under MPS > System Root > Subscriber.
Sonar will write static assignments into Incognito and will retrieve dynamic assignments from Incognito. If an IP address is assigned directly to the cable modem inventory item in Sonar, then Sonar will tell Incognito that this IP should be statically assigned, using the
staticAddresses API endpoint. Conversely, if Incognito assigns an IP to a cable modem dynamically, Sonar will learn this data from Incognito and assign it to the cable modem as a soft assignment inside Sonar.
Sonar utilizes the following SOAP API endpoints via Incognito, and the user information entered into Sonar will need access to the following functions: