From db89a1eb449d60c02d727f0118919872ceee9be9 Mon Sep 17 00:00:00 2001 From: Mike Macgirvin Date: Tue, 21 Sep 2010 16:01:19 -0700 Subject: [PATCH] prepare for open source server release --- .gitignore | 1 + INSTALL | 64 +++++++++++++++++++++++++++++++++++++++---------- LICENSE | 25 +++++++++++++++++++ README | 30 +++++++++++++++++++++++ mod/item.php | 4 ++-- mod/like.php | 4 ++-- mod/message.php | 2 +- 7 files changed, 112 insertions(+), 18 deletions(-) create mode 100644 LICENSE create mode 100644 README diff --git a/.gitignore b/.gitignore index f7aa4e1cdb..34f2896f70 100644 --- a/.gitignore +++ b/.gitignore @@ -5,3 +5,4 @@ include/jquery-1.4.2.min.js *.log *.out push +home.html diff --git a/INSTALL b/INSTALL index 5be33a7517..41275f6636 100644 --- a/INSTALL +++ b/INSTALL @@ -1,38 +1,76 @@ -Installation guide -The following notes apply to alpha/beta releases. Some manual installation is -required at this time. +Mistpark Installation +This is an early release. Some manual installation is required at this time. 1. Requirements - Apache with mod-rewrite enabled and "Options All" so you can use a local .htaccess file + - PHP > 5.1. The later the better. You'll need 5.3 for full openssl encryption support + - PHP *command line* access with register_argc_argv set to true in the php.ini file + - Mysql 5.x - - cron + + - ability to schedule jobs with cron (Linux/Mac) or Scheduled Tasks +(Windows) [Dreamhost.com offers all of the necessary hosting features at a reasonable price. If your hosting provider doesn't allow Unix shell access, you might have trouble getting everything to work.] -2. Edit htconfig.php and change system settings. Rename to .htconfig.php +2. Put this directory into the root of your web server document area. -3. Import database.sql into your database with mysql command line or via phpmyadmin + - If you copy the directory tree to your webserver, make sure + that you also copy .htaccess - as "dot" files are often hidden + and aren't normally copied. -4. Import updates.sql (if it exists) to catch any late-breaking devel changes - -5. Put this directory into the root of your web server document area. - - To use a subdir of your main site, set the + - To use a subdirectory of your main domain, set the config variable $a->path to the relative subdir in .htconfig.php - for example to use http://example.com/test - - set $a->path to 'test'. + use + $a->path = 'test'; + + In this case, you cannot use the web installer. + Skip step 3 and proceed to step 4 - especially steps 4a and 4b. + - Everything will work much better if you can dedicate a domain or subdomain so that you don't require an extra server path. -6. Navigate to your site with a web browser and register an account. +3. Visit your website with a web browser and follow the instructions. -7. Set up a cron task to run "php include/poller.php http://my.domain.name" once every 5-10 minutes. +4. *If* the automated installation fails for any reason, check the following: + 4a. ".htconfig.php" exists + If not, edit htconfig.php and change system settings. Rename +to .htconfig.php + 4b. Database is populated. + If not, import the contents of "database.sql" with phpmyadmin +or mysql command line + +5. At this point visit your website again, and register your personal account. +Registration errors should all be recoverable automatically. +If you get any *critical* failure at this point, it generally indicates the +database was not installed correctly. You might wish to move/rename +.htconfig.php to another name and empty (called 'dropping') the database +tables, so that you can start fresh. + +6. Set up a cron job or scheduled task to run the poller once every 5-10 +minutes to pick up the recent "public" postings of your friends. Example: + + cd /base/directory; /path/to/php include/poller.php + +Change "/base/directory", and "/path/to/php" as appropriate for your situation. + +If you are using a Linux server, run "crontab -e" and add a line like the +one shown, substituting for your unique paths and settings: + +*/5 * * * * cd /home/myname/mywebsite; /usr/bin/php include/poller.php + +You can generally find the location of PHP by executing "which php". If you +have troubles with this section please contact your hosting provider for +assistance. Mistpark will not work correctly if you cannot perform this step. + \ No newline at end of file diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000000..9066308b97 --- /dev/null +++ b/LICENSE @@ -0,0 +1,25 @@ +* Mistpark +* Copyright (c) 2010, Mike Macgirvin +* All rights reserved. +* +* Redistribution and use in source and binary forms, with or without +* modification, are permitted provided that the following conditions are met: +* * Redistributions of source code must retain the above copyright +* notice, this list of conditions and the following disclaimer. +* * Redistributions in binary form must reproduce the above copyright +* notice, this list of conditions and the following disclaimer in the +* documentation and/or other materials provided with the distribution. +* * Neither the name of Mistpark nor the +* names of its contributors may be used to endorse or promote products +* derived from this software without specific prior written permission. +* +* THIS SOFTWARE IS PROVIDED BY Mike Macgirvin ``AS IS'' AND ANY +* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED +* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE +* DISCLAIMED. IN NO EVENT SHALL Mike Macgirvin BE LIABLE FOR ANY +* DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES +* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; +* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND +* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS +* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/README b/README new file mode 100644 index 0000000000..3ffef30e22 --- /dev/null +++ b/README @@ -0,0 +1,30 @@ + +Mistpark Server +Version 2.0 alpha + +IMPORTANT: Please see the file INSTALL for system requirements. + +Mistpark introduces a new generation of social networks. Mistpark Server +allows you to interact with other members of the Mistpark community using +the DFRN (Distributed Friends and Relations Network) protocol. Other networks +(such as Diaspora, OneSocialWeb, status.net, etc.) will be supported in the +future as their products mature and protocol and privacy/rights issues are +resolved between these networks. + +It's your network now. If social networking isn't what you thought it would +be, help us to make it better. + +A single instance of Mistpark Server supports up to several hundred people +using commodity hosting hardware. Also available from Mistpark Labs is +Mistpark Personal Edition, which supports a single user. + +Please see http://dfrn.org for more information on the mistpark/DFRN project. + +We will be providing a support site specifically for mistpark at +http://mistpark.com at a future (unspecified) date. We are still +evaluating wiki, forum, and bug-tracking software for use on the project. +At the present time, you may contact the author and raise issues via +the source code repository on github. + +Please support mistpark with a donation. + diff --git a/mod/item.php b/mod/item.php index f864673761..c903a61c6f 100644 --- a/mod/item.php +++ b/mod/item.php @@ -227,7 +227,7 @@ function item_post(&$a) { $php_path = ((strlen($a->config['php_path'])) ? $a->config['php_path'] : 'php'); - proc_close(proc_open("\"$php_path\" \"include/notifier.php\" \"$notify_type\" \"$post_id\" > notify.out &", + proc_close(proc_open("\"$php_path\" \"include/notifier.php\" \"$notify_type\" \"$post_id\" &", array(),$foo)); goaway($a->get_baseurl() . "/" . $_POST['return'] ); @@ -317,7 +317,7 @@ function item_content(&$a) { // send the notification upstream/downstream as the case may be - proc_close(proc_open("\"$php_path\" \"include/notifier.php\" \"drop\" \"$drop_id\" > drop.out &", + proc_close(proc_open("\"$php_path\" \"include/notifier.php\" \"drop\" \"$drop_id\" &", array(), $foo)); goaway($a->get_baseurl() . '/' . $_SESSION['return_url']); diff --git a/mod/like.php b/mod/like.php index d52b3a3243..2ee887241a 100644 --- a/mod/like.php +++ b/mod/like.php @@ -97,7 +97,7 @@ function like_content(&$a) { $php_path = ((strlen($a->config['php_path'])) ? $a->config['php_path'] : 'php'); - proc_close(proc_open("\"$php_path\" \"include/notifier.php\" \"like\" \"$post_id\" > notify.out &", + proc_close(proc_open("\"$php_path\" \"include/notifier.php\" \"like\" \"$post_id\" &", array(),$foo)); return; } @@ -164,7 +164,7 @@ EOT; $php_path = ((strlen($a->config['php_path'])) ? $a->config['php_path'] : 'php'); - proc_close(proc_open("\"$php_path\" \"include/notifier.php\" \"like\" \"$post_id\" > notify.out &", + proc_close(proc_open("\"$php_path\" \"include/notifier.php\" \"like\" \"$post_id\" &", array(),$foo)); return; // NOTREACHED diff --git a/mod/message.php b/mod/message.php index 6119e894fe..45908d2332 100644 --- a/mod/message.php +++ b/mod/message.php @@ -70,7 +70,7 @@ function message_post(&$a) { $php_path = ((strlen($a->config['php_path'])) ? $a->config['php_path'] : 'php'); if($post_id) { - proc_close(proc_open("\"$php_path\" \"include/notifier.php\" \"mail\" \"$post_id\" > mail.out &", + proc_close(proc_open("\"$php_path\" \"include/notifier.php\" \"mail\" \"$post_id\" &", array(),$foo)); notice( t('Message sent.') . EOL ); }