Freeside:4:Documentation:Administration:svc broadband.pm

From Freeside
Revision as of 09:10, 12 March 2019 by Mitch (talk | contribs) (Automatically assign IP addresses)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Broadband Services svc_broadband.pm

Freeside:4:Documentation:Developer/FS/svc_broadband

Automatically Assign IP Addresses

This guide describes how Freeside can automatically assign IP addresses while provisioning services for a customer.

Create a Service Definition

In the main menu, navigate to: Configuration > Services > Service Definitions

Add a new service definition of the type svc_broadband, choosing the default configuration options

Configure any exports you want for this service. Exporting to a RADIUS server, for example, will allow RADIUS to provision hardware with the assigned IP address.

Create a Router Definition

In the main menu, navigate to: Configuration > Services > Wireless Broadband > Routers > Add a new router

Leave the Assign IP addresses manually box unchecked

Under service types, check the box for your Service Definition

Allocate an Address Block to the Router

In the main menu, navigate to: Configuration > Services > Wireless Broadband > Address Blocks

Enter a gateway and a netmask. For example, Gateway 10.0.0.1 and Netmask of 24. Click the Add button.

Your new network should appear in the list of Address Blocks.

Click the allocate link for the address block. Choose your router, and click the Apply Changes button.

Create a Package with this Service

In the main menu, navigate to: Configuration > Packages > Package Definitions

Add a new Package definition. In the Services section, include your svc_broadband Service in this Package.

Order Package and Provision

Order the new package for a customer. View the customer's Packages tab. Click the link to Provision Service displayed on the Package.

The provisioning page allows you to select from which router/block to provision from. The hardware will be assigned the first available IP address within the selected network block.

Choose from available IP addresses

By default, an IP address is provisioned for the service automatically. If the selected netblock is size /24 or smaller, you may choose to select from a list of available IP addresses within that block.

By clicking on the down arrow button attached to the IP address input box, a list of available IP addresses is revealed. You may choose from this list, or allow Freeside to choose the first available IP address automatically. For network blocks larger than /24, this list would be quite large and will not be displayed.