ns-3 নেটওয়ার্ক সিমুলেটর টিউটোরিয়াল। অধ্যায় 3

অধ্যায় 1,2

3 শুরু করা
3.1। সংক্ষিপ্ত বিবরণ
3.2 পূর্বশর্ত
3.2.1 উৎস সংরক্ষণাগার হিসেবে ns-3 রিলিজ ডাউনলোড করা হচ্ছে
3.3 গিট ব্যবহার করে ns-3 ডাউনলোড করা হচ্ছে
3.3.1 বেক ব্যবহার করে ns-3 লোড হচ্ছে
3.4 সমাবেশ ns-3
3.4.1 build.py সহ বিল্ডিং
3.4.2 বেক সহ বিল্ডিং
3.4.3 ওয়াফ দিয়ে তৈরি করুন
3.5 টেস্টিং ns-3
3.6 স্ক্রিপ্ট চালানো
3.6.1 কমান্ড লাইন আর্গুমেন্ট
3.6.2 ডিবাগিং
3.6.3 ওয়ার্কিং ডিরেক্টরি

অধ্যায় 3

শুরু হচ্ছে

এই অধ্যায়টি পাঠককে এমন একটি কম্পিউটার দিয়ে শুরু করার জন্য প্রস্তুত করার উদ্দেশ্যে যা ns-3 ইনস্টল করেনি। এটি সমর্থিত প্ল্যাটফর্মগুলি, পূর্বশর্তগুলি, কীভাবে ns-3 পেতে হয়, কীভাবে ns-3 তৈরি করতে হয় এবং কীভাবে আপনার বিল্ড এবং সহজ প্রোগ্রামগুলি চালানোর পরীক্ষা করতে হয় তা কভার করে।

3.1। সংক্ষিপ্ত বিবরণ

ns-3 সিমুলেটরটি সহযোগিতামূলক সফ্টওয়্যার লাইব্রেরির একটি সিস্টেম হিসাবে তৈরি করা হয়েছে। সমাবেশের সময়, ব্যবহারকারীর প্রোগ্রামগুলির কোড এই লাইব্রেরির সাথে সংযুক্ত থাকে। C++ বা পাইথন প্রোগ্রামিং ভাষা কাস্টম প্রোগ্রাম লিখতে ব্যবহৃত হয়।

Ns-3 সোর্স কোড হিসাবে বিতরণ করা হয়, যার মানে লক্ষ্য সিস্টেমের একটি সফ্টওয়্যার উন্নয়ন পরিবেশ থাকতে হবে প্রথমে লাইব্রেরি তৈরি করতে এবং তারপর ব্যবহারকারী প্রোগ্রাম তৈরি করতে। নীতিগতভাবে, ns-3 একটি নির্দিষ্ট সিস্টেমের জন্য তৈরি লাইব্রেরি হিসাবে বিতরণ করা যেতে পারে এবং ভবিষ্যতে সেগুলি এভাবে বিতরণ করা যেতে পারে। কিন্তু আজকাল অনেক ব্যবহারকারী আসলে ns-3 নিজেই সম্পাদনা করে তাদের কাজ করে, তাই লাইব্রেরি তৈরির জন্য সোর্স কোড থাকা দরকারী। কেউ যদি অপারেটিং সিস্টেমের জন্য রেডিমেড লাইব্রেরি এবং প্যাকেজ তৈরির কাজটি নিতে চান, দয়া করে মেইলিং লিস্টে যোগাযোগ করুন ns-ডেভেলপাররা.

এর পরে, আমরা ns-3 ডাউনলোড এবং তৈরি করার তিনটি উপায় দেখব। প্রথমটি হল মূল সাইট থেকে অফিসিয়াল রিলিজ ডাউনলোড এবং তৈরি করা। দ্বিতীয়টি হল মৌলিক ns-3 ইনস্টলেশনের উন্নয়ন সংস্করণের অনুলিপি নির্বাচন এবং সমাবেশ। তৃতীয়টি হল ns-3 এর জন্য আরও এক্সটেনশন লোড করতে অতিরিক্ত বিল্ড টুল ব্যবহার করা। আমরা প্রতিটির মধ্য দিয়ে যাব যেহেতু সরঞ্জামগুলি কিছুটা আলাদা।

অভিজ্ঞ লিনাক্স ব্যবহারকারীরা ভাবতে পারেন কেন প্যাকেজ ম্যানেজার ব্যবহার করে এমন অন্যান্য লাইব্রেরির মতো প্যাকেজ হিসাবে ns-3 প্রদান করা হয় না? যদিও বিভিন্ন লিনাক্স ডিস্ট্রিবিউশনের জন্য বাইনারি প্যাকেজ রয়েছে (যেমন ডেবিয়ান), বেশিরভাগ ব্যবহারকারীরা লাইব্রেরি সম্পাদনা করে এবং ns-3 নিজেরাই পুনর্নির্মাণ করে, তাই সোর্স কোড উপলব্ধ থাকা সহজ। এই কারণে, আমরা উত্স থেকে ইনস্টল করার উপর ফোকাস করব।

বেশিরভাগ অ্যাপ্লিকেশনের জন্য ns-3 অধিকার শিকড় প্রয়োজন নেই, এটি একটি সুবিধাবিহীন ব্যবহারকারী অ্যাকাউন্ট ব্যবহার করার সুপারিশ করা হয়।

3.2 পূর্বশর্ত

উপলব্ধ ns-3 লাইব্রেরিগুলির সম্পূর্ণ সেটের তৃতীয়-পক্ষের লাইব্রেরির উপর অনেকগুলি নির্ভরতা রয়েছে, তবে বেশিরভাগ অংশের জন্য ns-3 তৈরি করা যেতে পারে এবং বেশ কয়েকটি সাধারণ (প্রায়ই ডিফল্টভাবে ইনস্টল করা) উপাদানগুলির সমর্থনে ব্যবহার করা যেতে পারে: একটি C++ কম্পাইলার, পাইথন, একটি উৎস কোড সম্পাদক (উদাহরণস্বরূপ, তেজ, Emacs বা অন্ধকার) এবং, যদি ডেভেলপমেন্ট রিপোজিটরি ব্যবহার করা হয়, গিট সংস্করণ নিয়ন্ত্রণ ব্যবস্থা। বেশিরভাগ প্রথমবার ব্যবহারকারীদের চিন্তা করতে হবে না যদি তাদের কনফিগারেশনে কিছু ns-3 উন্নত বৈশিষ্ট্য অনুপস্থিত থাকে তবে যারা সম্পূর্ণ ইনস্টলেশন চান তাদের জন্য প্রকল্পটি একটি উইকি প্রদান করে যাতে প্রচুর দরকারী টিপস এবং কৌশল সহ পৃষ্ঠাগুলি অন্তর্ভুক্ত থাকে। এরকম একটি পৃষ্ঠা হল ইনস্টলেশন পৃষ্ঠা, বিভিন্ন সিস্টেমের জন্য ইনস্টলেশন নির্দেশাবলী সহ, এখানে উপলব্ধ: https://www.nsnam.org/wiki/Installation.

এই উইকির পূর্বশর্ত বিভাগটি ব্যাখ্যা করে যে সাধারণ ns-3 বিকল্পগুলিকে সমর্থন করার জন্য কোন প্যাকেজগুলি প্রয়োজন এবং লিনাক্স বা macOS-এর সাধারণ ফ্লেভারগুলিতে সেগুলি ইনস্টল করার জন্য ব্যবহৃত কমান্ডগুলিও প্রদান করে।

আপনি ns-3 উইকি পৃষ্ঠা বা প্রধান ওয়েবসাইট অন্বেষণ করার জন্য এই সুযোগের সদ্ব্যবহার করতে পারেন: https://www.nsnam.org, কারণ সেখানে অনেক তথ্য আছে। ns-3 (ns-3.29) এর সর্বশেষ সংস্করণ দিয়ে শুরু করে, ns-3 চালানোর জন্য নিম্নলিখিত সরঞ্জামগুলির প্রয়োজন:

টুল প্যাকেজ/সংস্করণ

• C++ কম্পাইলার
  ক্ল্যাং++ বা জি++ (জি++ সংস্করণ 4.9 বা উচ্চতর)
• পাইথন
  python2 সংস্করণ >= 2.7.10, অথবা python3 সংস্করণ >=3.4
• git
  যেকোনো সর্বশেষ সংস্করণ (GitLab.com এ ns-3 অ্যাক্সেস করতে)
• আলকাতরা
  যেকোনো সর্বশেষ সংস্করণ (এনএস-৩ রিলিজ আনপ্যাক করার জন্য)
• bunzip2
  যেকোনো সর্বশেষ সংস্করণ (NS-3 রিলিজ আনপ্যাক করার জন্য)

পাইথনের ডিফল্ট সংস্করণ পরীক্ষা করতে, টাইপ করুন python -V. জি++ সংস্করণ পরীক্ষা করতে, টাইপ করুন g++ -v. যদি কোনো সরঞ্জাম অনুপস্থিত বা খুব পুরানো হয়, অনুগ্রহ করে ns-3 উইকি পৃষ্ঠায় ইনস্টলেশন গাইড পড়ুন।

