3gpp-emulator

Authors: Ferm&iacute;n Gal&aacute;n (fermin at tid.es) Miguel G&oacute;mez (miguelg at tid.es) version 1.0, March Xth, 2008

Introduction
Introduce the context, citing TridentCom'08. Not too long (a couple of paragraph should be ok) [Miguel]

Reference Architecture
The reference scenario architecture (shown in figure below) is composed of several domains. Each domain consists of an core netowrk (CN) and an arbitrary number of access networks (ANs). The IMS lays within the CN, consisting of a set of CSCFs proxies (our model considers one of each type: P-CSCF, S-CSCF and I-CSCF). Each AN is connected to its corresponding CN through an Access Router (AR).

[Missing Figure]

The different domain CNs are connected through an interconnection point (IX), also known as inter-PLMS (Public Land Mobile Network) backbone. The IX also interconnect a segment of auxiliary network elements (such as a DNS server).

The scenario considers two kinds of attachment points for external equipment: access networks (for UEs) and IMS cores (for core entities, such as the SIP Application Server shown as example in the figure below).

The following script (TODO) allows VNUML multi-domain specifications automatically. Some observations follow:

vn script (you should have it in /usr/share/vnuml/contrib/vn_script if you installed VNUML through the .deb package or in the .tgz if you used the sources). For example: "vn console sae ar1". See the vn README for more detail.
 * The first parameter is the number of domains (D) and the second one the number of access network per domain (N).
 * The 'external' attribute is not added in neither acc*_* nor core* s, due to it is depend of the host physical interface (e.g., eth0, eth1, etc.) and the particular VLAN ID being used. Therefore, user needs to edit the resulting XML properly.
 * The script only generates homogeneous specifications, i.e. the same number of AN for each domain, although the resulting XML can be easily prune to fit user needs.
 * An auxiliary segment with a DNS server is added
 * IPv6 addresses are automatically assigned to each element
 * The is pts. The recommended way to access virtual machines is the

Intradomain Scenario
[Missing Figure]

Interdomain Mobility Scenario
The inter-domain mobility mobility can be download here: sae-inter.xml (TODO)

[Missing Figure]

The scenario is composed of five domains (it can be obtained after pruning the scenario generated by the script with D=5 and N=1), which may play the following roles:


 * Domain 1 (one AN): Terminating Visiting
 * Domain 2 (one AN): Originating Final Visiting
 * Domain 3 (one AN): Originating Initial Visiting
 * Domain 4 (no AN): Originating Home
 * Domain 5 (no AN): Terminating Home

Note that acc1_1, acc2_1 and acc3_1 s use the 'external' attribute in order to allow the interconnection of external UE equipment. However, note that the values considered in the example (eth0.121, eth0.122 and eth0.123) have to be changed to match the proper ones in your emulation environment.

 <!DOCTYPE vnuml SYSTEM "/usr/local/share/xml/vnuml/vnuml.dtd">

1.8    sae-inter   /usr/local/share/vnuml/kernels/linux pts 

          <net name="acc3_1" mode="uml_switch" /> <net name="acc3_2" mode="uml_switch" /> <net name="ppp3"  mode="uml_switch" /> <net name="core4" mode="uml_switch" /> <net name="acc4_1" mode="uml_switch" /> <net name="acc4_2" mode="uml_switch" /> <net name="ppp4"  mode="uml_switch" /> <net name="core5" mode="uml_switch" /> <net name="acc5_1" mode="uml_switch" /> <net name="acc5_2" mode="uml_switch" /> <net name="ppp5"  mode="uml_switch" /> <net name="aux"   mode="uml_switch" />

<vm name="dhcp1_1"> /usr/local/share/vnuml/filesystems/tridentcom-dhcpv6 <if id="1" net="acc1_1"> 2001:db8:1:2::2/64 </if> <route type="ipv6" gw="2001:db8:1:2::1">2000::/3 </vm>

<vm name="dhcp1_2"> /usr/local/share/vnuml/filesystems/tridentcom-dhcpv6 <if id="1" net="acc1_2"> 2001:db8:1:3::2/64 </if> <route type="ipv6" gw="2001:db8:1:3::1">2000::/3 </vm>

/usr/local/share/vnuml/filesystems/n3vlr-0.11-vnuml-v0.1.img <if id="1" net="acc1_1"> 2001:db8:1:2::1/64 </if> <if id="2" net="acc1_2"> 2001:db8:1:3::1/64 </if> 2001:db8:1:100::1/64 </if> <route type="ipv6" gw="2001:db8:1:100::2">2000::/3 </vm>

