Revision: 383 http://svn.savannah.gnu.org/viewvc/?view=rev&root=administration&revision=383 Author: ineiev Date: 2019-06-11 02:56:36 -0400 (Tue, 11 Jun 2019) Log Message: ----------- Update info on running locally.
Modified Paths: -------------- trunk/sviki/RunningSavaneLocally.mdwn Modified: trunk/sviki/RunningSavaneLocally.mdwn =================================================================== --- trunk/sviki/RunningSavaneLocally.mdwn 2019-06-10 13:29:39 UTC (rev 382) +++ trunk/sviki/RunningSavaneLocally.mdwn 2019-06-11 06:56:36 UTC (rev 383) @@ -15,13 +15,12 @@ The following instructions have been tested on **Debian 8 (Jessie)** and **Ubuntu 14.04 LTS** running as **non-root** user. Other -configurations might not work (See below for know issues). If you +configurations might not work (see below for know issues). If you encounter errors, please write to <savannah-hackers-pub...@gnu.org> . Use the instructions below to run the PHP code locally on your computer. The PHP code needs a MySQL with a pre-configured database. -Either use our demo server, or create a local MySQL server (instructions -for both, below). +Create a local MySQL server: # Install required packages. # Use php-mysql for PHP 7.0. @@ -70,29 +69,35 @@ Set the hostname, database, username and password, then reload the website. +Download and import savane_demo dump: -Send us an email to <savannah-hackers-pub...@gnu.org>, -introduce yourself and ask for access to our demo MySQL server. -We'll send you (privately) the following information: + $ wget https://download.savannah.nongnu.org/releases/administration/savane_demo-2019-06-11.sql.gz - $sys_dbhost="demo.database.foobar.org"; - $sys_dbname="savane_XXXXXX"; - $sys_dbuser="XXXXXXX"; - $sys_dbpasswd="XXXXXXXXXX"; + # Create a new MySQL database + $ echo "CREATE DATABASE savane_demo;" | mysql -Paste the above values in the indicated file -(e.g. `/home/gordon/savane/local2/etc-savane/savane-dev-db.php` above). + # Load the demo tables + $ zcat savane_demo-2019-06-11.sql.gz | mysql savane_demo + # Create a demo user + $ echo "grant SELECT on savane_demo.* TO 'USER'@'%' IDENTIFIED by 'PASSWORD';" | mysql savane_demo + $ echo "grant insert,update,select,delete on savane_demo.* to 'USER'@'%';" | mysql savane_demo + +Set `USER` and `PASSWORD` above to your desired values. + +Then update the configuration file with your local values +(e.g. `/home/gordon/savane/local2/etc-savane/savane-dev-db.php` above): + + $sys_dbhost="localhost"; + $sys_dbname="savane_demo"; + $sys_dbuser="USER"; + $sys_dbpasswd="PASSWORD"; + Reloading the savannah web page on your local web browser should now 'just work' and display the savannah website (with dummy values). -There is just one project in the demo database: `site-administration`. -There is one user in the database: `admin` (password `admin`). +There is an admin user 'agn' in the demo database, with password '12345'. -Each volunteer developer will get a dedicated copy of the demo -database, so adding/removing/updating information and creating projects -will not interfere with other developers. - ## Supported PHP versions Savannah currently requires **php version 5.4, 5.5, 5.6 or 7.0**. @@ -122,9 +127,9 @@ like this: ~~~~~ -Listen 127.0.0.51:80 http +Listen 127.0.0.1:7890 http -<VirtualHost 127.0.0.51:80> +<VirtualHost 127.0.0.1:7890> ServerAdmin webmast...@test.org ServerName 127.0.0.1 @@ -221,39 +226,6 @@ </VirtualHost> ~~~~~ -## Running local MySQL demo database - -If you prefer to run a local MySQL server, the following guidelines -should work (but YMMV): - - - # Download a snapshot of the demo database: - - $ wget https://download-mirror.savannah.gnu.org/releases/administration/savane_demo-2017-02-12.sql.gz - $ sha256sum savane_demo-2017-02-12.sql.gz - 78ddffc7eddcaace1e4539bf9f0753ad5489362824658c8e60ae8e9e8d214bf1 - - # Create a new MySQL database - $ echo "CREATE DATABASE savane_demo;" | mysql - - # Load the demo tables - $ zcat savane_demo-2017-02-12.sql.gz | mysql savane_demo - - # Create a demo user - $ echo "grant SELECT on savane_demo.* TO 'USER'@'%' IDENTIFIED by 'PASSWORD';" | mysql savane_demo - $ echo "grant insert,update,select,delete on savane_demo.* to 'USER'@'%';" | mysql savane_demo - -Set `USER` and `PASSWORD` above to your desired values. - -Then update the configuration file with your local values -(e.g. `/home/gordon/savane/local2/etc-savane/savane-dev-db.php` above): - - $sys_dbhost="localhost"; - $sys_dbname="savane_demo"; - $sys_dbuser="USER"; - $sys_dbpasswd="PASSWORD"; - - ## More Information * [[FrontEndDebuggingTips]] for log files and PHP debugging tips.