How to Prepare a Development Environment for Tatoeba Using a Pre-made Virtual Machine
Installing the VM
Grab the vm file:
Untar the file:
Download both the vbox and the xz file
Use 7zip 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
Get and install VirtualBox
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
Get and install 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 as your SSH GUI.
To SSH into the machine, use the username tatoeba, password tatoeba, and port 4242:
ssh -p 4242 email@example.com
Now you can see the website running in your browser by pointing it to the following address:
Steps such as installing packages require superuser privileges. Prefix these commands with sudo or run:
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 firstname.lastname@example.org, you'll execute:
git config --global user.name "ghuser" git config --global user.email email@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 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 firstname.lastname@example.org: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.