Frequently Asked Questions


1. What is the Megapath-RR?
2. OK, so what's a Route Registry?
3. I never used the RADB, what's the RADB?
4. What is the purpose of the Megapath-RR?
5. What language does the Megapath-RR speak?
6. How do I Install Objects in the Megapath-RR for the first time?
7. Where do I Submit My Objects to the Route Registry?
8. What does a Maintainer Object look like?
9. What does an AS Object look like?
10. What does a Route Object look like? How do I add Routes to be announced to Megapath?
11. How do I query objects in the Megapath-RR?
12. How do I modify objects in the Megapath-RR?
13. How do I delete objects in the Megapath-RR?
14. How long does it take for Megapath to update their routers after I submit an object?
15. Where do I go for additional information?

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:

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.

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:

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

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:

Never fear! We have provided three different AS Object templates for you so you don't have to worry about RPSL syntax!

The export field is where you define what routes you would like to announce to Megapath. For most of you, you will simply say

export:        to AS4565
               announce AS5649
This basically says, announce any route objects under AS5649 to AS4565 (Megapath).

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:

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.

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.
For Linux: whois query string@whois.megapath.net.

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.
Make sure to update the changed field with the correct date.

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:

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

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.


June, 2000
Last updated: August 15th, 2007