Add a wiki

Revision as of 13:28, 20 July 2010

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

This pulls information from two other pages: Add_a_language & Add_a_special_wiki

• Login to our bastion host, currently fenari.
• Get all relevant information for the new project, including all InitialiseSettings variables and entries.
• Determine if this is a new language project (Say something like Spanish Wikibooks) or a Chapter Wiki, or a special wiki.

• 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 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.

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/language/Names.php, in SVN and live

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

• Go to Part D

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 Part D

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 Part D

Part D (All Projects)

• If there are any other domains which should point to the same wiki, set up a redirect in redirects.conf
• If it's a private wiki, add it to /home/wikipedia/common/private.dblist to ensure it gets proper private-wiki configurations.

• Run sync-dblist

• Update the settings files for the new wiki.

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

• Update with wgUploadDirectory, wgSitename, wgMetaNamespace and wgServer. (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.

• wgServer is 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)
• php maintenance/addwiki.php 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/
• php maintenance/addwiki.php languagecode projectname databasename domain EG: php maintenance/addwiki.php 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/
• php maintenance/addwiki.php languagecode projectname databasename domain EG: php maintenance/addwiki.php 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/
• php maintenance/addwiki.php languagecode projectname databasename domain EG: php maintenance/addwiki.php en wikimedia strategywiki strategy.wikimedia.org

• Run dumpInterwiki.php to update the interwiki cache:

  php maintenance/dumpInterwiki.php -o cache/interwiki.cdb

• 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.