Guia - SimEON (Simulator for Elastic Optical Networks ) William Silva dos Santos Observações:

Transcrição

1 Guia - SimEON (Simulator for Elastic Optical Networks ) William Silva dos Santos william.santos@ee.ufcg.edu.br Observações: 1. Todo o guia foi baseado em apenas uma forma de deixar um ambiente pronto para utilização do SimEON, mas existem outras formas de se obter o mesmo m; 2. Este guia deve ser útil pelo menos nas distribuições Ubuntu e Debian, talvez extendendo para qualquer distribuição que utilize o gerenciador de pacotes Aptitude (que utiliza o trecho no terminal apt-get); Campina Grande - PB 1

2 1 Qt Creator Qt Creator fornece um Ambiente de Desenvolvimento Integrado (IDE) e é utilizado como software gerenciador do SimEON em forma de projeto. Para instalar, digite no terminal sudo apt-get install qtcreator Como complemento, deve-se instalar uma versão do Qt, necessária para lidar com as funcionalidades de desenvolvimento do Qt Creator. Para instalar, digite no terminal (resolve o problema da Figura 1) sudo apt-get install qt5-default Figura 1: Problema causado pela falta do pacote qt5-default. 2 Git e GitLab O Git é um sistema de controle de versão e será o intermediador entre o GitLab e o ambiente de trabalho (desktop ou notebook). O GitLab é o local" onde está hospedado o projeto do SimEON. É importante destacar que qualquer projeto hospedado no GitLab é acessível apenas aos usuários que forem concedida permissão. Para instalar o Git, digite no terminal sudo apt-get install git 3 SimEON Para ter acesso ao projeto do SimEON, entre com o usuário e senha no site do GitLab. Ná página do projeto, altere a opção SSH para HTTPS e copie o endereço. Escolha uma pasta no seu ambiente de trabalho para fazer a cópia do projeto, clique com o 2

3 Figura 2: Endereço HTTPS. botão direito do mouse em um espaço vazio e selecione Abrir no Terminal (ou abra o terminal em qualquer diretório e navegue até a dita pasta) e digite git clone endereco-aqui será solicitado o usuário e senha, digite-os para permitir o prosseguimento da cópia. Será feita uma cópia do projeto para a pasta escolhida com as últimas modicações registradas no GitLab. Deve-se destacar que quaisquer modicações na cópia, não altera de nenhuma forma o projeto hospedado no GitLab, a não ser que seja utilizado o Git para registrar tais modicações. Portanto, a cópia pode ser alterada e salva no ambiente de trabalho quantas vezes for necessária. Abra o Qt Creator e vá em Arquivo Abrir Arquivo ou Projeto; navegue até a pasta do projeto e selecione o arquivo com o nome adamant-broccoli.pro, como indicado na Figura 3 e clique em Congurar Projeto, como indicado na Figura 4. Figura 3: Arquivo de projeto adamant-broccoli.pro. 3

4 Figura 4: Etapa para congurar o projeto. Atualmente, o SimEON conta com pacotes externos que fornecem funcionalidades para C++, que são: 1. Boost: Contém um conjunto de bibliotecas que otimizam recursos que já existem em C++, como o Boost.Bimap, utilizado no SimEON. Para instalar, digite no terminal (resolve os problemas das Figuras 5 e 6) sudo apt-get install libboost-system-dev sudo apt-get install libboost-program-options-dev Figura 5: Problema causado pela falta do pacote libboost-system-dev. 4

5 Figura 6: Problema causado pela falta do pacote libboost-program-options-dev. 2. Armadillo: É uma biblioteca de álgebra linear com recursos de alto nível para resolver problemas matemáticos. Para instalar, digite no terminal (resolve o problema da Figura 7) sudo apt-get install libarmadillo-dev Figura 7: Problema causado pela falta do pacote libarmadillo-dev. 3. Gtest: É um framework da Google para lidar com o problema de alocação de memória, por exemplo. Os testes são feitos antes de passar pelo arquivo main.cpp e testa a integridade das funções das classes. Para instalar, digite no terminal sudo apt-get install libgtest-dev 5

6 Diferentemente dos outros pacotes, este apenas instala os arquivos de código, portanto, é necessário que estes sejam compilados e copiados para a pasta de bibliotecas. Para isso, digite os seguintes passos (o conjunto pacote e os passos resolvem o problema da Figura 8) sudo apt-get install cmake cd /usr/src/gtest sudo cmake CMakeLists.txt sudo make sudo cp *.a /usr/lib Figura 8: Problema causado pela falta do pacote libgtest-dev. As topologias selecionadas durante a execução do SimEON são descritas por arquivos de texto, como ilustrado na Figura 9. Após a compilação do SimEON, na pasta raíz do projeto se encontram duas pastas: adamant-broccoli e build-adamant-broccoli-desktop- Debug. No passo da escolha da topologia, o programa executável do SimEON fará a busca das topologias e não as encontrará. Para resolver, copie a pasta data que se encontra na pasta adamant-broccoli para a pasta build-adamant-broccoli-desktop- Debug. 6

7 Figura 9: Arquivo de texto com informações da topologia. Figura 10: Problema causado pela falta da pasta data na pasta build-adamant-broccoli- Desktop-Debug. Com todos os passos anteriormente expostos concluídos, o ambiente para utilização do SimEON está pronto para uso. No entanto, existe mais um problema que não é recorrente e não é sempre que acontece. Após a conclusão da compilação, executa-se o simulador, no entanto a aplicação é aberta apenas na janela embutida no Qt Creator, como ilustrado na Figura 11, e não é possível fornecer entradas para interagir com o simulador. 7

8 Figura 11: Execução da aplicação no Qt Creator. Para resolver esse impecílio, realiza-se os passos indicados numericamente na Figura 12 e descritos a seguir e, portanto, permitindo que o simulador seja executado no terminal, como ilustrado na Figura Na barra vertical do lado esquerdo do Qt Creator, clique na opção Projects; 2. Clique na seção Run; 3. Desmarque a caixa de diálogo Run in Terminal ; 4. Compile o simulador (opcional); 5. Marque a caixa de diálogo Run in Terminal ; 6. Compile e execute o simulador. Figura 12: Etapas para resolver o problema da execução no Qt Creator. 8

9 4 Noções de Git Figura 13: SimEON executando no terminal. 1. Faz o download do projeto com as últimas modicações git clone endereco-aqui 2. Lista todos os arquivos modicados para realizar commit git status 3. Desfaz todas as modicações nos arquivos do ambiente de trabalho git checkout. 4. Realiza uma captura do estado dos arquivos e adiciona ao histórico de modicações git commit -m "mensagem-aqui" 5. Envia as modicações para o ramo especicado git push endereco-aqui nome-do-ramo 6. Lista todos os ramos do repositório atual 9

10 git branch 7. Altera o ramo e atualiza os arquivos no ambiente de trabalho git checkout nome-do-ramo 8. Combina o ramo especicado com o ramo atual git merge nome-do-ramo 10