-
Notifications
You must be signed in to change notification settings - Fork 673
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
docs(install): Move environment-specific instructions to their own pages
Fixes #7834
- Loading branch information
Showing
10 changed files
with
248 additions
and
213 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,57 @@ | ||
:orphan: | ||
|
||
Installing Elgg on Cloud9 IDE | ||
############################# | ||
|
||
1. Create a c9 workspace | ||
======================== | ||
|
||
- Go to http://c9.io | ||
- Login with GitHub | ||
- On the Dashboard, click "Create new workspace" => "Create a new | ||
workspace" | ||
- Choose a project name (e.g. "elgg") | ||
- Choose "PHP" for project type | ||
- Click "Create" | ||
- Wait... (~1 min for c9 workspace to be ready) | ||
- Click "Start editing" for the workspace | ||
|
||
2. Set up the workspace for Elgg | ||
================================ | ||
|
||
Run the following in cloud9's terminal: | ||
|
||
.. code:: sh | ||
rm -rf * # Clear out the c9 hello-world stuff | ||
git clone https://github.com/Elgg/Elgg . # the hotness | ||
cp install/config/htaccess.dist .htaccess | ||
cp engine/settings.example.php engine/settings.php | ||
mysql-ctl start # start c9's local mysql server | ||
mkdir ../elgg-data # setup data dir for Elgg | ||
Configure ``engine/settings.php`` to be like so: | ||
|
||
.. code:: php | ||
// Must set timezone explicitly! | ||
date_default_timezone_set('America/Los_Angeles'); | ||
$CONFIG->dbuser = 'your_username'; // Your c9 username | ||
$CONFIG->dbpass = ''; | ||
$CONFIG->dbname = 'c9'; | ||
$CONFIG->dbhost = $_SERVER['SERVER_ADDR']; | ||
$CONFIG->dbprefix = 'elgg_'; | ||
3. Complete the install process from Elgg's UI | ||
============================================== | ||
|
||
- Hit "Run" at the top of the page to start Apache. | ||
- Go to ``http://your-workspace.your-username.c9.io/install.php?step=database`` | ||
- Change Site URL to ``http://your-workspace.your-username.c9.io/`` | ||
- Put in the data directory path. Should be something like | ||
``/var/..../app-root/data/elgg-data/``. | ||
- Click "Next" | ||
- Create the admin account | ||
- Click "Go to site" | ||
- You may have to manually visit http://your-workspace.your-username.c9.io/ | ||
and login with the admin credentials you just configured. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,34 @@ | ||
:orphan: | ||
|
||
Installing Elgg on EasyPHP | ||
########################## | ||
|
||
You should first be familiar with the :doc:`standard installation instructions <../install>`. | ||
|
||
- Assuming no MySQL, PHP or Apache installations exist already. | ||
- Best run as a development/test server | ||
|
||
1. Stop IIS running if installed | ||
|
||
2. Download and install the latest Easy PHP from http://www.easyphp.org | ||
|
||
3. Set up the database and point the web server to your Elgg folder (all done from the EasyPHP tray icon) | ||
- Right click EasyPHP tray icon, select "Administration" | ||
- A new tab is created in your browser for managing Easy PHP | ||
- Add your Elgg folder to Apache in "Alias" section | ||
- Click "Manage MySQL with PhpMyAdmin", create a database and account for Elgg | ||
|
||
4. (Ignore this step for v5.3 or later) From the tray icon go Configuration/Apache | ||
and uncomment this line:: | ||
#LoadModule rewrite_module modules/mod_rewrite.so | ||
|
||
5. (Ignore this step for v5.3 or later) Change ``AllowOverride None`` to ``AllowOverride All`` | ||
in the relevant directory entry in Configuration/Apache | ||
|
||
6. (Ignore this step for v5.3 or later) From the tray icon fo Configuration/PHP | ||
and uncomment this line:: | ||
;extension=php_curl.dll | ||
|
||
7. A reboot is best Elgg should run via http://127.0.0.1 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,20 @@ | ||
:orphan: | ||
|
||
Installing Elgg on IIS | ||
###################### | ||
|
||
You can follow the :doc:`standard installation instructions <../install>` with the | ||
following caveats: | ||
|
||
When installing on IIS, the problem is that the Apache mod\_rewrite | ||
rules will not be recognized, and this breaks the application. You need | ||
to convert the mod\_rewrite rules to the `IIS URL Rewrite`_ module | ||
format. | ||
|
||
You can do this using the IIS 7+ management console, and the "Import | ||
Rules" feature that will do the conversion, as described in the tutorial | ||
"`importing Apache mod\_rewrite rules`_\ ". | ||
|
||
.. _IIS URL Rewrite: http://www.iis.net/download/URLRewrite | ||
.. _importing Apache mod\_rewrite rules: http://learn.iis.net/page.aspx/470/importing-apache-modrewrite-rules/ | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,13 @@ | ||
:orphan: | ||
|
||
Installing Elgg on MAMP | ||
####################### | ||
|
||
Follow the :doc:`standard installation instructions <../install>`. | ||
|
||
On certain versions of MAMP, Elgg will either fail to install or have | ||
intermittent problems while running. | ||
|
||
This is a known issue with MAMP and is related to the Zend Optimizer. | ||
Until Zend/MAMP have resolved this issue it is recommended that you | ||
**turn off the Zend Optimizer** in your PHP settings. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,13 @@ | ||
:orphan: | ||
|
||
Installing Elgg on MariaDB | ||
########################## | ||
|
||
You should be able to follow the :doc:`standard intallation instructions <../install>`, | ||
since this DBMS is supposed to be a drop-in replacement for MySQL. | ||
|
||
Let us know how it goes! | ||
|
||
Here is some historical community discussion, for reference: | ||
https://community.elgg.org/discussion/view/1455994/alternative-dbmss | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,13 @@ | ||
:orphan: | ||
|
||
Installing Elgg on Nginx | ||
######################## | ||
|
||
To run Elgg on Nginx, you will need to: | ||
|
||
- configure Nginx to talk to a PHP process in either CGI or FPM mode | ||
- Port the following rewrite rules | ||
|
||
.. literalinclude:: ../../../install/config/nginx.dist | ||
|
||
Other than that, you should be able to follow the :doc:`standard installation instructions <../install>`. |
Oops, something went wrong.