Troubleshoot OVHcloud Connect

View as Markdown

Diagnose and resolve the most common issues encountered with OVHcloud Connect

Objective

This guide helps you diagnose and resolve the most common issues encountered with OVHcloud Connect. Each section describes a known issue, its possible causes, and the steps to fix it.

Before you begin

General considerations

  • Always check both sides โ€” Most OVHcloud Connect issues involve configuration or physical elements on both your side and OVHcloud's side. Verify your router, cross-connect (or provider virtual circuit), and the OVHcloud Control Panel before opening a ticket.
  • Collect diagnostics first โ€” Before making changes, gather interface status, BGP state, traceroute, and optical values. This information speeds up resolution whether you solve the issue yourself or need to contact support.
  • Check for scheduled maintenance โ€” Some issues may be caused by planned work on OVHcloud infrastructure or at your provider. Always check the status page before deep-diving into troubleshooting.

Useful resources


After ordering OVHcloud Connect Direct, the physical link shows no optical signal on one or both sides.

Possible causes and solutions

#Possible causeSolution
1Cross-connect not yet installedContact your data centre operator and provide the LOA. See Ordering a Cross Connect with an LOA.
2LOA misinterpreted by the data centreVerify the LOA details with the PoP operator: cabinet, cage, patch panel, port, fibre termination. See How to read LOA information below.
3Tx/Rx fibre inversionThe transmit and receive fibres may be swapped, causing light to arrive on the wrong port. Ask the data centre operator to check for a Tx/Rx inversion on the cross-connect.
4SFP module issueEnsure the SFP matches the ordered bandwidth: 1000Base-LX/LH for 1 Gbps, 10GBase-LR for 10 Gbps, 100GBase-LR4 for 100 Gbps. Replace the SFP if faulty. See Prerequisites & Limitations.
5Port disabled or lockedCheck the OVHcloud Control Panel โ€” the port may be administratively locked. If the OUT optical value is DOWN, the port may also be in the process of being cancelled.
6Faulty cross-connect cableAsk the data centre operator to test the cable or provision a new one.

How to read LOA information

A typical LOA contains information formatted like this:

Equipment: 103 PA3:OG:00GMC3:OVH Patch Panel: PP:0103:1132697
Port: P16/FO31-32/BCK Fiber Termination: SC/PC

Interpretation:

FieldValueMeaning
Cabinet103Position of the bay where the rack is located
CagePA3:OG:00GMC3:OVHRack reference
Patch Panel (Z-side)PP:0103:1132697Switch position on OVHcloud side
Port16Position on the switch
FibreOptic Port A31Fibre A identifier
FibreOptic Port B32Fibre B identifier
SideBCK (Back)Front or back of the equipment
Fibre TerminationSC/PCConnector type

Checking optical values

In the OVHcloud Control Panel, navigate to Network โ†’ OVHcloud Connect โ†’ select your service, and check the IN/OUT optical values:

  • OUT is DOWN โ€” The OVHcloud-side port is not emitting light. Possible reasons: port issue, service being cancelled, port locked, SFP failure.
  • IN is DOWN โ€” OVHcloud is not receiving light from your side. Possible reasons: cross-connect not installed, your equipment not connected, your port disabled, Tx/Rx fibre inversion.

Diagnostic flowchart

Diagnostic flowchart for no light on the physical link

Optical values show UP on both sides, but the Ethernet interface remains DOWN and no peering can be established.

Possible causes and solutions

#Possible causeSolution
1SFP type mismatchThe SFP must match the ordered bandwidth. Use 1000Base-LX/LH for 1 Gbps, 10GBase-LR for 10 Gbps, 100GBase-LR4 for 100 Gbps.
2Auto-negotiation enabledAuto-negotiation is not supported on OVHcloud Connect. Disable it on your router (see commands below).
3Speed mismatchYour interface speed must match the ordered link speed. Configure it explicitly.
4Faulty SFP or transceiverTry replacing the SFP module on your side.

