Skip to content

Commit

Permalink
tutorial: topology source host missing causes [email protected]
Browse files Browse the repository at this point in the history
… to crash (#4619)

Hi,

I've tried to setup the freestanding SCION network as per the
[tutorial](https://docs.scion.org/en/latest/tutorials/deploy.html) and
ran into a few issues:

Using the default topology files from the website, the scion-router
service always crashes because of an invalid source IP (see screenshot
below):


![image](https://github.com/user-attachments/assets/cef3fa72-a945-438f-ac31-1bc535da2a44)

@tobiasmoldan realized that this can be resolved by adding the source IP
(or host name) to the local field in the topology:

`"underlay": {
            "local": "scion01:50012",
            "remote": "scion02:50012"
          },`

Secondly, I was wondering if all ASes need to be up and running for the
network to be fully functional? I have set up and configured scion01 and
scion02 as per the tutorial. All services (daemon, router, control,
dispatcher) are active and there is a direct link between the two VMs.
The machines are pingable (via normal ICMP), however, there is no
reachability via SCMP. I assume that, even without scion03-05, they
should have connectivity?

I got scion addresses for scion01 and scion02 respectively,

`42-ffaa:1:1,127.0.0.1`

`42-ffaa:1:2,127.0.0.1`

and I have generated the certificate material on scion01 and shared it
with scion02. Is there anything I'm missing - e.g., does path
exploration need to be triggered somehow or should it happen
automatically?

Thanks a lot for your help on this!

Best regards,

Thomas

---------

Co-authored-by: jiceatscion <[email protected]>
  • Loading branch information
thomasgruebl and jiceatscion authored Sep 17, 2024
1 parent a192c66 commit 24ec39d
Show file tree
Hide file tree
Showing 6 changed files with 18 additions and 18 deletions.
10 changes: 5 additions & 5 deletions doc/tutorials/deploy.rst
Original file line number Diff line number Diff line change
Expand Up @@ -86,11 +86,11 @@ OS Setup
.. code-block:: sh
# additions to /etc/hosts
10.0.1.1 scion01
10.0.1.2 scion02
10.0.1.3 scion03
10.0.1.4 scion04
10.0.1.5 scion05
10.0.0.1 scion01
10.0.0.2 scion02
10.0.0.3 scion03
10.0.0.4 scion04
10.0.0.5 scion05
.. _step1:
Expand Down
6 changes: 3 additions & 3 deletions doc/tutorials/deploy/topology1.json
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@
"interfaces": {
"1": {
"underlay": {
"local": ":50014",
"local": "scion01:50014",
"remote": "scion04:50014"
},
"isd_as": "42-ffaa:1:4",
Expand All @@ -29,7 +29,7 @@
},
"2": {
"underlay": {
"local": ":50012",
"local": "scion01:50012",
"remote": "scion02:50012"
},
"isd_as": "42-ffaa:1:2",
Expand All @@ -38,7 +38,7 @@
},
"3": {
"underlay": {
"local": ":50013",
"local": "scion01:50013",
"remote": "scion03:50013"
},
"isd_as": "42-ffaa:1:3",
Expand Down
6 changes: 3 additions & 3 deletions doc/tutorials/deploy/topology2.json
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@
"interfaces": {
"1": {
"underlay": {
"local": ":50012",
"local": "scion02:50012",
"remote": "scion01:50012"
},
"isd_as": "42-ffaa:1:1",
Expand All @@ -29,7 +29,7 @@
},
"2": {
"underlay": {
"local": ":50023",
"local": "scion02:50023",
"remote": "scion03:50023"
},
"isd_as": "42-ffaa:1:3",
Expand All @@ -38,7 +38,7 @@
},
"3": {
"underlay": {
"local": ":50025",
"local": "scion02:50025",
"remote": "scion05:50025"
},
"isd_as": "42-ffaa:1:5",
Expand Down
6 changes: 3 additions & 3 deletions doc/tutorials/deploy/topology3.json
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@
"interfaces": {
"1": {
"underlay": {
"local": ":50013",
"local": "scion03:50013",
"remote": "scion01:50013"
},
"isd_as": "42-ffaa:1:1",
Expand All @@ -29,7 +29,7 @@
},
"2": {
"underlay": {
"local": ":50023",
"local": "scion03:50023",
"remote": "scion02:50023"
},
"isd_as": "42-ffaa:1:2",
Expand All @@ -38,7 +38,7 @@
},
"3": {
"underlay": {
"local": ":50034",
"local": "scion03:50034",
"remote": "scion04:50034"
},
"isd_as": "42-ffaa:1:4",
Expand Down
4 changes: 2 additions & 2 deletions doc/tutorials/deploy/topology4.json
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@
"interfaces": {
"1": {
"underlay": {
"local": ":50014",
"local": "scion04:50014",
"remote": "scion01:50014"
},
"isd_as": "42-ffaa:1:1",
Expand All @@ -27,7 +27,7 @@
},
"2": {
"underlay": {
"local": ":50034",
"local": "scion04:50034",
"remote": "scion03:50034"
},
"isd_as": "42-ffaa:1:3",
Expand Down
4 changes: 2 additions & 2 deletions doc/tutorials/deploy/topology5.json
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@
"interfaces": {
"1": {
"underlay": {
"local": ":50025",
"local": "scion05:50025",
"remote": "scion02:50025"
},
"isd_as": "42-ffaa:1:2",
Expand All @@ -27,7 +27,7 @@
},
"2": {
"underlay": {
"local": ":50035",
"local": "scion05:50035",
"remote": "scion03:50035"
},
"isd_as": "42-ffaa:1:3",
Expand Down

0 comments on commit 24ec39d

Please sign in to comment.