HTML

<div id="google_translate_element"></div>
<script type="text/javascript">
function googleTranslateElementInit() {
  new google.translate.TranslateElement({pageLanguage: 'en'}, 'google_translate_element');
}
</script>
<script type="text/javascript" src="//translate.google.com/translate_a/element.js?cb=googleTranslateElementInit"></script>

...

Peering

The Peering tab displays peering stats, allows you to add and manage exchanges, routers and , sessions, and peers. Admin users may view and manage communications and sessions for each exchange.

Image Removed

Two other sections are available via the drop down menu:

Image Removed

Routers - Links to the resource list of routers

recent emails for a company peering email address, and associate email communications with ProVision peers.

Image Added

ProVision's Peering tab has five subtabs to manage various peering functions: IXs (Exchanges), Routers, Sessions, Peers, AS Set, and Emails.

The IXs tab shows the exchange list. From here, you can edit exchange settings and view, manage, and mark peer status and communications via the exchange details page.

The Routers tab shows the list of routers in ProVision. From here, you can add new routers or manage existing routers.

The Sessions tab lists the current sessions in ProVision. You may also add new sessions, or click on a session name to show session details, from which you may configure and manage each session.

On the Peers tab, you can view and manage session peers.

The AS Set tab lets you view, import, and update Autonomous Set inbound prefix filters per peer.

In the Email tab (Global Admins only), recent email communications to and from a company peering email account may be managed.

Table of Contents

Peering Overview

In ProVision's Peering tab, you can add multiple exchanges, routers, sessions, view peer details, as well as send and receive peering requests. ProVision directly interfaces with PeeringDB's API to update exchange and peering data to ensure up to date information, which is automatically managed for cloud installations. Local installations of ProVision that use Peering need to have a PeeringDB account, and for the API Key or Database to be set up in ProVision.Logging - View peering related logs

Info

title	Peering Setup - Local Installations

If you are using a locally hosted instance of ProVision, verify that you have followed the instructions on the Local Installations - Peering Setup page to set up Peering for your instance.

Set up ProVision Peering

In order to perform common peering tasks, one or more ASNs need to be added in ProVision.

Local instances will also need to provide a PeeringDB API key, or self-manage a PeeringDB database. For cloud instances, 6connect manages the PeeringDB database automatically.

Peering Views:

Two "Views" are available for the Peering Tab: "View by Exchange", and "View by Peer". The view may be changed by clicking on the "View by ..." buttons at the top left corner of the page.

View by Exchange

"View by Exchange" is the default view for the Peering Tab, and is the view where most management tasks will be completed.

Image Removed

At the top right of the page are easily accessed buttons for adding new Routers or New Sessions. See: Add Routers and Add Sessions for details.

Next, general information is shown on the Peering data for the set ASNs in ProVision, including PeeringDB information and a breakdown of Peer types.

Below that are modules for specific exchanges - here, we can see peer and session breakdowns for Equinix Palo Alto, including a bar chart of Peered / Qualified / Unqualified / Rejected status types.

Clicking on the "Communications" or "Sessions" buttons for an exchange will open detailed information for all peers or sessions, respectively, currently in ProVision. For details on managing peers and sessions in these areas, see Peering - Common Tasks, Managing Peer Sessions, and Managing Peer Communications.

View by Peer

"View by Peer" is a supplemental reference view that allows for quick lookup of a Peer's PeeringDB information and sessions currently in ProVision for that Peer.

Selecting a Peer from the list at the left shows the PeeringDB information available for that Peer, including profile and policy links.

Image Removed

If sessions exist in ProVision for that Peer, clicking on the "Sessions" tab will show an overall of all sessions, including ASN, assigned router, IP, peer Group, Type, and State.

Image Removed

Add ASN(s) to ProVision

Add at least one ASN to ProVision from either the Admin → Admin Preferences → Peering page, or via the Peering Tab -> Exchange Settings.

Click one of the options below for details:

Expand

title	How to set an ASN via the Admin Preferences Page...

From the Admin Settings page, go to Peering -> Peering Settings.

Next to "ASN", enter the ASN(s) you want to track in ProVision.

Image Added

For multiple ASNs, separate each ASN with a comma (e.g. "1234, 5678").

When done, click "Save Changes" to save your changes.

Expand

title	How to set an ASN via the Peering Tab...

From the Peering Tab, go to the IX's subtab and then click "Settings".

Image Added

Peering Settings will display.

Image Added

Under the "Config" section, you'll see a field to add an ASN - fill in the desired ASN(s), and click "Add".

Add PeeringDB API Key (Local Installations)

Local installations may set the PeeringDB API Key in the ProVision Admin → Admin Preferences -> Peering page, or via the Peering Tab -> Exchange Settings.

Click one of the options below for details:

Expand

title	How to set PeeringDB Credentials via the Admin Preferences Page...

From the Admin Settings page, go to Peering -> Peering Settings.

The current PeeringDB Account status will display next to "Peering DB Account".

Enter the PeeringDB account API Key, then hit "Test" - the connection will be tested. If successful, you can then save the key.

Image Added

When you are done, click "Save Changes".

Additional Options for Local Installations

Local Installations have an additional option of hard-coding PeeringDB credentials in ProVision's globals.php file or self-managing a local database.

Additional Peering constants may be added into globals.php to change the PeeringDB URL between the main and beta site (some users may find the beta site to have faster response times), and to adjust the PeeringDB cache TTL.