এখন থেকে, আমরা অনুমান করি যে পাঠক লিনাক্স, ম্যাকওএস বা একটি লিনাক্স এমুলেটর চালাচ্ছেন এবং কমপক্ষে উপরের সরঞ্জামগুলি রয়েছে৷

3.2.1 উৎস সংরক্ষণাগার হিসেবে ns-3 রিলিজ ডাউনলোড করা হচ্ছে

এটি একটি নতুন ব্যবহারকারীর জন্য পদক্ষেপ যা ns-3 এর সর্বশেষ প্রকাশ এবং প্যাকেজ সংস্করণ ডাউনলোড করতে এবং পরীক্ষা করতে চায়। ns-3 রিলিজ কম্প্রেসড সোর্স আর্কাইভ হিসাবে প্রকাশিত হয়, কখনও কখনও বলা হয় তারবাল. তারবাল একটি বিশেষ সফ্টওয়্যার সংরক্ষণাগার বিন্যাস যাতে বেশ কয়েকটি ফাইল একসাথে একত্রিত হয়। সংরক্ষণাগার সাধারণত সংকুচিত হয়. ns-3 বুট প্রক্রিয়ার মাধ্যমে তারবাল সহজ, আপনাকে শুধু একটি রিলিজ নির্বাচন করতে হবে, ডাউনলোড করতে হবে এবং আনপ্যাক করতে হবে।

ধরুন আপনি, একজন ব্যবহারকারী হিসাবে, একটি স্থানীয় ডিরেক্টরিতে ns-3 তৈরি করতে চান কর্মক্ষেত্র. আপনি লিনাক্স কনসোলে নিম্নলিখিতটি প্রবেশ করে রিলিজের একটি কার্যকরী অনুলিপি পেতে পারেন (অবশ্যই উপযুক্ত সংস্করণ নম্বরগুলি প্রতিস্থাপন করে)

$ cd 
$ mkdir workspace 
$ cd workspace 
$ wget https://www.nsnam.org/release/ns-allinone-3.29.tar.bz2 
$ tar xjf ns-allinone-3.29.tar.bz2 

উপরে ব্যবহৃত ইউটিলিটি মনোযোগ দিন wget হয়, যা ইন্টারনেট থেকে অবজেক্ট ডাউনলোড করার জন্য একটি কমান্ড লাইন টুল। আপনি এটি ইনস্টল না করে থাকলে, আপনি এটির জন্য আপনার ব্রাউজার ব্যবহার করতে পারেন।

এই পদক্ষেপগুলি অনুসরণ করলে আপনাকে ns-allinone-3.29 ডিরেক্টরিতে নিয়ে যাবে, সেখানে আপনাকে বেশ কয়েকটি ফাইল এবং ডিরেক্টরি দেখতে হবে

$ cd ns-allinone-3.29
$ ls
bake constants.py ns-3.29 README
build.py netanim-3.108 pybindgen-0.17.0.post58+ngcf00cc0 util.py

আপনি এখন একটি মৌলিক ns-3 ডিস্ট্রিবিউশন তৈরি করতে প্রস্তুত এবং ns-3 বিল্ডিংয়ের বিভাগে যেতে পারেন।

3.3 গিট ব্যবহার করে ns-3 ডাউনলোড করা হচ্ছে

ns-3 কোডটি GitLab.com-এ গিট রিপোজিটরিতে পাওয়া যায় https://gitlab.com/nsnam/. গ্রুপ nsnam একটি ওপেন সোর্স প্রজেক্ট দ্বারা ব্যবহৃত বিভিন্ন রিপোজিটরি একত্রিত করে।

গিট রিপোজিটরি ব্যবহার শুরু করার সবচেয়ে সহজ উপায় হল পরিবেশকে কাঁটাচামচ বা ক্লোন করা ns-3-অ্যালিনোন. এটি একটি স্ক্রিপ্টের সেট যা সর্বাধিক ব্যবহৃত ns-3 সাবসিস্টেমের লোডিং এবং সমাবেশ পরিচালনা করে। আপনি যদি গিটে নতুন হয়ে থাকেন, তাহলে "ফর্ক" এবং "ক্লোন" শব্দটি আপনার কাছে অপরিচিত হতে পারে; যদি তাই হয়, তাহলে আমরা সুপারিশ করছি যে আপনি GitLab.com-এ অবস্থিত সংগ্রহস্থলটি এইভাবে ক্লোন করুন (আপনার নিজস্ব অনুলিপি তৈরি করুন):

$ cd 
$ mkdir workspace 
$ cd workspace 
$ git clone https://gitlab.com/nsnam/ns-3-allinone.git 
$ cd ns-3-allinone 

এই পর্যায়ে, আপনার ডিরেক্টরির দৃশ্য ns-3-অ্যালিনোন উপরে বর্ণিত রিলিজ সংরক্ষণাগার ডিরেক্টরি থেকে সামান্য ভিন্ন। এটি এই মত কিছু দেখা উচিত:

$ ls
build.py constants.py download.py README util.py

একটি স্ক্রিপ্ট আছে যে দয়া করে নোট করুন download.py, যা অতিরিক্তভাবে ns-3 এবং সহগামী সোর্স কোড বের করবে। এখানে আপনার একটি পছন্দ আছে: হয় সর্বশেষ ns-3 ডেভেলপমেন্ট স্ন্যাপশট ডাউনলোড করুন:

$ python download.py

অথবা পতাকা ব্যবহার করে ns-3 রিলিজ পছন্দ করুন -n রিলিজ সংখ্যা নির্দেশ করতে:

$ python download.py -n ns-3.29

এই ধাপের পর ডিরেক্টরিতে যান ns-3-অ্যালিনোন অতিরিক্ত সংগ্রহস্থল ডাউনলোড করা হবে ns-3, সেকা, পাইবিন্ডজেন и নেতানিম.

মন্তব্য
পরিষ্কার উবুন্টু16.04 সহ একটি মেশিনে, আমাকে এটিতে কমান্ড পরিবর্তন করতে হবে: $ sudo python3 download.py -n ns-3.29 (এরপরে অনুবাদকের নোট)।

3.3.1 বেক ব্যবহার করে ns-3 লোড হচ্ছে

উপরের দুটি পদ্ধতি (উৎস সংরক্ষণাগার বা সংগ্রহস্থল ns-3-অ্যালিনোন Git এর মাধ্যমে) একাধিক অ্যাডঅন সহ সহজতম ns-3 ইনস্টলেশন পাওয়ার জন্য দরকারীপাইবিন্ডজেন পাইথন বাইন্ডিং তৈরি করতে এবং নেতানিম নেটওয়ার্ক অ্যানিমেশনের জন্য)। ns-3-allinone-এ ডিফল্টরূপে প্রদত্ত তৃতীয় সংগ্রহস্থল বলা হয় সেকা.

সেকা একাধিক সংগ্রহস্থল থেকে সফ্টওয়্যার সমন্বিত বিল্ডিংয়ের জন্য একটি টুল, যা ns-3 প্রকল্পের জন্য তৈরি করা হয়েছে। সেকা ns-3-এর ডেভেলপমেন্ট সংস্করণ পেতে, সেইসাথে ns-3 ডিস্ট্রিবিউশনের বেস সংস্করণের এক্সটেনশন ডাউনলোড এবং তৈরি করতে ব্যবহার করা যেতে পারে, যেমন পরিবেশ ডাইরেক্ট কোড এক্সিকিউশন, CradleNetwork সিমুলেশন ক্র্যাডল, নতুন পাইথন বাইন্ডিং এবং বিভিন্ন ns-3 "অ্যাপ" তৈরি করার ক্ষমতা।

মন্তব্য
CradleNetwork Simulation Cradle হল একটি ফ্রেমওয়ার্ক যা আপনাকে নেটওয়ার্ক সিমুলেটরের ভিতরে বাস্তব TCP/IP নেটওয়ার্ক স্ট্যাক ব্যবহার করতে দেয়।

আপনি যদি আশা করেন আপনার ns-3 ইনস্টলেশনে উন্নত বা অতিরিক্ত বৈশিষ্ট্য থাকবে, আপনি এই ইনস্টলেশনের পথ অনুসরণ করতে পারেন।

সর্বশেষ ns-3 রিলিজে সেকা টার রিলিজে যোগ করা হয়েছে। রিলিজটিতে একটি কনফিগারেশন ফাইল রয়েছে যা আপনাকে রিলিজের সময় বর্তমান সফ্টওয়্যার সংস্করণগুলি ডাউনলোড করতে দেয়। যে, উদাহরণস্বরূপ, সংস্করণ সেকা, যা রিলিজ ns-3.29 এর সাথে বিতরণ করা হয়, ns-3 বা তার আগের রিলিজের জন্য উপাদানগুলি পুনরুদ্ধার করতে ব্যবহার করা যেতে পারে, কিন্তু পরবর্তী রিলিজের জন্য উপাদানগুলি পুনরুদ্ধার করতে ব্যবহার করা যাবে না (যদি প্যাকেজ বিবরণ ফাইল bakeconf.xml আপডেট করা হয়নি)।

আপনি সর্বশেষ কপি পেতে পারেন সেকাআপনার লিনাক্স কনসোলে নিম্নলিখিত কমান্ডটি প্রবেশ করান (ধরে নিচ্ছি যে আপনি গিট ইনস্টল করেছেন):

