Added instructions to run dojot on VirtualBox. (#6)

source/index.rst

@@ -23,6 +23,7 @@ pages.
    ops_guide
    user_guide
    install/compose_guide
+   vms/vbox/guide
    faq/faq
 
 

source/locale/pt_BR/LC_MESSAGES/vms.po

@@ -0,0 +1,135 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) 2017, CPqD
+# This file is distributed under the same license as the dojot package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, 2017.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: dojot 0.0.0\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2017-11-24 10:55-0200\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Generated-By: Babel 2.5.1\n"
+
+#: ../../source/vms/vbox/guide.rst:2
+msgid "Running dojot on VirtualBox"
+msgstr "Rodando a dojot no VirtualBox"
+
+#: ../../source/vms/vbox/guide.rst:4
+msgid "This guide provides instructions to run dojot platform on VirtualBox."
+msgstr "Este guia provê instruções para rodar a plataforma dojot no VirtualBox."
+
+#: ../../source/vms/vbox/guide.rst:6
+msgid ""
+"You should only run dojot this way if you don’t have any familiarity with"
+" docker and just want to learn how to use dojot. We don’t recommend it "
+"for development and much less for experimental or real deployments."
+msgstr ""
+"Você deve rodar a dojot desta maneira somente se você não tiver nenhuma familiaridade "
+"com docker e quiser apenas conhecer a dojot. Não recomendamos rodá-la desta maneira "
+"para desenvolvimento e muito menos para qualquer tipo de implantação."
+
+#: ../../source/vms/vbox/guide.rst:10
+msgid ""
+"The steps described here were checked on Windows 7, but you shouldn’t "
+"have problems to run them in different operational systems."
+msgstr ""
+"Os passos descritos aqui foram validados em Windows 7, mas você não deve "
+"ter dificuldade para executá-los num sistema operacional diferente."
+
+#: ../../source/vms/vbox/guide.rst:13
+msgid ""
+"First of all, if you don’t have VirtualBox you’ll need to install it. Up "
+"to date information and installation procedures can be found at the "
+"project’s documentation:"
+msgstr ""
+"Primeiramente, se você não tem o VirtualBox, você precisa instalá-lo. Informações "
+"e instruções atualizadas estão disponíveis na documentação do projeto:"
+
+#: ../../source/vms/vbox/guide.rst:17
+msgid "https://www.virtualbox.org/"
+msgstr ""
+
+#: ../../source/vms/vbox/guide.rst:19
+msgid ""
+"Then, you need to download a virtual machine image with dojot, which is "
+"available at:"
+msgstr ""
+"Em seguida, você precisa baixar a imagem da máquina virtual com a dojot, que está "
+"disponível em: "
+
+#: ../../source/vms/vbox/guide.rst:21
+msgid "http://dojot-iso.s3.amazonaws.com/imagem/dojot.0.1.0-dojot.vdi"
+msgstr ""
+
+#: ../../source/vms/vbox/guide.rst:23
+msgid ""
+"The next step is to create a virtual machine on VirtualBox. Chick on the "
+"New button, then set the name ``as you wish``, type to ``Linux`` and "
+"version to ``Debian (64-bit)``."
+msgstr ""
+"O próximo passo é criar no VirtualBox uma máquina virtual. Clique em `New` e "
+"dê o nome que desejar, configure o tipo como ``Linux`` e a versão como ``Debian (64-bit)``."
+
+#: ../../source/vms/vbox/guide.rst:30
+msgid "Click on Next, and set the memory size. We recommend at least 2048 MB."
+msgstr "Clique em *Next* e configure o tamanho da memória. Recomendamos pelo menos 2048 MB."
+
+#: ../../source/vms/vbox/guide.rst:36
+msgid ""
+"Click on Next, and set the hard disk to use an existing virtual hard disk"
+" file and choose the downloaded image."
+msgstr ""
+"Clique em *Next* e configure o disco com a opção *use an existing virtual hard disk file* e "
+"selecione a imagem que você baixou."
+
+#: ../../source/vms/vbox/guide.rst:43
+msgid "Click on Create."
+msgstr "Clique em *Create* para finalizar."
+
+#: ../../source/vms/vbox/guide.rst:45
+msgid ""
+"Next, click on Settings/Network and check whether the network adapter is "
+"enabled and set it to ``Host-only``. This will allow host and guest to "
+"communicate to each other. Write down the MAC Address, you will need it "
+"later."
+msgstr ""
+"Em seguida, clique em *Settings/Network* e verifique se a interface está habilitada e "
+"configure-a para ``Host-only``. Isto era permitir a comunicação entre o *host* e o *guest*. "
+"Anote o *MAC Address*, pois será usado posteriormente.*"
+
+
+#: ../../source/vms/vbox/guide.rst:53
+msgid "Click on OK and start the virtual machine."
+msgstr "Clique em *OK* e inicie a máquina virtual."
+
+#: ../../source/vms/vbox/guide.rst:55
+msgid ""
+"Login in the virtual machine (login/password are ``dojot/dojot``) to set "
+"the network interface. Firstly, get the interface name:"
+msgstr ""
+"Acesse a máquina virtual (*login/password* são ``dojot/dojot``) para configurar "
+"a sua interface de rede. Primeiramente, obtenha o nome da interface:"
+
+#: ../../source/vms/vbox/guide.rst:66
+msgid "Edit the file ``/etc/network/interfaces``, adding ::"
+msgstr "Edite o arquivo ``/etc/network/interfaces``, adicionando ::"
+
+#: ../../source/vms/vbox/guide.rst:77
+msgid "Restart the networking service:"
+msgstr "Reinicie o serviço de rede:"
+
+#: ../../source/vms/vbox/guide.rst:84
+msgid "Get the ip address assigned to the interface:"
+msgstr "Obtenha o endereço ip atribuído à interface:"
+
+#: ../../source/vms/vbox/guide.rst:94
+msgid "In the host machine, open a browser and type ``<YOUR IP ADDRESS>:8000``."
+msgstr "Na máquina *host*, abra um browser e digite ``<YOUR IP ADDRESS>:8000``."
+

