Difference between revisions of "Freeside:2.3:Documentation:Administration:svc dsl:ikano"
(→Exports) |
|||
| Line 13: | Line 13: | ||
Create an ikano export - most fields are obvious on the export add page, except: | Create an ikano export - most fields are obvious on the export add page, except: | ||
| − | Export Name - note that it's used in several user-visible places, such as on qualifications | + | * Export Name - note that it's used in several user-visible places, such as on qualifications |
| − | Export Host - not used, may be set to anything | + | * Export Host - not used, may be set to anything |
| − | Check Networks - comma separated list of telco networks to check (refer to Ikano API doc or web interface if you're not sure what these are). Only set this to the telcos you use. Ikano qualifications are slow. Adding extra telco networks to check will result in a performance impact when making each qualification. This field can look similar to "ATT,ATTTAS,VERTAS,VER". | + | * Check Networks - comma separated list of telco networks to check (refer to Ikano API doc or web interface if you're not sure what these are). Only set this to the telcos you use. Ikano qualifications are slow. Adding extra telco networks to check will result in a performance impact when making each qualification. This field can look similar to "ATT,ATTTAS,VERTAS,VER". |
| − | |||
| − | |||
| + | * Debug Mode - generates A LOT of output in the logs - turn it off for production | ||
= Services = | = Services = | ||
Revision as of 15:13, 13 December 2010
Introduction
Ikano DSL provisioning and qualifications requires installation of Net::Ikano and then configuration of the exports, services, DSL pull cron job, packages, and config option for qualifications.
Global Configuration
Enable qual-alt-address-format
Exports
Create an ikano export - most fields are obvious on the export add page, except:
- Export Name - note that it's used in several user-visible places, such as on qualifications
- Export Host - not used, may be set to anything
- Check Networks - comma separated list of telco networks to check (refer to Ikano API doc or web interface if you're not sure what these are). Only set this to the telcos you use. Ikano qualifications are slow. Adding extra telco networks to check will result in a performance impact when making each qualification. This field can look similar to "ATT,ATTTAS,VERTAS,VER".
- Debug Mode - generates A LOT of output in the logs - turn it off for production
Services
Create a new svc_dsl and attach your export. No other DSL-pulling/qualifying exports may be attached to this service.
Configure the service similarly to the following screenshot:
DSL pull cron job
freeside-pull-dsl syncs data from Ikano to the svc_dsl. It runs synchronously/non-concurrently, meaning that it works with one svc_dsl at a time. It must be run via a cron job as often as needed to update all monitored DSL orders, but not such that it starts again before all monitored orders were updated. Thus, the frequency will vary depending on each Freeside installation's number of monitored Ikano orders.
Packages
Create one-to-one mappings between each Ikano package you wish to use and each Freeside package as follows:
1. In Ikano's web interface, under Subscription Manager, find each package you wish to use and set its "Unique ID" field to a string which is unique across all packages you'll be setting up
2. Either edit or add a new Freeside package with at least one Ikano svc_dsl service (see above), and set "Vendor Package Id" beside the Ikano export (see above) to the "Unique ID" from Ikano for the corresponding package
