| Line 1: | Line 1: | ||
| - | + | == Notes == | |
| - | + | *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. | |
| - | + | *The directions below assume the versions of Apache, Perl and MySQL to be used were extracted from the archive available on the [ftp://ftp.thegpm.org/ GPM FTP site]. | |
| - | + | *Text written in <tt>fixed-space font</tt> denote text to be typed. | |
| - | + | *Text written in '''bold''' are directory paths. | |
| - | + | ||
| - | + | == Prequisites == | |
| - | + | *A fully patched 32-bit version of a Windows operating system. | |
| - | + | *A hard drive with several gigabytes of free space. | |
| - | + | ||
| - | + | == Obtaining Server Software == | |
| - | + | *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. | |
| - | + | *Download Apache HTTP Server, ActiveState Perl and MySQL Community Edition. | |
| - | + | **Apache: http://httpd.apache.org/download.cgi | |
| - | + | **ActiveState Perl: http://www.activestate.com/activeperl/downloads | |
| - | + | **MySQL: http://www.mysql.com/downloads/mirror.php?id=390181#mirrors | |
| - | + | **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. After downloading, extract the three setup files to a temporary location; you will not need them after installation is complete. | |
| - | + | ||
| - | + | == Software Installation == | |
| - | + | *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:\'''. This will create the necessary directory structure and place the scripts required to display information. | |
| - | + | === Apache === | |
| - | + | #Locate and start the installer, called '''httpd-2.2.15-win32-x86-openssl-0.9.8m-r2.msi''') | |
| - | ###Navigate to the Apache installation directory ('''C:\Program Files\Apache Software Foundation\Apache2.2''' by default). Go into the '''conf''' directory. Make a backup copy of httpd.conf. | + | #"Network domain" value should be the same as the end of the target computer's DNS name; e.g., if the target computer has a DNS entry of "science14.med.university.edu", enter "med.university.edu". If you need assistance with this step, contact your local support. |
| - | + | #"Server name" value should match the full DNS name of the target computer. E.g., if the computer onto which the local version of the GPM is being installed has a DNS name of "web3.university.edu", enter "web3.university.edu". If you need assistance with this step, contact your local support. | |
| - | + | #"Administrator's email address" is the email displayed if the web server encounters problems displaying pages. | |
| - | + | #Choose between having Apache run as a service (will be available whenever the computer is on; recommended), or being manually started and stopped. | |
| - | + | #Use a "Typical" installation. | |
| - | + | #Let installation complete. | |
| - | + | === Perl === | |
| - | + | #Locate the installer called '''ActivePerl-5.10.1.1007-MSWin32-x86-291969.msi''') | |
| - | + | #Choose a "typical" install using the recommended settings. | |
| - | + | === MySQL === | |
| - | + | #Choose a "Typical" install. | |
| - | + | #Choose "Configure the MySQL Server now". | |
| - | + | ##Choose "Detailed Configuration". | |
| - | + | ##Choose "Server Machine". | |
| - | + | ##Choose "Non-transactional Database". | |
| - | + | ##Choose "Decision Support (DSS)/OLAP". | |
| - | + | ##Choose "Include Bin Directory in Windows PATH". | |
| - | + | ##Enter a root password. Remember this password, as it will be needed later. Complete the configuration. | |
| - | + | ||
| - | + | == Software Configuration == | |
| - | + | === Apache === | |
| - | + | #Navigate to the Apache installation directory ('''C:\Program Files\Apache Software Foundation\Apache2.2''' by default). Go into the '''conf''' directory. Make a backup copy of httpd.conf. | |
| - | + | #Edit httpd.conf as follows: | |
| - | + | ##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:/websites/thegpm"'''. | |
| + | ##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. | ||
| + | ##In the section marked "<IfModule alias_module>", modify the ScriptAlias value, based off wherever you extracted gpm-software.zip. Make the line read: <tt>ScriptAlias /thegpm-cgi/ "<base_path>/thegpm/thegpm-cgi/"</tt>, 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:/websites/thegpm/thegpm-cgi/"'''. | ||
| + | #Save the changes and restart the Apache server. If it fails to start, use the command-line Apache tool: "<tt>apachectl configtest</tt>" in the '''/bin/''' folder of the Apache install directory. | ||
| + | === MySQL === | ||
| + | #Stop the MySQL service. Go to the installation directory of MySQL. Make a backup copy of the my.ini file. Open the my.ini file and locate the <tt>datadir</tt> value. | ||
| + | #Navigate to the default data directory specified in the <tt>datadir</tt> directory, and copy all contents of the default data folder (including all subfolders) to '''<base_path>/gpmdb/data/''', where '''<base_path>''' is where the gpm-software.zip archive was extracted. | ||
| + | #Update the <tt>datadir</tt> value in the my.ini file to read <tt>datadir="<base_path>/gpmdb/data/"</tt>, including the double quotes, where '''<base_path>''' is where the gpm-software.zip archive was extracted. | ||
| + | #Save the file and restart the MySQL service. | ||
| + | === Perl === | ||
| + | #Navigate to the Perl '''\bin\''' directory (by default, this is '''c:\perl\bin\'''). | ||
| + | #Run the command <tt>ppm</tt>. This will start the Perl Package Manager. | ||
| + | #Display all packages. | ||
| + | #In the search box, type <tt>dbd-mysql</tt>. Choose the resulting package, and install it. | ||
| + | === GPM Configuration === | ||
#Run the script to edit the path information for all the Perl scripts used. Start a command-line window, and navigate to '''\thegpm\scripts\''' directory. Run the script '''local_gpm_pathmod.pl''' by typing <tt>perl local_gpm_pathmod.pl <base_path>/thegpm/</tt> where <base_path> is the path to where the gpm-software.zip archive was extracted. Ensure you use front slashes (/) instead of back slashes (\) when typing the path. This will edit scripts in both '''\thegpm\scripts\''' and '''\thegpm\thegpm-cgi\'''. | #Run the script to edit the path information for all the Perl scripts used. Start a command-line window, and navigate to '''\thegpm\scripts\''' directory. Run the script '''local_gpm_pathmod.pl''' by typing <tt>perl local_gpm_pathmod.pl <base_path>/thegpm/</tt> where <base_path> is the path to where the gpm-software.zip archive was extracted. Ensure you use front slashes (/) instead of back slashes (\) when typing the path. This will edit scripts in both '''\thegpm\scripts\''' and '''\thegpm\thegpm-cgi\'''. | ||
#In the '''\thegpm\thegpm-cgi\''' directory, edit the hurricane.cfg file. | #In the '''\thegpm\thegpm-cgi\''' directory, edit the hurricane.cfg file. | ||
Contents |