<div dir="ltr"><div dir="ltr">Hi all,<div>but so this script:</div><div><a href="https://github.com/inex/IXP-Manager/blob/master/tools/runtime/route-servers/api-reconfigure-example-birdv2.sh" rel="noreferrer" target="_blank">https://github.com/inex/IXP-Manager/blob/master/tools/runtime/<span class="gmail-il">route</span>-<span class="gmail-il">servers</span>/api-reconfigure-example-birdv2.sh</a></div><div>generates the bird.conf?</div><div><br></div><div>I mean how does IXP Manager generate the bird.conf such as understanding which are the BGP peering?</div><div><br></div><div>Thanks,</div><div><br></div><div>Fabiano</div></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">Il giorno lun 30 mar 2020 alle ore 12:04 Barry O'Donovan <<a href="mailto:barry.odonovan@inex.ie">barry.odonovan@inex.ie</a>> ha scritto:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;border-left-color:rgb(204,204,204);padding-left:1ex">Hi Sam,<br>
<br>
Sam Malyon wrote on 29/03/2020 15:34:<br>
> I’m having issues installing the route server as I have never actually <br>
> used Bird before.<br>
> <br>
> So I have completed the router config on IXP Manager (Excluding the API <br>
> details). And installed bird using “apt-get install bird” but after that <br>
> I have no idea how to connect it to IXP Manager. I haven’t yet installed <br>
> Birdseye.<br>
> <br>
> Any Suggestions on what I should do here as I’m lost?<br>
<br>
Bird as a route server and Birdseye are separate components and you do <br>
not /need/ to install Birdseye but we would strongly recommend it. You <br>
should have a look at some of out talks from 2019 on this stuff at:<br>
<br>
<a href="https://www.ixpmanager.org/presentations" rel="noreferrer" target="_blank">https://www.ixpmanager.org/presentations</a><br>
<br>
The one from UKNOF is probably the most recent and best (although the <br>
slides didn't work at the beginning which is why it's a bit rough there 😉).<br>
<br>
IXP Manager will configure Bird for three purposes: route servers, route <br>
collectors and an AS112 service. As such, the documentation is split a <br>
little. The most important one is:<br>
<br>
<a href="https://docs.ixpmanager.org/features/routers/" rel="noreferrer" target="_blank">https://docs.ixpmanager.org/features/routers/</a><br>
<br>
and particularly the section 'Configuration Generation Overview'.<br>
<br>
Then you should look at the route server specific stuff on:<br>
<br>
<a href="https://docs.ixpmanager.org/features/route-servers/" rel="noreferrer" target="_blank">https://docs.ixpmanager.org/features/route-servers/</a><br>
<br>
I take it from your offlist email that you have Bird installed and <br>
you're trying to figure out out it connects to IXP Manager. That is <br>
covered in the specific section I mentioned above. We have sample <br>
scripts for this which you can find here:<br>
<br>
<a href="https://github.com/inex/IXP-Manager/tree/master/tools/runtime/route-servers" rel="noreferrer" target="_blank">https://github.com/inex/IXP-Manager/tree/master/tools/runtime/route-servers</a><br>
<br>
and specifically:<br>
<br>
<a href="https://github.com/inex/IXP-Manager/blob/master/tools/runtime/route-servers/api-reconfigure-example-birdv2.sh" rel="noreferrer" target="_blank">https://github.com/inex/IXP-Manager/blob/master/tools/runtime/route-servers/api-reconfigure-example-birdv2.sh</a><br>
<br>
<br>
You will need to download that to your route server and then edit the <br>
settings at the top:<br>
<br>
KEY="your-api-key"<br>
URL="<a href="https://ixp.example.com/ixp/api/v4/router/gen-config" rel="noreferrer" target="_blank">https://ixp.example.com/ixp/api/v4/router/gen-config</a>"<br>
URL_DONE="<a href="https://ixp.example.com/ixp/api/v4/router/updated" rel="noreferrer" target="_blank">https://ixp.example.com/ixp/api/v4/router/updated</a>"<br>
ETCPATH="/usr/local/etc/bird"<br>
RUNPATH="/var/run/bird"<br>
LOGPATH="/var/log/bird"<br>
BIN="/usr/sbin/bird"<br>
<br>
You can create an API key per:<br>
<br>
<a href="https://docs.ixpmanager.org/features/api/" rel="noreferrer" target="_blank">https://docs.ixpmanager.org/features/api/</a><br>
<br>
The URLs reflect wherever the script can access IXP Manager via http(s).<br>
<br>
Once that's all set, you can run it in debugging mode via:<br>
<br>
bash ./api-reconfigure-example-birdv2.sh -d <handle><br>
<br>
where '<handle>' is the handle you gave the route server when adding it <br>
via the form in IXP Manager. E.g.<br>
<br>
bash ./api-reconfigure-example-birdv2.sh -d rs1-ipv4<br>
<br>
<br>
Once you have the route server running, you can then turn to Birdseye <br>
which integrates into IXP Manager for monitoring and looking glass <br>
features. That's documented at:<br>
<br>
<a href="https://docs.ixpmanager.org/features/looking-glass/" rel="noreferrer" target="_blank">https://docs.ixpmanager.org/features/looking-glass/</a><br>
<br>
<a href="https://github.com/inex/birdseye/blob/master/README.md" rel="noreferrer" target="_blank">https://github.com/inex/birdseye/blob/master/README.md</a><br>
<br>
<br>
  - Barry<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
_______________________________________________<br>
INEX IXP Manager mailing list<br>
<a href="mailto:ixpmanager@inex.ie" target="_blank">ixpmanager@inex.ie</a><br>
Unsubscribe or change options here: <a href="https://www.inex.ie/mailman/listinfo/ixpmanager" rel="noreferrer" target="_blank">https://www.inex.ie/mailman/listinfo/ixpmanager</a><br>
</blockquote></div>