Difference between revisions of "Core (real-time) Framework v0.1 - Installation Instructions"

Latest revision as of 08:28, 10 April 2014

This page only applies to v0.1 (2012) of the GPII framework - please see: Setting Up Your Development Environment for more current instructions

This release supports two platforms: Windows 7 and Fedora Linux with Gnome 3. Installation instructions can be found below.

Fedora 17

Requirements:

• Fedora 17 needs to be installed. Installation requires super-user privileges.

Installation Instructions

Ensure pre-requisites

sudo yum install kernel-devel kernel-headers dkms gcc gcc-c++ \
  git openssl-devel glib-devel glib2-devel gtk3-devel \
  pcsc-lite-devel pcsc-lite pcsc-perl

Install node

sudo yum localinstall --nogpgcheck http://nodejs.tchol.org/repocfg/fedora/nodejs-stable-release.noarch.rpm
sudo yum install nodejs nodejs-devel nodejs-gyp nodejs-doc nodejs-debuginfo
sudo ln -s /usr/bin/node /usr/bin/nodejs 

Install RFID listener

(only required if you want to use a RFID listener on the system)

Go to the location where you want to install the GPII

Clone the GPII PCSC Tools Repository

git clone https://github.com/GPII/linux-rfid-user-listener
cd linux-rfid-user-listener

Compile and install

make all
sudo make install

Final step is to start a daemon running in the background and the scanner

Start first daemon and then scanner:

sudo /usr/sbin/pcscd
./pcsc_scan

Install and run GPII Personalization Framework

Make sure you're in the directory where you want to install the GPII.

From the command line:

# Clone the GPII Linux repository:
git clone git://github.com/GPII/linux.git
cd linux
git checkout origin/v0.1

# Build the Framework:
./build.sh

# Start up the Personalization Framework:
./start.sh

Running the framework in general

After having followed the above steps, you will have installed the GPII and it should be running on the machine. In general (for example after a reboot), you would have to do the following steps:

To starts GPII, go to the GPII install dir, then:

cd linux
./start.sh

To enable the RFID listener, go to the GPII install dir, then:

cd linux-rfid-user-listener
sudo /usr/sbin/pcscd
./pcsc_scan

Windows Installation Instructions

Dependencies

• Git
  • Go to http://code.google.com/p/msysgit/downloads/list?q=full+installer+official+git and download the latest release of Git
  • Or, for advanced developers, use Cygwin for a full Unix-like environment on Windows
  • Be sure to choose "Run Git from the Windows Command Prompt" on the "Adjusting your PATH environment" panel

• Node
  • Go to http://nodejs.org/download/, and choose the 32-bit (x86) version for Windows. NB - we've had issues with the latest version of node, so to be on the safe side, we suggest you use 0.8.23, found here: http://nodejs.org/dist/v0.8.23/ - for windows, download the file ending in "x86.msi"

• MinGW
  • Download and run http://sourceforge.net/projects/mingw/files/Installer/mingw-get-inst/mingw-get-inst-20120426/
  • When installing MinGW, make sure the C and C++ compiler checkboxes are on
  • Add C:\MinGW\bin to your PATH variable (Right click My Computer > Properties > Advanced > Environment Variables)
• Microsoft Visual C++ 2010 Redistributable Package (x86)
  • Download and install from http://www.microsoft.com/en-us/download/details.aspx?id=5555
• Microsoft Hotfix for issue KB2516889 - this issue prevents the application of the "High Contrast" desktop profile on all modern versions of Windows (7 and 8)
  • Download and install from http://support.microsoft.com/kb/2516889

Building and Starting

• Open up cmd.exe (Start > Run > cmd.exe)
• Create a GPII directory
  • mkdir c:\gpii (or wherever you prefer)
  • cd c:\gpii
• Clone the GPII Windows repository and make sure we got the correct version
  • git clone git://github.com/GPII/windows.git
  • cd windows
  • git checkout origin/v0.1
• Compile the GPII Windows native code (run the following command from the Windows/DOS shell):
  • build.cmd
• Start the GPII Framework and the USB Listener (from the Windows/DOS shell - not the Git Bash sell - while in the gpii\windows folder):
  • start.cmd

Setup and Configuration

• On Windows 7, the GPII can't currently kill applications using taskill unless you:
  • Go into Control Panel > User Accounts and Family Safety > User Accounts > User Account Control Settings
  • Set the notification level to "Never notify"

RFID Listener

The RFID is currently at an experimental state and only available as an exe. It can be found here: https://www.dropbox.com/s/n7ntpzvj4v1ksm8/GpiiUserListener110.exe

Testing

Once you start the system (by using the start.cmd/start.sh scripts), you can test it without USB by navigating your browser to the following URLs:

http://localhost:8081/user/sammy/login (This will run the windows magnifier which can be exited with the WindowsKey + Esc)

http://localhost:8081/user/sammy/logout

To test the USB listener create a file '.gpii-user-token.txt' in the root of a USB memory stick containing the text "sammy" (no quotes). Insert the stick to login and remove it to logout.