Skip to content

Commit

Permalink
Merge pull request #30 from atlanticwave-sdx/update_deploy_doc
Browse files Browse the repository at this point in the history 
update the doc with recent changes
  • Loading branch information
@italovalcy
italovalcy authored Oct 16, 2024
2 parents 4ab1a7c + 41441a8 commit cfd41ea
Show file tree
Hide file tree
Showing 3 changed files with 36 additions and 31 deletions.
Binary file added source/media/sdx-single3oxps.png
View file
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
55 changes: 28 additions & 27 deletions source/sdx_deploy_multi_server.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -72,14 +72,14 @@ Deploying SDX-Controller

.. code-block :: RST
docker run -d --name mq1 -e RABBITMQ_DEFAULT_USER=testsdx1 -e RABBITMQ_DEFAULT_PASS=testsdx1 -p 5672:5672 rabbitmq:latest
docker run -d --name mq1 --pull always -e RABBITMQ_DEFAULT_USER=testsdx1 -e RABBITMQ_DEFAULT_PASS=testsdx1 -p 5672:5672 rabbitmq:latest
2. Create an instance for MongoDB and configure a database/username/password:

.. code-block :: RST
docker run -d --name mongo mongo:5.0
docker exec -it mongo mongo --eval 'db.getSiblingDB("sdxctl").createUser({user: "sdxctl", pwd: "sdxctl", roles: [ { role: "dbAdmin", db: "sdxctl" } ]})'
docker run -d --name mongo --pull always mongo:7.0
docker exec -it mongo mongosh --eval 'db.getSiblingDB("sdxctl").createUser({user: "sdxctl", pwd: "sdxctl", roles: [ { role: "dbAdmin", db: "sdxctl" } ]})'
3. Install dependencies and build sdx-controller:

Expand Down Expand Up @@ -111,7 +111,9 @@ Deploying SDX-Controller

.. code-block :: RST
docker run -d --name mininet -it --privileged -v /lib/modules:/lib/modules italovalcy/mininet:latest https://raw.githubusercontent.com/atlanticwave-sdx/sdx-continuous-development/main/data-plane/container-mininet/link-hosts.py 192.168.56.100 192.168.56.102 192.168.56.103
curl -LO https://raw.githubusercontent.com/atlanticwave-sdx/sdx-continuous-development/main/data-plane/container-mininet/link-hosts.py
sed -i '1s/python/python3/g' link-hosts.py
docker run --pull always -d --name mininet -it --privileged -v /lib/modules:/lib/modules -v ./link-hosts.py:/link-hosts.py italovalcy/mininet:latest file:///link-hosts.py 192.168.56.100 192.168.56.102 192.168.56.103
Deploying OXP-Ampath
========================
Expand All @@ -120,9 +122,9 @@ Deploying OXP-Ampath

.. code-block :: RST
docker run -d --name mongo mongo:5.0
docker exec -it mongo mongo --eval 'db.getSiblingDB("amlight").createUser({user: "amlight", pwd: "amlight", roles: [ { role: "dbAdmin", db: "amlight" } ]})'
docker exec -it mongo mongo --eval 'db.getSiblingDB("sdx_lc").createUser({user: "sdxlcmongo_user", pwd: "sdxlcmongo_pw", roles: [ { role: "dbAdmin", db: "sdx_lc" } ]})'
docker run --pull always -d --name mongo mongo:7.0
docker exec -it mongo mongosh --eval 'db.getSiblingDB("amlight").createUser({user: "amlight", pwd: "amlight", roles: [ { role: "dbAdmin", db: "amlight" } ]})'
docker exec -it mongo mongosh --eval 'db.getSiblingDB("sdx_lc").createUser({user: "sdxlcmongo_user", pwd: "sdxlcmongo_pw", roles: [ { role: "dbAdmin", db: "sdx_lc" } ]})'
2. Install dependencies and build Kytos-ng OXPO:

