{"id":24527585,"url":"https://github.com/offlinehacker/ethertest","last_synced_at":"2025-03-15T16:33:21.576Z","repository":{"id":5682226,"uuid":"6892331","full_name":"offlinehacker/ethertest","owner":"offlinehacker","description":"Testing bed for ip networks","archived":false,"fork":false,"pushed_at":"2013-02-17T15:52:11.000Z","size":1468,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-15T04:46:19.833Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Puppet","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/offlinehacker.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2012-11-27T22:44:00.000Z","updated_at":"2014-03-05T23:50:20.000Z","dependencies_parsed_at":"2022-08-31T12:02:09.895Z","dependency_job_id":null,"html_url":"https://github.com/offlinehacker/ethertest","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/offlinehacker%2Fethertest","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/offlinehacker%2Fethertest/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/offlinehacker%2Fethertest/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/offlinehacker%2Fethertest/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/offlinehacker","download_url":"https://codeload.github.com/offlinehacker/ethertest/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243760345,"owners_count":20343626,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-01-22T06:19:37.552Z","updated_at":"2025-03-15T16:33:21.555Z","avatar_url":"https://github.com/offlinehacker.png","language":"Puppet","funding_links":[],"categories":[],"sub_categories":[],"readme":".. image:: https://raw.github.com/offlinehacker/ethertest/master/docs/_static/logo.png\n\nTestbed for ethernet networks\n\nDocumentation is avalible at `http://offlinehacker.x-truder.net/ethertest/ \u003chttp://offlinehacker.x-truder.net/ethertest/\u003e`_\n\nWe are trying to make this project as good as our knowledge about networking is,\nbut we are still learning and we know you can make it even better!\n\n**Any contributions in form of knowledge, comments, new ideas, bug reports and more\nthat would make ethertest better are very welcome.**\n\nDevelopment\n-----------\n\nSystem requierments:\n\n* Any moderen linux distribution supported by vagrant and virtualbox\n* x86_64 or any other arhitecture supported by virtualbox,\n  hardware virtualization is not a requierment.\n* 2Gigs or more memory\n\n    .. note::\n\n        VirtualBox can run inside os-based virtualization like openvz or lxc,\n        that's also why we use bridge networking inside virtual boxe-s(host-only does not work).\n\nRequierments:\n\n* Python 2.7\n* `VirtualBox \u003chttps://www.virtualbox.org/wiki/Downloads\u003e`_ 4.2.4 or newer\n* `Vagrant \u003chttp://downloads.vagrantup.com\u003e`_ 1.0.5 or newer\n* System packages: `iptables`, `tunctl`, `dnsmasq`\n\nDevelopment::\n\n    $ git clone git@github.com:offlinehacker/ethertest.git\n    $ git submodule update\n    $ cd ethertest\n    $ python setup.py develop\n    $ vagrant gem install vagrant-hiera\n    $ vagrant up [name]\n\nUpdate\n\n    ::\n\n        $ git pull origin master\n        $ git submodule update --init\n        $ vagrant destroy (only if you are having problems)\n        $ vagrant up [name]\n\n    .. note::\n        \n        You don't need to destroy, `vagrant provision` should do the task \n        in most cases. If you are having problems first try to halt (vagrant halt -f name)\n        or reload you virtual machines.\n\n\nUbuntu 12.04/12.10 instructions\n\n    ::\n\n        $ wget http://download.virtualbox.org/virtualbox/4.2.4/virtualbox-4.2_4.2.4-81684~Ubuntu~precise_amd64.deb\n        $ sudo dpkg -i virtualbox-4.2_4.2.4-81684~Ubuntu~precise_amd64.deb\n        $ wget http://files.vagrantup.com/packages/be0bc66efc0c5919e92d8b79e973d9911f2a511f/vagrant_1.0.5_i686.deb\n        $ sudo dpkg -i vagrant_1.0.5_i686.deb\n        $ sudo apt-get install python python-dev python-virtualenv dnsmasq iptables uml-utilities\n        $ git clone git@github.com:offlinehacker/ethertest.git\n        $ virtualenv --no-site-packages --python=python2.7 ethertest\n        $ cd ethertest\n        $ source bin/activate\n        $ python setup.py develop\n\n    .. note::\n\n        To activate and deactivate python virtualenv use `source bin/activate` and `deactivate` commands.\n\n        If you are having problems with installing vagrant try to install x64 version. On the other hand\n        if you are having problems with numpy try `pip install numpy`, and then again `python setup.py develop`\n\nBringing up virtual box-es\n--------------------------\n\n    .. note::\n\n        Configurations for virtual box-es are located inside `Vagrantfile`.\n\nFirst you need to start your network, dhcp server and nat.\nPlease make sure `tunctl`, `dnsmaq` and `iptables` commands are installed\n\n    ::\n\n        $ fab netstart\n        $ fab dhcp\n        $ fab natstart\n\n    .. note::\n\n        Configuration for network subnets(interfaces) are located inside `fabfile.py`.\n        `VirtualBox` will bridge with virtual intefaces as specified inside `Vagrantfile`.\n\n* To bring-up virtual box use\n  \n    ::\n\n        $ vagrant up [name]\n\n* To shut down virtualbox use\n\n    ::\n\n        $ vagrant halt [name]\n\n    .. note::\n\n        You can also start virtualbox and control and debug your running virtual box-es\n        form there.\n\n    .. warning::\n\n        If `vagrant` command is not avalible you must setup your search `PATH` variable.\n        You can set it by doing something like this::\n\n            $ export PATH=$PATH:/opt/vagrant/bin\n\n    To make it persistent edit your `~/.profile` file.\n\nTo ssh to virtualbox use\n\n    ::\n\n        $ vagrant ssh [name]\n\nTesting\n-------\n\n    .. note::\n\n        Tests are located inside `./ethertest/tests/`.\n\nWe use nose for running tests\n\n    ::\n\n        $ python setup.py test\n\n    .. note::\n        \n        For testing security of ipv6 you need thc-ipv6 tools installed.\n\nBuilding docs\n-------------\n\nDocumentation is located in `docs/` folder. To build it do\n\n    ::\n\n        $ sphinx-build -b html docs/ build/\n\n    .. note::\n\n        Documentation is written in `reStructuredText \u003chttp://docutils.sourceforge.net/rst.html\u003e`_\n        markup language and is using `sphinx \u003chttp://sphinx-doc.org/\u003e`_ speciffics and builders.\n\nBuilding latex tex files with sphinx:\n\n    ::\n\n\t$ cd ethertest/lat-docs\n\t$ make latex\n\n    .. note::\n\t\n\tThis will output a latex construct with [filename].tex. Filename is edited in conf.py\n\tin the source directory, where all the other .rst files are located.\n\nBuilding pdf from latex\n\n    ::\n\n\t$ cd ../build/latex\n\t$ make all-pdf\n\n    .. note::\n\n\tThis will generate a [filename].pdf from latex source files. More info and how to startup\n\tand generate first sphinx documents and convert them to pdf are located\n\t`here \u003chttp://jimmyg.org/blog/2009/sphinx-pdf-generation-with-latex.html\u003e`_.\n\nLicense\n-------\n\nThe MIT License (MIT)\n\nCopyright (C) 2013 and beyond Jaka Hudoklin and Matej Vrabec\n\nAll rights reserved.\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\nTHE SOFTWARE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fofflinehacker%2Fethertest","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fofflinehacker%2Fethertest","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fofflinehacker%2Fethertest/lists"}