<vm name="p_cscf1"> /usr/local/share/vnuml/filesystems/tridentcom-node 2001:db8:1:1::2/64 </if> <route type="ipv6" gw="2001:db8:1:1::1">2001:db8:1:2::/64 <route type="ipv6" gw="2001:db8:1:1::100">2000::/3 </vm>

<vm name="s_cscf1"> /usr/local/share/vnuml/filesystems/tridentcom-node 2001:db8:1:1::3/64 </if> <route type="ipv6" gw="2001:db8:1:1::1">2001:db8:1:2::/64 <route type="ipv6" gw="2001:db8:1:1::100">2000::/3 </vm>

<vm name="i_cscf1"> /usr/local/share/vnuml/filesystems/tridentcom-node 2001:db8:1:1::4/64 </if> <route type="ipv6" gw="2001:db8:1:1::1">2001:db8:1:2::/64 <route type="ipv6" gw="2001:db8:1:1::100">2000::/3 </vm>

<vm name="p_gw1"> /usr/local/share/vnuml/filesystems/n3vlr-0.11-vnuml-v0.1.img 2001:db8:1:1::100/64 </if> 2001:db8:100::1/64 </if> 2001:db8:1:100::2/64 </if> <route type="ipv6" gw="2001:db8:1:100::1">2001:db8:1:2::/64 <route type="ipv6" gw="2001:db8:1:100::1">2001:db8:1:3::/64 <route type="ipv6" gw="2001:db8:100::2">2001:db8:2::/48 <route type="ipv6" gw="2001:db8:100::3">2001:db8:3::/48 <route type="ipv6" gw="2001:db8:100::4">2001:db8:4::/48 <route type="ipv6" gw="2001:db8:100::5">2001:db8:5::/48 <route type="ipv6" gw="2001:db8:100::200">2001:db8:200::/48 </vm>

<vm name="dhcp2_1"> /usr/local/share/vnuml/filesystems/tridentcom-dhcpv6 <if id="1" net="acc2_1"> 2001:db8:2:2::2/64 </if> <route type="ipv6" gw="2001:db8:2:2::1">2000::/3 </vm>

<vm name="dhcp2_2"> /usr/local/share/vnuml/filesystems/tridentcom-dhcpv6 <if id="1" net="acc2_2"> 2001:db8:2:3::2/64 </if> <route type="ipv6" gw="2001:db8:2:3::1">2000::/3 </vm>

/usr/local/share/vnuml/filesystems/n3vlr-0.11-vnuml-v0.1.img <if id="1" net="acc2_1"> 2001:db8:2:2::1/64 </if> <if id="2" net="acc2_2"> 2001:db8:2:3::1/64 </if> 2001:db8:2:100::1/64 </if> <route type="ipv6" gw="2001:db8:2:100::2">2000::/3 </vm>

<vm name="p_cscf2"> /usr/local/share/vnuml/filesystems/tridentcom-node 2001:db8:2:1::2/64 </if> <route type="ipv6" gw="2001:db8:2:1::1">2001:db8:2:2::/64 <route type="ipv6" gw="2001:db8:2:1::100">2000::/3 </vm>

<vm name="s_cscf2"> /usr/local/share/vnuml/filesystems/tridentcom-node 2001:db8:2:1::3/64 </if> <route type="ipv6" gw="2001:db8:2:1::1">2001:db8:2:2::/64 <route type="ipv6" gw="2001:db8:2:1::100">2000::/3 </vm>

<vm name="i_cscf2"> /usr/local/share/vnuml/filesystems/tridentcom-node 2001:db8:2:1::4/64 </if> <route type="ipv6" gw="2001:db8:2:1::1">2001:db8:2:2::/64 <route type="ipv6" gw="2001:db8:2:1::100">2000::/3 </vm>

<vm name="p_gw2"> /usr/local/share/vnuml/filesystems/n3vlr-0.11-vnuml-v0.1.img 2001:db8:2:1::100/64 </if> 2001:db8:100::2/64 </if> 2001:db8:2:100::2/64 </if> <route type="ipv6" gw="2001:db8:2:100::1">2001:db8:2:2::/64 <route type="ipv6" gw="2001:db8:2:100::1">2001:db8:2:3::/64 <route type="ipv6" gw="2001:db8:100::1">2001:db8:1::/48 <route type="ipv6" gw="2001:db8:100::3">2001:db8:3::/48 <route type="ipv6" gw="2001:db8:100::4">2001:db8:4::/48 <route type="ipv6" gw="2001:db8:100::5">2001:db8:5::/48 <route type="ipv6" gw="2001:db8:100::200">2001:db8:200::/48 </vm>

