Running the PMT & PCP on Windows and Linux with a local web server

From wiki.gpii
Jump to: navigation, search

NOTE:

The contents of this page is related to JIRA ticket GPII-283.

Running PMT & PCP on Windows 7

NOTE: Steps 1-4 should be taken only once. Step 5 is needed every time you need to start the PMT.

Step 1. Install Apache Web Server

  1. Download and start the installer http://apache.tsl.gr//httpd/binaries/win32/httpd-2.2.25-win32-x86-openssl-0.9.8y.msi
  2. In the "Server Information" step set
    • Network Domain: localhost
    • Server Name: c4a.localhost
    • Administrator's e-mail Address: your e-mail
  3. Accept all other selections as they are
  4. Upon successful installation you should see the Apache Services icon in the task bar bottom right

Step 2. Install PMT & PCP application

(Assuming that GPII:master contains everything needed for the pilots. Will tweak accordingly if this is not the case.)

  1. Download the PMT & PCP Web application .zip file from "https://github.com/GPII/prefsEditors/archive/master.zip"
  2. Extract the prefsEditors-master.zip file
  3. Enter the "prefsEditors-master" folder. There will be another "prefsEditors-master" folder. Rename that folder to "prefsEditors".
  4. Move the "prefsEditors" folder to "C:\Program Files\Apache Software Foundation\Apache2.2\htdocs\"

Step 3. Install supported web browser

  1. Visit www.mozilla.org or www.getfirefox.net.
  2. Download the latest version of Mozilla Firefox in your locale using the Download button provided there.
    • Note: The locale in which Mozilla Firefox will be downloaded will determine the language that PCP and PMT will use during the pilot tests!
  3. Run the installer
  4. During installation there will be a checked selection to make Firefox your default browser. Leave that selection checked.

Step 4. Create desktop shortcut for PMT

  1. Right click on a empty area on desktop, and click on "New" and "Shortcut".
  2. In the "Location" textbox write http://localhost/prefsEditors/demos/prefsEditor/. Click "Next".
  3. In the name of the shortcut write "Preferences Management Tool". Click "Finish".

Step 5. Start the PMT

Double-click on the newly created "Preferences Management Tool" shortcut on the desktop.

Step 6. Switch to PCP

Click the "Quick Editor" link at the top of PMT (after you log in or create new token).

Running PMT & PCP on Fedora 20

NOTES:

  • Before going through the steps below, open a terminal window and get root privileges with su -. Give current user's password.
  • Steps 1-7 should be taken only once. Step 8 is needed every time you need to start the PMT.

Step 1. Install Apache Web Server

  • In the terminal: "yum install httpd"

Step 2. Start Apache web server and register it as a service

  1. In the terminal: "service httpd start"
  2. In the terminal: "systemctl enable httpd.service"

Step 3. Install PMT & PCP application

(Assuming that GPII:master contains everything needed for the pilots. Will tweak accordingly if this is not the case.)

  1. Download the PMT & PCP Web application .zip file from "https://github.com/GPII/prefsEditors/archive/master.zip"
  2. Extract prefsEditors-master.zip in the user's home folder.
  3. Rename the "prefsEditors-master" folder to "prefsEditors".
  4. In the terminal: cp -r /home/<username>/prefsEditors /var/www/html/
    • Note: Substitute <username> with currently logged user's username.

Step 4. Exit root mode

  • In the terminal, type exit.

Step 5. Create a launcher shortcut for PMT

  1. In the terminal, type: gedit ~/.local/share/applications/pmt.desktop
  2. Paste the following content into that file and save it
[Desktop Entry]
Type=Application
Encoding=UTF-8
Name=Preferences Management Tool
Comment=Preferences Management Tool
Exec=firefox "http://localhost/prefsEditors/demos/prefsEditor/"
Terminal=false

Step 6. Add the PMT shortcut to favourites

  1. Click on "Activities" in the top-left of the screen.
  2. Start writing "Preferences Management Tool", e.g. "Pre"; the launcher should show up.
  3. Right click on the "Preferences Management Tool" launcher, click "Add to favourites".

Step 7. Set your locale in Mozilla Firefox

  1. Start Firefox
  2. Menu Edit -> Preferences -> Content -> Choose (in Languages section)
  3. Click "Select a language to add"
  4. Select your locale's language
  5. Click "Add"
  6. Move language up first if it's not already there.
  7. Click "OK. Then click "Close".

Step 8. Start the PMT

  1. Click on "Activities" top-left
  2. Click on the "Preferences Management Tool" launcher.

Step 9. Switch to PCP

Click the "Quick Editor" link at the top of PMT (after you log in or create new token).