Disabling auto-negotiation

Cisco IOS:

interface GigabitEthernet0/0
 no negotiate auto

or:

interface GigabitEthernet0/0
 speed nonegotiate

Cisco NX-OS:

interface Ethernet1/1
 speed 1000
 no negotiate auto

Juniper JunOS:

set interfaces ge-0/0/0 ether-options no-auto-negotiation

Issue 3 โ€” BGP session stuck in Active or Idle state

The physical link is up, but the BGP session does not reach the Established state.

Possible causes and solutions

#Possible causeSolution
1Incorrect peer IP addressVerify that the peer IP configured on your router matches exactly the IP assigned by OVHcloud in the Control Panel. The PoP peering subnet is a /30: OVHcloud takes the first IP, you take the second. See Configure OCC L3 with BGP.
2Incorrect ASNCheck that you are peering with OVHcloud ASN 35540 and that your own ASN is correctly configured (private ASN range 64512โ€“65534 recommended). Avoid reserved ASNs: 65501 (EU PoP), 65502 (CA PoP), 65519 (Asia PoP).
3VLAN ID mismatchThe VLAN tag on your interface must match the VLAN ID configured in the OVHcloud Control Panel PoP configuration. Verify with show interfaces or show vlans.
4Firewall blocking TCP port 179BGP uses TCP port 179. Ensure no firewall or ACL is blocking this port between the two peers.
5Interface not configured with correct encapsulationFor L3 connections, the interface must use 802.1Q encapsulation with the correct VLAN ID. See configuration examples in the Configure OCC L3 with BGP.
6PoP configuration not created in OVHcloudVerify in the OVHcloud Control Panel that a PoP configuration has been created for your service. Without it, OVHcloud's router will not peer.
7MD5 authentication mismatchIf MD5 is configured, the password must match on both sides. Check with your OVHcloud Connect service details.

Verification commands

Cisco IOS:

show ip bgp summary
show bgp ipv4 unicast neighbors 192.0.2.1
show interfaces GigabitEthernet0/0
show ip interface brief

Juniper JunOS:

show bgp summary
show bgp neighbor 192.0.2.1
show interfaces terse

Diagnostic flowchart

Diagnostic flowchart for BGP session stuck in Active or Idle state

Issue 4 โ€” BGP session established but no routes received

The BGP session shows Established, but no prefixes are being received from OVHcloud (or from your network).

Possible causes and solutions

#Possible causeSolution
1Missing network statement or export policyOn your router, ensure you are advertising the correct prefixes using network commands (Cisco) or export policies (Juniper). See Configure OCC L3 with BGP.
2Prefix filter blocking routesYour import prefix-list may be too restrictive, filtering out OVHcloud routes. Check your prefix-lists and route policies.
3vRack not associatedOVHcloud routes are only exchanged if the OVHcloud Connect service is associated with a vRack. Verify the association in the Control Panel. See Associate with vRack.
4AZ subnets not configuredIf no subnets are defined in the Availability Zone configuration, there will be no routes to exchange. See Set up your vRack network.
5Maximum prefix limit reachedOVHcloud supports up to 100 prefixes per BGP session. If you exceed this limit, the session may stop accepting new routes. Aggregate your prefixes.
6Route not in the routing tableThe prefix you are trying to advertise must exist in your router's routing table (via a connected network, static route, or IGP).

Verification commands

Cisco IOS:

show ip bgp summary
show ip bgp neighbors 192.0.2.1 received-routes
show ip bgp neighbors 192.0.2.1 advertised-routes
show ip route bgp

Juniper JunOS:

show bgp summary
show route receive-protocol bgp 192.0.2.1
show route advertising-protocol bgp 192.0.2.1
show route protocol bgp

Issue 5 โ€” BGP session keeps flapping (repeatedly going up and down)

The BGP session oscillates between Established and Active/Idle states, causing intermittent connectivity.