<vm name="dhcp3_1"> /usr/local/share/vnuml/filesystems/tridentcom-dhcpv6 <if id="1" net="acc3_1"> 2001:db8:3:2::2/64 </if> <route type="ipv6" gw="2001:db8:3:2::1">2000::/3 </vm>

<vm name="dhcp3_2"> /usr/local/share/vnuml/filesystems/tridentcom-dhcpv6 <if id="1" net="acc3_2"> 2001:db8:3:3::2/64 </if> <route type="ipv6" gw="2001:db8:3:3::1">2000::/3 </vm>

/usr/local/share/vnuml/filesystems/n3vlr-0.11-vnuml-v0.1.img <if id="1" net="acc3_1"> 2001:db8:3:2::1/64 </if> <if id="2" net="acc3_2"> 2001:db8:3:3::1/64 </if> 2001:db8:3:100::1/64 </if> <route type="ipv6" gw="2001:db8:3:100::2">2000::/3 </vm>

<vm name="p_cscf3"> /usr/local/share/vnuml/filesystems/tridentcom-node 2001:db8:3:1::2/64 </if> <route type="ipv6" gw="2001:db8:3:1::1">2001:db8:3:2::/64 <route type="ipv6" gw="2001:db8:3:1::100">2000::/3 </vm>

<vm name="s_cscf3"> /usr/local/share/vnuml/filesystems/tridentcom-node 2001:db8:3:1::3/64 </if> <route type="ipv6" gw="2001:db8:3:1::1">2001:db8:3:2::/64 <route type="ipv6" gw="2001:db8:3:1::100">2000::/3 </vm>

<vm name="i_cscf3"> /usr/local/share/vnuml/filesystems/tridentcom-node 2001:db8:3:1::4/64 </if> <route type="ipv6" gw="2001:db8:3:1::1">2001:db8:3:2::/64 <route type="ipv6" gw="2001:db8:3:1::100">2000::/3 </vm>

<vm name="p_gw3"> /usr/local/share/vnuml/filesystems/n3vlr-0.11-vnuml-v0.1.img 2001:db8:3:1::100/64 </if> 2001:db8:100::3/64 </if> 2001:db8:3:100::2/64 </if> <route type="ipv6" gw="2001:db8:3:100::1">2001:db8:3:2::/64 <route type="ipv6" gw="2001:db8:3:100::1">2001:db8:3:3::/64 <route type="ipv6" gw="2001:db8:100::1">2001:db8:1::/48 <route type="ipv6" gw="2001:db8:100::2">2001:db8:2::/48 <route type="ipv6" gw="2001:db8:100::4">2001:db8:4::/48 <route type="ipv6" gw="2001:db8:100::5">2001:db8:5::/48 <route type="ipv6" gw="2001:db8:100::200">2001:db8:200::/48 </vm>

<vm name="dhcp4_1"> /usr/local/share/vnuml/filesystems/tridentcom-dhcpv6 <if id="1" net="acc4_1"> 2001:db8:4:2::2/64 </if> <route type="ipv6" gw="2001:db8:4:2::1">2000::/3 </vm>

<vm name="dhcp4_2"> /usr/local/share/vnuml/filesystems/tridentcom-dhcpv6 <if id="1" net="acc4_2"> 2001:db8:4:3::2/64 </if> <route type="ipv6" gw="2001:db8:4:3::1">2000::/3 </vm>

/usr/local/share/vnuml/filesystems/n3vlr-0.11-vnuml-v0.1.img <if id="1" net="acc4_1"> 2001:db8:4:2::1/64 </if> <if id="2" net="acc4_2"> 2001:db8:4:3::1/64 </if> 2001:db8:4:100::1/64 </if> <route type="ipv6" gw="2001:db8:4:100::2">2000::/3 </vm>

<vm name="p_cscf4"> /usr/local/share/vnuml/filesystems/tridentcom-node 2001:db8:4:1::2/64 </if> <route type="ipv6" gw="2001:db8:4:1::1">2001:db8:4:2::/64 <route type="ipv6" gw="2001:db8:4:1::100">2000::/3 </vm>

<vm name="s_cscf4"> /usr/local/share/vnuml/filesystems/tridentcom-node 2001:db8:4:1::3/64 </if> <route type="ipv6" gw="2001:db8:4:1::1">2001:db8:4:2::/64 <route type="ipv6" gw="2001:db8:4:1::100">2000::/3 </vm>

<vm name="i_cscf4"> /usr/local/share/vnuml/filesystems/tridentcom-node 2001:db8:4:1::4/64 </if> <route type="ipv6" gw="2001:db8:4:1::1">2001:db8:4:2::/64 <route type="ipv6" gw="2001:db8:4:1::100">2000::/3 </vm>

