Local GPM Installation Instructions

Revision as of 19:53, 24 June 2010

1. Key
   1. Text written in fixed-space font denote text you will type in, as written.
   2. Text written in bold are directory paths.
2. Prerequisites
   1. A fully patched 32-bit version of a Windows operating system.
   2. A hard drive with several gigabytes of free space.
   3. PLEASE NOTE: The suggestions made below are a best-guess to get your local version of the GPM up and running. Your specific computing environment may require different values than those listed; if you have difficulty getting everything installed, please contact your local technical support.
3. Download ftp://ftp.thegpm.org/projects/localgpm/gpm-software.zip This is the directory structure, scripts and support files that will operate the local GPM version, as well as some tools to modify the scripts for your specific location.
4. Download Apache HTTP Server, ActiveState Perl and MySQL Community Edition.
   1. Apache: http://httpd.apache.org/download.cgi
   2. ActiveState Perl: http://www.activestate.com/activeperl/downloads
   3. MySQL: http://www.mysql.com/downloads/mirror.php?id=390181#mirrors
   4. Or, ftp://ftp.thegpm.org/projects/localgpm/apache-perl-mysql.zip This is a single archive file which contains Apache HTTP Server 2.2.15, ActiveState Perl 5.10.1.1007 and MySQL Server 5.1.48.
5. Extract the contents of gpm-software.zip to the location you have chosen. E.g., if the E: drive on your computer has the free space an installation will require, extract gpm-software.zip to E:\.
6. Install Apache, Perl and MySQL, following the directions provided in the installation process.
   1. Apache
      1. "Network domain" value should be the same as the end of your institution's email addresses. E.g., if you are "user@university.edu", enter "university.edu".
      2. "Server name" value should be how this computer will be addressed over the web. E.g., if the computer onto which the local version of the GPM is being installed has a DNS name of "web3", enter "web3.university.edu".
      3. "Administrator's email address" is the email displayed if the web server encounters problems displaying pages.
      4. Choose between having Apache run as a service (will be available whenever the computer is on; recommended), or being manually started and stopped.
      5. Use a "Typical" installation.
      6. Let installation complete.
      7. Navigate to the Apache installation directory (probably C:\Program Files\Apache Group\Apache2\). Go into the conf directory. Make a backup copy of httpd.conf to assist in case of error.
      8. Edit httpd.conf as follows:
         1. The DocumentRoot value is based off wherever you extracted gpm-software.zip. Do a search and replace on everything between the quotes and substitute "<base_path>/thegpm", where <base_path> stands for the path in which you extracted gpm-software.zip. E.g., if you installed to E:\, write "E:/thegpm"; if you installed to "D:/websites/", write "D:/webistes/thegpm".
         2. A few lines below the DocumentRoot entry is a line that begins <Directory "<drive_letter>:/path"> There is a note above it regarding changing that value to match the DocumentRoot path. Do so.
         3. The ScriptAlias value is based off wherever you extracted gpm-software.zip. Make the line read: ScriptAlias /thegpm-cgi/ "<base_path>/thegpm/thegpm-cgi/", where <base_path> stands for the path in which you extracted gpm-software.zip. E.g., if you installed to 'E:\, write "E:/thegpm/thegpm-cgi/"; if you installed to "D:/websites/", write "D:/webistes/thegpm/thegpm-cgi/". If the line does not exist, add it anywhere below the "</Directory>" line that closes the <Directory "<base_path>/thegpm/"> line.
      9. Save the changes and restart the Apache server. If it fails to start, use the command-line Apache tool: "apachectl configtest" in the /bin/ folder of the Apache install directory.
   2. Perl: install using the recommended settings. Remember the drive letter in which Perl was installed; it will be needed later (the default perl installation directory is C:\perl).
   3. MySQL
      1. install using the MyISAM table type, and following the other recommended settings.
      2. Go to the installation directory of MySQL (by default, this is found in the "Program Files" directory). Make a backup copy of the my.ini file. Edit the original and change the "datadir" value to read datadir="<base_path>/gpmdb/data/", including the double quotes.
      3. Restart the MySQL server service.
7. Start a command-line window, and navigate to \thegpm\scripts\ directory. Run the script __SCRIPT_NAME__, and supply the path to the Perl bin directory from step 5.2 (by default, this value is C:\perl\bin. This will ensure that the perl scripts in \thegpm\thegpm-cgi\ use the proper path.
8. In the \thegpm\thegpm-cgi\ directory, edit the hurricane.cfg file.
   1. This needs details.
9. Log inty MySQL as the root user you defined during its installation. Then, type: source <base_path>/thegpm/scripts/create_gpmdb.sql;. This will create the gpmdb database and table structure that will be populated after data files are submitted to the identification software.