Add a wiki

Revision as of 18:11, 29 September 2009

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

Part A (Language Project)

• Make sure the language is approved by looking at meta:Approved requests for new languages

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

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

• Update with wgUploadDirectory, wgSitename, wgMetaNamespace and wgServer. (Some may not be required, but these are the most common setttings.)
• 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 or Part B above:

• php maintenance/addwiki.php languagecode projectname databasename
• 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 EG: php maintenance/addwiki.php es wikinews eswikinews to add a spanish wikinews.

• Part B 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 EG: php maintenance/addwiki.php en wikimedia strategywiki

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