From 961540160f0924e2b64eb52bc8a0a3c82407468a Mon Sep 17 00:00:00 2001 From: redmatrix Date: Tue, 12 Jan 2016 20:05:16 -0800 Subject: cleanup text in INSTALL.txt --- install/INSTALL.txt | 38 +++++++++++++++++++++++++------------- 1 file changed, 25 insertions(+), 13 deletions(-) (limited to 'install/INSTALL.txt') diff --git a/install/INSTALL.txt b/install/INSTALL.txt index 8ca74c23b..78cea638d 100644 --- a/install/INSTALL.txt +++ b/install/INSTALL.txt @@ -1,6 +1,6 @@ Hubzilla Installation -We've tried very hard to ensure that the Hubzilla will run on commodity +We've tried very hard to ensure that Hubzilla will run on commodity hosting platforms - such as those used to host Wordpress blogs and Drupal websites. It will run on most any Linux VPS system. Windows LAMP platforms such as XAMPP and WAMP are not officially supported at this time - however @@ -29,7 +29,7 @@ issues. Before you begin: Choose a domain name or subdomain name for your server. -The Hubzilla can only be installed into the root of a domain or +Hubzilla can only be installed into the root of a domain or sub-domain, and can not be installed using alternate TCP ports. Decide if you will use SSL and obtain an SSL certificate before software @@ -53,13 +53,14 @@ advice. This is disruptive to the community. That said, we recognise the issues surrounding the current certificate infrastructure and agree there are many problems, but that doesn't change the requirement. -Free "browser-valid" certificates are available from providers such as StartSSL. +Free "browser-valid" certificates are available from providers such as StartSSL +and LetsEncrypt. If you do NOT use SSL, there may be a delay of up to a minute for the initial install script - while we check the SSL port to see if anything responds there. When communicating with new sites, Hubzilla always attempts connection on the SSL port first, before falling back to a less secure connection. If you do not -use SSL, your webserver must not listen on port 443 at all. +use SSL, your webserver MUST NOT listen on port 443 at all. 1. Requirements - Apache with mod-rewrite enabled and "AllowOverride All" so you can use a @@ -137,7 +138,7 @@ use SSL, your webserver must not listen on port 443 at all. cd mywebsite util/update_addon_repo matrix - - Create searchable represenations of the online documentation. You may do this any time + - Create searchable representations of the online documentation. You may do this any time that the documentation is updated. cd mywebsite @@ -177,7 +178,16 @@ 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. +tables, so that you can start fresh. + +In order for your account to be given administrator access, it should be the +first account created, and the email address provided during registration +must match the "administrator email" address you provided during +installation. Otherwise to give an account administrator access, +add 4096 to the account_roles for that account in the database. + +For your site security there is no way to provide administrator access +using web forms. **************************************************************************** **************************************************************************** @@ -185,7 +195,7 @@ tables, so that you can start fresh. **************************************************************************** **************************************************************************** -8. Set up a cron job or scheduled task to run the poller once every 5-10 +8. Set up a cron job or scheduled task to run the poller once every 10-15 minutes to pick up the recent "public" postings of your friends. Example: cd /base/directory; /path/to/php include/poller.php @@ -201,10 +211,11 @@ 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. Hubzilla will not work correctly if you cannot perform this step. -You should also be sure that $a->config['system']['php_path'] is set correctly, -it should look like (changing it to the correct PHP location) +You should also be sure that $a->config['system']['php_path'] is set correctly +in your .htconfig.php file, it should look like (changing it to the correct +PHP location): -$a->config['system']['php_path'] = '/usr/local/php53/bin/php'; +$a->config['system']['php_path'] = '/usr/local/php55/bin/php'; ##################################################################### @@ -221,7 +232,7 @@ $a->config['system']['php_path'] = '/usr/local/php53/bin/php'; Check your database settings. It usually means your database could not be opened or accessed. If the database resides on the same machine, check that -the database server name is the word "localhost". +the database server name is "127.0.0.1" or the word "localhost". ##################################################################### - 500 Internal Error @@ -296,7 +307,7 @@ Retry the installation. As soon as the database has been created, ##################################################################### - Some configurations with "suhosin" security are configured without -an ability to run external processes. The Hubzilla requires this ability. +an ability to run external processes. Hubzilla requires this ability. Following are some notes provided by one of our members. ##################################################################### @@ -386,4 +397,5 @@ MaxRequestWorkers to 70. Here you can read more about Apache performance tuning: https://httpd.apache.org/docs/2.4/misc/perf-tuning.html -There are tons of scripts to help you with fine-tuning your Apache installation. Just search with your favorite search engine 'apache fine-tuning script'. +There are tons of scripts to help you with fine-tuning your Apache installation. +Just search with your favorite search engine 'apache fine-tuning script'. -- cgit v1.2.3 From 48495f41e898498a91a1b3d9e8fa1950e60a12de Mon Sep 17 00:00:00 2001 From: redmatrix Date: Fri, 22 Jan 2016 02:22:27 -0800 Subject: provide mechanism for custom .well-known handlers and static files (e.g. for letsencypt ownership verification). Document that if you create a .well-known directory to validate a letsencrypt cert you need to remove it before installing hubzilla. We probably need a check for this in the install checklist. --- install/INSTALL.txt | 8 ++++++++ 1 file changed, 8 insertions(+) (limited to 'install/INSTALL.txt') diff --git a/install/INSTALL.txt b/install/INSTALL.txt index 78cea638d..22c7ef35f 100644 --- a/install/INSTALL.txt +++ b/install/INSTALL.txt @@ -62,6 +62,14 @@ When communicating with new sites, Hubzilla always attempts connection on the SSL port first, before falling back to a less secure connection. If you do not use SSL, your webserver MUST NOT listen on port 443 at all. +If you use LetsEncrypt to provide certificates and create a file under +.well-known/acme-challenge so that LetsEncrypt can verify your domain ownership, +please remove or rename the .well-known directory as soon as the certificate is +generated. Hubzilla will provide its own handler for ".well-known" services when +it is installed, and an existing directory in this location may prevent some of +these services from working correctly. + + 1. Requirements - Apache with mod-rewrite enabled and "AllowOverride All" so you can use a local .htaccess file. Some folks have successfully used nginx and lighttpd. -- cgit v1.2.3 From d04aef4c44a867453dc815b901de7f7cdadfb15f Mon Sep 17 00:00:00 2001 From: Jeroen van Riet Paap Date: Fri, 12 Feb 2016 17:17:26 +0100 Subject: don't confuse people with matrix --- install/INSTALL.txt | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) (limited to 'install/INSTALL.txt') diff --git a/install/INSTALL.txt b/install/INSTALL.txt index 22c7ef35f..37faddc55 100644 --- a/install/INSTALL.txt +++ b/install/INSTALL.txt @@ -135,16 +135,16 @@ these services from working correctly. cd mywebsite - Then you should clone the addon repository (separately). We'll give this repository - a nickname of 'matrix'. You can pull in other hubzilla addon repositories by + a nickname of 'hzaddons'. You can pull in other hubzilla addon repositories by giving them different nicknames. - util/add_addon_repo https://github.com/redmatrix/hubzilla-addons.git matrix + util/add_addon_repo https://github.com/redmatrix/hubzilla-addons.git hzaddons - For keeping the addon tree updated, you should be on your top level website directory and issue an update command for that repository. cd mywebsite - util/update_addon_repo matrix + util/update_addon_repo hzaddons - Create searchable representations of the online documentation. You may do this any time that the documentation is updated. -- cgit v1.2.3 From 32c23ef562fc963c2972c51895b4cfa71743e495 Mon Sep 17 00:00:00 2001 From: redmatrix Date: Thu, 10 Mar 2016 15:43:59 -0800 Subject: some minor cleanups --- install/INSTALL.txt | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) (limited to 'install/INSTALL.txt') diff --git a/install/INSTALL.txt b/install/INSTALL.txt index 37faddc55..1d3811501 100644 --- a/install/INSTALL.txt +++ b/install/INSTALL.txt @@ -67,7 +67,8 @@ If you use LetsEncrypt to provide certificates and create a file under please remove or rename the .well-known directory as soon as the certificate is generated. Hubzilla will provide its own handler for ".well-known" services when it is installed, and an existing directory in this location may prevent some of -these services from working correctly. +these services from working correctly. This should not be a problem with Apache, +but may be an issue with nginx or other web server platforms. 1. Requirements -- cgit v1.2.3 From 9abd95fad3784a10fc48bc40f9b8a75d7d74edda Mon Sep 17 00:00:00 2001 From: redmatrix Date: Thu, 31 Mar 2016 16:06:03 -0700 Subject: static App --- install/INSTALL.txt | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) (limited to 'install/INSTALL.txt') diff --git a/install/INSTALL.txt b/install/INSTALL.txt index 1d3811501..18cf4a1db 100644 --- a/install/INSTALL.txt +++ b/install/INSTALL.txt @@ -220,11 +220,11 @@ 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. Hubzilla will not work correctly if you cannot perform this step. -You should also be sure that $a->config['system']['php_path'] is set correctly +You should also be sure that App::$config['system']['php_path'] is set correctly in your .htconfig.php file, it should look like (changing it to the correct PHP location): -$a->config['system']['php_path'] = '/usr/local/php55/bin/php'; +App::$config['system']['php_path'] = '/usr/local/php55/bin/php'; ##################################################################### @@ -353,7 +353,7 @@ are NOT called with -d suhosin.executor.func.blacklist=none. So the simple solution is to put the correct parameters into .htconfig.php: // Location of PHP command line processor - $a->config['system']['php_path'] = '/usr/bin/php -d suhosin.executor.func.blacklist=none + App::$config['system']['php_path'] = '/usr/bin/php -d suhosin.executor.func.blacklist=none -d suhosin.executor.eval.blacklist=none'; -- cgit v1.2.3