$ cd 
$ mkdir workspace 
$ cd workspace 
$ git clone https://gitlab.com/nsnam/bake.git

আপনি যখন গিট কমান্ড চালান, তখন আপনাকে নিম্নলিখিতগুলির মতো কিছু দেখতে হবে:

Cloning into 'bake'...
remote: Enumerating objects: 2086, done. 
remote: Counting objects: 100% (2086/2086), done. 
remote: Compressing objects: 100% (649/649), done. 
remote: Total 2086 (delta 1404), reused 2078 (delta 1399) 
Receiving objects: 100% (2086/2086), 2.68 MiB | 3.82 MiB/s, done. 
Resolving deltas: 100% (1404/1404), done.

কমান্ড সম্পূর্ণ হওয়ার পরে ক্লোন আপনার নামের একটি ডিরেক্টরি থাকা উচিত সেকা, যার বিষয়বস্তু এইরকম দেখতে হবে:

$ cd bake
$ ls
bake bakeconf.xml bake.py doc examples generate-binary.py test TODO

মনে রাখবেন যে আপনি অনেকগুলি পাইথন স্ক্রিপ্ট লোড করেছেন, একটি পাইথন মডিউল নামে সেকা এবং একটি XML কনফিগারেশন ফাইল। পরবর্তী ধাপ হল এই স্ক্রিপ্টগুলিকে আপনার পছন্দের ns-3 ডিস্ট্রিবিউশন ডাউনলোড এবং তৈরি করতে ব্যবহার করা। বেশ কয়েকটি কাস্টমাইজেশন লক্ষ্য উপলব্ধ:

1. ns-3.29: রিলিজের সাথে সম্পর্কিত মডিউল; এটি টারবলে রিলিজের অনুরূপ উপাদানগুলি ডাউনলোড করবে;

2. ns-3-dev: একটি অনুরূপ মডিউল, কিন্তু উন্নয়ন গাছ থেকে কোড ব্যবহার করে;

3. ns-অ্যালিনোন-3.29: একটি মডিউল যাতে অন্যান্য অতিরিক্ত বৈশিষ্ট্য যেমন ক্লিক রাউটিং এবং নেটওয়ার্ক সিমুলেশন ক্র্যাডল, ns-3 এর জন্য ওপেনফ্লো অন্তর্ভুক্ত থাকে।

4. ns-3-অ্যালিনোন: মডিউল রিলিজ সংস্করণ অনুরূপ allinone, কিন্তু উন্নয়ন কোডের জন্য।

মন্তব্য
ক্লিক — রাউটার তৈরির জন্য মডুলার সফ্টওয়্যার আর্কিটেকচার।

ওপেনফ্লো হল একটি প্রোটোকল যা রাউটার এবং সুইচ দ্বারা ডেটা নেটওয়ার্কে প্রেরিত ডেটা প্রক্রিয়াকরণের প্রক্রিয়া পরিচালনা করার জন্য, সফ্টওয়্যার-সংজ্ঞায়িত নেটওয়ার্ক প্রযুক্তি বাস্তবায়ন করে।

বর্তমান ডেভেলপমেন্ট স্ন্যাপশট (নন-রিলিজ) ns-3 এখানে পাওয়া যাবে:https://gitlab.com/nsnam/ns-3-dev.git.

বিকাশকারীরা এই সংগ্রহস্থলগুলিকে একটি সামঞ্জস্যপূর্ণ কাজের ক্রমানুসারে রাখার চেষ্টা করে, কিন্তু সেগুলি বিকাশের ক্ষেত্রে এবং অপ্রকাশিত কোড ধারণ করে, তাই আপনি যদি নতুন বৈশিষ্ট্যগুলি ব্যবহার করার পরিকল্পনা না করেন, তাহলে অফিসিয়াল রিলিজটি নির্বাচন করুন৷

আপনি সংগ্রহস্থলের তালিকা ব্রাউজ করে বা ns-3 রিলিজ ওয়েব পৃষ্ঠায় গিয়ে কোডের সর্বশেষ সংস্করণটি খুঁজে পেতে পারেন:https://www.nsnam.org/releases/ এবং সর্বশেষ সংস্করণ লিঙ্কে ক্লিক করুন। এই উদাহরণে আমরা ns-3.29 দিয়ে চালিয়ে যাব।

এখন, আমাদের প্রয়োজনীয় ns-3 উপাদানগুলি পেতে, আমরা টুলটি ব্যবহার করব সেকা. কাজ সম্পর্কে কিছু পরিচিতিমূলক কথা বলি সেকা.

একটি ডিরেক্টরিতে প্যাকেজ উত্স লোড করে বেক কাজ করে উৎস এবং বিল্ড ডিরেক্টরিতে লাইব্রেরি ইনস্টল করা। সেকা বাইনারি রেফারেন্স করে চালানো যেতে পারে, কিন্তু আপনি যদি চালাতে চান সেকা যে ডিরেক্টরিতে এটি ডাউনলোড করা হয়েছিল তা থেকে নয়, এতে পাথ যোগ করার পরামর্শ দেওয়া হয় সেকা আপনার পাথে (PATH এনভায়রনমেন্ট ভেরিয়েবল), উদাহরণস্বরূপ নিম্নরূপ (লিনাক্স ব্যাশ শেলের উদাহরণ)। "বেক" ডিরেক্টরিতে যান এবং তারপরে নিম্নলিখিত পরিবেশ ভেরিয়েবলগুলি সেট করুন:

$ export BAKE_HOME=`pwd` 
$ export PATH=$PATH:$BAKE_HOME:$BAKE_HOME/build/bin 
$ export PYTHONPATH=$PYTHONPATH:$BAKE_HOME:$BAKE_HOME/build/lib

এই প্রোগ্রাম স্থাপন করা হবে bake.py শেল পাথে এবং অন্যান্য প্রোগ্রামগুলিকে এটি তৈরি করা এক্সিকিউটেবল এবং লাইব্রেরিগুলি খুঁজে পেতে অনুমতি দেবে সেকা. কিছু ব্যবহারের ক্ষেত্রে সেকা, উপরে বর্ণিত PATH এবং PYTHONPATH সেটিং প্রয়োজন হয় না, তবে ns-3-অ্যালিনোন (অতিরিক্ত প্যাকেজ সহ) একটি সম্পূর্ণ বিল্ডের জন্য সাধারণত এটির প্রয়োজন হয়।

আপনার কাজের ডিরেক্টরিতে যান এবং কনসোলে নিম্নলিখিতটি লিখুন:

$ ./bake.py configure -e ns-3.29

পরবর্তী আমরা জিজ্ঞাসা করব সেকা বিভিন্ন উপাদান লোড করার জন্য আমাদের কাছে পর্যাপ্ত সরঞ্জাম আছে কিনা তা পরীক্ষা করুন। ডায়াল করুন:

$ ./bake.py check

আপনি নিম্নলিখিত মত কিছু দেখতে হবে:

> Python - OK 
> GNU C++ compiler - OK 
> Mercurial - OK 
> Git - OK 
> Tar tool - OK 
> Unzip tool - OK 
> Make - OK 
> cMake - OK 
> patch tool - OK 
> Path searched for tools: /usr/local/sbin /usr/local/bin /usr/sbin /usr/bin /sbin /bin ...

বিশেষ করে, মার্কুরিয়াল, সিভিএস, গিট এবং বাজারের মতো আপলোড সরঞ্জামগুলি এই ধাপে অপরিহার্য কারণ তারা আমাদের কোড পেতে দেয়৷ এই মুহুর্তে, আপনার সিস্টেমের জন্য স্বাভাবিক উপায়ে অনুপস্থিত সরঞ্জামগুলি ইনস্টল করুন (যদি আপনি কীভাবে জানেন) বা সাহায্যের জন্য আপনার সিস্টেম প্রশাসকের সাথে যোগাযোগ করুন।

পরবর্তী, সফ্টওয়্যার ডাউনলোড করার চেষ্টা করুন:

$ ./bake.py download

ফলাফল এমন কিছু হওয়া উচিত:

>> Searching for system dependency setuptools - OK 
>> Searching for system dependency libgoocanvas2 - OK 
>> Searching for system dependency gi-cairo - OK 
>> Searching for system dependency pygobject - OK 
>> Searching for system dependency pygraphviz - OK 
>> Searching for system dependency python-dev - OK 
>> Searching for system dependency qt - OK 
>> Searching for system dependency g++ - OK 
>> Downloading pybindgen-0.19.0.post4+ng823d8b2 (target directory:pybindgen) - OK 
>> Downloading netanim-3.108 - OK 
>> Downloading ns-3.29 - OK

এর মানে হবে তিনটি উৎস ডাউনলোড করা হয়েছে। এখন সোর্স ডিরেক্টরিতে যান এবং ls লিখুন; তোমার দেখা উচিত:

$ cd source 
$ ls
netanim-3.108 ns-3.29 pybindgen

এখন আপনি ns-3 ডিস্ট্রিবিউশন তৈরি করতে প্রস্তুত।

3.4 সমাবেশ ns-3

