Revision as of 17:20, 19 February 2013

Installation Instrutions

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/nodejs /usr/bin/node

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

# 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.

• 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

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
  • git clone git://github.com/GPII/windows.git
  • cd windows
• 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 Panels > User Accounts and Family Safety > User Accounts > User Account Control Settings
  • Set the notification level to "Never notify"

Troubleshooting

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

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