1. What is the Megapath-RR?
The Megapath-RR is a Route Registry similar to the RADB.
2. OK, so what's a Route Registry?
A. A Route Registry is
simply a database that stores Internet Protocol routes as objects and
associates them with a BGP Autonomous System Number. From this database,
route policy can be controlled at a higher level than router configuration.
3. I never used the RADB, what's the RADB?
A. The RADB is a public route registry. Almost all providers use
public route servers at exchange points for some of its peering relationships.
For more information
on the RADB, please visit http://www.radb.net .
4. What is the purpose of the Megapath-RR?
A. The purpose of the Megapath-RR is to provide a smoother mechanism for BGP policy
changes between the customer and Megapath. When you use the Megapath-RR, many of
the changes you wish to make will become automatic i.e. for most tasks, you
will no longer have to open tickets with the Megapath NOC and wait for an
engineer to respond. Simply reflect the changes in the Megapath-RR and the
the new policy will take affect in two business days.
5. What language does the Megapath-RR speak?
A. The Megapath-RR uses the database language of RPSL, the same language used by
the RADB. For more information about RPSL, visit
http://www.radb.net/docs/rpsl.html . Do not worry if you aren't familiar with
RPSL. The examples given in this FAQ will be enough to guide you through the
simple process of registering objects in the Megapath-RR.
6. How do I Install Objects In the Megapath-RR for the first time?
A. You need to be a Megapath Customer. Fill
out the form at http://whois.epoch.net/BGP.html
7. How do I Submit My Objects to the Route Registry?
Once you have filled out the templates below (keep reading) or used the Object Builder on the main
page http://whois.megapath.net, mail them to
auto-dbm@whois.epoch.net.
They will automatically be processed by the Registry. Maintainer Objects
require manual approval and can take up to two business days to be processed by the
server.
8. What does a Maintainer Object look like?
If you have never used the Megapath-RR before, you will need first to create a
"maintainer object". A maintainer object is the master database object that
associates you, the user, with the database. It enables you to configure what
people will have access to add, modify, or delete route objects under your
autonomous system. It also tells the database who to nofity when changes are
made. A sample maintainer object looks like this:
The second field, descr, is a brief description of the maintainter object.
The third field, admin-c, allows the user to specify an admin contact. I have opted to
use my NIC handle. A simple text name will suffice, however.
The upd-to field is where you specify what email address is notified when
FAILED modifications are attempted on objects registered under the maintainter.
The mnt-nfy field is where you specify what email address is notified upon
SUCCESSFUL modifications of objects registered under the maintainer.
The auth line controlls the authentication method used to verify that a
user has permission to modify objects under this maintainer. The "MAIL-FROM"
is a keyword that indicates that mail must be recieved from the user with an
email address of kevin@epoch.net in order to be approved. All other mail users
will be denied. Other options include CRYPT-PW and PGP-FROM. For a detailed
explanation visit http://www.radb.net/docs/auth.html. Currently PGP-FROM is
not supported in the Megapath-RR but there are plans to add PGP support if there
is demand.
The mnt-by field sets the Maintainer object which controls the object being
registered. As redundant as it may seem in this case, it is required. When
registering other objects, it becomes more meaningful.
The changed field reflects when the objects was created or last modified and
the user who made the changes. It is customary to use an email address
followed by the date in YYYYMMDD format.
The source field specifies what database the object belongs to. Since the
route server software supports multiple registries, you will need to specify
"EPOCH" on this line.
9. What does an AS Object look like?
The AS Object describes the "route policy" of the autonomous system. It is
with this object that you will define what AS's routes you want to annouce
to Megapath as well as what routes you want to receive from Megapath (if you need to change
routes you are RECEIVING post install from Megapath please contact the NOC). Below is a
sample AS Object:
The second field, as-name, allows you to name the AS object.
The descr field is where you put the descripton of the AS. It is good
policy to enter valid 24 hour contact info in this field. Data can span
multiple lines.
The admin-c and tech-c fields are where you can put other NIC
handle information. Names or email addresses are also valid.
The nofity, mnt-by, changed, and source have the
same meaning as in the maintainer object.
The import and export lines are the real meat of the AS object.
The import field is where you define what routes you would like Megapath
to send to you. For example:
The export field is where you define what routes you would like to
announce to Megapath. For most of you, you will simply say
If you are a large BGP customer and announce more than one AS to Megapath, you
will want to use an AS-SET object. This applies only to a select few
customers.
10. What does a Route Object look like? How do I add Routes to be announced to Megapath?
The Route Object is where you define the routes that you would like announced
to Megapath (and, thus, the Internet). Each network is a unique Route Object
give in CIDR notation. Here is an example:
The descr field provides a brief description of the route. For example
you could put the CIDR block name given by ARIN if applicable.
The origin field attaches the Route Object to an AS Object thereby
defining the route policy for the network.
The mnt-by field is where you put the maintainer object.
The changed and source fields are the same for all objects.
Use the Route Object Builder on at http://whois.megapath.net/route-form.html to create a new object and then
Email the objects to auto-dbm@whois.epoch.net and the system will process them.
11. How do I Query Objects in the Megapath-RR?
The Route Registry will respond to whois queries similar to ARIN or InterNIC.
For UNIX: whois -h whois.megapath.net query string.
Finally, you can search the database via the web at
http://whois.megapath.net
12. How do I Modify Objects In the Megapath-RR?
First, Query the object you want to modify (see Question 11).
Make whatever changes necessary and mail the object to
auto-dbm@whois.epoch.net. 13. How do I Delete Objects In the Megapath-RR?
First, Query the object you want to modify (see Question 11).
Add the following field at the bottom of the object:
14. How long does it take for Megapath to update their filters after I submit an object?
After an new object has been submitted to the registry, an automatic
notification is sent to Megapath's Engineering department. The objects are
reviewed by Engineering and then processed. Typical turn-around time for
configuration changes is approximately one business day.
Megapath guarantees that all objects submitted
to the Megapath Route Registry will be processed within two business days of their
submission.
15. Where do I go for additional Information?
The Megapath-RR homepage provides a wealth of links and information.
Check http://whois.megapath.net for
additional information.
Also, you can email the Registry Administrator at
db-admin@whois.epoch.net .
Do not send objects to this address. They will not be processed by the registry.
mntner: MAINT-AS5649
descr: Maintainer for AS 5649
admin-c: KN45
upd-to: kevin@epoch.net
mnt-nfy: kevin@epoch.net
auth: MAIL-FROM kevin@epoch.net
mnt-by: MAINT-AS5649
changed: kevin@epoch.net 20000517
source: EPOCH
The first field, mntner, is the unique ID of the maintainer object. It
is customary to use "MAINT-ASXXXX" in this field.
aut-num: AS5649
as-name: KEVIN.NET
descr: Kevin Nicastro's Personal AS
1953 Gallows Rd
Suite 860
Vienna, VA 22182
NOC: 1-888-6383696 noc@eni.net
admin-c: KN45
tech-c: KN45
import: from AS4565
action pref=100;
accept any AND NOT {0.0.0.0/0}
export: to AS4565
announce AS5649
notify: kevin@epoch.net
mnt-by: MAINT-AS5649
changed: kevin@epoch.net 20000517
source: EPOCH
The first field, aut-num, is the unique identifier for the AS object.
It is customary to use ASXXXX as the data
Never fear! We have provided three different AS Object templates
for you so you don't have to worry about RPSL syntax!
export: to AS4565
announce AS5649
This basically says, announce any route objects under AS5649 to AS4565 (Megapath).
route: 192.168.0.0/24
descr: Sample Route in the AS5649 Domain
origin: AS5649
mnt-by: MAINT-AS5649
changed: kevin@epoch.net 20000519
source: EPOCH
The route field specifies the netblock in CIDR notation. The route
must have valid fully qualified syntax or it will be rejected. There is no
assumption that routes not given in CIDR notation are Class C's or Class B's.
For Linux: whois query string@whois.megapath.net.
Make sure to update the changed field with the correct date.
delete: email date reason-for-deletion
For Example, this will delete 192.168.0.0/24 from the Registry:
route: 192.168.0.0/24
descr: Sample Route in the AS5649 Domain
origin: AS5649
mnt-by: MAINT-AS5649
changed: kevin@epoch.net 20000519
source: EPOCH
delete: kevin@epoch.net 20001012 network no longer routed via AS5649
June, 2000
Last updated: August 15th, 2007