Peers

Documentation 7.2.0 > Managing Peers > 7.2.0 Peering Peers Lists.png

The Peers subtab lists existing peers in ProVision. Here, you can add new peers and view peer details. ProVision supports Peer lookup from PeeringDB, as well as creation of "Local Peers". Local or custom Peers that are 'private' or not registered with PeeringDB may also be used for session creation.

Working with Peers

Peer List

The Peer list shows peers currently in ProVision, their ASN, associated exchange, and whether session exist.

Filter the peer list by typing all or part of a peer name into the "Filter" text box in the right side of the list header, and the list will narrow down to matching Peers.

You may also sort by any field by clicking on the column name in the header.

Documentation 7.2.0 > Managing Peers > 7.2.0 Peering Peers No Local.png

Organizations will show as Peers in this list if:

There is an existing session in Provision with the organization set as the destination - applies to both "Add Session" and "Add Peer"→ Configure Sessions
The organization is marked "Existing Peer" in Exchange communications

Manually added Local Peers will show in the Local Peer list, below the standard Peer List.

Add Peers

Adding a Peer can be done via many methods in ProVision, depending on whether the peer is from PeeringDB, Local, and what the peer/session status is.

In general, Peers will added from either:

PeeringDB through "Import Peer", session creation, or exchange communications
Local / Custom creation through "Add Peer" or session creation

The following approaches will result in a Peer being added into ProVision:

Create a session for a peer, selecting the Peer from PeeringDB options available under the Session tab → "Add Session" form.
Create a session for a local or custom peer, selecting an existing local peer or manually entering a custom destination in the Session tab → "Add Session" form.
Manually create a Local Peer, from "Add Peer".
Import/search for a Peer from PeeringDB, then add the peer by configuring multiple sessions.
Add a peer without creating sessions by marking the peer as "existing" under Exchange→Communications. The Peer will show in the Peer List, but no sessions will exist for the peer until they are created in ProVision.

Add PeeringDB Peer (Import Lookup)

Peers may be added via finding a peer from PeeringDB to import,

You can search for Peers by clicking "Import Peer" on the Peers or Peer Details pages.

Documentation 7.2.0 > Managing Peers > 7.2.0 Peering Import Peer.png

The "Import Peer from PeeringDB" search module will open. Enter all or part of the peer name, then click "Search". The results will show in a list below.

Documentation 7.2.0 > Managing Peers > 7.2.0 Peering Search-Import Peer.png

From the results list, click "View" - this will open the Peer Details page for the Peer, where you can view the peer's information, available exchanges, existing sessions, or add the peer via configuring multiple sessions.

Add Peer via Configure / Configure Multiple Sessions

From the Peer Details page, click "Configure Multiple Sessions".

Documentation 7.2.0 > Managing Peers > 7.1.0 Peering Peers Configure Multiple button.png

Clicking the configure multiple buttons opens a page where you may select and set up multiple sessions for that peer.

Documentation 7.2.0 > Managing Peers > 7.0.0 Peering Peers Config Multiple Sessions.png

Select the desired exchanges, router, peer group, and type, and then choose to either "Configure Now" or Schedule the config to run later via the Scheduler Tab.

Configuring sessions here will create new sessions, and add the peer used to the Peer List.

Add a Local Peer

Add a new local peer by going to the Peering Tab → Peers subtab, and clicking "Add Peer".

Documentation 7.2.0 > Managing Peers > 7.2.0 Peering Peer Add Peer.png

In the "Add Local Peer" form, enter the Peer details including Name, ASN, IPv4 or IPv6 Address, Route-Set, select an Exchange Option, and add notes if desired.

When finished, click "Create".

Documentation 7.2.0 > Managing Peers > 7.2.0 Peering Add new local Peer filled create.png

The Peer will be added to the "Local Peers" list, and be available to select while creating a session.

Documentation 7.2.0 > Managing Peers > 7.2.0 Peering Local Peers List Only.png

Add Peer via Session

New Peers are added when creating a session with that Peer. While creating a new Session, you may select a PeeringDB Peer, an existing Local Peer, or create a new custom Peer.

Add Session Information

Click "Add Session" from the Peering → Sessions sub-tab.

In the Create New Session Form, type the session information, selecting the appropriate exchange type for the planned Peer. If using a Local Peer, "No Exchange" is an available option.

Documentation 7.2.0 > Managing Peers > 7.2.0 Peering Add Session Button.png

Documentation 7.2.0 > Managing Peers > 7.2.0 Peering Session Create New No Exchange.png

Select or Add Destination

Documentation 7.2.0 > Managing Peers > 7.2.0 Peering Add Session Find Exising Local Peer.png

Under the Destination section, select or type in information for a peer. You may add Peer information from any of the three available methods:

Use PeeringDB Lookup to select a PeeringDB Peer (the destination fields will be automatically populated).
Look up an existing Local Peer under "Local Peer Lookup" by selecting the peer name and IP address (the destination fields will be automatically populated).
Manually add a new Local or Custom Peer, by directly typing the Peer Name, ASN, and IP in the Destination fields.

Documentation 7.2.0 > Managing Peers > 7.2.0 Peering Add Session Local Peer Desitnation Create.png

When complete, click "Create".

The new Session will be added to the Session List.

Documentation 7.2.0 > Managing Peers > 7.2.0 Peering Session List w Local.png

Peer Details Page

Clicking on a peer in the list will open the Peer Details page.
Documentation 7.2.0 > Managing Peers > 7.2.0 Peer Details.png

From here, you can view details for the existing peer, including available exchanges and what routers you have available on that exchange. Additional, the peer may be added by configuring new sessions via Configure Multiple Sessions.

Existing sessions for the Peer may be viewed, managed and deleted under "Sessions".

Documentation 7.2.0 > Managing Peers > 7.1.0 Peering PeerDetails Sessions.png

To edit, manage, or delete a single session, click on the session listing to open the Session detail page. All sessions under the Peer may be deleted by clicking "Delete All Sessions".