Installation


 

Introduction

This document will take you through the installation procedures for installing WebPA. Please take the time to read through this document fully before beginning the installation process.   WebPA is built on open source software and can be used in conjunction with any server as long as all the ‘requirements/ pre-installation checklist’ have been met.   WebPA can be broken down into two major components. The first component is the Database, and the second component being the PHP files that constitute the application and interface. Information for how to set up/ install these components are described in the following sections.  

Requirements/Pre-installation Checklist

The WebPA application requires the following components:   These software components need to be installed on the computer/machine/server where you are going to be installing WebPA. It is possible to install the components independently, however, it is possible to find packages of the components that can be installed together. If you want to use a packaged install please read ‘Appendix 3– Software Packages’ where you can find information about where to download the software components and packages.   Information on installing, configuring and administering these software components is beyond the scope of this document. Comprehensive help about the software components can be best sought from each of the open source communities.  

Web Server

WebPA was originally written to be run on Apache Server Project. The system has sucessfully been installed on other server architectures e.g. Microsoft IIS Server. The project would be grateful to know of any other server configurations running WebPA.  

MySQL

You will need the login details (username and password) which will allow you to create and administer at least one database, if MySQL has already been set up. If you need to install MySQL then you will to need choose to either install the latest supported version 5.x.x or the version that WebPA has currently been written for, which is version 4.1.22.  

PHP

You will need to install the 5.2.x version of PHP When installing php you will need to ensure that the following configuration modules are included   A lot of these configuration modules are installed as standard but it is best to check that they are included.  

Permissions

You will need to set up permissions on the web server to allow files to be written to the server file structure in a specified location. WebPA advise you to take security measures that are appropriate for your server to ensure that the files can only be written by the application.  

Installing a new version of WebPA?

In general the reasons for why self and peer assessment are used is related to the meanings of the terms. Generally the assessment forms are under stood to be;  

Downloading

You will need to download the latest WebPA stable release from this link

Create the WebPA Database

The database script pa_tables.sql has been created to be UTF-8 compliant and should, in theory work, on all platforms. It is entirely up to you on how you run the script. If you are using an interface to MySQL such as Query Browser then you can open the files via File->Open Script… this will then open a directory browser window for you to locate the pa_tables.sql file where you have saved it. Alternatively you can run the pa_tables.sql script from the a command line. For example for a Linux machine you will need to type mysql [my_db_name[ -u[user_name] -p[password] pa_tables.sql Where the text within the [] brackets is replaced with your local terms. It is also possible to achieve the same outcome by using the MySQL command prompt by entering: mysql>source pa_tables.sql Where script name is replaced by the name of the file downloaded.   Once you have run the WebPA script we recommend that you remove the following files; /pa_tables.sql /tables_updates.sql   It is also recommended that you put in place a database back up schedule if not already present. More information on creating back-ups and schedules can be found in the MySQL Documentation.  

Alternative Database Installation

You may wish to create you own copy so that you can test the system before putting it into use. It is possible for you to install a blank database, however Bob has provided a solution for versions prior to 1.0.0.2.   By following the above instructions you will create a semi populated database with false information.   This will inturn create the following users:   Admin User username = fred password = test Staff User username = rakia password = rakia and username = Chimoa password = Chimoa   There are also aproximately 10 students with the details of AAAA, BBBB etc.   Unable to connect to database! Please try again later.