Difference between revisions of "Talk:Installation InstructionsG2"

From GeeklogWiki
Jump to: navigation, search
(Step Three: Configure The Database)
 
Line 11: Line 11:
 
:Use SVN to check out the latest Geeklog 2 code tree. You can either place the code tree in a folder accessable by your web server or, if you are running a *nix system, you can place a system link in a web accessable folder that links to the root of the Geeklog 2 code tree.
 
:Use SVN to check out the latest Geeklog 2 code tree. You can either place the code tree in a folder accessable by your web server or, if you are running a *nix system, you can place a system link in a web accessable folder that links to the root of the Geeklog 2 code tree.
  
==Step Three: Configure The Database==
+
==Step Three: Configure Geeklog 2==
:::REVISIT: I noticed there is a database.php file. Should that be used for setting up the database instead? If so then the folder sql/MySQL needs to be renamed to sql/mysql and line 113 of sql/mysql/base_data.sql needs to be fixed. --[[User:Wbushey|Wbushey]] 13:09, 27 May 2008 (EDT)
+
:With your favorite editor open <Geeklog_2_Root>/config.php and edit the various settings to work with your computer. The file is well commented so this step should be pretty straight forward. You may need to change the value of $appConf['db_host'] to 'localhost'.
:You are going to need to add a user to your database server for Geeklog 2 as well as a set of tables.  
 
  
:Login to your MySQL server and issue the following command to add a Geeklog 2 user:
+
==Step Four: Configure The Database==
<pre>grant all on <db_name>.* to '<db_user>'@'localhost' identified by '<db_pass>';</pre>
+
:Once you have edited <Geeklog_2_Root>/config.php and saved you can now run the provided database configuration script. Open your browser and go to <site_url>/database.php. Follow the instructions on the page to setup the database for Geeklog 2.
:Now exit MySQL and navigate to <Geeklog_2_Root>/sql/. In this folder issue the following commands:
 
<pre>mysql -u <db_user> -p < create.sql
 
mysql -u <db_user> -p < base_data.sql</pre>
 
:This will create the neccessary database and tables for Geeklog 2.
 
  
==Step Four: Configure Geeklog 2==
+
==Step Five: Visit check.php==
:With your favorite editor open <Geeklog_2_Root>/config.php and edit the various settings to work with your computer. The file is well commented so this step should be pretty straight forward. Be sure to edit the database settings to match the values that you choose earlier. Also, you may need to change the value of $appConf['db_host'] to 'localhost'.
+
:Using your browser go to <site_url>/check.php. If all the tests pass then you have properly setup Geeklog 2. If a test fails the script will display an error message indicating what is wrong.
  
==Step Five: Visit check.php==
+
==Step Six: Visit index.php==
:Once you have edited <Geeklog_2_Root>/config.php and saved you can now run a simple configuration check. Open your browser and go to <site_url>/check.php. If all the tests pass then you have properly setup Geeklog 2. If a test fails the script will display an error message indicating what is wrong.
+
:Your Geeklog 2 installation should be finished now. Browse to <site_url>/index.php. The first time you visit this page the Geeklog 2 system will run though a system build and will output various messages to your browser. Scroll to the bottom of the output and click the Continue link to be taken to your Geeklog 2 main page.
 +
 
 +
:During the build process you may encounter a "Fatal error: Allowed memory size of X bytes exhausted" error. You will need to increase the amount of memory that is available to PHP in order to finish the build process.

Latest revision as of 01:36, 3 June 2008

Installation Instructions

Step One: Dependencies

To run Geeklog 2 you will need to have the following software installed and running:

Step Two: Checkout Geeklog 2 Code

Use SVN to check out the latest Geeklog 2 code tree. You can either place the code tree in a folder accessable by your web server or, if you are running a *nix system, you can place a system link in a web accessable folder that links to the root of the Geeklog 2 code tree.

Step Three: Configure Geeklog 2

With your favorite editor open <Geeklog_2_Root>/config.php and edit the various settings to work with your computer. The file is well commented so this step should be pretty straight forward. You may need to change the value of $appConf['db_host'] to 'localhost'.

Step Four: Configure The Database

Once you have edited <Geeklog_2_Root>/config.php and saved you can now run the provided database configuration script. Open your browser and go to <site_url>/database.php. Follow the instructions on the page to setup the database for Geeklog 2.

Step Five: Visit check.php

Using your browser go to <site_url>/check.php. If all the tests pass then you have properly setup Geeklog 2. If a test fails the script will display an error message indicating what is wrong.

Step Six: Visit index.php

Your Geeklog 2 installation should be finished now. Browse to <site_url>/index.php. The first time you visit this page the Geeklog 2 system will run though a system build and will output various messages to your browser. Scroll to the bottom of the output and click the Continue link to be taken to your Geeklog 2 main page.
During the build process you may encounter a "Fatal error: Allowed memory size of X bytes exhausted" error. You will need to increase the amount of memory that is available to PHP in order to finish the build process.