Version at: 27/03/2014, 02:07 vs. version at: 03/04/2014, 01:56
11#How to Prepare a Development Environment for Tatoeba Using a Pre-made Virtual Machine
22
33## Installing the VM
4* Grab the vm file [http://mirrors.bouah.net/pub/tatoeba/Tatovm/](http://mirrors.bouah.net/pub/tatoeba/Tatovm/)
4* Grab the vm file:
5 [Mirror 1](http://www.aloneonmars.info/public/lool0/Tatovm/)
6 [Torrent(mirror 1)](http://www.aloneonmars.info/public/lool0/Tatovm/Tatovm.torrent)
7 [Magnet link](magnet:?xt=urn:btih:3b36fc35649e1c181a1aae99a13863f2735b75b1&dn=Tatovm)
58
69* Untar the file:
710
811 * On Windows:
912
1013 * Download both the vbox and the xz file
1114
1215 * Use [7zip](http://www.7-zip.org/) to extract Tatovm.vmdk file from the xz file (using the "Extract here" item from the right-click menu)
1316
1417 * On Linux: use file-roller or from the terminal, type:
1518 xz -d Tatovm.vmdk.xz
1619
1720### Using VirtualBox
1821
1922* Get and install [VirtualBox](https://www.virtualbox.org/wiki/Downloads)
2023
2124* Load the VM files in VirtualBox:
2225
2326 From the GUI: **Machine -> Add**, then browse to the location of the .vbox file
2427
2528 From the command line: VBoxManage registervm /path/to/vm.vbox
2629
2730### Using Qemu
2831
2932* Get and install [qemu](http://en.wikibooks.org/wiki/QEMU/Installing_QEMU)
3033
3134* Run the following command: (tweak the -m flag for more ram)
3235
3336 qemu-system-i386 Downloads/Tatovm.vmdk -smp 4 -m 512 -enable-kvm -net nic -net user -redir tcp:8080::80 -redir tcp:4242::22 -redir tcp:8081::81
3437
3538## Accessing the VM
3639* The default http port is **8080**, the default SSH port is **4242**, and the default webdav port is **8081**.
3740
3841* On Windows, you may want to download [PuTTY](http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html) as your SSH GUI.
3942
4043* To SSH into the machine, use the username **tatoeba**, password **tatoeba**, and port **4242**:
4144
4245 ssh -p 4242 tatoeba@127.0.0.1
4346
4447* Now you can see the website running in your browser by pointing it to the following address:
4548
4649 127.0.0.1:8080
4750
4851* Steps such as installing packages require superuser privileges. Prefix these commands with sudo or run:
4952
5053 sudo su
5154
5255 Then type in the password **tatoeba** when prompted.
5356
5457 After performing your operation, execute "exit" to end superuser access.
5558
5659* The MySQL user is **root** and password is **tatoeba** in case you need to do operations directly on the table or import more data. Getting to a mysql shell or excuting a mysql script is as easy as:
5760
5861 mysql -u root -ptatoeba tatoeba
5962
6063 mysql -u root -ptatoeba tatoeba < script.sql
6164
6265##Performing Additional Configuration Steps
6366
6467* If you will be committing code, configure your user.name and user.email. (You can do this retroactively after your first commit, but it's better to do it beforehand.) For instance, if your username at GitHub is ghuser, and your e-mail address is address@example.com, you'll execute:
6568
6669 git config --global user.name "ghuser"
6770
6871 git config --global user.email address@example.com
6972
7073* It's also a good idea to set your time correctly, especially if you're going to be committing code. Otherwise, the time stamps on your commits will be wrong, and it will look as if you're committing code days before or after you actually do. Try installing the ntp package. See [this page](https://wiki.debian.org/DateTime) for more information.
7174
7275* You may find it useful at this point to back up your databases so that you can return them to their virgin state. Make a directory (for instance, /backup ; this may require root permission) and then execute a command such as this one:
7376
7477 mysqldump -u root -ptatoeba -A > /backup/all_dbs.sql
7578
7679## Customizing Your Installation
7780* There are three ways to access the codebase via your favorite editor in the comfort of your host computer:
7881
7982 * Mount a drive over SSH:
8083
8184 * On Windows: download NetDrive [www.netdrive.net] and use the aforementioned credentials and port
8285
8386 * On Linux: install SSHFS and then mount it using:
8487
8588 sshfs tatoeba@127.0.0.1:4242 /path/to/mountpoint
8689
8790 * Mount a drive over WebDAV:
8891
8992 * On Windows: use NetDrive. The user and password are **tatoeba**, and the port is **8081**.
9093
9194 * On Linux: use your favorite file manager with WebDAV support, or install cadaver and connect using the above credentials.
9295
9396 * Mount a shared file (slow and not recommended):
9497
9598 * Set up Guest additions [https://help.ubuntu.com/community/VirtualBox/GuestAdditions]
9699
97100 * In the GUI select Devices -> Shared Folders -> Add
98101
99102 * Browse to the folder you want to share from your host and select it
100103
101104 * Select the Make permanent option
102105
103106 * Now mount the shared file on the guest system:
104107
105108 mount -t vboxfs /media/sharefoldername /path/to/mountpoint
106109
107110* You can also install a graphical environment (GNOME or any other development environment) to work directly from the VM:
108111
109112 apt-get install task-gnome-desktop
110113
111114##Logging Into Tatoeba on the VM
112115
113116The users provided by default are:
114117
115118 admin
116119
117120 corpus_maintainer
118121
119122 advanced_contributor
120123
121124 contributor
122125
123126 inactive
124127
125128 spammer
126129
127130The default password for each user is '123456'.
128131
129132In addition, you can register new users.
diff view generated by jsdifflib

Version at: 27/03/2014, 02:07

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

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

* Untar the file:

   * On Windows: 

        * Download both the vbox and the xz file

        * Use [7zip](http://www.7-zip.org/) to extract Tatovm.vmdk file from the xz file (using the "Extract here" item from the right-click menu)

   * On Linux: use file-roller or from the terminal, type:
   xz -d Tatovm.vmdk.xz

### Using VirtualBox

* 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

### Using Qemu

* Get and install [qemu](http://en.wikibooks.org/wiki/QEMU/Installing_QEMU)

* Run the following command: (tweak the -m flag for more ram)

  qemu-system-i386 Downloads/Tatovm.vmdk -smp 4 -m 512 -enable-kvm -net nic -net user -redir tcp:8080::80 -redir tcp:4242::22 -redir tcp:8081::81

## Accessing the VM
* The default http port is **8080**, the default SSH port is **4242**, and the default webdav port is **8081**.

* On Windows, you may want to download [PuTTY](http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html) as your SSH GUI.

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

   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

* Steps such as installing packages require superuser privileges. Prefix these commands with sudo or run:

   sudo su

   Then type in the password **tatoeba** when prompted.

   After performing your operation, execute "exit" to end superuser access.

* The MySQL user is **root** and password is **tatoeba** in case you need to do operations directly on the table or import more data. Getting to a mysql shell or excuting a mysql script is as easy as:

  mysql -u root -ptatoeba tatoeba

  mysql -u root -ptatoeba tatoeba < script.sql

##Performing Additional Configuration Steps

* If you will be committing code, configure your user.name and user.email. (You can do this retroactively after your first commit, but it's better to do it beforehand.) For instance, if your username at GitHub is ghuser, and your e-mail address is address@example.com, you'll execute:

        git config --global user.name "ghuser"

        git config --global user.email address@example.com

* It's also a good idea to set your time correctly, especially if you're going to be committing code. Otherwise, the time stamps on your commits will be wrong, and it will look as if you're committing code days before or after you actually do. Try installing the ntp package. See [this page](https://wiki.debian.org/DateTime) for more information.

* You may find it useful at this point to back up your databases so that you can return them to their virgin state. Make a directory (for instance, /backup ; this may require root permission) and then execute a command such as this one:

    mysqldump -u root -ptatoeba -A > /backup/all_dbs.sql
 
## Customizing Your Installation
* There are three ways to access the codebase via your favorite editor in the comfort of your host computer:

   * 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 **8081**.

        * 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

##Logging Into Tatoeba on the VM

The users provided by default are:

    admin

    corpus_maintainer

    advanced_contributor

    contributor

    inactive

    spammer

The default password for each user is '123456'.

In addition, you can register new users.

version at: 03/04/2014, 01:56

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

## Installing the VM
* Grab the vm file:
    [Mirror 1](http://www.aloneonmars.info/public/lool0/Tatovm/)
    [Torrent(mirror 1)](http://www.aloneonmars.info/public/lool0/Tatovm/Tatovm.torrent)
    [Magnet link](magnet:?xt=urn:btih:3b36fc35649e1c181a1aae99a13863f2735b75b1&dn=Tatovm)

* Untar the file:

   * On Windows: 

        * Download both the vbox and the xz file

        * Use [7zip](http://www.7-zip.org/) to extract Tatovm.vmdk file from the xz file (using the "Extract here" item from the right-click menu)

   * On Linux: use file-roller or from the terminal, type:
   xz -d Tatovm.vmdk.xz

### Using VirtualBox

* 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

### Using Qemu

* Get and install [qemu](http://en.wikibooks.org/wiki/QEMU/Installing_QEMU)

* Run the following command: (tweak the -m flag for more ram)

  qemu-system-i386 Downloads/Tatovm.vmdk -smp 4 -m 512 -enable-kvm -net nic -net user -redir tcp:8080::80 -redir tcp:4242::22 -redir tcp:8081::81

## Accessing the VM
* The default http port is **8080**, the default SSH port is **4242**, and the default webdav port is **8081**.

* On Windows, you may want to download [PuTTY](http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html) as your SSH GUI.

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

   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

* Steps such as installing packages require superuser privileges. Prefix these commands with sudo or run:

   sudo su

   Then type in the password **tatoeba** when prompted.

   After performing your operation, execute "exit" to end superuser access.

* The MySQL user is **root** and password is **tatoeba** in case you need to do operations directly on the table or import more data. Getting to a mysql shell or excuting a mysql script is as easy as:

  mysql -u root -ptatoeba tatoeba

  mysql -u root -ptatoeba tatoeba < script.sql

##Performing Additional Configuration Steps

* If you will be committing code, configure your user.name and user.email. (You can do this retroactively after your first commit, but it's better to do it beforehand.) For instance, if your username at GitHub is ghuser, and your e-mail address is address@example.com, you'll execute:

        git config --global user.name "ghuser"

        git config --global user.email address@example.com

* It's also a good idea to set your time correctly, especially if you're going to be committing code. Otherwise, the time stamps on your commits will be wrong, and it will look as if you're committing code days before or after you actually do. Try installing the ntp package. See [this page](https://wiki.debian.org/DateTime) for more information.

* You may find it useful at this point to back up your databases so that you can return them to their virgin state. Make a directory (for instance, /backup ; this may require root permission) and then execute a command such as this one:

    mysqldump -u root -ptatoeba -A > /backup/all_dbs.sql
 
## Customizing Your Installation
* There are three ways to access the codebase via your favorite editor in the comfort of your host computer:

   * 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 **8081**.

        * 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

##Logging Into Tatoeba on the VM

The users provided by default are:

    admin

    corpus_maintainer

    advanced_contributor

    contributor

    inactive

    spammer

The default password for each user is '123456'.

In addition, you can register new users.

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.