For real-time updates, TTL may be set to 0. However, some users may experience severe lag with a TTL = 0; we recommend using a 10 to 15 minute or greater TTL if this occurs.

For details on adding / editing these peering constants, see Local Installations - Peering Setup.

Peering Workflow

After the initial Peering setup is complete, you can begin to work with the rest of the Peering tabs, including routers, peer groups, sessions, managing peers, and communications.

Expand

title	Click here to see the graphical workflow...

Image Added

Peering Workflow Steps

Below is an outline of the steps needed for a basic workflow process.

Expand

title	Peering Workflow Extended Steps...

Table of Contents

1) Add Router(s)

Adding a router is the fundamental base and first step of working with peering in ProVision. Routers may be added through the "Add Router" button in the Peering Tab.

For a detailed breakdown of this task, see Peering Routers.

2) Add Peer Groups

Associating the router with a peer group is necessary to link the router to a particular exchange. You may add the Peer Group information either in the "Router Details" page in Peering, or in the Peer Group Gadget prior to adding sessions.

Expand

From Peering → "Router Details" Page:

Go to Peering Tab → Routers. Click on the desired router to view the Router Details page. (See Peering Routers)

Here, you may add and delete and Peer Groups associated with the router - select the Exchange, Add the Peer Group Name, select the IP type, and click "Add Group".

Image Added

From the Peer Group Gadget:

If you need to add a Peer Group to an existing router, you may use the Peer Group gadget.

The Peer Group Gadget allows you to add peer groups for IPv4 and IPv6 for a selected exchange from a router's Resource Entry page.

To do this, simply select the exchange, type in a Peer Group name in the text box, select IPv4 or IPv6, the click "Add Group".

Image Added

Peer Groups added from this gadget will be then be available to select in the "Add Session" dialog box in the Peering tab.

3) Add Session(s)

After Routers and Peer Groups have been set up, the next step is Adding Sessions to ProVision.

You may add a new session through the "Add Session" button in the Peering tab, or you may Import Sessions from an existing router.

Importing sessions requires Admin level permissions, and is accessed through the Data Import Tab in the Admin section of ProVision.

4) Configure Sessions

Once a session has been added, you will see it in the session list. For a newly added session, the status will show as "Not Configured". There are a few options to configure sessions:

Expand

Configure Sessions Individually by Exchange / Session:

You may configure the session through 1 click config or the Config Manager, accessed by clicking session and opening the Session Details page. 1 click config uses the default config settings, while the Config Manager allows you to manually create one time use unique settings.

Configure Sessions by Peers:

From the Peer Details Page, you can choose to create or configure multiple sessions.

With this option, you can view and configure all sessions for that Peer from one menu (as opposed to the Sessions list configure option, which configures individual sessions by Exchange).

Clicking on "Configure Multiple Sessions" button opens a page showing the available exchanges with routers and options to change the router, peer group, and Peer type.

Select the checkmarks for the desired sessions to configure. As a shortcut, you may also check the "Exchanges" option to select all sessions under all exchanges, or, check "Select all networks" next to the exchange header to select all sessions in that exchange. From there, deselect items as needed.

When your selections have been made, click "Create Sessions" to immediately configure all selected sessions.

5) Manage Communications

Once a session has been added with a peer, you will see the peer listed Peer List under the Peers tab.

You'll also be able to manage communications from Exchange Communications.

You will see the list of Peers, their ASNs, Name, Request Status, Notes (log), and the Action Menu (wrench icon).

From here, you may send peer requests, mark peer status, and view notes on previous actions. The available options and flow depends on the Peer Status and whether a request is Outgoing or Incoming.

Expand

New Peer:

Expand

For an existing peer that was just added, you can mark the peer as:

a) Mark Existing Peer, or,

b) Mark Not Qualified

You may also choose to send an outgoing peer request.

Outgoing Peer Request:

Expand

To send out a peer request, select "Send Request" from the Action Menu (wrench icon) . This sends an initial peering request email to the peering coordinator for that peer. The email template pre-populates data based on peeringdb data (To address, Subject line and Peering exchange information). You have the chance to edit the email prior to sending. If Peering Emails are set up in ProVision with the same email address, a copy of the request will be saved to the Sent box.

Once a Request has been sent out, it can proceed two ways:

a) The request is accepted and Peering is established (becomes current peer)

b) The request is not accepted / responded to, and the "Resend Request" option becomes available, allowing you to repeat the request.

Incoming Peer Request:

Expand

If a request is received, you have a few options from which you may mark the peer from the Action Menu:

a) If you accept the request, you may "Mark Approved" and Peering is established (becomes current peer).

b) You may "Mark Rejected", in which case a peer status is marked rejected.

c) "Reset Status" is available at various points in the communications process, if you want to reset the peer back to the beginning state and re-establish a different status condition. This reopens the initial options from which you may select a different peer mark.

d) "Resend Request" may be available to resend a request

If Peering Emails are set up in ProVision, and the message was sent to the account as set there, the incoming request will be recieved to the ProVision inbox.

6) Repeat for new Routers, Sessions, and Peers.

To add additional Routers, Sessions, and Peers repeat steps 1, 2, or 3, and manage your newly added sessions and peer communications similarly with steps 4 and 5.

Additional Information

Children Display

Page tree

Versions Compared

Old Version 17

New Version Current

Key

Peering Overview

Set up ProVision Peering