--------------------------------------------- # Mutsun Language Database Virtual Machine Preferred citation (DataCite format): Rios, Fernando; Warner, Natasha (2022). Mutsun Language Database Virtual Machine. University of Arizona Research Data Repository. Software. https://doi.org/10.25422/azu.data.20010236 Corresponding Author: Natasha Warner, Department of Linguistics, UA, nwarner@email.arizona.edu License: CC BY 4.0 DOI: https://doi.org/10.25422/azu.data.20010236 --------------------------------------------- ## Summary This is an Ubuntu 20.04.4 virtual machine containing a ready-to-use copy of the FieldWorks software with the Mutsun language database already loaded. This virtual machine was created to archive a working copy of the database along with the database software itself. Licenses: * FieldWorks is licensed under the GNU LGPL 2.1 * The FieldWorks dependencies are licensed according to their own licenses * Ubuntu is free software licensed under the terms at https://ubuntu.com/legal/intellectual-property-policy * The data as well as this documentation is licensed CC BY 4.0. The software is described using [CodeMeta](https://codemeta.github.io/terms/)[ ](https://codemeta.github.io/terms/)and the Software Preservation Network [Software Metadata Recommended Format](https://doi.org/10.7298/xe9s-3b15). Refer to the included readme file for more information. ### Running the Fieldworks VM To run the VM, install Oracle VirtualBox (tested v6.1.34) - Computer must support virtualization - If there are errors like "VT-x is disabled in the BIOS" when starting the VM, ensure that virtualization extensions are enabled in the computer's BIOS - If VM freezes on Windows hosts with Windows Subsystem for Linux installed, see https://stackoverflow.com/questions/58031941/how-to-get-oracle-vm-virtualbox-6-0-and-wsl-working-at-the-same-time Add the VM to VirtualBox - Select File -> Import Appliance from the menu and select the downloaded OVA file. - Run the VM and double click the Mutsun2022Public icon on the Desktop The virtual machine has been configured with - Ubuntu 20.04.4 64 bit - 2048 MB RAM, 64 MB video ram - fieldworks 9.0.17 and all dependencies pre-installed - The Mutsun database loaded - Most autoupdate checks, analytics etc. have been disabled from the OS, Fieldworks, and Firefox. ### VM Creation To recreate the VM, follow these steps - Download official Ubuntu 20.04.4 LTS desktop image (64bit) https://releases.ubuntu.com/20.04.4/ - Select the "minimal install" option and install into a VirtualBox machine with - 2048MB RAM - 64MB video memory - PAE/NX enabled - nested VT-x disabled - nested paging disabled - Username: redata, password: redata **Configuration** Add the SIL repos according to https://packages.sil.org - `(wget -O- https://packages.sil.org/keys/pso-keyring-2016.gpg | sudo tee /etc/apt/trusted.gpg.d/pso-keyring-2016.gpg)&>/dev/null` - `(. /etc/os-release && sudo tee /etc/apt/sources.list.d/packages-sil-org.list>/dev/null <<< "deb http://packages.sil.org/$ID $VERSION_CODENAME main")` - `sudo apt update` **Fieldworks Installation** Do one of the following 1. `sudo apt-get install fieldworks` if an internet connection is available. If no internet connection is available or a dependency isn't found, perform an offline install. 2. Offline install. - From the dependencies package copy the `corefonts` directory to `/usr/local/share` - `sudo apt-get install -o Dir::Cache=/path/to/deps -o Dir::Cache::archives=/path/to/deps fieldworks` where /path/to/deps is the extracted dependencies package directory - Accept any license agreements 3. Optionally install GNOME Character Map `sudo apt-get install gucharmap`. It's needed by the Fieldworks Insert Special Character function Offline install notes: the dependencies package was generated using - `sudo apt-get install -d -o Dir::Cache=/path/to/deps -o Dir::Cache::archives=/path/to/deps fieldworks` (see https://stackoverflow.com/questions/13756800/how-to-download-all-dependencies-and-packages-to-directory) - Downloading the mscore fonts directly (see https://lists.debian.org/debian-user/2015/07/msg00195.html) - if the corefonts installation has already failed, make sure `corefonts` is copied to `/usr/local/share` and then run - sudo echo "ttf-mscorefonts-installer msttcorefonts/dldir string /usr/local/share/corefonts" | sudo debconf-set-selections - `sudo dpkg --configure --pending` - `sudo apt-get --reinstall install -o Dir::Cache=/home/redata/flex -o Dir::Cache::archives=/home/redata/flex ttf-mscorefonts-installer` **Loading the Mutsun database** The database from the archive is pre-loaded. To update the database, the files must be transferred to to the VM. This can be done in various ways - Download them directly within the VM from the ReDATA archive - Install the VirtualBox Guest Additions in the VM and transfer the files via a shared folder - Transfer the files via USB drive - Use the VirtualBox VISO Creator within the Virtual Media Manager Optical Disks tab to create a new virtual disk with the files. --------------------------------------------- ## Files and Folders - Mutsun Database (Ubuntu 20.04.4).ova: Virtual machine in OVA 2.0 format - fieldworks-offline-dependencies.tar.gz: All dependencies needed by FieldWorks on Ubuntu 20.04.4. Can be used to recreate the virtual machine. Refer to the Fieldworks Offline Install section of this documentation for additional information - preview.png: a screenshot of the software running in the virtual machine - spnmeta.csv: software metadata in the Software Preservation Network Software Metadata Recommended Format - codemeta.json: software metadata in the CodeMeta 2.0 schema --------------------------------------------- ## Materials and Methods - Oracle VirtualBox 6.1 - FieldWorks 9.0.17 - Ubuntu 20.04.4 --------------------------------------------- ## Contributor Roles The roles are defined by the CRediT taxonomy http://credit.niso.org/ - Fernando Rios, University of Arizona: Data Curation - Natasha Warner, University of Arizona: Conceptualization, Data curation, Formal analysis, Funding acquisition, Investigation, Methodology, Project administration, Supervision, Validation, Writing - original draft, Writing - review & editing --------------------------------------------- ## Additional Notes Refer to the main dataset for additional information https://doi.org/10.25422/azu.data.19880254 Links: - https://doi.org/10.25422/azu.data.19880254 - https://doi.org/10.7298/xe9s-3b15 - https://codemeta.github.io/terms/