Expand All @@ -131,7 +133,7 @@ Deploying OXP-Ampath
sudo apt-get install -y git vim jq
git clone https://github.com/atlanticwave-sdx/kytos-sdx
cd kytos-sdx
docker build -t kytos-sdx .
docker build --pull -t kytos-sdx .
3. Create an instance for Kytos-ng OXPO based on a set of environment variables:

Expand Down Expand Up @@ -159,6 +161,7 @@ Deploying OXP-Ampath
docker build -t sdx-lc .
cat >amlight-sdx-lc.env <<EOF
SDXLC_PORT=8080
MONGODB_CONNSTRING=mongodb://sdxlcmongo_user:sdxlcmongo_pw@mongo:27017/sdx_lc
OXP_CONNECTION_URL=http://192.168.56.100:8181/api/kytos/sdx/v1/l2vpn_ptp
DB_NAME=sdx_lc
Expand All @@ -173,7 +176,7 @@ Deploying OXP-Ampath
MQ_PASS=testsdx1
EOF
docker run -d --name ampath-sdx-lc --link mongo --env-file ampath-sdx-lc.env -p 8080:8080 sdx-lc:latest
docker run -d --name ampath-sdx-lc --link mongo --env-file amlight-sdx-lc.env -p 8080:8080 sdx-lc:latest
Deploying OXP-SAX
========================
Expand All @@ -182,9 +185,9 @@ Deploying OXP-SAX

.. code-block :: RST
docker run -d --name mongo mongo:5.0
docker exec -it mongo mongo --eval 'db.getSiblingDB("sax").createUser({user: "sax", pwd: "sax", roles: [ { role: "dbAdmin", db: "sax" } ]})'
docker exec -it mongo mongo --eval 'db.getSiblingDB("sdx_lc").createUser({user: "sdxlcmongo_user", pwd: "sdxlcmongo_pw", roles: [ { role: "dbAdmin", db: "sdx_lc" } ]})'
docker run --pull always -d --name mongo mongo:7.0
docker exec -it mongo mongosh --eval 'db.getSiblingDB("sax").createUser({user: "sax", pwd: "sax", roles: [ { role: "dbAdmin", db: "sax" } ]})'
docker exec -it mongo mongosh --eval 'db.getSiblingDB("sdx_lc").createUser({user: "sdxlcmongo_user", pwd: "sdxlcmongo_pw", roles: [ { role: "dbAdmin", db: "sdx_lc" } ]})'
2. Install dependencies and build Kytos-ng OXPO:

Expand All @@ -193,7 +196,7 @@ Deploying OXP-SAX
sudo apt-get install -y git vim jq
git clone https://github.com/atlanticwave-sdx/kytos-sdx
cd kytos-sdx
docker build -t kytos-sdx .
docker build --pull -t kytos-sdx .
3. Create an instance for Kytos-ng OXPO based on a set of environment variables:

Expand Down Expand Up @@ -221,6 +224,7 @@ Deploying OXP-SAX
docker build -t sdx-lc .
cat >sax-sdx-lc.env <<EOF
SDXLC_PORT=8080
MONGODB_CONNSTRING=mongodb://sdxlcmongo_user:sdxlcmongo_pw@mongo:27017/sdx_lc
OXP_CONNECTION_URL=http://192.168.56.102:8181/api/kytos/sdx/v1/l2vpn_ptp
DB_NAME=sdx_lc
Expand All @@ -229,8 +233,6 @@ Deploying OXP-SAX
OXP_PULL_INTERVAL=180
SDXLC_DOMAIN=sax.net
SUB_QUEUE=connection
SUB_EXCHANGE=connection
SUB_TOPIC=sax.net
MQ_HOST=192.168.56.104
MQ_PORT=5672
MQ_USER=testsdx1
Expand All @@ -246,9 +248,9 @@ Deploying OXP-Tenet

