harukin/core
Archived
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

cleanup text in INSTALL.txt

Browse Source
This commit is contained in:
redmatrix 2016-01-12 20:05:16 -08:00
parent f757285ea8
commit 961540160f
1 changed files with 25 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
install/INSTALL.txt
View File

@ -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
@ -179,13 +180,22 @@ 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.
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.
****************************************************************************
****************************************************************************
******** THIS NEXT STEP IS IMPORTANT!!!! ***********
****************************************************************************
****************************************************************************
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'.