Version at: 09/02/2014, 12:57 vs. version at: 09/02/2014, 12:58
11#How to Prepare a Development Environment for Tatoeba Using a Pre-made Virtual Machine
22
33* Grab the vm file [http://mirrors.bouah.net/pub/tatoeba/Tatovm/](http://mirrors.bouah.net/pub/tatoeba/Tatovm/)
44
55* Untar the file:
66
77 On Windows: use 7zip [http://www.7-zip.org/]
88
99 On Linux: use file-roller or from the terminal, type:
1010
1111 tar -xvf vmfile
1212
1313* Get and install VirtualBox [https://www.virtualbox.org/wiki/Downloads]
1414
1515* Load the VM files in VirtualBox:
1616
1717 From the GUI: Machine -> Add then browse to the location of the .vbox file
1818
1919 From the command line: VBoxManage registervm /path/to/vm.vbox
2020
2121* The default http port is 8080 and the default SSH port is 4242.
2222
2323* To SSH into the machine, use the username **tatoeba** and password **tatoeba**:
2424
2525 ssh -p 4242 tatoeba@127.0.0.1
2626
2727* Now you can see the website running in your browser by pointing it to the following address:
2828
2929 127.0.0.1:8080
3030
3131* The mysql user is **root** and password is **tatoeba** in case you need to do operations directly on the table or import more data.
3232
3333* To hack the codebase in your favorite editor in the comfort of your host computer, there are 3 ways:
3434
35 Mount a drive over SSH:
35 * Mount a drive over SSH:
3636
3737 * On Windows: download NetDrive [www.netdrive.net] and use the aforementioned credentials and port
3838
3939 * On Linux: install SSHFS and then mount it using:
4040
4141 sshfs tatoeba@127.0.0.1:4242 /path/to/mountpoint
4242
43 Mount a drive over WebDAV:
43 * Mount a drive over WebDAV:
4444
4545 * On Windows: use NetDrive. The user and password are **tatoeba**, and the port is 8080.
4646
4747 * On Linux: use your favorite file manager with WebDAV support, or install cadaver and connect using the above credentials.
4848
49 Mount a shared file (slow and not recommended):
49 * Mount a shared file (slow and not recommended):
5050
5151 * Set up Guest additions [https://help.ubuntu.com/community/VirtualBox/GuestAdditions]
5252
5353 * In the GUI select Devices -> Shared Folders -> Add
5454
5555 * Browse to the folder you want to share from your host and select it
5656
5757 * Select the Make permanent option
5858
5959 * Now mount the shared file on the guest system:
6060
6161 mount -t vboxfs /media/sharefoldername /path/to/mountpoint
6262
6363* You can also install a graphical environment (GNOME or any other development environment) to work directly from the VM:
6464
6565 apt-get install task-gnome-desktop
6666
6767* Before coding anything, make sure your codebase is up to date by executing the following commands:
6868
6969 cd ~/tatoeba-www
7070
7171 svn update
7272
7373* After you have changed the code enough and want to update the main repository, do the following:
7474
7575 * Make sure your config files aren't being committed:
7676
7777 svn ignore config/*
7878
7979 * Double-check your changes:
8080
8181 svn diff
8282
8383 * Make sure you're still up to date, then commit your changes:
8484
8585 svn update
8686
8787 svn commit
diff view generated by jsdifflib

Version at: 09/02/2014, 12:57

#How to Prepare a Development Environment for Tatoeba Using a Pre-made Virtual Machine

* Grab the vm file [http://mirrors.bouah.net/pub/tatoeba/Tatovm/](http://mirrors.bouah.net/pub/tatoeba/Tatovm/)

* Untar the file:

   On Windows: use 7zip [http://www.7-zip.org/]

   On Linux: use file-roller or from the terminal, type:

   tar -xvf vmfile

* Get and install VirtualBox [https://www.virtualbox.org/wiki/Downloads]

* Load the VM files in VirtualBox:

  From the GUI: Machine -> Add then browse to the location of the .vbox file

  From the command line: VBoxManage registervm /path/to/vm.vbox

* The default http port is 8080 and the default SSH port is 4242.

* To SSH into the machine, use the username **tatoeba** and password **tatoeba**:

   ssh -p 4242 tatoeba@127.0.0.1

* Now you can see the website running in your browser by pointing it to the following address:

   127.0.0.1:8080

* The mysql user is **root** and password is **tatoeba** in case you need to do operations directly on the table or import more data.

* To hack the codebase in your favorite editor in the comfort of your host computer, there are 3 ways:

 Mount a drive over SSH:

    * On Windows: download NetDrive [www.netdrive.net] and use the aforementioned credentials and port

    * On Linux: install SSHFS and then mount it using:

       sshfs tatoeba@127.0.0.1:4242 /path/to/mountpoint

 Mount a drive over WebDAV:

    * On Windows: use NetDrive. The user and password are **tatoeba**, and the port is 8080.

    * On Linux: use your favorite file manager with WebDAV support, or install cadaver and connect using the above credentials.

 Mount a shared file (slow and not recommended):

    * Set up Guest additions [https://help.ubuntu.com/community/VirtualBox/GuestAdditions]

    * In the GUI select Devices -> Shared Folders -> Add

    * Browse to the folder you want to share from your host and select it

    * Select the Make permanent option

    * Now mount the shared file on the guest system:

       mount -t vboxfs /media/sharefoldername /path/to/mountpoint

* You can also install a graphical environment (GNOME or any other development environment) to work directly from the VM:

  apt-get install task-gnome-desktop

* Before coding anything, make sure your codebase is up to date by executing the following commands:

  cd ~/tatoeba-www

  svn update

* After you have changed the code enough and want to update the main repository, do the following:

  * Make sure your config files aren't being committed:

    svn ignore config/* 

  * Double-check your changes:

    svn diff

  * Make sure you're still up to date, then commit your changes:

    svn update

    svn commit

version at: 09/02/2014, 12:58

#How to Prepare a Development Environment for Tatoeba Using a Pre-made Virtual Machine

* Grab the vm file [http://mirrors.bouah.net/pub/tatoeba/Tatovm/](http://mirrors.bouah.net/pub/tatoeba/Tatovm/)

* Untar the file:

   On Windows: use 7zip [http://www.7-zip.org/]

   On Linux: use file-roller or from the terminal, type:

   tar -xvf vmfile

* Get and install VirtualBox [https://www.virtualbox.org/wiki/Downloads]

* Load the VM files in VirtualBox:

  From the GUI: Machine -> Add then browse to the location of the .vbox file

  From the command line: VBoxManage registervm /path/to/vm.vbox

* The default http port is 8080 and the default SSH port is 4242.

* To SSH into the machine, use the username **tatoeba** and password **tatoeba**:

   ssh -p 4242 tatoeba@127.0.0.1

* Now you can see the website running in your browser by pointing it to the following address:

   127.0.0.1:8080

* The mysql user is **root** and password is **tatoeba** in case you need to do operations directly on the table or import more data.

* To hack the codebase in your favorite editor in the comfort of your host computer, there are 3 ways:

 * Mount a drive over SSH:

    * On Windows: download NetDrive [www.netdrive.net] and use the aforementioned credentials and port

    * On Linux: install SSHFS and then mount it using:

       sshfs tatoeba@127.0.0.1:4242 /path/to/mountpoint

 * Mount a drive over WebDAV:

    * On Windows: use NetDrive. The user and password are **tatoeba**, and the port is 8080.

    * On Linux: use your favorite file manager with WebDAV support, or install cadaver and connect using the above credentials.

 * Mount a shared file (slow and not recommended):

    * Set up Guest additions [https://help.ubuntu.com/community/VirtualBox/GuestAdditions]

    * In the GUI select Devices -> Shared Folders -> Add

    * Browse to the folder you want to share from your host and select it

    * Select the Make permanent option

    * Now mount the shared file on the guest system:

       mount -t vboxfs /media/sharefoldername /path/to/mountpoint

* You can also install a graphical environment (GNOME or any other development environment) to work directly from the VM:

  apt-get install task-gnome-desktop

* Before coding anything, make sure your codebase is up to date by executing the following commands:

  cd ~/tatoeba-www

  svn update

* After you have changed the code enough and want to update the main repository, do the following:

  * Make sure your config files aren't being committed:

    svn ignore config/* 

  * Double-check your changes:

    svn diff

  * Make sure you're still up to date, then commit your changes:

    svn update

    svn commit

Note

The lines in green are the lines that have been added in the new version. The lines in red are those that have been removed.