Possible causes and solutions

#Possible causeSolution
1Unstable physical linkCheck interface error counters (show interfaces) for CRC errors, input errors, or output drops. Inspect the SFP, cross-connect cable, and patch panel.
2MTU mismatchAn MTU mismatch between your equipment and OVHcloud can cause large BGP update packets to be dropped. The default MTU is 1500 bytes. Confirm MTU settings on both sides.
3BGP hold timer expiryDefault BGP hold time is 90 seconds. If keepalives are lost due to link instability, the session drops. Consider adjusting BGP timers, but fix the root cause first.
4CPU or memory overload on your routerBGP processing may be delayed if the router is under high load. Check CPU and memory usage.
5Aggressive prefix changesRapidly withdrawing and re-advertising routes can trigger flap dampening. Stabilise your routing announcements.

Verification commands

Cisco IOS:

show interfaces GigabitEthernet0/0
show ip bgp summary
show ip bgp flap-statistics
show log | include BGP

Juniper JunOS:

show interfaces ge-0/0/0 extensive
show bgp summary
show log messages | match BGP

Issue 6 โ€” Traffic not flowing despite BGP session established and routes exchanged

BGP is up, routes appear in the routing table on both sides, but actual traffic (ping, application data) does not flow.

Possible causes and solutions

#Possible causeSolution
1Firewall or ACL blocking trafficCheck firewall rules and access control lists on your router, your OVHcloud resources (security groups, iptables), and any intermediate devices.
2VLAN tagging mismatchThe VLAN ID on your interface must match the VLAN configured in OVHcloud. A mismatch results in tagged traffic being silently dropped.
3Incorrect subnet configurationVerify that source and destination IPs belong to the correct subnets and that there are no overlapping ranges. See Set up your vRack network.
4Asymmetric routingIf you have multiple paths (e.g. internet + OVHcloud Connect), return traffic may take a different path. Ensure symmetric routing using BGP attributes (Local Preference, AS-path prepending).
5vRack resource not attachedThe target OVHcloud resource (Bare Metal server, Public Cloud instance, Hosted Private Cloud) must be attached to the same vRack as OVHcloud Connect. Verify in the Control Panel.
6MTU mismatch causing fragmentationLarge packets may be silently dropped if MTU differs between segments. Test with varying packet sizes: ping -s 1472 -M do <destination> (Linux) to check for fragmentation issues.

Verification commands

From your side:

ping 172.16.1.1
traceroute 172.16.1.1

From a Linux host in OVHcloud:

ping -c 10 10.0.0.1
traceroute 10.0.0.1
mtr -r -c 50 10.0.0.1

Issue 7 โ€” Slow performance or high latency

The connection is working, but throughput is lower than expected or latency is higher than normal.

Possible causes and solutions

#Possible causeSolution
1Bandwidth saturationCheck interface utilisation in the OVHcloud Control Panel and on your router. If you consistently exceed 80% of the provisioned bandwidth, plan an upgrade.
2MTU mismatch causing fragmentationFragmented packets reduce effective throughput. Verify MTU end-to-end and run path MTU discovery: ping -s 1472 -M do <destination>.
3Interface errors (CRC, FCS, drops)Check show interfaces for error counters. Physical issues (dirty fibre, bad SFP, loose connector) cause retransmissions and degrade performance.
4Sub-optimal routingTraffic may be taking a longer path than expected. Check traceroute and BGP attributes (Local Preference, AS-path) to ensure optimal path selection.
5Congestion at the providerIf using OVHcloud Connect Provider, check the provider's portal (Megaport, Equinix Fabric, Console Connect) for utilisation and alerts on the virtual circuit.
6TCP window size misconfigurationFor high-bandwidth, high-latency links, ensure TCP window scaling is enabled on hosts to maximise throughput.

Verification commands

Cisco IOS:

show interfaces GigabitEthernet0/0 | include rate|error|drop|CRC
show ip route 172.16.1.0