ns-3 ডাউনলোড করার মতো, ns-3 তৈরি করার বিভিন্ন উপায় রয়েছে। আমরা যে বিষয়টির উপর জোর দিতে চাই তা হল ns-3 নামের একটি বিল্ড টুল ব্যবহার করে তৈরি করা হয়েছে Wafনীচে বর্ণিত. বেশিরভাগ ব্যবহারকারীর সাথে কাজ করবে Waf, তবে আপনাকে শুরু করতে বা আরও জটিল বিল্ডগুলি সংগঠিত করতে সাহায্য করার জন্য কয়েকটি সহজ স্ক্রিপ্ট রয়েছে৷ তাই, আপনি সম্পর্কে পড়া আগে দয়া করে Waf, একবার দেখে নিন build.py এবং সঙ্গে সমাবেশ সেকা.

3.4.1 build.py সহ বিল্ডিং

সতর্কতা এই বিল্ড ধাপটি শুধুমাত্র উপরে বর্ণিত হিসাবে প্রাপ্ত উৎস সংরক্ষণাগার সংস্করণ থেকে উপলব্ধ; এবং গিট বা বেক এর মাধ্যমে ডাউনলোড করা হয় না।

একটি রিলিজ সংরক্ষণাগার সঙ্গে কাজ করার সময় তারবাল, ইন ns-3-অ্যালিনোন একটি সহজ স্ক্রিপ্ট রয়েছে যা উপাদানগুলিকে একত্রিত করা সহজ করে তুলতে পারে। এটা বলা হয় build.py. এই প্রোগ্রামটি আপনার জন্য সবচেয়ে দরকারী উপায়ে প্রকল্প সেট আপ করবে। যাইহোক, মনে রাখবেন যে ns-3 এর সাথে আরও উন্নত সেটআপ এবং কাজ সাধারণত ns-3 এর নিজস্ব বিল্ড সিস্টেম, Waf ব্যবহার করে, যা এই টিউটোরিয়ালে পরে চালু করা হবে।

ব্যবহার করে ডাউনলোড করলে তারবাল, তারপর আপনার ডিরেক্টরিতে ~/ওয়ার্কস্পেস একটি নাম সঙ্গে একটি ডিরেক্টরি কিছু মত ns-অ্যালিনোন-3.29. নিম্নলিখিত প্রবেশ:

$ ./build.py --enable-examples --enable-tests

ডাকলে build.py আমরা এই টিউটোরিয়ালে ব্যবহৃত উদাহরণ এবং পরীক্ষাগুলি তৈরি করতে কমান্ড লাইন আর্গুমেন্ট ব্যবহার করেছি, যা ns-3 তে ডিফল্টরূপে তৈরি করা হয় না। ডিফল্টরূপে, প্রোগ্রামটি সমস্ত উপলব্ধ মডিউল তৈরি করে। তারপর, আপনি যদি চান, আপনি উদাহরণ এবং পরীক্ষা ছাড়াই ns-3 তৈরি করতে পারেন, বা আপনার কাজের জন্য প্রয়োজনীয় নয় এমন মডিউলগুলি বাদ দিতে পারেন।

আপনি স্ক্রিপ্ট দ্বারা প্রদর্শিত প্রচুর কম্পাইলার আউটপুট বার্তা দেখতে পাবেন কারণ এটি আপনার লোড করা বিভিন্ন অংশ তৈরি করে। প্রথমে স্ক্রিপ্টটি অ্যানিমেটর তৈরি করার চেষ্টা করবে নেতানিম, তারপর বাঁধাই জেনারেটর পাইবিন্ডজেন এবং অবশেষে ns-3. প্রক্রিয়া সম্পূর্ণ হলে, আপনি নিম্নলিখিত দেখতে হবে:

Waf: Leaving directory '/path/to/workspace/ns-allinone-3.29/ns-3.29/build'
'build' finished successfully (6m25.032s) 

Modules built:
antenna                aodv                     applications
bridge                 buildings                config-store
core                   csma                     csma-layout
dsdv                   dsr                      energy 
fd-net-device          flow-monitor             internet
internet-apps          lr-wpan                  lte
mesh                   mobility                 mpi
netanim (no Python)    network                  nix-vector-routing 
olsr                   point-to-point           point-to-point-layout 
propagation            sixlowpan                spectrum 
stats                  tap-bridge               test (no Python) 
topology-read          traffic-control          uan 
virtual-net-device     visualizer               wave 
wifi                   wimax 

Modules not built (see ns-3 tutorial for explanation):
brite                  click                    openflow 
Leaving directory ./ns-3.29

তালিকার শেষ তিনটি লাইনে আমরা মডিউল সম্পর্কে একটি বার্তা দেখতে পাচ্ছি যা নির্মিত হয়নি:

Modules not built (see ns-3 tutorial for explanation):
brite                     click

এর সহজ অর্থ হল যে কিছু ns-3 মডিউল যা বাহ্যিক লাইব্রেরির উপর নির্ভর করে তৈরি করা হয়নি বা এই কনফিগারেশনের জন্য তাদের তৈরি করার প্রয়োজন নেই। এর অর্থ এই নয় যে সিমুলেটরটি একত্রিত হয়নি বা একত্রিত মডিউলগুলি সঠিকভাবে কাজ করবে না।

3.4.2 বেক সহ বিল্ডিং

আপনি যদি প্রোজেক্ট রিপোজিটরি থেকে সোর্স কোড পেতে উপরে বেক ব্যবহার করেন, তাহলে আপনি ns-3 তৈরি করতে এটি ব্যবহার চালিয়ে যেতে পারেন। ডায়াল করুন:

$ ./bake.py build

এবং আপনার এমন কিছু দেখতে হবে:

>> Building pybindgen-0.19.0.post4+ng823d8b2 - OK 
>> Building netanim-3.108 - OK 
>> Building ns-3.29 - OK

সাহায্য: আপনি "bake.py deploy" কল করে একবারে ডাউনলোড এবং বিল্ড উভয় ধাপই করতে পারেন।

সমস্ত উপাদান একত্রিত করা ব্যর্থ হতে পারে, কিন্তু একটি উপাদান প্রয়োজন না হলে সমাবেশ চলতে থাকবে। উদাহরণস্বরূপ, একটি সাম্প্রতিক বহনযোগ্যতা সমস্যা ছিল যে castxml টুল দ্বারা একত্রিত করা যেতে পারে সেকা সব প্ল্যাটফর্মে নয়। এই ক্ষেত্রে, এই মত একটি বার্তা প্রদর্শিত হবে:

>> Building castxml - Problem 
> Problem: Optional dependency, module "castxml" failed
This may reduce the functionality of the final build.
However, bake will continue since "castxml" is not an essential dependency.
For more information call bake with -v or -vvv, for full verbose mode.

কিন্তু castxml আপনি যদি আপডেট করা পাইথন বাইন্ডিং তৈরি করতে চান তবেই প্রয়োজন। বেশিরভাগ ব্যবহারকারীর জন্য এটির কোন প্রয়োজন নেই (অন্তত তারা ns-3 পরিবর্তন না করা পর্যন্ত), তাই এই ধরনের সতর্কতাগুলি আপাতত নিরাপদে উপেক্ষা করা যেতে পারে।

যদি এটি ব্যর্থ হয়, নিম্নলিখিত কমান্ড আপনাকে অনুপস্থিত নির্ভরতা সম্পর্কে একটি ইঙ্গিত দেবে:

$ ./bake.py show

আপনি যে প্যাকেজগুলি তৈরি করার চেষ্টা করছেন তার বিভিন্ন নির্ভরতা তালিকাভুক্ত করা হবে।

3.4.3 ওয়াফ দিয়ে তৈরি করুন

এই বিন্দু পর্যন্ত, ns-3 নির্মাণ শুরু করতে, আমরা হয় স্ক্রিপ্ট ব্যবহার করেছি build.py, বা টুল সেকা. এই সরঞ্জামগুলি ns-3 তৈরি এবং লাইব্রেরি বজায় রাখার জন্য দরকারী। আসলে, বিল্ড করার জন্য তারা বিল্ড টুল চালায় Waf ns-3 ডিরেক্টরি থেকে। Waf ns-3 সোর্স কোড দিয়ে ইনস্টল করা হয়েছে। বেশীরভাগ ব্যবহারকারী দ্রুত NS-3 কনফিগার এবং একত্রিত করতে সরাসরি ব্যবহারে এগিয়ে যান Waf. সুতরাং, চালিয়ে যেতে, অনুগ্রহ করে ns-3 ডিরেক্টরিতে যান যা আপনি মূলত তৈরি করেছেন।

এই মুহুর্তে এটি কঠোরভাবে প্রয়োজনীয় নয়, তবে এটি কিছুটা ব্যাকট্র্যাক করা এবং প্রকল্পের কনফিগারেশনে কীভাবে পরিবর্তন করা যায় তা দেখতে কার্যকর হবে। সম্ভবত আপনি সবচেয়ে দরকারী কনফিগারেশন পরিবর্তন করতে পারেন কোডের একটি অপ্টিমাইজ করা সংস্করণ তৈরি করা। ডিফল্টরূপে, আপনি একটি ডিবাগ সংস্করণ তৈরি করতে আপনার প্রকল্পটি কনফিগার করেছেন৷ একটি অপ্টিমাইজড বিল্ড তৈরি করার জন্য একটি প্রকল্পের দিকে নজর দেওয়া যাক। ওয়াফকে ব্যাখ্যা করার জন্য যে এটি অপ্টিমাইজড বিল্ড তৈরি করবে যাতে উদাহরণ এবং পরীক্ষা অন্তর্ভুক্ত থাকে, আপনাকে নিম্নলিখিত কমান্ডগুলি চালাতে হবে:

$ ./waf clean 
$ ./waf configure --build-profile=optimized --enable-examples --enable-tests

এই চালু হবে Waf স্থানীয় ডিরেক্টরির বাইরে (আপনার সুবিধার জন্য)। প্রথম কমান্ডটি পূর্ববর্তী বিল্ড থেকে পরিষ্কার করে, এটি সাধারণত কঠোরভাবে প্রয়োজনীয় নয়, তবে এটি ভাল অনুশীলন (নীচে বিল্ড প্রোফাইলগুলিও দেখুন); এটি পূর্বে তৈরি করা লাইব্রেরি এবং ডিরেক্টরিতে অবস্থিত অবজেক্ট ফাইল মুছে ফেলবে নির্মাণ/. যখন প্রকল্পটি পুনরায় কনফিগার করা হয় এবং বিল্ড সিস্টেম বিভিন্ন নির্ভরতা পরীক্ষা করে, তখন আপনাকে নিম্নলিখিতগুলির মতো আউটপুট দেখতে হবে:

Setting top to      : /home/ns3user/workspace/bake/source/ns-3-dev
Setting out to      : /home/ns3user/workspace/bake/source/ns-3-dev/build
Checking for 'gcc' (C compiler)        : /usr/bin/gcc 
Checking for cc version                : 7.3.0 
Checking for 'g++' (C++ compiler)      : /usr/bin/g++ 
Checking for compilation flag -march=native support : ok 
Checking for compilation flag -Wl,--soname=foo support : ok 
Checking for compilation flag -std=c++11 support       : ok 
Checking boost includes   : headers not found, please ,!provide a --boost-includes argument (see help) 
Checking boost includes   : headers not found, please ,!provide a --boost-includes argument (see help) 
Checking for program 'python'            : /usr/bin/python 
Checking for python version >= 2.3       : 2.7.15 python-config                                                                     : /usr/bin/python-config
Asking python-config for pyembed '--cflags --libs --ldflags' flags : yes
Testing pyembed configuration                                      : yes
Asking python-config for pyext '--cflags --libs --ldflags' flags   : yes
Testing pyext configuration                                        : yes

Checking for compilation flag -fvisibility=hidden support          : ok 
Checking for compilation flag -Wno-array-bounds support            : ok 
Checking for pybindgen location          : ../pybindgen ,!(guessed) 
Checking for python module 'pybindgen'   : 0.19.0. ,!post4+g823d8b2 
Checking for pybindgen version           : 0.19.0. ,!post4+g823d8b2 
Checking for code snippet                : yes 
Checking for types uint64_t and unsigned long equivalence : no 
Checking for code snippet                                 : no 
Checking for types uint64_t and unsigned long long equivalence     : yes 
Checking for the apidefs that can be used for Python bindings                       : gcc-LP64 
Checking for internal GCC cxxabi         : complete 
Checking for python module 'pygccxml'    : not found 
Checking for click location              : not found 
Checking for program 'pkg-config'        : /usr/bin/pkg- ,!config 
Checking for 'gtk+-3.0'                  : not found 
Checking for 'libxml-2.0'                : yes 
checking for uint128_t                   : not found 
checking for __uint128_t                 : yes 
Checking high precision implementation   : 128-bit integer ,!(default) 
Checking for header stdint.h             : yes 
Checking for header inttypes.h           : yes 
Checking for header sys/inttypes.h       : not found 
Checking for header sys/types.h          : yes 
Checking for header sys/stat.h           : yes 
Checking for header dirent.h             : yes 
Checking for header stdlib.h             : yes 
Checking for header signal.h             : yes 
Checking for header pthread.h            : yes 
Checking for header stdint.h             : yes 
Checking for header inttypes.h           : yes 
Checking for header sys/inttypes.h       : not found
Checking for library rt                  : yes 
Checking for header sys/ioctl.h          : yes 
Checking for header net/if.h             : yes 
Checking for header net/ethernet.h       : yes 
Checking for header linux/if_tun.h       : yes 
Checking for header netpacket/packet.h   : yes 
Checking for NSC location                : not found 
Checking for 'sqlite3'                   : not found 
Checking for header linux/if_tun.h       : yes 
Checking for python module 'gi'          : 3.26.1 
Checking for python module 'gi.repository.GObject'      : ok 
Checking for python module 'cairo'                      : ok 
Checking for python module 'pygraphviz'                 : 1.4rc1 
Checking for python module 'gi.repository.Gtk'          : ok 
Checking for python module 'gi.repository.Gdk'          : ok 
Checking for python module 'gi.repository.Pango'        : ok 
Checking for python module 'gi.repository.GooCanvas'    : ok 
Checking for program 'sudo'                             : /usr/bin/sudo 
Checking for program 'valgrind'                         : not found 
Checking for 'gsl' : not found python-config            : not found 
Checking for compilation flag -fstrict-aliasing support : ok 
Checking for compilation flag -fstrict-aliasing support : ok 
Checking for compilation flag -Wstrict-aliasing support : ok 
Checking for compilation flag -Wstrict-aliasing support : ok 
Checking for program 'doxygen'                          : /usr/bin/doxygen
---- Summary of optional ns-3 features:
Build profile : optimized
Build directory : 
BRITE Integration : not enabled (BRITE not enabled (see option --with- ,!brite)) 
DES Metrics event collection : not enabled (defaults to disabled) 
Emulation FdNetDevice        : enabled 
Examples                     : enabled 
File descriptor NetDevice    : enabled 
GNU Scientific Library (GSL) : not enabled (GSL not found) 
Gcrypt library               : not enabled
(libgcrypt not found: you can use ,!libgcrypt-config to find its location.) GtkConfigStore               : not enabled (library 'gtk+-3.0 >= 3.0' not fou   nd)
MPI Support                  : not enabled (option --enable-mpi not selected)
ns-3 Click Integration       : not enabled (nsclick not enabled (see option --with- ,!nsclick))
ns-3 OpenFlow Integration   : not enabled (Required boost libraries not found) 
Network Simulation Cradle    : not enabled (NSC not found (see option --with-nsc))
PlanetLab FdNetDevice         : not enabled (PlanetLab operating system not detected ,!(see option --force-planetlab)) PyViz visualizer : enabled 
Python API Scanning Support   : not enabled (Missing 'pygccxml' Python module)
Python Bindings : enabled 
Real Time Simulator           : enabled 
SQlite stats data output      : not enabled (library 'sqlite3' not found)
Tap Bridge                    : enabled 
Tap FdNetDevice               : enabled
Tests                         : enabled 
Threading Primitives          : enabled 
Use sudo to set suid bit   : not enabled (option --enable-sudo not selected)
XmlIo                         : enabled
'configure' finished successfully (6.387s)

উপরের তালিকার শেষ অংশ দয়া করে নোট করুন. কিছু ns-3 বিকল্প ডিফল্টরূপে সক্রিয় করা হয় না বা সঠিকভাবে কাজ করার জন্য সিস্টেম সমর্থন প্রয়োজন। উদাহরণস্বরূপ, XmlTo সক্ষম করতে, লাইব্রেরিটি সিস্টেমে উপস্থিত থাকতে হবে libxml-2.0. যদি এই লাইব্রেরিটি খুঁজে পাওয়া না যায় এবং সংশ্লিষ্ট ns-3 ফাংশন সক্রিয় না হয়, তাহলে একটি বার্তা প্রদর্শিত হবে। এছাড়াও মনে রাখবেন যে কমান্ডটি ব্যবহার করা সম্ভব উবুন্টু নির্দিষ্ট প্রোগ্রামের জন্য suid বিট সেট করতে "রানটাইমে গ্রুপ আইডি সেট করুন"। এটি ডিফল্টরূপে সক্ষম নয় এবং তাই এই বৈশিষ্ট্যটি "সক্ষম নয়" হিসাবে উপস্থিত হয়৷ অবশেষে, সক্রিয় বিকল্পগুলির একটি তালিকা পেতে, ব্যবহার করুন Waf প্যারামিটার সহ --check-config.

এখন ফিরে যাই এবং উদাহরণ এবং পরীক্ষা সহ ডিবাগ বিল্ডে ফিরে যাই।

$ ./waf clean 
$ ./waf configure --build-profile=debug --enable-examples --enable-tests

বিল্ড সিস্টেম এখন সেট আপ করা হয়েছে এবং আপনি কেবল টাইপ করে ns-3 প্রোগ্রামের ডিবাগ সংস্করণ তৈরি করতে পারেন:

$ ./waf

উপরের পদক্ষেপগুলি আপনাকে দুইবার ns-3 সিস্টেমের অংশ তৈরি করতে বাধ্য করেছে, কিন্তু এখন আপনি কনফিগারেশন পরিবর্তন করতে এবং অপ্টিমাইজড কোড তৈরি করতে জানেন।