source/vms/vbox/guide.rst

@@ -0,0 +1,99 @@
+Running dojot on VirtualBox
+===================================
+
+This guide provides instructions to run dojot platform on VirtualBox.
+
+You should only run dojot this way if you don’t have any familiarity with 
+docker and just want to learn how to use dojot. We don’t recommend it for 
+development and much less for experimental or real deployments.
+
+The steps described here were checked on Windows 7, but you shouldn’t have 
+problems to run them in different operational systems.
+
+First of all, if you don’t have VirtualBox you’ll need to install it. 
+Up to date information and installation procedures can be found at the 
+project’s documentation: 
+
+https://www.virtualbox.org/
+
+Then, you need to download a virtual machine image with dojot, which is available at: 
+
+http://dojot-iso.s3.amazonaws.com/imagem/dojot.0.1.0-dojot.vdi
+
+The next step is to create a virtual machine on VirtualBox. Click on the New button, 
+then set the name ``as you wish``, type to ``Linux`` and version to ``Debian (64-bit)``.
+
+.. image:: image1.png
+        :width: 95%
+        :align: center
+
+Click on Next, and set the memory size. We recommend at least 2048 MB.
+
+.. image:: image2.png
+        :width: 95%
+        :align: center
+
+Click on Next, and set the hard disk to use an existing virtual hard disk file and choose 
+the downloaded image.
+
+.. image:: image3.png
+        :width: 95%
+        :align: center
+
+Click on Create.
+
+Next, click on Settings/Network and check whether the network adapter is enabled and set it to 
+``Host-only``. This will allow host and guest to communicate to each other. 
+Write down the MAC Address, you will need it later.
+
+.. image:: image4.png
+        :width: 95%
+        :align: center
+
+Click on OK and start the virtual machine.
+
+Login in the virtual machine (login/password are ``dojot/dojot``) to set the network interface. 
+Firstly, get the interface name:
+
+.. code-block:: bash
+
+	$ sudo ip address | grep -B1 -i "<YOUR MAC ADDRESS>" | head -1 | cut -d':' -f2
+
+.. image:: image5.png
+        :width: 95%
+        :align: center
+
+Edit the file ``/etc/network/interfaces``, adding ::
+
+	# The primary network interface
+	auto <YOUR INTERFACE NAME>
+	allow-hotplug <YOUR INTERFACE NAME>
+	iface <YOUR INTERFACE NAME> inet dhcp
+
+.. image:: image6.png
+        :width: 95%
+        :align: center
+
+Restart the networking service:
+
+.. code-block:: bash
+
+	$ systemctl restart networking.service
+
+
+Get the ip address assigned to the interface: 
+
+.. code-block:: bash
+
+	ip address show dev <YOUR INTERFACE NAME>
+
+.. image:: image7.png
+        :width: 95%
+        :align: center
+
+In the host machine, open a browser and type ``<YOUR IP ADDRESS>:8000``.
+
+.. image:: image8.png
+        :width: 95%
+        :align: center
+