193 lines
10 KiB
ReStructuredText
193 lines
10 KiB
ReStructuredText
.. include:: replace.txt
|
|
|
|
..
|
|
========================================================================================
|
|
Translated for portuguese by the students of the inter-institutional doctorate program of IME-USP/UTFPR-CM.
|
|
|
|
Traduzido para o português pelos alunos do programa de doutorado inter institucional do Instituto de Matemática e Estatística da Universidade de São Paulo --- IME-USP em parceria com a Universidade Tecnológica Federal do Paraná - Campus Campo Mourão --- UTFPR-CM:
|
|
|
|
* Frank Helbert (frank@ime.usp.br);
|
|
* Luiz Arthur Feitosa dos Santos (luizsan@ime.usp.br);
|
|
* Rodrigo Campiolo (campiolo@ime.usp.br).
|
|
========================================================================================
|
|
|
|
|
|
Introdução
|
|
-----------
|
|
|
|
|
|
..
|
|
The |ns3| simulator is a discrete-event network simulator targeted
|
|
primarily for research and educational use. The
|
|
`ns-3 project
|
|
<http://www.nsnam.org>`_,
|
|
started in 2006, is an open-source project developing |ns3|.
|
|
|
|
O |ns3| é um simulador de redes baseado em eventos discretos desenvolvido especialmente para pesquisa e uso educacional. O `projeto ns-3 <http://www.nsnam.org>`_ iniciou em 2006 e tem seu código aberto.
|
|
|
|
|
|
..
|
|
The purpose of this tutorial is to introduce new |ns3| users to the
|
|
system in a structured way. It is sometimes difficult for new users to
|
|
glean essential information from detailed manuals and to convert this
|
|
information into working simulations. In this tutorial, we will build
|
|
several example simulations, introducing and explaining key concepts and
|
|
features as we go.
|
|
|
|
O objetivo deste tutorial é apresentar o |ns3| de forma estruturada aos usuários iniciantes. Algumas vezes torna-se difícil obter informações básicas de manuais detalhados e converter em informações úteis para as simulações. Neste tutorial são ilustrados vários exemplos de simulações, introduzindo e explicando os principais conceitos necessários ao longo do texto.
|
|
|
|
..
|
|
As the tutorial unfolds, we will introduce the full |ns3| documentation
|
|
and provide pointers to source code for those interested in delving deeper
|
|
into the workings of the system.
|
|
|
|
A documentação completa do |ns3| e trechos do código fonte são apresentados para os interessados em aprofundar-se no funcionamento do sistema.
|
|
|
|
..
|
|
A few key points are worth noting at the onset:
|
|
|
|
Alguns pontos importantes para se observar:
|
|
|
|
..
|
|
* Ns-3 is not an extension of `ns-2
|
|
<http://www.isi.edu/nsnam/ns>`_;
|
|
it is a new simulator. The two simulators are both written in C++ but
|
|
|ns3| is a new simulator that does not support the ns-2 APIs. Some
|
|
models from ns-2 have already been ported from ns-2 to |ns3|. The
|
|
project will continue to maintain ns-2 while |ns3| is being built,
|
|
and will study transition and integration mechanisms.
|
|
|
|
* O |ns3| não é uma extensão do ns-2; O |ns3| é um simulador novo. Ambos são escritos em C++, mas o |ns3| é totalmente novo e não suporta as APIs da versão anterior. Algumas funcionalidades do ns-2 já foram portadas para o |ns3|. O projeto continuará mantendo o ns-2 enquanto o |ns3| estiver em fase de desenvolvimento e formas de integração e transição estão em estudo.
|
|
|
|
..
|
|
* |ns3| is open-source, and the project strives to maintain an
|
|
open environment for researchers to contribute and share their software.
|
|
|
|
* O |ns3| é código aberto e existe um grande esforço para manter um ambiente aberto para pesquisadores que queiram contribuir e compartilhar software com o projeto.
|
|
|
|
..
|
|
For ns-2 Users
|
|
|
|
Para os usuários do ns-2
|
|
*************************
|
|
|
|
..
|
|
For those familiar with ns-2, the most visible outward change when moving to
|
|
|ns3| is the choice of scripting language. Ns-2 is
|
|
scripted in OTcl and results of simulations can be visualized using the
|
|
Network Animator nam. It is not possible to run a simulation
|
|
in ns-2 purely from C++ (i.e., as a main() program without any OTcl).
|
|
Moreover, some components of ns-2 are written in C++ and others in OTcl.
|
|
In |ns3|, the simulator is written entirely in C++, with optional
|
|
Python bindings. Simulation scripts can therefore be written in C++
|
|
or in Python. The results of some simulations can be visualized by
|
|
nam, but new animators are under development. Since |ns3|
|
|
generates pcap packet trace files, other utilities can be used to
|
|
analyze traces as well.
|
|
In this tutorial, we will first concentrate on scripting
|
|
directly in C++ and interpreting results via trace files.
|
|
|
|
Para aqueles familiarizados com o ns-2 a mudança mais visível é a escolha da linguagem de codificação (*scripting*). O ns-2 utiliza a linguagem OTcl e os resultados das simulações podem ser visualizados utilizando o *Network Animator - nam*. Entretanto, não é possível executar uma simulação escrita inteira em C++ no ns-2 (por exemplo, com um ``main()`` sem nenhum código OTcl). Assim sendo, no ns-2 alguns componentes são escritos em C++ e outros em OTcl. No |ns3|, todo o simulador é escrito em C++ com suporte opcional a Python. Desta forma, os códigos de simulação podem ser escritos somente em C++ ou Python. Os resultados de algumas simulações podem ser visualizados pelo *nam*, mas novas formas de visualização estão sendo desenvolvidas. O |ns3| gera arquivos de rastreamento de pacotes *(packet trace)* no formato *pcap*, assim, é possível utilizar outras ferramentas para a análise de pacotes. Neste tutorial iremos nos concentrar inicialmente nos códigos de simulação escritos em C++ e na interpretação dos pacotes nos arquivos de rastreamento.
|
|
|
|
..
|
|
But there are similarities as well (both, for example, are based on C++
|
|
objects, and some code from ns-2 has already been ported to |ns3|).
|
|
We will try to highlight differences between ns-2 and |ns3|
|
|
as we proceed in this tutorial.
|
|
|
|
Também existem semelhanças entre o ns-2 e o |ns3|. Ambos, por exemplo, são orientados a objeto e parte do código do ns-2 já foi portado para o |ns3|. As diferenças entre as versões serão destacadas ao longo deste tutorial.
|
|
|
|
..
|
|
A question that we often hear is "Should I still use ns-2 or move to
|
|
|ns3|?" The answer is that it depends. |ns3| does not have
|
|
all of the models that ns-2 currently has, but on the other hand, |ns3|
|
|
does have new capabilities (such as handling multiple interfaces on nodes
|
|
correctly, use of IP addressing and more alignment with Internet
|
|
protocols and designs, more detailed 802.11 models, etc.). ns-2
|
|
models can usually be ported to |ns3| (a porting guide is under
|
|
development). There is active development on multiple fronts for
|
|
|ns3|. The |ns3| developers believe (and certain early users
|
|
have proven) that |ns3| is ready for active use, and should be an
|
|
attractive alternative for users looking to start new simulation projects.
|
|
|
|
Uma questão que frequentemente aparece é: "Eu devo continuar usando o ns-2 ou devo migrar para o |ns3|?". A resposta é: depende. O |ns3| não tem todos os modelos do ns-2, contudo, possui novas funcionalidades (tais como: trabalha corretamente com nós de rede com múltiplas interfaces de rede (por exemplo, computadores com várias placas de rede), usa endereçamento IP, é mais consistente com arquiteturas e protocolos da Internet, detalha mais o modelo 802.11, etc.). Em todo o caso, os modelos do ns-2 podem ser portados para o |ns3| (um guia está em desenvolvimento). Atualmente existem várias frentes de trabalho para o desenvolvimento do simulador. Os desenvolvedores acreditam (e os primeiros usuários concordam) que o |ns3| está pronto para o uso e é uma ótima alternativa para usuários que querem iniciar novos projetos de simulação.
|
|
|
|
..
|
|
Contributing
|
|
|
|
Contribuindo
|
|
************
|
|
|
|
..
|
|
|ns3| is a research and educational simulator, by and for the
|
|
research community. It will rely on the ongoing contributions of the
|
|
community to develop new models, debug or maintain existing ones, and share
|
|
results. There are a few policies that we hope will encourage people to
|
|
contribute to |ns3| like they have for ns-2:
|
|
|
|
O |ns3| é um simulador para pesquisas e de uso educacional, feito por e para pesquisadores. Este conta com contribuições da comunidade para desenvolver novos modelos, corrigir erros ou manter códigos e compartilhar os resultados. Existem políticas de incentivo para que as pessoas contribuam com o projeto, assim como foi feito no ns-2, tais como:
|
|
|
|
..
|
|
* Open source licensing based on GNU GPLv2 compatibility
|
|
|
|
* Licença de código aberto compatível com GNU GPLv2;
|
|
|
|
* `Wiki <http://www.nsnam.org/wiki>`_;
|
|
|
|
..
|
|
* `Contributed Code
|
|
<http://www.nsnam.org/wiki/Contributed_Code>`_ page, similar to ns-2's popular Contributed Code
|
|
`page
|
|
<http://nsnam.isi.edu/nsnam/index.php/Contributed_Code>`_
|
|
|
|
* Página para `contribuição com o código <http://www.nsnam.org/wiki/Contributed_Code>`_, similar a página de contribuição do `ns-2 <http://nsnam.isi.edu/nsnam/index.php/Contributed_Code>`_;
|
|
|
|
..
|
|
* Open `bug tracker
|
|
<http://www.nsnam.org/bugzilla>`_
|
|
|
|
* `Registro de erros (bugs) <http://www.nsnam.org/bugzilla>`_ aberto.
|
|
|
|
..
|
|
We realize that if you are reading this document, contributing back to
|
|
the project is probably not your foremost concern at this point, but
|
|
we want you to be aware that contributing is in the spirit of the project and
|
|
that even the act of dropping us a note about your early experience
|
|
with |ns3| (e.g. "this tutorial section was not clear..."),
|
|
reports of stale documentation, etc. are much appreciated.
|
|
|
|
Se você está lendo este documento, provavelmente contribuir diretamente não seja o foco neste momento, mas esteja ciente que contribuir está no espírito do projeto, mesmo que seja deixando uma mensagem descrevendo suas experiências com o |ns3| (por exemplo, você pode relatar qual seção deste tutorial não esta clara), reportar a desatualização da documentação, etc. Toda ajuda será muita bem vinda.
|
|
|
|
..
|
|
Tutorial Organization
|
|
|
|
Organização do Tutorial
|
|
***********************
|
|
|
|
..
|
|
The tutorial assumes that new users might initially follow a path such as the
|
|
following:
|
|
|
|
Este tutorial assume que os novos usuários podem iniciar da seguinte forma:
|
|
|
|
..
|
|
* Try to download and build a copy;
|
|
|
|
* Baixar e compilar uma cópia do |ns3|;
|
|
|
|
..
|
|
* Try to run a few sample programs;
|
|
|
|
* Executar alguns programas exemplo;
|
|
|
|
..
|
|
* Look at simulation output, and try to adjust it.
|
|
|
|
* Analisar as saídas de simulação e ajustá-las.
|
|
|
|
..
|
|
As a result, we have tried to organize the tutorial along the above
|
|
broad sequences of events.
|
|
|
|
Assim, tentamos organizar este tutorial nesta sequência.
|