Add a wiki

Latest revision as of 01:14, 12 February 2013

This page will walk you through how to add a new wiki project. This includes new languages on projects, committees, chapters, and so on...

[edit] Start

You will firstly have to login to our bastion host. As of January 2011 this is the host fenari. Then gather all relevant information for the new project, including all InitialiseSettings variables and entries. Each wiki will have different requirements (project name, namespaces, extensions to be enabled ...).

You now have to determine if this is a new language project (say something like Spanish Wikibooks) or a Chapter Wiki, or a special wiki. Then choose the correct part of this manual:

• If it is a language project, follow steps in Part A
• if it is a chapter, Part B
• if it is a special wiki, part C.

Please note that the directions in this guide are approximate. Some cases may not need apache updates and some may not need docroot. You need to look at the existing similar wikis and see what is required.

[edit] Part A (Language Project)

• Make sure the language is approved by looking at [1]

• If this is in bugzilla, it should have a link to its approval someplace. If it is not a new language project, then it may not be on the new languages meta page.

• Find its ISO 639 code. We don't currently have a decent way to pick subdomains for languages without an ISO 639 code.
• If new language:
  • Add the code to /home/wikipedia/common/langlist
  • Add the language name to /home/wikipedia/common/wmf-deployment/languages/Names.php, in SVN and live

• svn up, update file, svn commit (and put in notes or we will hate you.)

• Go to #Finish

[edit] Part B (Chapters Project)

• If this is a new chapter, you need to edit wikimedia.conf and add it to its apache config file:

• vim /home/wikipedia/conf/httpd/wikimedia.conf

• If you updated apache files, you need to push the change and restart the apache processes on the servers:

• sync-apache
• apache-graceful-all

• Go to #Finish

[edit] Part C (Special Project)

• If this is a new special wiki, you need to edit remnants.conf and add it with a new virtual host entry (please note the docroot determines the dbname, EG: docroot of meta and dbname is metawiki):

• You do NOT do this if it was a chapter wiki.

• vim /home/wikipedia/conf/httpd/remnant.conf

• Alternatively, some of the labs are in wikimedia.conf

• vim /home/wikipedia/conf/httpd/wikimedia.conf

• Create a document root directory in /home/wikipedia/common/docroot, using skel-1.5 as a template. Preserve the symlinks by copying the template with cp -pr.

• cd /home/wikipedia/common/docroot && cp -pr skel-1.5 <new docroot name>
• Run sync-docroot

• If you updated apache files, you need to push the change and restart the apache processes on the servers:

• sync-apache
• apache-graceful-all

• Go to #Finish

[edit] Finish

This apply to all projects.

• If there are any other domains which should point to the same wiki, set up a redirect in /home/wikipedia/conf/httpd/redirects.conf
• Update the settings files for the new wiki.

• Update InitialiseSettings (located at /home/wikipedia/common/wmf-config/InitialiseSettings.php)

• Update with wgUploadDirectory, wgSitename, wgMetaNamespace and wgServer, wgCanonicalServer. (Some may not be required, but these are the most common setttings.)
• Not listing a wgUploadDirectory just means uploads are disabled and they have to use commons, which is what MOST projects do now.
• Ensure you add ANY AND ALL new wikis to wmgUseDualLicense, with a value of true.

• wgServer and wgCanonicalServer are most commonly updated for wikis following Part B of the instructions, since they do not have fully standard URLs compared to our automatically generated ones for most language projects.

• Now it is time to add the actual wiki. There are two different ways to do this, depending on if you did Part A, B, or C above:

• TEMP You need to put in --wiki=aawiki after the addWiki.php and before the langcode for now. Script is wonky --RobH 19:20, 29 September 2009 (UTC) This means literally "aawiki", not the name of the wiki you create!!
• mwscript extensions/WikimediaMaintenance/addWiki.php --wiki=aawiki languagecode projectname databasename domain
• Part A is for standard language additions to projects, like adding a spanish wikinews, which will be my example.

• cd /home/wikipedia/common/wmf-deployment/
• mwscript extensions/WikimediaMaintenance/addWiki.php --wiki=aawiki languagecode projectname databasename domain EG: mwscript extensions/WikimediaMaintenance/addWiki.php --wiki=aawiki es wikinews eswikinews es.wikinews.org to add a spanish wikinews.

• Part B is for Chapters Wikis. My example will be adding a finnish chapter wiki:

• cd /home/wikipedia/common/wmf-deployment/
• mwscript extensions/WikimediaMaintenance/addWiki.php --wiki=aawiki languagecode projectname databasename domain EG: mwscript extensions/WikimediaMaintenance/addWiki.php --wiki=aawiki fi wikimedia fiwikimedia fi.wikimedia.org

• Part C is for non-standard special wikis such as committees, chapters, and the like. My example will be strategy.wikimedia.org.

• cd /home/wikipedia/common/wmf-deployment/
• mwscript extensions/WikimediaMaintenance/addWiki.php --wiki=aawiki languagecode projectname databasename domain EG: mwscript extensions/WikimediaMaintenance/addWiki.php --wiki=aawiki en wikimedia strategywiki strategy.wikimedia.org

• Check *.dblist files now contain the new wiki [NOTE: WE NEED TO DOCUMENT WHAT EACH *.dblist IS APPROPRIATE FOR]
• Run sync-dblist to synchronize [NOTE: CHECK IF THIS INSTRUCTION IS NEEDED, AS WE CALL sync-common-all AFTER]
• Run dumpInterwiki.php to update the interwiki cache:

  mwscript extensions/WikimediaMaintenance/dumpInterwiki.php -o /home/wikipedia/common/php/cache/interwiki.cdb --protocolrelative

• Run sync-common-all (needed to refresh the dblist files and the interwiki cache, scap is not enough!)

  sync-common-all

• Add entry in the DNS zone

• Be careful adding DNS.

[edit] Search

• Get someone from ops to do Lucene#Adding_new_wikis

[edit] Swift

• Public wikis:
  • Create the container for thumbnails. mwscript extensions/WikimediaMaintenance/filebackend/setZoneAccess.php --wiki=aawiki --backend=local-multiwrite
• Private wikis:
  • Create the container for thumbnails. mwscript extensions/WikimediaMaintenance/filebackend/setZoneAccess.php --wiki=aawiki --backend=local-multiwrite --private

[edit] After you finished

If there's something to import (as in A), someone will do so following the process described at MetaWikipedia:incubator:Incubator:Importing from Incubator (logged at MetaWikipedia:incubator:Incubator:Site creation log).

See also Delete a wiki.