Skip to content

Commit c87f89e

Browse files
authored
Document new multi-AP configuration (#135)
* Document new multi-AP configuration * Remove obsolete TODO comment related to mkdocs
1 parent d6ceeb9 commit c87f89e

File tree

3 files changed

+12
-15
lines changed

3 files changed

+12
-15
lines changed

content/config/create_as.md

+12-13
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ parent: Configuration
44
nav_order: 10
55
---
66

7-
# Creating SCIONLab AS
7+
# Creating a SCIONLab AS
88

99
## SCIONLab Portal Overview
1010

@@ -24,7 +24,7 @@ This view is initially empty, later you will see a list of your ASes:
2424
* The columns in this summary refer to the configuration you've made for this AS, as discussed below.
2525
* The link with the <span class="fa fa-pencil"></span>-symbol in the `AS ID` column brings you to the edit page for an AS.
2626
* The link with the <span class="fa fa-download"></span>-symbol in the `Configuration` column lets you download the configuration tarfile for an AS.
27-
* The tick or cross in the `Active` column indicates whether an AS has been deactivated (using the corresponding button on the edit page).
27+
* The tick or cross in the `Active` column indicates whether an AS has been deactivated (using the corresponding button or check-boxes in the edit page).
2828

2929

3030
## Configure a SCIONLab AS
@@ -37,15 +37,20 @@ The `Create a new SCIONLab AS` button or the edit link for an existing AS will b
3737

3838
* Label: here you can add a short label for your AS that will be displayed on the `My ASes` list page. This label just helps you identify your ASes and doesn't have any other functionality.
3939

40-
* Attachment Point: this selects the provider AS for your AS. This selection also determines the ISD (isolation domain) which your AS will belong to.
40+
* Installation Type: select the way you have installed or will install SCION. Please refer to [Installation/Pick an Option](../install/index.html).
4141

42-
After creating your AS, you can still change your Attachment Point as often as you want.
42+
-----
4343

44-
For lower latency, prefer to pick an Attachment Point that is closest to you -- the topology map on the [SCIONLab home page](https://www.scionlab.org) has some hints on the geographical regions in which the ASes are located.
44+
The following options configure the "Provider links" for your AS. For each of your ASes, you can create up to 5 overlay links to provider infrastructure ASes called "Attachment Points".
45+
Each of these links is a Provider-Customer link in the SCION network topology, which cannot cross ISD (isolation domain) boundaries. Thus, you can create only links to Attachment Point ASes in the same ISD.
4546

46-
-----
47+
The interface is restricted to only add one link at a time. During creation of your AS, you can define (exactly) one "Provider link", later you can modify/add/remove links.
48+
49+
The following options configure each "Provider link", that is, the options define the parameters for the overlay link between the border router in your AS and the border router in an Attachment Point AS.
50+
51+
* Attachment Point: this selects the provider AS to which a link will be established. This selection also determines the ISD which your AS will belong to.
4752

48-
The following options are the parameters for the overlay link between the border router in your AS and the border router in the Attachment Point AS.
53+
For lower latency, prefer to pick an Attachment Point that is closest to you -- the topology map on the [SCIONLab home page](https://www.scionlab.org) has some hints on the geographical regions in which the ASes are located.
4954

5055
* Use VPN: if enabled, an OpenVPN tunnel is configured between your AS and the chosen Attachment Point.
5156

@@ -93,12 +98,6 @@ available Attachment Points have an IPv6 address configured.
9398
If you are behind a NAT or firewall, make sure to open/forward the chosen port. For this you may need to contact your network administrator.
9499
If you have a port forwarding rule that rewrites the port number, enter the local port number in the `Bind Port` field, otherwise leave it blank.
95100

96-
-----
97-
98-
Finally, select the type of SCION installation for which the configuration should be created.
99-
100-
* Installation Type: please refer to [Installation/Pick an Option](../install/index.html).
101-
102101

103102
## Download and install configuration
104103

-29.6 KB
Loading

content/install/pkg.md

-2
Original file line numberDiff line numberDiff line change
@@ -82,8 +82,6 @@ configuration tarfile from the SCIONLab website and unpack it.
8282
# Start SCION
8383
sudo systemctl start scionlab.target
8484

85-
[//]: # (TODO mkdocs is broken here, the f*in < renderes as &lt; ffs)
86-
8785

8886
## Running SCION
8987

0 commit comments

Comments
 (0)