This repository contains all of the platform-specific code required to run the GPII Personalization Framework on GNU/Linux with GNOME.
The following components can be found in the repository:
- usbDriveListener: a UserListener implementation that will detect a USB drive with an anonymous GPII user token installed on it
- orca: a Node.js module for dealing with GNOME Orca's settings
Building, Installing, and Running
We use the grunt task system to perform our build operations. If you don't have grunt installed yet you can do so with:
npm install -g grunt-cli
To fetch our core universal dependencies and build the linux specific plugins run
npm install grunt build
Because the history of the universal repository is quite large, it can take a long time to clone (and sometimes will fail depending on the network). To check it out faster for testing use the fastClone option. Note however, you will need the regular build in order to commit code and push on universal.
grunt build --fastClone
To clean the plugin binaries use
You can start the GPII local server on port 8080 using:
To install and uninstall the listener components use the following. Note that this may prompt you for sudo access.
grunt install grunt uninstall
Setting Up a Virtual Machine
This repository contains content that will allow you to automatically provision a development VM. A Vagrantfile is provided that downloads a Fedora Vagrant box, starts a VM, and deploys the GPII Framework on it.
provisioning directory contains these files:
playbook.yml- an Ansible playbook that orchestrates the provisioning process
requirements.yml- specifies the Ansible roles that the playbook requires
vars.yml- a list of variables used by the playbook
Please ensure that the QI Development Environments software requirements have been met. You will additionally need the following on your host operating system:
- At least 2GB of available storage space
In order to create a new VM you will need to issue the following command:
By default the VM will use two processor cores and 2GB of RAM. Two environment variables can be passed to the
vagrant up command to allocate more cores (
VM_CPUS=2) and RAM (
VM_RAM=2048). If this is your first time setting up this VM then the 2GB Fedora Vagrant box will be downloaded.
Once the box has been downloaded the provisioning process will ensure that project dependencies have been met and then the
npm install and
grunt --force build commands will be executed. If you reboot the VM the provisioner will not run again. However, you can use
vagrant provision to trigger that process at any time.
To run tests you can use the
grunt tests command on your host which will run unit and acceptance tests in the VM. Or you could use
grunt unit-tests and/or
grunt acceptance-tests separately.
You can stop the VM using
vagrant halt or delete it altogether using
The entire Git working directory will be mounted at the
/home/vagrant/sync path in the VM and bidirectionally synced with the host operating system. This means build artifacts created by processes in the VM will be exposed to the host. It will be safer if you commit to running build tasks such as
npm install or
grunt build in the VM and not attempt that on the host.