Apertium VirtualBox

From Apertium
Revision as of 08:48, 7 January 2015 by Unhammer (talk | contribs) (step by step)
Jump to navigation Jump to search
Apertium-VirtualBox.png

Since so many have problems getting Apertium to run on Windows or OS X, or are limited in bandwidth, Tino Didriksen has put together a ready-to-use VirtualBox VDI:

...or if you prefer a ZIP file:

The archive decompresses to a 3.3 GB vdi file.

Contents

  • Xubuntu 14.10, so Xfce4 instead of Unity (Ubuntu's fancy-yet-useless interface), trimmed of all non-essential packages
  • VirtualBox 4.3.18 Guest Additions
  • XChat, set to automatically connect to Freenode #apertium as nick ap-vbox (appending -2 or -3 on conflict), preconfigured in UTF-8 mode
  • Firefox, homepage set to Apertium Wiki
  • Gedit

Core tools installed via apt-get from repository http://apertium.projectjj.com/apt/ :

  • Foma 0.17
  • HFST 3.8.0
  • CG-3 0.9.9
  • Apertium 3.3.0
  • lttoolbox 3.3.0
  • apertium-lex-tools 0.1.0

It automatically logs in to a 1024x768 desktop. All passwords set to 'apertium' for when root is needed. Keyboard and timezone are set to Danish, but there is a shortcut for Keyboard configuration on the desktop.

On first boot, it looks like:

http://tinodidriksen.com/uploads/Apertium-VirtualBox-20140418.png

On the desktop is apertium-kaz-tat which works - compiling and testing that language pair should pretty much guarantee all required tools are installed and functional.

Nothing else from svn is left checked out - all was wiped after installing in order to save space.

The image is set up as a dynamically expanding hdd with max size 64 GB, where 8 GB is allocated to swap space.

Prerequisites

Step-by-Step Installation Instructions

1. Download the file (http://tinodidriksen.com/uploads/Apertium-VirtualBox-20141028.7z).

2. Use 7-Zip or a similar program to unzip the file. There should be exactly one thing in the unzipped folder - the Virtual Disk Image (VDI) entitled Apertium (Xubuntu 14.10).

3. Start VirtualBox and click "New" to create a new virtual machine.

4. For the OS Type, select Linux, Ubuntu.

5. For Memory, give it at least 512 MB RAM - it might run with less, but the more the better.

6. For Hard Disk, select the "Use an existing virtual hard drive file" radio button. Pick Apertium (Xubuntu 14.10).vdi from the drop-down menu, or if it isn't there, click the folder icon with the green arrow to the right and navigate to wherever you unzipped the file to. Finish the process by clicking "Create".

7. You can now run the new virtual box. On first boot it should look like this: http://tinodidriksen.com/uploads/Apertium-VirtualBox-20140418.png


Now you should have a system with all the prerequisites installed, and you should be able to follow Minimal installation from SVN to install a language pair (and possibly any required language modules).

Clipboard

To get the clipboard working between the virtualbox and e.g. Windows, go into Options of that VBox -> General -> Advanced tab -> Clipboard -> Bidirectional.

Copying files between Windows and the Virtualbox

You can have Virtualbox mount the Windows drive through VBox's shared folder feature:

  • Click "Devices" → "Shared Folders" and find a windows folder you want to share, giving it a name like Shared. Tick "Make Permanent".
  • Create a directory in the virtualbox to share it to: sudo mkdir /media/windows-shared
  • Mount it like this: sudo mount -t vboxsf Shared /media/windows-shared
  • To mount it on each reboot, do sudo gedit /etc/rc.local and write sudo mount -t vboxsf Shared /media/windows-shared before the "exit" line.