From a Linux host:

iperf3 -c <destination> -t 30
mtr -r -c 100 <destination>

Issue 8 โ€” Provider virtual circuit not connecting (OVHcloud Connect Provider)

You have ordered an OVHcloud Connect Provider service, but the connection through your provider (Megaport, Equinix Fabric, or Console Connect) is not coming up.

Possible causes and solutions

#Possible causeSolution
1Incorrect pairing key / service keyVerify that the pairing key (or service key) entered in your provider's portal exactly matches the key from the OVHcloud Control Panel.
2Provider virtual circuit not provisionedCheck the status of the VXC (Megaport), virtual connection (Equinix), or connection (Console Connect) in the provider's portal. It should show as "Active" or "Provisioned".
3Provider does not have presence at the PoPThe provider must be available at the OVHcloud PoP you selected. Verify PoP availability in Providers and PoP Locations.
4Bandwidth mismatchThe bandwidth ordered on the provider side must match or be compatible with the OVHcloud Connect service bandwidth.
5Provider-side maintenance or outageCheck your provider's status page for ongoing incidents or planned maintenance.
Tip

Tip: If the provider portal shows the connection as "Active" but OVHcloud still shows it as "Pending", wait a few minutes for the provisioning to complete. If it persists beyond 30 minutes, contact OVHcloud support.


Issue 9 โ€” Service ordered but not delivered / not configurable

Your OVHcloud Connect service appears in the Control Panel but cannot be configured.

Possible causes and solutions

#Possible causeSolution
1Cross-connect not yet installed (Direct)The service becomes configurable once OVHcloud detects light on the port. Order the cross-connect from your data centre operator using the LOA and ensure your equipment is connected.
260-day interconnection window (Direct)After the order, you have 60 days to finalize the interconnection (order the cross-connect and interconnect your equipment). Beyond 60 days โ€” even without detected light โ€” the service is considered operational and billing starts.
3Provider circuit not yet linked (Provider)Ensure the provider virtual circuit is provisioned and linked to the OVHcloud service using the correct pairing key.
4Provisioning in progressNew services may take a few minutes to become configurable after ordering. Wait and refresh the Control Panel.
5Order issueIf the service remains in "Pending" state for an extended period, contact OVHcloud support with your order reference.

Issue 10 โ€” Failover not working in Multi-AZ setup

You have two OVHcloud Connect links for redundancy, but traffic does not failover when one link goes down.

Possible causes and solutions

#Possible causeSolution
1Both links in the same PoPFor true Multi-AZ resilience, the two links must terminate at different PoPs and different Availability Zones. See Multi-AZ.
2BGP failover not configuredConfigure BGP attributes to control path selection: use Local Preference to prefer the primary path and AS-path prepending on the backup. See Configure OCC L3 with BGP.
3BFD not enabledWithout BFD, BGP failover relies on hold timers (default 90 seconds). Enable BFD (Bidirectional Forwarding Detection) to reduce failover time to under 1 second. Contact OVHcloud support to confirm BFD availability for your service.
4vRack not shared between both servicesBoth OVHcloud Connect services must be associated with the same vRack for failover to work. Verify in the Control Panel. See Associate with vRack.
5Prefix-list filtering backup routesEnsure your import/export prefix filters allow the same prefixes on both links.

Verification commands

Cisco IOS:

show ip bgp
show ip bgp summary
show ip route bgp
show ip bgp neighbors 192.0.2.1
show ip bgp neighbors 198.51.100.1

Check that both BGP sessions are Established and that routes are received from both peers with different attributes (Local Preference, AS-path length).


Issue 11 โ€” IP address conflict in PoP or DC configuration

BGP session may not establish, or traffic may be routed incorrectly due to IP address conflicts.

Possible causes and solutions