<vm name="p_gw4"> /usr/local/share/vnuml/filesystems/n3vlr-0.11-vnuml-v0.1.img 2001:db8:4:1::100/64 </if> 2001:db8:100::4/64 </if> 2001:db8:4:100::2/64 </if> <route type="ipv6" gw="2001:db8:4:100::1">2001:db8:4:2::/64 <route type="ipv6" gw="2001:db8:4:100::1">2001:db8:4:3::/64 <route type="ipv6" gw="2001:db8:100::1">2001:db8:1::/48 <route type="ipv6" gw="2001:db8:100::2">2001:db8:2::/48 <route type="ipv6" gw="2001:db8:100::3">2001:db8:3::/48 <route type="ipv6" gw="2001:db8:100::5">2001:db8:5::/48 <route type="ipv6" gw="2001:db8:100::200">2001:db8:200::/48 </vm>

<vm name="dhcp5_1"> /usr/local/share/vnuml/filesystems/tridentcom-dhcpv6 <if id="1" net="acc5_1"> 2001:db8:5:2::2/64 </if> <route type="ipv6" gw="2001:db8:5:2::1">2000::/3 </vm>

<vm name="dhcp5_2"> /usr/local/share/vnuml/filesystems/tridentcom-dhcpv6 <if id="1" net="acc5_2"> 2001:db8:5:3::2/64 </if> <route type="ipv6" gw="2001:db8:5:3::1">2000::/3 </vm>

/usr/local/share/vnuml/filesystems/n3vlr-0.11-vnuml-v0.1.img <if id="1" net="acc5_1"> 2001:db8:5:2::1/64 </if> <if id="2" net="acc5_2"> 2001:db8:5:3::1/64 </if> 2001:db8:5:100::1/64 </if> <route type="ipv6" gw="2001:db8:5:100::2">2000::/3 </vm>

<vm name="p_cscf5"> /usr/local/share/vnuml/filesystems/tridentcom-node 2001:db8:5:1::2/64 </if> <route type="ipv6" gw="2001:db8:5:1::1">2001:db8:5:2::/64 <route type="ipv6" gw="2001:db8:5:1::100">2000::/3 </vm>

<vm name="s_cscf5"> /usr/local/share/vnuml/filesystems/tridentcom-node 2001:db8:5:1::3/64 </if> <route type="ipv6" gw="2001:db8:5:1::1">2001:db8:5:2::/64 <route type="ipv6" gw="2001:db8:5:1::100">2000::/3 </vm>

<vm name="i_cscf5"> /usr/local/share/vnuml/filesystems/tridentcom-node 2001:db8:5:1::4/64 </if> <route type="ipv6" gw="2001:db8:5:1::1">2001:db8:5:2::/64 <route type="ipv6" gw="2001:db8:5:1::100">2000::/3 </vm>

<vm name="p_gw5"> /usr/local/share/vnuml/filesystems/n3vlr-0.11-vnuml-v0.1.img 2001:db8:5:1::100/64 </if> 2001:db8:100::5/64 </if> 2001:db8:5:100::2/64 </if> <route type="ipv6" gw="2001:db8:5:100::1">2001:db8:5:2::/64 <route type="ipv6" gw="2001:db8:5:100::1">2001:db8:5:3::/64 <route type="ipv6" gw="2001:db8:100::1">2001:db8:1::/48 <route type="ipv6" gw="2001:db8:100::2">2001:db8:2::/48 <route type="ipv6" gw="2001:db8:100::3">2001:db8:3::/48 <route type="ipv6" gw="2001:db8:100::4">2001:db8:4::/48 <route type="ipv6" gw="2001:db8:100::200">2001:db8:200::/48 </vm>

/usr/local/share/vnuml/filesystems/tridentcom-dns 2001:db8:200::1/64 </if> <route type="ipv6" gw="2001:db8:200::100">2000::/3 </vm>

<vm name="aux_r"> 2001:db8:200::100/64 </if> 2001:db8:100::200/64 </if> <route type="ipv6" gw="2001:db8:5:1::1">2001:db8:5:2::/64 <route type="ipv6" gw="2001:db8:100::1">2001:db8:1::/48 <route type="ipv6" gw="2001:db8:100::2">2001:db8:2::/48 <route type="ipv6" gw="2001:db8:100::3">2001:db8:3::/48 <route type="ipv6" gw="2001:db8:100::4">2001:db8:4::/48 <route type="ipv6" gw="2001:db8:100::5">2001:db8:5::/48 </vm>

Supporting stuff
Link to filesystems, kernels, etc.

Roadmap
List of things to do. Open to contributions.