Installation Instructions

System Requirements

Voting Client:

Computer must be running Linux or Microsoft Windows 95 or higher.
System must be capable of running Java bytecode.
Computer must have access to the Internet.
Election Server System:
Computer must be running Linux.
System must have MySQL installed on it.
System must be capable of running Java bytecode.
Computer must have high-speed access to the Internet.
Only authourized personnel should have access to this computer.
Server Installation
 
Copy the server.tgz and serversetup.sh files into the directory where you want to install the server.  Change the serversetup.sh file to be executable and run it.  This will extract all the server files to that directory.
The config.xml files in BOTH the main directory and the sql directory will have to be changed to the settings that are valid for your database.
Once the files are extracted, change directory into the sql directory and run the tables.sh file. This will initialize the database. Go back out of the sql directory if you with to run the server.
The server is compiled to class files already but if you want to recompile, run the build.sh file in the main directory.


Client Installation for Linux
 

Copy the client.tgz and clientsetup.sh files into the directory where you want to install the client.  Change the clientsetup.sh file to be executable and run it by typing java GUIMain at the command prompt in the proper directory.


Client Installation for Windows
 

Double-click on the client-win.exe file to run the client setup.  You will be prompted for a directory to install the client into.  The default directory is "C:\client"
Follow any instructions in the Readme.txt file.
To run the client: Double-click on the vote.bat file


Running the System

Make sure that you have a valid mysql database connected to and specified in the config file (config.xml)
Simultaneously clear the database and create the appropriate tables by running the supplied tables.sh script
Set up an election using the ElectionsAdministrator (java AdminGUI). The default username and password are admin / admin. Change password is not as yet implemented, so this can be changed in the database.
Configure an election using the Election Editor (java ElectionEditor)
Run rmiregistry in the SAME directory as the Server
Run the Server, using the host running it as a command line argument (java ElectionGenerator media23)
Vote with the Client on the same or another computer (java GUIMain)
Simple Sample Election

Questions or comments: cory@uoguelph.ca

Top to top of page