প্রদত্ত প্রকল্প কনফিগারেশনের জন্য কোন প্রোফাইল সক্রিয় তা পরীক্ষা করতে, একটি কমান্ড রয়েছে:

$ ./waf --check-profile 
Waf: Entering directory `/path/to/ns-3-allinone/ns-3.29/build' 
Build profile: debug

উপরের দৃশ্যকল্প build.py এছাড়াও যুক্তি সমর্থন করে --enable-examples и --enable-tests, কিন্তু অন্যান্য বিকল্প Waf এটা সরাসরি সমর্থন করে না। উদাহরণস্বরূপ, এটি কাজ করবে না:

$ ./build.py --disable-python

প্রতিক্রিয়া এই মত হবে:

build.py: error: no such option: --disable-python

যাইহোক, বিশেষ অপারেটর - - এর মাধ্যমে অতিরিক্ত প্যারামিটার পাস করতে ব্যবহার করা যেতে পারে ওয়াফতাই উপরের পরিবর্তে নিম্নলিখিত কমান্ড কাজ করবে:

$ ./build.py -- --disable-python

কারণ এটি প্রধান কমান্ড তৈরি করে ./waf কনফিগার --disable-python. এখানে সম্পর্কে আরো কিছু পরিচায়ক টিপস আছে Waf.

নির্মাণ ত্রুটি হ্যান্ডলিং

সাধারণ Linux এবং MacOS ডিস্ট্রিবিউশনে রিলিজের সময় উপলব্ধ সর্বশেষ C++ কম্পাইলারগুলিতে ns-3 রিলিজ পরীক্ষা করা হয়। যাইহোক, সময়ের সাথে সাথে, নতুন কম্পাইলারগুলির সাথে নতুন ডিস্ট্রিবিউশন প্রকাশ করা হয়, এবং এই নতুন কম্পাইলারগুলি সতর্কতা সম্পর্কে আরও বুদ্ধিমান হতে থাকে। ns-3 সমস্ত সতর্কতাকে ত্রুটি হিসাবে বিবেচনা করার জন্য এটির বিল্ড কনফিগার করে, তাই কখনও কখনও আপনি যদি একটি নতুন সিস্টেমে একটি পুরানো সংস্করণ চালাচ্ছেন, একটি কম্পাইলার সতর্কতা বিল্ডটি বন্ধ করতে পারে।

উদাহরণস্বরূপ, ফেডোরা 3.28-এর জন্য পূর্বে ns‑28 প্রকাশ করা হয়েছিল, যার মধ্যে একটি নতুন প্রধান সংস্করণ অন্তর্ভুক্ত ছিল জিসিসি (gcc-8) Fedora 3.28 এর অধীনে রিলিজ ns-28 বা পূর্ববর্তী সংস্করণ তৈরি করা, Gtk2+ ইনস্টল করা হলে, নিম্নলিখিত ত্রুটি ঘটবে:

/usr/include/gtk-2.0/gtk/gtkfilechooserbutton.h:59:8: error: unnecessary parentheses ,!in declaration of ‘__gtk_reserved1’ [-Werror=parentheses] void (*__gtk_reserved1);

ns‑3.28.1 থেকে শুরু হওয়া রিলিজে, ইন Waf এই সমস্যাগুলি সমাধান করার জন্য একটি বিকল্প উপলব্ধ। এটি g++ এবং clang++ এ "-Werror" পতাকা সেট করা অক্ষম করে। এটি "--disable-werror" বিকল্প এবং কনফিগারেশনের সময় অবশ্যই প্রয়োগ করতে হবে:

$ ./waf configure --disable-werror --enable-examples --enable-tests

কনফিগার করুন বা একত্রিত করুন

কিছু আদেশ Waf শুধুমাত্র কনফিগারেশন পর্যায়ে অর্থ আছে, এবং কিছু শুধুমাত্র বিল্ড ফেজে বৈধ। উদাহরণস্বরূপ, আপনি যদি ns-3 এমুলেশন বৈশিষ্ট্যগুলি ব্যবহার করতে চান তবে আপনি বিট সেটিং সক্ষম করতে পারেন দক্ষিণ ব্যবহার উবুন্টু, উপরে বর্ণিত. এটি কনফিগারেশন ধাপের কমান্ডগুলিকে ওভাররাইড করবে, এবং এইভাবে আপনি নিম্নলিখিত কমান্ডটি ব্যবহার করে কনফিগারেশন পরিবর্তন করতে পারেন, যার মধ্যে উদাহরণ এবং পরীক্ষাও রয়েছে।

$ ./waf configure --enable-sudo --enable-examples --enable-tests

আপনি যদি এই কাজ Waf চালু হবে উবুন্টুঅনুমতি সহ চালানোর জন্য এমুলেশন কোড সকেট তৈরির প্রোগ্রাম পরিবর্তন করতে শিকড়। দ্য Waf কনফিগারেশন এবং বিল্ড ধাপের জন্য উপলব্ধ অন্যান্য অনেক বিকল্প আছে. আপনার বিকল্পগুলি অন্বেষণ করতে, লিখুন:

$ ./waf --help

পরবর্তী বিভাগে আমরা কিছু পরীক্ষা সংক্রান্ত বিকল্প ব্যবহার করব।

সমাবেশ প্রোফাইল

আমরা ইতিমধ্যে দেখেছি কিভাবে আপনি কনফিগার করতে পারেন Waf সমাবেশের জন্য ডেবাগ্ করা и অপ্টিমাইজ:

$ ./waf --build-profile=debug

একটি মধ্যবর্তী সমাবেশ প্রোফাইলও রয়েছে, মুক্তি. অপশন -d এর সমার্থক --build-profile. বিল্ড প্রোফাইল লগিং, দাবী এবং কম্পাইলার অপ্টিমাইজেশান সুইচগুলির ব্যবহার নিয়ন্ত্রণ করে:

আপনি দেখতে পাচ্ছেন, লগিং এবং দাবী শুধুমাত্র ডিবাগ বিল্ডে উপলব্ধ। প্রস্তাবিত অনুশীলনটি হল আপনার স্ক্রিপ্ট ডিবাগ মোডে বিকাশ করা, তারপর একটি অপ্টিমাইজ করা বিল্ড প্রোফাইলে বারবার রান করা (পরিসংখ্যান বা প্যারামিটার পরিবর্তনের জন্য)।

আপনার যদি কোড থাকে যা শুধুমাত্র নির্দিষ্ট বিল্ড প্রোফাইলে চালানো উচিত, কোড র্যাপার ম্যাক্রো ব্যবহার করুন:

NS_BUILD_DEBUG (std::cout << "Part of an output line..." << std::flush; timer.Start ,!()); DoLongInvolvedComputation ();
NS_BUILD_DEBUG (timer.Stop (); std::cout << "Done: " << timer << std::endl;)

ডিফল্ট, Waf বিল্ড ডিরেক্টরিতে আর্টিফ্যাক্ট তৈরি করে। আপনি বিকল্পটি ব্যবহার করে একটি ভিন্ন আউটপুট ডিরেক্টরি নির্দিষ্ট করতে পারেন - -outউদাহরণস্বরূপ,

$ ./waf configure --out=my-build-dir

বিল্ড প্রোফাইলের সাথে এটি একত্রিত করে, আপনি সহজেই বিভিন্ন সংকলন বিকল্পগুলির মধ্যে স্যুইচ করতে পারেন:

$ ./waf configure --build-profile=debug --out=build/debug
$ ./waf build
... 
$ ./waf configure --build-profile=optimized --out=build/optimized 
$ ./waf build
...

যা আপনাকে প্রতিবার সর্বশেষ সমাবেশ পুনর্লিখন না করে একাধিক সমাবেশের সাথে কাজ করতে দেয়। আপনি যখন অন্য প্রোফাইলে যান, Waf সম্পূর্ণরূপে সবকিছু পুনরায় কম্পাইল না করে শুধুমাত্র এটি কম্পাইল করবে।

আপনি যখন এই পদ্ধতিতে বিল্ড প্রোফাইলগুলি স্যুইচ করেন, তখন আপনাকে প্রতিবার একই কনফিগারেশন বিকল্পগুলি দিতে সতর্কতা অবলম্বন করতে হবে। বিভিন্ন পরিবেশের ভেরিয়েবল সংজ্ঞায়িত করা আপনাকে ভুলগুলি এড়াতে সাহায্য করবে:

$ export NS3CONFIG="--enable-examples --enable-tests" 
$ export NS3DEBUG="--build-profile=debug --out=build/debug"
$ export NS3OPT=="--build-profile=optimized --out=build/optimized" 

$ ./waf configure $NS3CONFIG $NS3DEBUG
$ ./waf build 
... 
$ ./waf configure $NS3CONFIG $NS3OPT
$ ./waf build

কম্পাইলার এবং পতাকা

উপরের উদাহরণে Waf ns-3 তৈরি করতে GCC থেকে C++ কম্পাইলার ব্যবহার করে ( g ++) যাইহোক, আপনি যেটি ব্যবহার করেন তা পরিবর্তন করতে পারেন Waf C++ কম্পাইলার, CXX পরিবেশ পরিবর্তনশীল সংজ্ঞায়িত করে। উদাহরণস্বরূপ, C++ কম্পাইলার Clang ব্যবহার করতে, clang++,

$ CXX="clang++" ./waf configure 
$ ./waf build 

একই ভাবে আপনি কনফিগার করতে পারেন Waf ব্যবহার করে বিতরণকৃত সংকলন ব্যবহার করতে distcc:

$ CXX="distcc g++" ./waf configure 
$ ./waf build

distcc এবং বিতরণকৃত সংকলন সম্পর্কে আরও তথ্য ডকুমেন্টেশন বিভাগে প্রকল্প পৃষ্ঠায় পাওয়া যাবে। ns-3 কনফিগার করার সময় কম্পাইলার ফ্ল্যাগ যোগ করতে, CXXFLAGS_EXTRA এনভায়রনমেন্ট ভেরিয়েবল ব্যবহার করুন।

বিন্যাস

Waf সিস্টেমের বিভিন্ন জায়গায় লাইব্রেরি ইনস্টল করতে ব্যবহার করা যেতে পারে। ডিফল্টরূপে, সংকলিত লাইব্রেরি এবং এক্সিকিউটেবলগুলি ডিরেক্টরিতে অবস্থিত নির্মাণ করা, এবং যেহেতু ওয়াফ এই লাইব্রেরি এবং এক্সিকিউটেবলগুলির অবস্থান জানে, তাই অন্য কোথাও লাইব্রেরিগুলি ইনস্টল করার দরকার নেই।

ব্যবহারকারীরা বিল্ড ডিরেক্টরির বাইরে ইনস্টল করতে পছন্দ করলে, তারা কমান্ডটি চালাতে পারে ./waf ইনস্টল. ইনস্টলেশনের জন্য ডিফল্ট উপসর্গ হয় , / Usr / স্থানীয়যে কেন ./waf ইনস্টল প্রোগ্রাম ইনস্টল করা হবে , / Usr / স্থানীয় / বিন, মধ্যে লাইব্রেরি , / Usr / local / lib এবং শিরোনাম ফাইল /usr/local/include. সুপার ইউজার অধিকারগুলি সাধারণত একটি ডিফল্ট উপসর্গের সাথে সেট করা প্রয়োজন, তাই একটি সাধারণ কমান্ড হবে sudo ./waf ইনস্টল করুন. চালু হলে, Waf প্রথমে বিল্ড ডিরেক্টরিতে ভাগ করা লাইব্রেরিগুলি ব্যবহার করতে বেছে নেবে, তারপর স্থানীয় পরিবেশে কনফিগার করা লাইব্রেরির পথ ধরে লাইব্রেরিগুলি সন্ধান করবে। সুতরাং একটি সিস্টেমে লাইব্রেরি ইনস্টল করার সময়, সঠিক লাইব্রেরিগুলি ব্যবহার করা হচ্ছে কিনা তা পরীক্ষা করা একটি ভাল অভ্যাস। ব্যবহারকারীরা কনফিগারেশনের সময় বিকল্পটি পাস করে একটি ভিন্ন উপসর্গ দিয়ে ইনস্টল করতে বেছে নিতে পারেন --prefixউদাহরণস্বরূপ,

./waf configure --prefix=/opt/local

যদি পরে, বিল্ড করার পরে, ব্যবহারকারী ইনস্টলেশন কমান্ড প্রবেশ করে ./waf, উপসর্গ ব্যবহার করা হবে /অপ্ট/স্থানীয়.

টীম ./waf clean ইনস্টলেশন ব্যবহার করা হলে প্রকল্পটি পুনরায় কনফিগার করার আগে ব্যবহার করা আবশ্যক Waf একটি ভিন্ন উপসর্গ অধীনে।

সুতরাং, ns-3 ব্যবহার করতে কল করার দরকার নেই ./waf install. বেশিরভাগ ব্যবহারকারীর এই কমান্ডের প্রয়োজন হবে না কারণ Waf বিল্ড ডিরেক্টরি থেকে বর্তমান লাইব্রেরিগুলি বাছাই করা হবে, কিন্তু কিছু ব্যবহারকারী যদি তাদের ক্রিয়াকলাপগুলি ns-3 ডিরেক্টরির বাইরের প্রোগ্রামগুলির সাথে কাজ করে তবে এটি দরকারী বলে মনে করতে পারে।

ওয়াফ একক

ns-3 উৎস গাছের উপরের স্তরে, শুধুমাত্র একটি ওয়াফ লিপি আছে। একবার আপনি কাজ শুরু করলে, আপনি ডিরেক্টরিতে অনেক সময় ব্যয় করবেন scratch/ বা আরও গভীরেsrc/... এবং একই সময়ে চালাতে হবে Waf. আপনি কোথায় আছেন তা মনে রাখতে পারেন এবং দৌড়াতে পারেন Waf নিম্নরূপ:

$ ../../../waf ...

কিন্তু এটি ক্লান্তিকর এবং ত্রুটি প্রবণ হবে, তাই আরও ভাল সমাধান আছে। একটি সাধারণ উপায় হল একটি পাঠ্য সম্পাদক যেমন ব্যবহার করা Emacs বা তেজ, যেখানে দুটি টার্মিনাল সেশন খোলা হয়, একটি ns-3 তৈরি করতে ব্যবহৃত হয় এবং দ্বিতীয়টি উৎস কোড সম্পাদনা করতে ব্যবহৃত হয়। যদি আপনি শুধুমাত্র আছে তারবাল, তারপর একটি পরিবেশ পরিবর্তনশীল সাহায্য করতে পারে:

$ export NS3DIR="$PWD" 
$ function waff { cd $NS3DIR && ./waf $* ; } 

$ cd scratch 
$ waff build

মডিউল ডিরেক্টরিতে এটি একটি তুচ্ছ waf স্ক্রিপ্ট যোগ করার জন্য লোভনীয় হতে পারে exec ../../waf. অনুগ্রহ করে সেটা করবেন না. এটি নতুনদের জন্য বিভ্রান্তিকর এবং, যখন খারাপভাবে করা হয়, তখন নির্ণয় করা কঠিন ত্রুটির দিকে নিয়ে যায়। উপরে দেখানো সমাধান হল যে পথ ব্যবহার করা উচিত।

3.5 টেস্টিং ns-3

আপনি স্ক্রিপ্টটি চালিয়ে ns-3 বিতরণের ইউনিট পরীক্ষা চালাতে পারেন ./test.py:

$ ./test.py

এই পরীক্ষাগুলি সমান্তরালভাবে চালানো হয় Waf. অবশেষে আপনি একটি বার্তা দেখতে হবে যে বলছে:

92 of 92 tests passed (92 passed, 0 failed, 0 crashed, 0 valgrind errors)

এটি ভ্যালগ্রিন্ড ক্র্যাশ, ক্র্যাশ বা ত্রুটি সনাক্ত করার জন্য একটি গুরুত্বপূর্ণ বার্তা, কোডের সাথে সমস্যা বা সরঞ্জাম এবং কোডের মধ্যে অসঙ্গতি নির্দেশ করে।

আপনি থেকে চূড়ান্ত আউটপুট দেখতে পাবেন Waf এবং প্রতিটি পরীক্ষা চালাচ্ছেন একজন পরীক্ষক, যা দেখতে এরকম কিছু হবে:

Waf: Entering directory `/path/to/workspace/ns-3-allinone/ns-3-dev/build' 
Waf: Leaving directory `/path/to/workspace/ns-3-allinone/ns-3-dev/build' 
'build' finished successfully (1.799s) 

Modules built:
aodv           applications          bridge
click          config-store          core
csma           csma-layout           dsdv
emu            energy                flow-monitor
internet       lte                   mesh
mobility       mpi                   netanim
network        nix-vector-routing    ns3tcp
ns3wifi        olsr                  openflow
point-to-point point-to-point-layout propagation
spectrum       stats                 tap-bridge
template       test                  tools
topology-read  uan                   virtual-net-device
visualizer     wifi                  wimax

PASS: TestSuite ns3-wifi-interference
PASS: TestSuite histogram 

...

PASS: TestSuite object
PASS: TestSuite random-number-generators
92 of 92 tests passed (92 passed, 0 failed, 0 crashed, 0 valgrind errors)

ns-3 ডিস্ট্রিবিউশন সঠিকভাবে তৈরি হয়েছে কিনা তা যাচাই করার জন্য এই কমান্ডটি সাধারণত ব্যবহারকারীদের দ্বারা চালিত হয়। (উল্লেখ্য যে "পাস: ..." লাইনের ক্রম ভিন্ন হতে পারে, এটি স্বাভাবিক। যেটা গুরুত্বপূর্ণ তা হল রিপোর্টের শেষে সারাংশ লাইন দেখায় যে সমস্ত পরীক্ষা পাস হয়েছে; কোনো পরীক্ষা ব্যর্থ বা ক্র্যাশ হয়নি।) এবং Wafএবং test.py মেশিনের উপলব্ধ প্রসেসর কোর জুড়ে কাজ সমান্তরাল করবে।

3.6 স্ক্রিপ্ট চালানো

আমরা সাধারণত নিয়ন্ত্রণে স্ক্রিপ্ট চালাই Waf. এটি বিল্ড সিস্টেমকে নিশ্চিত করতে দেয় যে ভাগ করা লাইব্রেরি পাথগুলি সঠিকভাবে সেট করা হয়েছে এবং লাইব্রেরিগুলি রানটাইমে উপলব্ধ রয়েছে। প্রোগ্রাম চালানোর জন্য, সহজভাবে ব্যবহার করুন Waf প্যারামিটার সহ - -run. চলুন সর্বব্যাপী প্রোগ্রামের সমতুল্য ns-3 রান করি ওহে বিশ্বনিম্নলিখিত টাইপ করে:

$ ./waf --run hello-simulator

ওয়াফ প্রথমে পরীক্ষা করে দেখবে যে প্রোগ্রামটি সঠিকভাবে তৈরি হয়েছে এবং প্রয়োজনে তৈরি করুন। তারপর Waf নিম্নলিখিত আউটপুট উত্পাদন করে এমন একটি প্রোগ্রাম চালাবে।

Hello Simulator

অভিনন্দন! আপনি এখন একজন ns-3 ব্যবহারকারী!

আমি ফলাফল দেখতে না পেলে আমার কি করা উচিত?

আপনি যদি বার্তা দেখতে পান Wafইঙ্গিত করে যে বিল্ডটি সফলভাবে সম্পন্ন হয়েছে, কিন্তু আপনি আউটপুট দেখতে পাচ্ছেন না "হ্যালো সিমুলেটর", তাহলে একটি সম্ভাবনা আছে যে [বিল্ড-উইথ-ওয়াফ] বিভাগে আপনি আপনার বিল্ড মোড পরিবর্তন করেছেন অপ্টিমাইজ, কিন্তু মোডে ফিরে যাওয়া মিস করা হয়েছে ডেবাগ্ করা. এই টিউটোরিয়ালে ব্যবহৃত সমস্ত কনসোল আউটপুট একটি বিশেষ ns-3 উপাদান ব্যবহার করে যা লগিং করে এবং কনসোলে কাস্টম বার্তা প্রিন্ট করতে ব্যবহৃত হয়। এই উপাদান থেকে আউটপুট স্বয়ংক্রিয়ভাবে অক্ষম করা হয় যখন অপ্টিমাইজ করা কোড কম্পাইল করা হয় - এটি "অপ্টিমাইজ করা হয়"। আপনি যদি "হ্যালো সিমুলেটর" আউটপুট দেখতে না পান তবে নিম্নলিখিতটি লিখুন:

$ ./waf configure --build-profile=debug --enable-examples --enable-tests

সুবিধামত করে নিতে Waf ns-3 প্রোগ্রামের ডিবাগ সংস্করণ তৈরি করতে, যার মধ্যে উদাহরণ এবং পরীক্ষা রয়েছে। তারপরে আপনাকে টাইপ করে কোডটির বর্তমান ডিবাগ সংস্করণটি পুনর্নির্মাণ করা উচিত

$ ./waf

এখন আপনি যদি প্রোগ্রাম চালান হ্যালো-সিমুলেটর, আপনি প্রত্যাশিত ফলাফল দেখতে হবে.

3.6.1 কমান্ড লাইন আর্গুমেন্ট

ns-3 প্রোগ্রামে কমান্ড লাইন আর্গুমেন্ট পাস করতে, নিম্নলিখিত প্যাটার্ন ব্যবহার করুন:

$ ./waf --run <ns3-program> --command-template="%s <args>"

প্রতিস্থাপন করুন আপনার প্রোগ্রামের নাম এবং আর্গুমেন্ট. যুক্তি - -command-template থেকে Waf মূলত প্রকৃত কমান্ড লাইন নির্মাণের জন্য একটি রেসিপি Waf প্রোগ্রাম চালানোর জন্য ব্যবহৃত হয়। ওয়াফ পরীক্ষা করে যে বিল্ডটি সম্পূর্ণ হয়েছে, শেয়ার্ড লাইব্রেরি পাথ সেট করে, তারপর প্রদত্ত কমান্ড লাইন টেমপ্লেট ব্যবহার করে এবং এক্সিকিউটেবল কল করার জন্য %s প্লেসহোল্ডারের জন্য প্রোগ্রামের নাম প্রতিস্থাপন করে। আপনি যদি এই সিনট্যাক্সটিকে জটিল মনে করেন, তাহলে একটি সহজ সংস্করণ রয়েছে যাতে ns-3 প্রোগ্রাম এবং এর আর্গুমেন্টগুলি একক উদ্ধৃতিতে আবদ্ধ থাকে:

$ ./waf --run '<ns3-program> --arg1=value1 --arg2=value2 ...'

আরেকটি বিশেষ উপযোগী উদাহরণ হল পরীক্ষা স্যুট নির্বাচনীভাবে চালানো। ধরা যাক মাইটেস্ট নামে একটি টেস্ট স্যুট আছে (আসলে সেখানে নেই)। উপরে আমরা সমান্তরালভাবে বেশ কয়েকটি পরীক্ষা চালানোর জন্য ./test.py স্ক্রিপ্ট ব্যবহার করেছি, যা বারবার পরীক্ষা প্রোগ্রামকে কল করে পরীক্ষা-রানার. কল পরীক্ষা-রানার সরাসরি একটি পরীক্ষা চালানোর জন্য:

$ ./waf --run test-runner --command-template="%s --suite=mytest --verbose"

আর্গুমেন্ট প্রোগ্রাম পাস করা হবে পরীক্ষা-রানার. যেহেতু mytest বিদ্যমান নেই, একটি ত্রুটি বার্তা উত্পন্ন হবে. উপলব্ধ পরীক্ষা-রানার বিকল্পগুলি মুদ্রণ করতে, লিখুন:

$ ./waf --run test-runner --command-template="%s --help"

3.6.2 ডিবাগিং

অন্য ইউটিলিটির অধীনে ns-3 প্রোগ্রাম চালানোর জন্য, যেমন একটি ডিবাগার (উদাহরণস্বরূপ, জিডিবি) বা একটি মেমরি পরীক্ষার টুল (উদাহরণস্বরূপ, ভালগ্রিন্ড), একটি অনুরূপ ফর্ম ব্যবহার করুন - -command-template = "…". উদাহরণস্বরূপ, ডিবাগারে চালানোর জন্য জিডিবি আর্গুমেন্ট সহ আপনার হ্যালো-সিমুলেটর ns-3 প্রোগ্রাম:

$ ./waf --run=hello-simulator --command-template="gdb %s --args <args>"

উল্লেখ্য যে ns-3 প্রোগ্রামের নাম আর্গুমেন্টের সাথে আসে - -run, এবং ব্যবস্থাপনা ইউটিলিটি (এখানে জিডিবি) হল আর্গুমেন্টের প্রথম টোকেন - -command-template. অপশন - -args রিপোর্ট জিডিবিযে কমান্ড লাইনের বাকি অংশ "নিম্ন" প্রোগ্রামের অন্তর্গত। (কিছু সংস্করণ জিডিবি বিকল্প বুঝতে পারছি না - -args. এই ক্ষেত্রে, থেকে প্রোগ্রাম আর্গুমেন্ট সরান - -command-template এবং কমান্ড সেট ব্যবহার করুন জিডিবি args.) আমরা ডিবাগারের অধীনে পরীক্ষা চালানোর জন্য এই রেসিপিটি এবং আগেরটি একত্রিত করতে পারি:

$ ./waf --run test-runner --command-template="gdb %s --args --suite=mytest --verbose"

3.6.3 ওয়ার্কিং ডিরেক্টরি

ns-3 গাছের উপরের অবস্থান থেকে ওয়াফ চালু করা উচিত। এই ফোল্ডারটি কার্যকারী ডিরেক্টরিতে পরিণত হয় যেখানে আউটপুট ফাইলগুলি লেখা হবে। কিন্তু আপনি যদি এই ফাইলগুলিকে ns-3 উৎস গাছের বাইরে রাখতে চান? যুক্তি ব্যবহার করুন - -cwd:

$ ./waf --cwd=...

আপনার কাজের ডিরেক্টরিতে আউটপুট ফাইলগুলি পেতে আপনি এটি আরও সুবিধাজনক বলে মনে করতে পারেন। এই ক্ষেত্রে, নিম্নলিখিত পরোক্ষ পদক্ষেপ সাহায্য করতে পারে:

$ function waff {
CWD="$PWD" 
cd $NS3DIR >/dev/null 
./waf --cwd="$CWD" $*
cd - >/dev/null 
}

কমান্ডের পূর্ববর্তী সংস্করণের এই সজ্জা বর্তমান কার্যকারী ডিরেক্টরি সংরক্ষণ করে, ডিরেক্টরিতে যায় Wafএবং তারপর নির্দেশ দেয় Waf প্রোগ্রাম শুরু করার আগে সংরক্ষিত বর্তমান ওয়ার্কিং ডিরেক্টরিতে ওয়ার্কিং ডিরেক্টরিটি পরিবর্তন করতে। আমরা দল উল্লেখ করি - -cwd সম্পূর্ণতার জন্য, বেশিরভাগ ব্যবহারকারীরা কেবলমাত্র শীর্ষ-স্তরের ডিরেক্টরি থেকে ওয়াফ চালান এবং সেখানে আউটপুট ফাইল তৈরি করে।

অব্যাহত: অধ্যায় 4

উত্স: www.habr.com