Bureaucrats, confirmed, Administrators
4,558
edits
Changes
Jump to navigation
Jump to search
Aliases will need Our farm design is based on the principle that we want to be handled in DNS able to put multiple wikis on the same host, each being distinct wikis, sharing the same codebase. Since each organization (or ReWrite?domain)Our entire installation should seem as 'normal' as possible to a regular Ubuntu server - even though it is configured and controlled by Ansible.
Special:Badtitle/NS100:QualityBox/farm (view source)
Revision as of 13:29, 13 October 2016
, 13:29, 13 October 2016more documentation on the farm layout as represented in the filesystem
== Farm Design ==
Each client organization may have more than one wiki, and we'd want to put them together, so wikis will be grouped by TLD first:
Given and organization '''ACME Widgets''' having 3 top level domains of acme.org, acme.com, acme.net we would point the .net and .org domains to the Canonical domain of acme.com in the webserver. Thus only the canonical domain (acme.com) would be present on the filesystem in the server root. Within the organization, if they want multiple wikis, we will find multiple subdirectories for the organization:
<pre>
/var/www/ <== Apache server root
|-- clients <== Wiki instance directory (holds legitimate domains)
| `-- acme.com
| `-- wiki.acme.com
| `-- software.acme.com
| `-- research.acme.com
</pre>
Each of these would be distinct virtual hosts with distinct wikis and databases. If there is no subdomain (ie. the canonical domain for the wiki is acme.com without 'wiki' or 'www', etc. then there will be a similar 'bare' subdirectory: acme.com/acme.com
Optionally, but not yet implemented, we could offer "project" wikis that are based on a subdirectory. E.g.
<pre>
/var/www/
|-- clients
| `-- acme.com
| `-- wiki.acme.com
| `-- software.acme.com
| `-- slicer <== https://software.acme.com/slicer/Main_Page
| `-- dicer <== https://software.acme.com/dicer/Main_Page
| `-- chopper <== https://software.acme.com/chopper/Main_Page
| `-- research.acme.com
</pre>
== Questions ==
<ol>
<li>Should we support '''Aliases'''? There is the form of differing sub-domains e.g. wiki.example.com and kb.example.com both representing the same thing; and/or the form of multiple TLDs representing the same thing, e.g. kb.acme.org kb.acme.com kb.acme.net. We'd need to ensure that DNS resolves for all aliases, and configure Apache with the alias.
<li>If aliases are supported, we need to redirect to the '''Canonical Name''' e.g. given that wiki.example.com and kb.example.com represent one website, we need to know which is authoritative, and Alias the other.
</ol>
=== Mass Virtual Hosting ===
* wiki.example.com
* wiki.foundation.org/project2
* wiki.foundation.org/project3
Note: Cindy's solution uses this layout where 'WIKI_NAME' is equivalent to the first 'folder' in the request.
<code>SetEnvIf Request_URI "^/([^/]+)" WIKI_NAME=$1</code>
Some organizations may want to have multiple wikis which also share certain aspects:
</source>
For wiki.example.com, the Document Root will be /var/www/clients/example.com/wiki.example.com/comtaining a subdirectory '''w ''' where 'w' is a symbolic link to /var/www/_MW_mw/mediawikiand furthermore, 'mediawiki' itself is a symbolic link to the release version of the software (e.g. mediawiki-REL1_27) running for that client.
Our layout would be <ref>See [[Unicode tricks]] because this editor is not Unicode safe. In order to get ascii layout, use <code>--charset=asci</code> in your <code>tree</code> command. </ref>
<pre>
/var/www/
|-- clients
| `-- example.com <== capable of holding multiple sites for a domain / client| `-- wiki.example.com <== the subdomain (which can still hold multiple (custom) software installs besides mediawiki)| `-- w -> ../var../www../_MW_mw/mediawiki <== the mediawiki codebase is at 'w'
|-- html
| `-- index.html`-- _mw |-- farm | |-- Debug.php | |-- Email.php | |-- GlobalExtensions.php | |-- Keys.php | |-- LocalExtensions.php | |-- Permissions.php | |-- Server.php | `-- _MWUpload.php |-- mediawiki -> /var/www/_MW/mediawiki-REL1_27
`-- mediawiki-REL1_27
|-- api.php
|-- autoload.php
|-- cache
|-- composer.json
|-- composer.local.json-sample
|-- composer.lock
|-- COPYING
|-- CREDITS
|-- docs
|-- extensions
| `-- README
|-- FAQ
|-- Gemfile
|-- Gemfile.lock
|-- Gruntfile.js
|-- HISTORY
|-- images
| `-- README
|-- img_auth.php
|-- includes
|-- index.php
|-- INSTALL
|-- jsduck.json
|-- languages
|-- load.php
|-- LocalSettings.php
|-- maintenance
|-- mw-config
|-- opensearch_desc.php
|-- package.json
|-- phpcs.xml
|-- profileinfo.php
|-- Rakefile
|-- README
|-- README.mediawiki -> README
|-- RELEASE-NOTES-1.27
|-- resources
|-- serialized
|-- skins
| `-- README
|-- StartProfiler.sample
|-- tests
|-- thumb_handler.php
|-- thumb.php
|-- UPGRADE
|-- vendor
| |-- autoload.php | |-- bin | |-- composer | |-- cssjanus | |-- data-values | |-- doctrine | |-- jakub-onderka | |-- jeroen | |-- justinrainbow | |-- liuggio | |-- mediawiki | |-- monolog | |-- nikic | |-- nmred | |-- onoi | |-- oojs | |-- oyejorge | |-- param-processor | |-- phpdocumentor | |-- phpspec | |-- phpunit | |-- psr | |-- sebastian | |-- serialization | |-- squizlabs | |-- symfony | |-- webmozart | |-- wikimedia | `-- zordius `-- WikiFarmwiki.phtml
</pre>
