| Version at: 19/01/2014, 01:20 vs. version at: 09/02/2014, 12:53 | ||
|---|---|---|
| 1 | 1 | #How to Prepare a Development Environment for Tatoeba Using a Pre-made Virtual Machine |
| 2 | 2 | |
| 3 | 3 | * Grab the vm file [http://mirrors.bouah.net/pub/tatoeba/Tatovm/](http://mirrors.bouah.net/pub/tatoeba/Tatovm/) |
| 4 | 4 | |
| 5 | 5 | * Untar the file: |
| 6 | 6 | |
| 7 | on windows: use 7zip [http://www.7-zip.org/] | |
| 7 | On Windows: use 7zip [http://www.7-zip.org/] | |
| 8 | 8 | |
| 9 | on linux: use file-roller or from the terminal: | |
| 9 | On Linux: use file-roller or from the terminal, type: | |
| 10 | 10 | |
| 11 | 11 | tar -xvf vmfile |
| 12 | 12 | |
| 13 | * Get and install virtual box [https://www.virtualbox.org/wiki/Downloads] | |
| 13 | * Get and install VirtualBox [https://www.virtualbox.org/wiki/Downloads] | |
| 14 | 14 | |
| 15 | * Load the vm files in virtualbox: | |
| 15 | * Load the VM files in VirtualBox: | |
| 16 | 16 | |
| 17 | from the GUI: Machine -> Add then browse to the location of the .vbox file | |
| 17 | From the GUI: Machine -> Add then browse to the location of the .vbox file | |
| 18 | 18 | |
| 19 | from the commandline: VBoxManage registervm /path/to/vm.vbox | |
| 19 | From the command line: VBoxManage registervm /path/to/vm.vbox | |
| 20 | 20 | |
| 21 | * The default http port is 8080 and the default ssh port is 4242 | |
| 21 | * The default http port is 8080 and the default SSH port is 4242. | |
| 22 | 22 | |
| 23 | * To ssh into the machine use the username tatoeba and password tatoeba: | |
| 23 | * To SSH into the machine, use the username **tatoeba** and password **tatoeba**: | |
| 24 | 24 | |
| 25 | ssh -p 4242 tatoeba@127.0.0.1 | |
| 25 | ssh -p 4242 tatoeba@127.0.0.1 | |
| 26 | 26 | |
| 27 | * Now you can see the website running in your browser, just point it to the following address: | |
| 27 | * Now you can see the website running in your browser by pointing it to the following address: | |
| 28 | 28 | |
| 29 | 29 | 127.0.0.1:8080 |
| 30 | 30 | |
| 31 | * The mysql user is root and password is tatoeba in case you need to do operations directly on the table or import more data | |
| 31 | * The mysql user is **root** and password is **tatoeba** in case you need to do operations directly on the table or import more data. | |
| 32 | 32 | |
| 33 | * To hack the codebase in your favorite editor in the comfort of your host computer there's 3 ways: | |
| 33 | * To hack the codebase in your favorite editor in the comfort of your host computer, there are 3 ways: | |
| 34 | 34 | |
| 35 | * Mount a drive over ssh: | |
| 35 | * Mount a drive over SSH: | |
| 36 | 36 | |
| 37 | * on windows: download netdrive [www.netdrive.net] and use the aforementioned credentials and port | |
| 37 | * On Windows: download NetDrive [www.netdrive.net] and use the aforementioned credentials and port | |
| 38 | 38 | |
| 39 | * on linux: install sshfs and then mount it using: | |
| 39 | * On Linux: install SSHFS and then mount it using: | |
| 40 | 40 | |
| 41 | 41 | sshfs tatoeba@127.0.0.1:4242 /path/to/mountpoint |
| 42 | 42 | |
| 43 | * Mount a drive over webdav: | |
| 43 | * Mount a drive over WebDAV: | |
| 44 | 44 | |
| 45 | * on windows: use netdrive, the user and password is tatoeba the port is 8080 | |
| 45 | * On Windows: use NetDrive. The user and password are **tatoeba**, and the port is 8080. | |
| 46 | 46 | |
| 47 | * on linux: use your favorite file manager with webdav support, or install cadaver and connect using the above credentials | |
| 47 | * On Linux: use your favorite file manager with WebDAV support, or install cadaver and connect using the above credentials. | |
| 48 | 48 | |
| 49 | * Mount a shared file (slow and not recommended): | |
| 49 | * Mount a shared file (slow and not recommended): | |
| 50 | 50 | |
| 51 | * Setup Guest additions [https://help.ubuntu.com/community/VirtualBox/GuestAdditions] | |
| 51 | * Set up Guest additions [https://help.ubuntu.com/community/VirtualBox/GuestAdditions] | |
| 52 | 52 | |
| 53 | * In the GUI select Devices -> Shared Folders -> Add | |
| 53 | * In the GUI select Devices -> Shared Folders -> Add | |
| 54 | 54 | |
| 55 | * browse to the folder you want to share from your host and select it | |
| 55 | * Browse to the folder you want to share from your host and select it | |
| 56 | 56 | |
| 57 | * Select the Make permanent option | |
| 57 | * Select the Make permanent option | |
| 58 | 58 | |
| 59 | * Now mount the shared file on the guest system: | |
| 59 | * Now mount the shared file on the guest system: | |
| 60 | 60 | |
| 61 | 61 | mount -t vboxfs /media/sharefoldername /path/to/mountpoint |
| 62 | 62 | |
| 63 | * You can also install a graphical environment (gnome or any other DE) to work directly from the vm: | |
| 63 | * You can also install a graphical environment (GNOME or any other development environment) to work directly from the VM: | |
| 64 | 64 | |
| 65 | 65 | apt-get install task-gnome-desktop |
| 66 | 66 | |
| 67 | * Make sure your codebase is up to date before coding anything with: | |
| 67 | * Before coding anything, make sure your codebase is up to date by executing the following commands: | |
| 68 | 68 | |
| 69 | 69 | cd ~/tatoeba-www |
| 70 | 70 | |
| 71 | 71 | svn update |
| 72 | 72 | |
| 73 | * After you have hacked the code enough and would want to update the main repository do the following: | |
| 73 | * After you have changed the code enough and want to update the main repository, do the following: | |
| 74 | 74 | |
| 75 | * make sure your config files aren't being commited: | |
| 75 | * Make sure your config files aren't being committed: | |
| 76 | 76 | |
| 77 | svn ingore config/* | |
| 77 | svn ignore config/* | |
| 78 | 78 | |
| 79 | * make sure you're still up to date then commit your changes: | |
| 79 | * Double-check your changes: | |
| 80 | ||
| 81 | svn diff | |
| 82 | ||
| 83 | * Make sure you're still up to date, then commit your changes: | |
| 80 | 84 | |
| 81 | 85 | svn update |
| 82 | 86 | |
| 83 | 87 | svn commit |
| diff view generated by jsdifflib | ||
Version at: 19/01/2014, 01:20
#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:
tar -xvf vmfile
* Get and install virtual box [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 commandline: 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, just point 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's 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 is tatoeba 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):
* Setup 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 DE) to work directly from the vm:
apt-get install task-gnome-desktop
* Make sure your codebase is up to date before coding anything with:
cd ~/tatoeba-www
svn update
* After you have hacked the code enough and would want to update the main repository do the following:
* make sure your config files aren't being commited:
svn ingore config/*
* make sure you're still up to date then commit your changes:
svn update
svn commit
version at: 09/02/2014, 12:53
#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