| 1 |
|
|---|
| 2 |
|
|---|
| 3 | ===============================
|
|---|
| 4 | t
|
|---|
| 5 | = =
|
|---|
| 6 | = omCollab =
|
|---|
| 7 | = =
|
|---|
| 8 | = an open source =
|
|---|
| 9 | = collaboration suite =
|
|---|
| 10 | = comprising... =
|
|---|
| 11 | = =
|
|---|
| 12 | = --> MediaWiki <-- =
|
|---|
| 13 | = --> WordPress <-- =
|
|---|
| 14 | = --> Bookmarks <-- =
|
|---|
| 15 | = --> Explore <-- =
|
|---|
| 16 | = =
|
|---|
| 17 | = Easy one-page installation =
|
|---|
| 18 | = =
|
|---|
| 19 | ================================
|
|---|
| 20 |
|
|---|
| 21 |
|
|---|
| 22 | Installation instructions
|
|---|
| 23 |
|
|---|
| 24 |
|
|---|
| 25 | This installation guide is written for a clean installation onto a server that doesn't have a website on it. If you already have a site and just want to add omCollab to it, please review the contents of the ZIP archive and make sure you are not going to overwrite your site when you uncompress it!
|
|---|
| 26 |
|
|---|
| 27 | Requirements:
|
|---|
| 28 |
|
|---|
| 29 | - PHP5
|
|---|
| 30 | - MySql5
|
|---|
| 31 | - A Web host (LAMP/WAMP/XAMP)
|
|---|
| 32 | - ImageMagick (before proceeding with installation, please see note below)
|
|---|
| 33 | - CURL php (before proceeding with installation, please see note below)
|
|---|
| 34 | - mysqli php module needed for phpBB Forums
|
|---|
| 35 |
|
|---|
| 36 | WHAT TO DO:
|
|---|
| 37 |
|
|---|
| 38 | 1. You need a virtual host with PHP5 and support for multiple MySQL5 DBs ( ***** SET THIS UP FIRST ***** )
|
|---|
| 39 |
|
|---|
| 40 | 2. Three MySql databases (one each for MediaWiki, WordPress and omBookmarks) ( ***** SET THIS UP FIRST ***** )
|
|---|
| 41 | E.g. omcollab_wiki, omcollab_blogs and omcollab_bookmarks
|
|---|
| 42 |
|
|---|
| 43 | 3. A MySql Database User with all privileges on those DBs ( ***** SET THIS UP FIRST ***** )
|
|---|
| 44 |
|
|---|
| 45 | 4. This DB user must have a password (ie, root without password won't work) ( ***** SET THIS UP FIRST ***** )
|
|---|
| 46 |
|
|---|
| 47 | 5. Unzip the omCollab.zip file to the chosen directory within your virtual host.
|
|---|
| 48 | You should have a root directory (e.g. omcollab) and then the rest of the files in it.
|
|---|
| 49 |
|
|---|
| 50 | 6. Browse to http://yourdomain.com/your/installation/directory - you should be redirected to the installer page.
|
|---|
| 51 | -- Problems? Browse directly to http://YourHost/your/installation/directory/install.php
|
|---|
| 52 | -- Try http://localhost/omcollab if you created a omcollab directory
|
|---|
| 53 |
|
|---|
| 54 | 7. Fill in and submit the form, getting everything just right first time
|
|---|
| 55 |
|
|---|
| 56 | Magic happens, and...
|
|---|
| 57 |
|
|---|
| 58 |
|
|---|
| 59 | You should now have the fully functional omCollab Suite ready to rock and roll!
|
|---|
| 60 |
|
|---|
| 61 | Your default username is Admin
|
|---|
| 62 | Your default password is password (you are strongly advised to log in and change it following installation!)
|
|---|
| 63 |
|
|---|
| 64 |
|
|---|
| 65 | *********************************************************
|
|---|
| 66 | NOTES FOR DEVELOPER
|
|---|
| 67 |
|
|---|
| 68 | Now omCollab uses svn:externals to retrieve the latest upstream applicaton. The setting is here:
|
|---|
| 69 |
|
|---|
| 70 | wiki/bin http://svn.wikimedia.org/svnroot/mediawiki/tags/REL1_16_0beta2/phase3/bin
|
|---|
| 71 | wiki/cache http://svn.wikimedia.org/svnroot/mediawiki/tags/REL1_16_0beta2/phase3/cache
|
|---|
| 72 | wiki/config http://svn.wikimedia.org/svnroot/mediawiki/tags/REL1_16_0beta2/phase3/config
|
|---|
| 73 | wiki/docs http://svn.wikimedia.org/svnroot/mediawiki/tags/REL1_16_0beta2/phase3/docs
|
|---|
| 74 | wiki/languages http://svn.wikimedia.org/svnroot/mediawiki/tags/REL1_16_0beta2/phase3/languages
|
|---|
| 75 | wiki/maintenance http://svn.wikimedia.org/svnroot/mediawiki/tags/REL1_16_0beta2/phase3/maintenance
|
|---|
| 76 | wiki/math http://svn.wikimedia.org/svnroot/mediawiki/tags/REL1_16_0beta2/phase3/math
|
|---|
| 77 | wiki/serialized http://svn.wikimedia.org/svnroot/mediawiki/tags/REL1_16_0beta2/phase3/serialized
|
|---|
| 78 | wiki/extensions/Interwiki http://svn.wikimedia.org/svnroot/mediawiki/tags/REL1_16_0beta2/extensions/Interwiki
|
|---|
| 79 |
|
|---|
| 80 |
|
|---|
| 81 | *********************************************************
|
|---|
| 82 | NOTES FOR APACHE USERS (ESP ON WINDOWS)
|
|---|
| 83 |
|
|---|
| 84 | 1. Pretty URLs and Rewrite Rules for MediaWiki
|
|---|
| 85 |
|
|---|
| 86 | MediaWiki permits a RewriteRule to allow pretty URLs
|
|---|
| 87 | so /wiki/index.php/Main_Page becomes /wiki/Main_Page
|
|---|
| 88 |
|
|---|
| 89 | You can automagically set this feature during the install.
|
|---|
| 90 | Just check the box and *most of* the right files will be set up.
|
|---|
| 91 |
|
|---|
| 92 | However, you may need to modify httpd.conf so that mod_rewrite is enabled.
|
|---|
| 93 |
|
|---|
| 94 | Users of XAMPP and WAMP: to enable mod_rewrite, edit httpd.conf and do the following:
|
|---|
| 95 |
|
|---|
| 96 | Find:
|
|---|
| 97 | #LoadModule rewrite_module modules/mod_rewrite.so
|
|---|
| 98 | change to:
|
|---|
| 99 | LoadModule rewrite_module modules/mod_rewrite.so
|
|---|
| 100 |
|
|---|
| 101 | Find:
|
|---|
| 102 | AllowOverride None
|
|---|
| 103 | change to:
|
|---|
| 104 | AllowOverride All
|
|---|
| 105 |
|
|---|
| 106 |
|
|---|
| 107 | 2. ImageMagick must be installed
|
|---|
| 108 | Visit http://www.imagemagick.org/script/binary-releases.php and get the latest
|
|---|
| 109 | build appropriate to your OS, if you need to.
|
|---|
| 110 |
|
|---|
| 111 | 3. CURL PHP module must be enabled
|
|---|
| 112 | Please refer to your php.ini settings and ensure CURL is enabled
|
|---|
| 113 | Note that for installations such as XAMPP this would be php.ini within the apache directory
|
|---|
| 114 |
|
|---|
| 115 | 4. mysqli php module must be enabled
|
|---|
| 116 | See note 3.
|
|---|
| 117 |
|
|---|
| 118 | 5. Don't forget to configure an SMTP server to support notifications (e.g. for registrations, user email etc.).
|
|---|
| 119 | You can configure the SMTP server in your php.ini file.
|
|---|
| 120 |
|
|---|
| 121 | *********************************************************
|
|---|
| 122 |
|
|---|
| 123 | After installation
|
|---|
| 124 |
|
|---|
| 125 | Delete /install.completed.php - REQUIRED (you could alternatively just rename it (less secure))
|
|---|
| 126 | Rename /_InstallationResources/*.* - recommended (you could also delete for greater security)
|
|---|
| 127 |
|
|---|
| 128 | * You may need to log manually into ./blogs/wp-admin as Admin/password, then go to "plugins" and activate the single sign on helper functions.
|
|---|
| 129 | * You may need to select the appropriate blog skin from wp-admin -> design the first time you run the blog app
|
|---|
| 130 | * Should you activate it, you will need to configure the Subscribe2 plugin within blogs
|
|---|
| 131 | as per instructions at: http://wordpress.org/extend/plugins/subscribe2/installation/
|
|---|
| 132 | * You may need to go into Forums Administration Control Panel as Admin/password to change the forums skin to mike2 or mike2red, depending your preference.
|
|---|
| 133 | * You may need to go into Forums Administration Control Panel as Admin/password to purge the cache.
|
|---|
| 134 |
|
|---|
