Core (real-time) Framework v0.1 - Installation Instructions

From wiki.gpii
Jump to: navigation, search

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.

Contents

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

  • 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"

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.

Personal tools
Namespaces

Variants
Actions
GPII Implementation
User Involvement
Developers Space
Communication
Other
Special Pages
Tools