#Possible causeSolution
1Using OVHcloud reserved IPsIn the PoP /30 subnet, the first IP is reserved for OVHcloud. In the DC /28 (minimum) subnet, the first three IPs are reserved for OVHcloud. Ensure you are using the correct IPs.
2Overlapping subnetsYour on-premises subnets must not overlap with subnets used in the OVHcloud vRack. Plan your IP addressing carefully. See Set up your vRack network.
3Duplicate ASNYour BGP ASN must differ from OVHcloud's ASN (35540) and from the reserved ASNs (65501, 65502, 65519).

Issue 12 โ€” Unsupported features or unexpected behaviour

Certain features may not work as expected due to current platform limitations.

Known limitations

FeatureStatusNotes
IPv6Not supportedOVHcloud Connect currently supports IPv4 only.
QoS / CoSNot supportedNo quality of service or 802.1p class of service mechanisms.
802.1q VLAN tagging (L2 mode)SupportedBut L2 mode is available on OVHcloud Connect Direct only.
Multi-VRFNot supportedOnly a single routing instance per OVHcloud Connect service.
eBGP Multi-HopNot supportedBGP peering must be directly connected (single hop).
iBGPNot supportedOnly eBGP is supported.
Static routing at PoPNot supportedAll routing is done via BGP.
Spanning Tree (L2)Not supportedL2 mode does not pass BPDUs.
Multicast / IGMP (L2)Not supportedOnly unicast traffic is supported in L2 mode.
FCoE (L2)Not supportedFibre Channel over Ethernet is not supported.
LACP (L2)SupportedCan be used for link aggregation in L2 mode within a single PoP.

For the full list of prerequisites and limitations, see Prerequisites & Limitations.


Quick reference: diagnostic commands

Cisco IOS / IOS-XE

PurposeCommand
Interface statusshow interfaces GigabitEthernet0/0
Interface briefshow ip interface brief
BGP session summaryshow ip bgp summary
BGP neighbour detailsshow bgp ipv4 unicast neighbors <peer-IP>
Routes received from peershow ip bgp neighbors <peer-IP> received-routes
Routes advertised to peershow ip bgp neighbors <peer-IP> advertised-routes
BGP routing tableshow ip route bgp
BGP flap statisticsshow ip bgp flap-statistics
Logsshow log | include BGP

Juniper JunOS

PurposeCommand
Interface statusshow interfaces ge-0/0/0 extensive
Interface summaryshow interfaces terse
BGP session summaryshow bgp summary
BGP neighbour detailsshow bgp neighbor <peer-IP>
Routes received from peershow route receive-protocol bgp <peer-IP>
Routes advertised to peershow route advertising-protocol bgp <peer-IP>
BGP routing tableshow route protocol bgp
Logsshow log messages | match BGP

Linux host

PurposeCommand
Connectivity testping -c 10 <destination>
Path tracetraceroute <destination>
Combined ping + tracemtr -r -c 50 <destination>
MTU test (no fragmentation)ping -s 1472 -M do <destination>
Throughput testiperf3 -c <destination> -t 30

When to contact support

If you have followed the troubleshooting steps above and the issue persists, open a support ticket:

  1. From the , go to Support โ†’ Create a ticket.
  2. Select Network โ†’ OVHcloud Connect.
  3. Include:
    • Your OVHcloud Connect service name/ID
    • Timestamp of the issue (UTC)
    • Symptoms observed
    • Diagnostic outputs (BGP summary, interface status, traceroute, optical values)
    • Steps already taken to troubleshoot
  4. See Declare and Follow Up Upon an Incident for the full incident management process.

What's next?

  • Set up proactive monitoring to detect issues before they impact your users
  • Review Prerequisites & Limitations to avoid known pitfalls
  • Consult the FAQ for answers to common questions
  • Check SLAs for uptime guarantees and service credits

Go further

For training or technical assistance implementing our solutions, contact your sales representative or visit our Professional Services page to request a quote and have your project analyzed by our experts.

Join our community of users.

Was this page helpful?