.. code-block :: RST
docker run -d --name mongo mongo:5.0
docker exec -it mongo mongo --eval 'db.getSiblingDB("tenet").createUser({user: "tenet", pwd: "tenet", roles: [ { role: "dbAdmin", db: "tenet" } ]})'
docker exec -it mongo mongo --eval 'db.getSiblingDB("sdx_lc").createUser({user: "sdxlcmongo_user", pwd: "sdxlcmongo_pw", roles: [ { role: "dbAdmin", db: "sdx_lc" } ]})'
docker run --pull always -d --name mongo mongo:7.0
docker exec -it mongo mongosh --eval 'db.getSiblingDB("tenet").createUser({user: "tenet", pwd: "tenet", roles: [ { role: "dbAdmin", db: "tenet" } ]})'
docker exec -it mongo mongosh --eval 'db.getSiblingDB("sdx_lc").createUser({user: "sdxlcmongo_user", pwd: "sdxlcmongo_pw", roles: [ { role: "dbAdmin", db: "sdx_lc" } ]})'
2. Install dependencies and build Kytos-ng OXPO:

Expand All @@ -257,7 +259,7 @@ Deploying OXP-Tenet
sudo apt-get install -y git vim jq
git clone https://github.com/atlanticwave-sdx/kytos-sdx
cd kytos-sdx
docker build -t kytos-sdx .
docker build --pull -t kytos-sdx .
3. Create an instance for Kytos-ng OXPO based on a set of environment variables:

Expand Down Expand Up @@ -285,6 +287,7 @@ Deploying OXP-Tenet
docker build -t sdx-lc .
cat >tenet-sdx-lc.env <<EOF
SDXLC_PORT=8080
MONGODB_CONNSTRING=mongodb://sdxlcmongo_user:sdxlcmongo_pw@mongo:27017/sdx_lc
OXP_CONNECTION_URL=http://192.168.56.103:8181/api/kytos/sdx/v1/l2vpn_ptp
DB_NAME=sdx_lc
Expand All @@ -293,8 +296,6 @@ Deploying OXP-Tenet
OXP_PULL_INTERVAL=180
SDXLC_DOMAIN=tenet.ac.za
SUB_QUEUE=connection
SUB_EXCHANGE=connection
SUB_TOPIC=tenet.ac.za
MQ_HOST=192.168.56.104
MQ_PORT=5672
MQ_USER=testsdx1
Expand Down Expand Up @@ -329,27 +330,27 @@ Final config on SDX-Controller

.. code-block :: RST
curl -s http://192.168.56.104:8080/SDX-Controller/1.0.0/topology | jq -r '.nodes[] | (.ports[] | .id)'
curl -s http://192.168.56.104:8080/SDX-Controller/1.0.0/topology | jq -r '.links[] | .id + " " + .ports[0].id + " " + .ports[1].id'
curl -s http://192.168.56.104:8080/SDX-Controller/topology | jq -r '.nodes[] | (.ports[] | .id)'
curl -s http://192.168.56.104:8080/SDX-Controller/topology | jq -r '.links[] | .id + " " + .ports[0] + " " + .ports[1]'
- Create a connection:

.. code-block :: RST
curl -s -X POST -H 'Content-type: application/json' http://0.0.0.0:8080/SDX-Controller/1.0.0/connection -d '{"name": "VLAN between AMPATH/300 and TENET/300", "endpoints": [{"port_id": "urn:sdx:port:ampath.net:Ampath3:50", "vlan": "300 "}, {"port_id": "urn:sdx:port:tenet.ac.za:Tenet03:50", "vlan": "300"}]}'
curl -s -X POST -H 'Content-type: application/json' http://0.0.0.0:8080/SDX-Controller/l2vpn/1.0 -d '{"name": "VLAN between AMPATH/300 and TENET/300", "endpoints": [{"port_id": "urn:sdx:port:ampath.net:Ampath3:50", "vlan": "300"}, {"port_id": "urn:sdx:port:tenet.ac.za:Tenet03:50", "vlan": "300"}]}'
- List the breakouts created on the OXPs:

