GSOC2021NixVectorFinalReport - Revision history

Ameyanrd at 03:30, 27 August 2021

2021-08-27T03:30:46Z

← Older revision		Revision as of 03:30, 27 August 2021
Line 34:		Line 34:
	\| [4] \|\| [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/640 nix-vector-routing: tests] \|\| Merged \|\| [https://gitlab.com/nsnam/ns-3-dev/-/commit/972413ce80988761e6768ba18f20330813bac4d9 972413ce]		\| [4] \|\| [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/640 nix-vector-routing: tests] \|\| Merged \|\| [https://gitlab.com/nsnam/ns-3-dev/-/commit/972413ce80988761e6768ba18f20330813bac4d9 972413ce]
	\|-		\|-
	\| [5] \|\| [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/691 nix-vector-routing: Update CHANGES.html and RELEASE_NOTES] \|\| ~~Open~~ \|\|		\| [5] \|\| [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/691 nix-vector-routing: Update CHANGES.html and RELEASE_NOTES] \|\| Merged \|\| [https://gitlab.com/nsnam/ns-3-dev/-/commit/3563510a82c32a32ccf7f1b613d79833e1d410bb 3563510a]
	\|-		\|-
	\| [6] \|\| [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/690 nix-vector-routing: Handle Multiple Wifi connections with same channel object] \|\| ~~Open~~ \|\|		\| [6] \|\| [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/690 nix-vector-routing: Handle Multiple Wifi connections with same channel object] \|\| Merged \|\| [https://gitlab.com/nsnam/ns-3-dev/-/commit/7be87100a9bf8ef14a36eb3bae412fe554a7b5ce 7be87100]
	\|}		\|}

Ameyanrd at 18:49, 23 August 2021

2021-08-23T18:49:27Z

← Older revision		Revision as of 18:49, 23 August 2021
Line 62:		Line 62:
	== Phase 1 ==		== Phase 1 ==

	I started refactoring the IPv4 and added the initial template code to the existing code during this period. Later, we initialized the template classes with the corresponding IPv6 class parameters and started making suitable changes for IPv6. We faced some routing issues during this period, but they got resolved in a week or two. Apart from that, we also modified the existing example topology for IPv6 Nix-Vector routing and updated the documentation for Nix.		I started refactoring the IPv4 and added the initial template code to the existing code during this period. Later, we initialized the template classes with the corresponding IPv6 class parameters and started making suitable changes for IPv6. We faced some routing issues during this period, but they got resolved in a week or two. In ns-3, the local delivery mechanism for IPv4 and IPv6 slightly different. In IPv4, we have to handle it separately in each <em>RouteInput ()</em> and but for IPv6, it is handled in the <em>Ipv6L3Protocol</em>. We have used C++ template specialization to differentiate between such cases. Most of the code is the same between the specialised and generic function definition but we have kept it as it is for better code readability. We have used template specialization for <em>RouteOutput ()</em> and <em>RouteInput ()</em> functions. In <em>RouteOutput ()</em>, it is mainly to handle the link-local multicast send separately for IPv6.

			Apart from that, we also modified the existing example topology for IPv6 Nix-Vector routing and updated the documentation for Nix.

	MRs submitted during this phase: [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/656 [1]], [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/646 [2]], [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/678 [3]] and [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/640 [4]].		MRs submitted during this phase: [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/656 [1]], [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/646 [2]], [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/678 [3]] and [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/640 [4]].

Ameyanrd at 08:02, 20 August 2021

2021-08-20T08:02:04Z

← Older revision		Revision as of 08:02, 20 August 2021
Line 7:		Line 7:
	* '''Project Name:''' IPv6 Nix-Vector Routing		* '''Project Name:''' IPv6 Nix-Vector Routing
	* '''Student:''' [mailto:ameyanrd@outlook.com Ameya Deshpande]		* '''Student:''' [mailto:ameyanrd@outlook.com Ameya Deshpande]
	* '''Mentors:''' [mailto:manoj24.rana@gmail.com Manoj Kumar Rama], [mailto:~~tommaso~~.~~pecorella~~@~~unifi~~.~~it Tommaso Pecorella~~]		* '''Mentors:''' [mailto:tommaso.pecorella@unifi.it Tommaso Pecorella], [mailto:manoj24.rana@gmail.com Manoj Kumar Rama], [mailto:j.ivey@gatech.edu Jared Ivey]

	The project is about implementing an IPv6 Nix-Vector routing protocol with minimal code duplication. The project involved coming up with a strategy to refactor and reuse the existing IPv4 Nix-Vector routing code. Nix routing is not a “real” routing protocol but is fast and helpful while working with huge topologies. This work also forms a basis for adding the support for other IPv4 routing protocols in ns-3, especially Global routing, as it is similar to Nix-Vector routing in some aspects.		The project is about implementing an IPv6 Nix-Vector routing protocol with minimal code duplication. The project involved coming up with a strategy to refactor and reuse the existing IPv4 Nix-Vector routing code. Nix routing is not a “real” routing protocol but is fast and helpful while working with huge topologies. This work also forms a basis for adding the support for other IPv4 routing protocols in ns-3, especially Global routing, as it is similar to Nix-Vector routing in some aspects.

Ameyanrd at 18:10, 19 August 2021

2021-08-19T18:10:06Z

← Older revision		Revision as of 18:10, 19 August 2021
Line 58:		Line 58:
	The above MR was created during the Community Bonding Period itself. The IPv4 Nix-Vector routing test suite was added during this period. Later, we decided to use the same MR for even the IPv6 tests.		The above MR was created during the Community Bonding Period itself. The IPv4 Nix-Vector routing test suite was added during this period. Later, we decided to use the same MR for even the IPv6 tests.

	Another thing was that the proposal made heavy usage of C++ templates, aliases, and some constructs from C++11 ~~and14~~. So, a concern was if the Python Bindings will be generated without any issues. So, I did the Python Bindings setup for rescanning nix-vector-routing in this period itself.		Another thing was that the proposal made heavy usage of C++ templates, aliases, and some constructs from C++11 and 14. So, a concern was if the Python Bindings will be generated without any issues. So, I did the Python Bindings setup for rescanning nix-vector-routing in this period itself.

	== Phase 1 ==		== Phase 1 ==

Ameyanrd at 18:08, 19 August 2021

2021-08-19T18:08:47Z

← Older revision		Revision as of 18:08, 19 August 2021
Line 52:		Line 52:
	=== Pre-coding phase setup ===		=== Pre-coding phase setup ===

	For refactoring the existing IPv4 Nix-Vector routing code, an initial set of tests is required to make sure that we don’t change the existing behavior of the ~~current (~~working) IPv4 code. There was no test suite written for IPv4 Nix routing, so we decided to write one before the start of the Coding Phase.		For refactoring the existing IPv4 Nix-Vector routing code, an initial set of tests was required to make sure that we don’t change the existing behavior of the working IPv4 code. There was no test suite written for IPv4 Nix routing, so we decided to write one before the start of the Coding Phase.

	Nix Tests Merge Request: [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/640 [4]]		Nix Tests Merge Request: [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/640 [4]]

Ameyanrd at 17:52, 19 August 2021

2021-08-19T17:52:15Z

← Older revision		Revision as of 17:52, 19 August 2021
Line 24:		Line 24:
	\|+ Merge Requests		\|+ Merge Requests
	\|-		\|-
	! No. !! Name !! Status		! No. !! Name !! Status !! Commit
	\|-		\|-
	\| [1] \|\| [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/656 internet: Make similar functions in IPv4 and IPv6 consistent with naming] \|\| Merged		\| [1] \|\| [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/656 internet: Make similar functions in IPv4 and IPv6 consistent with naming] \|\| Merged \|\| [https://gitlab.com/nsnam/ns-3-dev/-/commit/3294de147903c6635fe82771de35b83122a8486b 3294de14]
	\|-		\|-
	\| [2] \|\| [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/646 nix-vector-routing: template-based Nix-Vector Routing - IPv4 and IPv6 compliant.] \|\| Merged		\| [2] \|\| [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/646 nix-vector-routing: template-based Nix-Vector Routing - IPv4 and IPv6 compliant.] \|\| Merged \|\| [https://gitlab.com/nsnam/ns-3-dev/-/commit/a80d4c95e0e37907763c5a6faccbb49123d7b730 a80d4c95]
	\|-		\|-
	\| [3] \|\| [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/678 nix-vector-routing: Update doc on IPv6, examples and usage] \|\| Merged		\| [3] \|\| [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/678 nix-vector-routing: Update doc on IPv6, examples and usage] \|\| Merged \|\| [https://gitlab.com/nsnam/ns-3-dev/-/commit/ec05adaa9fac8278b48e4cc460aa382a38819a48 ec05adaa]
	\|-		\|-
	\| [4] \|\| [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/640 nix-vector-routing: tests] \|\| Merged		\| [4] \|\| [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/640 nix-vector-routing: tests] \|\| Merged \|\| [https://gitlab.com/nsnam/ns-3-dev/-/commit/972413ce80988761e6768ba18f20330813bac4d9 972413ce]
	\|-		\|-
	\| [5] \|\| [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/691 nix-vector-routing: Update CHANGES.html and RELEASE_NOTES] \|\| Open		\| [5] \|\| [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/691 nix-vector-routing: Update CHANGES.html and RELEASE_NOTES] \|\| Open \|\|
	\|-		\|-
	\| [6] \|\| [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/690 nix-vector-routing: Handle Multiple Wifi connections with same channel object] \|\| Open		\| [6] \|\| [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/690 nix-vector-routing: Handle Multiple Wifi connections with same channel object] \|\| Open \|\|
	\|}		\|}

Ameyanrd at 17:44, 19 August 2021

2021-08-19T17:44:20Z

← Older revision		Revision as of 17:44, 19 August 2021
Line 4:		Line 4:

	= Project Overview =		= Project Overview =

			* '''Project Name:''' IPv6 Nix-Vector Routing
			* '''Student:''' [mailto:ameyanrd@outlook.com Ameya Deshpande]
			* '''Mentors:''' [mailto:manoj24.rana@gmail.com Manoj Kumar Rama], [mailto:tommaso.pecorella@unifi.it Tommaso Pecorella]

	The project is about implementing an IPv6 Nix-Vector routing protocol with minimal code duplication. The project involved coming up with a strategy to refactor and reuse the existing IPv4 Nix-Vector routing code. Nix routing is not a “real” routing protocol but is fast and helpful while working with huge topologies. This work also forms a basis for adding the support for other IPv4 routing protocols in ns-3, especially Global routing, as it is similar to Nix-Vector routing in some aspects.		The project is about implementing an IPv6 Nix-Vector routing protocol with minimal code duplication. The project involved coming up with a strategy to refactor and reuse the existing IPv4 Nix-Vector routing code. Nix routing is not a “real” routing protocol but is fast and helpful while working with huge topologies. This work also forms a basis for adding the support for other IPv4 routing protocols in ns-3, especially Global routing, as it is similar to Nix-Vector routing in some aspects.

Ameyanrd: Created page with "{{TOC}} Back to GSoC 2021 projects = Project Overview = The project is about implementing an IPv6 Nix-Vector routing protoc..."

2021-08-19T15:14:34Z

Created page with "{{TOC}} Back to GSoC 2021 projects = Project Overview = The project is about implementing an IPv6 Nix-Vector routing protoc..."

New page

{{TOC}}

Back to [[Summer_Projects#Google_Summer_of_Code_2021 | GSoC 2021 projects]]

= Project Overview =

The project is about implementing an IPv6 Nix-Vector routing protocol with minimal code duplication. The project involved coming up with a strategy to refactor and reuse the existing IPv4 Nix-Vector routing code. Nix routing is not a “real” routing protocol but is fast and helpful while working with huge topologies. This work also forms a basis for adding the support for other IPv4 routing protocols in ns-3, especially Global routing, as it is similar to Nix-Vector routing in some aspects.

== Merge Requests, Commits, and Project Details ==

We maintained a single branch for all the GSoC work, named [https://gitlab.com/ameyanrd/ns-3-dev/-/tree/gsoc-21 ''gsoc-21''].

Project Wiki Page: [https://www.nsnam.org/wiki/GSOC2021NixVector ''GSOC2021NixVector'']

Proposal: [https://drive.google.com/file/d/18IpyX-UdrX7v_Xh-jpEixdEExq_0gsZa/view?usp=sharing ''link'']

To create a Merge Request, I picked the particular set of related commits from ''gsoc-21'', applied them on another master-derived branch, and then made an MR.

{| class="wikitable"
|+ Merge Requests
|-
! No. !! Name !! Status
|-
| [1] || [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/656 internet: Make similar functions in IPv4 and IPv6 consistent with naming] || Merged
|-
| [2] || [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/646 nix-vector-routing: template-based Nix-Vector Routing - IPv4 and IPv6 compliant.] || Merged
|-
| [3] || [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/678 nix-vector-routing: Update doc on IPv6, examples and usage] || Merged
|-
| [4] || [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/640 nix-vector-routing: tests] || Merged
|-
| [5] || [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/691 nix-vector-routing: Update CHANGES.html and RELEASE_NOTES] || Open
|-
| [6] || [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/690 nix-vector-routing: Handle Multiple Wifi connections with same channel object] || Open
|}

== Community Bonding Period ==

=== Discuss the plan and actions ===

During this period, we had decided on how to work on the project. Below are some of the things we did for this:
* Fix a weekly video call meeting for discussions and doubts.
* Discuss the ideas mentioned in the proposal and how they should be organized into different Merge Requests.
* Maintain a single gsoc-21 for all the work to be done during the Coding period.
* Plan a weekly project update, sent to the ns-developers mailing list.
* Layout a Design Documentation for the project.

=== Pre-coding phase setup ===

For refactoring the existing IPv4 Nix-Vector routing code, an initial set of tests is required to make sure that we don’t change the existing behavior of the current (working) IPv4 code. There was no test suite written for IPv4 Nix routing, so we decided to write one before the start of the Coding Phase.

Nix Tests Merge Request: [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/640 [4]]

The above MR was created during the Community Bonding Period itself. The IPv4 Nix-Vector routing test suite was added during this period. Later, we decided to use the same MR for even the IPv6 tests.

Another thing was that the proposal made heavy usage of C++ templates, aliases, and some constructs from C++11 and14. So, a concern was if the Python Bindings will be generated without any issues. So, I did the Python Bindings setup for rescanning nix-vector-routing in this period itself.

== Phase 1 ==

I started refactoring the IPv4 and added the initial template code to the existing code during this period. Later, we initialized the template classes with the corresponding IPv6 class parameters and started making suitable changes for IPv6. We faced some routing issues during this period, but they got resolved in a week or two. Apart from that, we also modified the existing example topology for IPv6 Nix-Vector routing and updated the documentation for Nix.

MRs submitted during this phase: [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/656 [1]], [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/646 [2]], [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/678 [3]] and [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/640 [4]].

== Phase 2 (Final Phase) ==

During Phase 2, I worked on all the comments and suggestions provided by the mentors and reviewers on the first 4 MRs. Along with this, we started working on a new feature i.e., add support for Nix-Vector routing with topologies having more than one WiFi network using the same WiFi channel object.

MRs submitted during this phase: [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/691 [5]] and [https://gitlab.com/nsnam/ns-3-dev/-/merge_requests/690 [6]]

== Proposal vs. Actual Work ==

We followed the GSoC proposal mainly throughout the project. We made a few changes with respect to code optimization, consistency, code maintainability, documentation, etc. These changes were made as we carried out the implementation. But overall, the idea proposed in the GSoC proposal remained the same.

The proposal kept some room for changes and potential blockers to the proposed implementation. For example, we didn’t know if the proposed modifications will work with the Python Bindings Generator, and when Tom Henderson pointed it out, I made a note of it in the proposal. However, the ideas mentioned worked out, and we didn’t have to change our implementation strategy.

We completed the proposed work before the timeline and moved on to a new feature.

= My Experience =

== Acknowledgment ==

I would like to thank all the mentors and ns-3 developers for helping me with my doubts and difficulties and for giving me this opportunity to be a part of GSoC’21 under ns-3. I had a great experience working on this project. I learned a lot of new concepts while working on this project. Our weekly discussions were very exciting - Apart from me giving the project updates, we used to have some good discussions on different topics and scenarios. A lot of times, we also dug into the code to identify and resolve the issues. This experience has taught me a lot, and it will definitely help me in the days to come. I would also like to thank Google for providing such a great opportunity.

== Any difficulties faced? How did we overcome it? ==

In general, most of the proposal ideas worked out. But sometimes, I have been stuck debugging the code for different issues. It took me around a week to resolve some of them each. The mentors were a great help during this process. Whenever it took more time to debug, I reached out to the mentors on our Zulip group to help me identify the issue. Even if the issue wasn’t resolved, we had gotten close to identifying and/or fixing it. And soon, the problem got resolved.

== Any Suggestions for Future Students? ==

* Use the Community Bonding Period well!
** Run through your timeline, discuss the idea with the mentors and identify any potential blockers.
** Get familiar with the code and gain confidence before you start working on the project.

* Reach out to the mentors or ns-3 community for help, suggestions, and updates.
** If you are stuck on something, don’t waste time till the next meeting. Give it a good try and reach out to your mentors soon!
** Keep communicating with your mentors throughout the week to keep them updated.

* Plan the GSoC project foreseeing your other future commitments.
** If you have any other commitments during the GSoC period, inform your mentors and plan your activities accordingly. If possible, please foresee this while writing your proposal itself.

* Make the most out of it!
** These ten weeks will be full of fun and learning experiences. Remember that you are getting a mentorship, and it’s an excellent opportunity for you.