.. code-block :: RST
sdx-controller:~$ curl -s http://192.168.56.100:8181/api/kytos/mef_eline/v2/evc/ | jq -r '.[] | .id + " " + .name + " active=" + (.active|tostring)'
73eb822faf6745 AMPATH_vlan_100_100 active=true
73eb822faf6745 AMPATH_vlan_100_4095 active=true
sdx-controller:~$ curl -s http://192.168.56.102:8181/api/kytos/mef_eline/v2/evc/ | jq -r '.[] | .id + " " + .name + " active=" + (.active|tostring)'
089d976599a44e SAX_vlan_100_100 active=true
089d976599a44e SAX_vlan_4095_4095 active=true
sdx-controller:~$ curl -s http://192.168.56.103:8181/api/kytos/mef_eline/v2/evc/ | jq -r '.[] | .id + " " + .name + " active=" + (.active|tostring)'
0050f201917949 TENET_vlan_100_100 active=false
0050f201917949 TENET_vlan_4095_100 active=true
Meican
=======
Expand Down
12 changes: 8 additions & 4 deletions source/sdx_deploy_single_server.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,10 @@ a docker compose file, template env file, and some useful scripts.
All build process will be based on **main** branches (note that we even
ignore the submodules and force cloning from main branch).

The topology being used on this setup is the following one:

.. image:: ./media/sdx-single3oxps.png

Pre-requirements
================

Expand Down Expand Up @@ -45,7 +49,7 @@ Deploying AW-SDX

.. code-block :: RST
for repo in sdx-lc sdx-controller kytos-sdx; do git -C $folder pull || git clone https://github.com/atlanticwave-sdx/$repo; cd $repo/; docker build -t $repo .; cd ..; done
for repo in sdx-lc sdx-controller kytos-sdx; do git -C $repo pull || git clone https://github.com/atlanticwave-sdx/$repo; cd $repo/; docker build -t $repo .; cd ..; done
4. Now we can finally bring the environment UP, by running:
Expand Down Expand Up @@ -110,14 +114,14 @@ Testing

.. code-block :: RST
curl -s http://0.0.0.0:8080/SDX-Controller/1.0.0/topology | jq -r '.nodes[] | (.ports[] | .id)'
curl -s http://0.0.0.0:8080/SDX-Controller/1.0.0/topology | jq -r '.links[] | .id + " " + .ports[0].id + " " + .ports[1].id'
curl -s http://0.0.0.0:8080/SDX-Controller/topology | jq -r '.nodes[] | (.ports[] | .id)'
curl -s http://0.0.0.0:8080/SDX-Controller/topology | jq -r '.links[] | .id + " " + .ports[0] + " " + .ports[1]'
- Try to create a connection creation request to SDX-Controller which should span requests to all other OXPs:

.. code-block :: RST
curl -s -X POST -H 'Content-type: application/json' http://0.0.0.0:8080/SDX-Controller/1.0.0/connection -d '{"name": "VLAN between AMPATH/300 and TENET/300", "endpoints": [{"port_id": "urn:sdx:port:ampath.net:Ampath3:50", "vlan": "300"}, {"port_id": "urn:sdx:port:tenet.ac.za:Tenet03:50", "vlan": "300"}]}'
curl -s -X POST -H 'Content-type: application/json' http://0.0.0.0:8080/SDX-Controller/l2vpn/1.0 -d '{"name": "VLAN between AMPATH/300 and TENET/300", "endpoints": [{"port_id": "urn:sdx:port:ampath.net:Ampath3:50", "vlan": "300"}, {"port_id": "urn:sdx:port:tenet.ac.za:Tenet03:50", "vlan": "300"}]}'
- Check if the connection was created on each OXP:

Expand Down

0 comments on commit cfd41ea

Please sign in to comment.