Differences between revisions 1 and 67 (spanning 66 versions)
Revision 1 as of 2005-09-05 14:46:58
Size: 614
Editor: Jeroen
Comment:
Revision 67 as of 2010-01-24 20:11:33
Size: 21674
Editor: FranklinPiat
Comment: moin config "url_prefix" is discontinued
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
= Status of wiki.debian.net migration =

 * [http://wiki.debian.net wiki.debian.net] is read-only, and a dump of the database is available
 * A script to convert the RCS files into moin moin revision files is fairly easy and will be done by ["Jeroen"].
 * A script to convert the markup from kwiki to moin moin needs to be written, see below.

== Convert markup ==

Any snippets appreciated. Todo:

 * Headers have now also a trailing set of ='s
 * Bold/italic/underscore are different
 * wikiwords that are not {{{StudlyCaps}}} are now {{{["Likethis"]}}} instead of {{{[Likethis]}}}
 * All the rest
#language en

<<TableOfContents(3)>>

== migrating moinmoin 1.7 -> 1.9+ ==
''This is a list of action for the [[DebianWiki/MigratedToMoinmoin19|next migration]] (lenny -> squeeze!)'' (currently tested on [[http://wiki-debian-net.klabs.be/]]).

=== TODO / Ideas ===
 * ?? Allow Embedding objects (Ogg,PDF...), see [[MoinMoin:HelpOnMacros/EmbedObject|EmbedObject]]

=== Actual wiki Migration steps ===

=== Pre-upgrade ===
 1. Get the list of [[EditedSystemPages]] (they may need to be updated after the upgrade) {{{#!wiki comment
as of 2010-01-24 :
  [[BadContent]],
  [[CategoryCategory]],
  [[CategoryHomepage]],
  [[CategoryTemplate]],
  [[FrontPage]],
  [[HomepageGroupsTemplate]],
  [[HomepagePrivatePageTemplate]],
  [[HomepageReadPageTemplate]],
  [[HomepageReadWritePageTemplate]],
  [[HomepageTemplate]],
  [[InterWiki]],
  [[LocalBadContent]],
  [[LocalSpellingWords]],
  [[WikiSandBox]]
}}}
 2. Update the links, to use {{{<<Anchor(foo)>>}} instead of {{{#head-1234567}}} anchors generated by moinmoi-1.7's {{{<TableOfContents>}}} feature. /* moin-1.9 create meaningful anchor name based on the header name. {{{#!wiki comment
[[Amarok]],
[[AptCLI]],
[[BSP/ch/Marathon]],
[[ContinuingDebianEducation]],
[[de/EeePC/Boot]],
[[de/EeePC/HowTo/Configure]],
[[de/EeePC/HowTo/Install]],
[[de/EeePC/HowTo/Sound]],
[[de/EeePC/HowTo/Troubleshooting]],
[[de/EeePC/Models]],
[[de/EeePC/Todo]],
[[de/Network]],
[[DebianEdu/HowTo/LtspLoadBalance]],
[[DebianEeePC/Boot]],
[[DebianEeePC/FAQ]],
[[DebianEeePC/HowTo/Install]],
[[DebianEeePC/Model/900A]],
[[DebianEeePC/Models]],
[[DebianEeePC/Todo]],
[[DebianEeePCDutch/Hoe/Installeren]],
[[DebianEeePCDutch/Modelen]],
[[DebianEeePCItalian/HowTo/Install]],
[[DebianEeePCItalian/HowTo/Wifi]],
[[DebianEeePCItalian/Models]],
[[DebianEeePCPortuguese/HowTo/Wifi]],
[[DebianEeePCSpanish/HowTo/Wifi]],
[[DebianInstaller/NetInstWithThirdPartyNetworkDriver]],
[[DebianInstaller/ReleaseProcess]],
[[DebianLive/Howto/Local_Swap_File]],
[[DebianLive/Howto/Mount_Local_Partition]],
[[DefaultMTA]],
[[fr/Amarok]],
[[fr/EeePC/HowTo/Install]],
[[fr/EeePC/HowTo/Wifi]],
[[fr/EeePC/Models]],
[[fr/Multimedia]],
[[fr/Network]],
[[fr/NetworkApplication]],
[[Games/Team]],
[[gpghowto]],
[[HalfLife2]],
[[i18n/TranslationDebs]],
[[i18n/TranslationDebsProposals]],
[[id/Network]],
[[InstallingDebianOn/Dell/Inspiron1525]],
[[KansaiDebianMeeting20081214]],
[[MigrateToDDAccount]],
[[MigrationStatus]],
[[ms/Network]],
[[Multimedia]],
[[NeilWilliams]],
[[Network]],
[[NetworkApplication]],
[[PackagingWithDarcsAndTailor]],
[[Passing_boot_options_to_modules]],
[[Passing_boot_options_to_modulesSpanish]],
[[pl/Amarok]],
[[Postfix]],
[[ProjectNews/Guidelines]],
[[pt_BR/Network]],
[[RaphaelGeissert]],
[[sfantar]],
[[Teams/Apache]],
[[Teams/Publicity/DebianTimesTeam/PressReleases/SerproChoseDebianAndCollaborate]],
[[Xen]],
[[zh_CN/BootProcess]],
[[zh_CN/DebianInstaller]],
[[zh_CN/DHCP_Server]],
[[zh_CN/HowToPackageForDebian]]
}}}

=== D-day ===

The pages folder is quite large... make sure it's in the cache...
 1. {{{for x in 1 2 3 4 5 6 7 8 9 ; do ls /srv/wiki.debian.org/var/moin/data/pages > /dev/null ; done}}}
''And Meanwhile...''

Turn the wiki read-only
 1. edit {{{/srv/wiki.debian.org/etc/moin/wikiconfig.py}}} and append: {{{#!python numbers=disable
    page_header1 = """<table width='100%'><tr><td style="background:#ffd0d0; text-align: center;padding:15pt">wiki.debian.org is in read-only mode for a maintenance operation. We will be back in 60 minutes. </td></tr></table>"""
    acl_enabled = 1
    acl_rights_default = 'Known:read All:read'
}}}


Upgrade moinmoin
 1. {{{
aptitude install --without-recommends python-flup python-tz python-xapian python-xappy poppler-utils
aptitude remove python-4suite-xml
}}}

Migrate moinmoin data (i.e update existing pages, for new syntax)
{{{
#Estimated time for migration: ~~10minutes.
/srv/wiki.debian.org/bin/moin --config-dir=/srv/wiki.debian.org/etc/moin/ --wiki-url=wiki.debian.org migration data
}}}
~- {{{{#!wiki comment
During my test...
{{{
2010-01-23 18:40:55,520 WARNING MoinMoin.log:139 using logging configuration read from built-in fallback in MoinMoin.log module!
2010-01-23 18:40:55,760 ERROR MoinMoin.config.multiconfig:342 xapian_search was auto-disabled because python-xapian is not installed [No module named xapian].
2010-01-23 18:40:55,761 INFO MoinMoin.config.multiconfig:127 using wiki config: /srv/wiki.debian.org/etc/moin/wikiconfig.py
Calling migration script for /srv/wiki.debian.org/var/moin/data, base revision 1070100
Returned. New rev is 1070200.
Calling migration script for /srv/wiki.debian.org/var/moin/data, base revision 1070200
Returned. New rev is 1070300.
Calling migration script for /srv/wiki.debian.org/var/moin/data, base revision 1070300
Returned. New rev is 1080000.
Calling migration script for /srv/wiki.debian.org/var/moin/data, base revision 1080000
Returned. New rev is 1080100.
Calling migration script for /srv/wiki.debian.org/var/moin/data, base revision 1080100
Returned. New rev is 1080200.
Calling migration script for /srv/wiki.debian.org/var/moin/data, base revision 1080200
Returned. New rev is 1080300.
Calling migration script for /srv/wiki.debian.org/var/moin/data, base revision 1080300
Returned. New rev is 1080400.
Calling migration script for /srv/wiki.debian.org/var/moin/data, base revision 1080400
Returned. New rev is 1080500.
Calling migration script for /srv/wiki.debian.org/var/moin/data, base revision 1080500
Returned. New rev is 1080600.
Calling migration script for /srv/wiki.debian.org/var/moin/data, base revision 1080600
Returned. New rev is 1089999.
Calling migration script for /srv/wiki.debian.org/var/moin/data, base revision 1089999
Returned. New rev is 1090000.
Calling migration script for /srv/wiki.debian.org/var/moin/data, base revision 1090000
Final mig script reached, migration is complete.
}}}
}}}}-~

Update WSGI application name:
 1. Edit {{{/srv/wiki.debian.org/bin/moin.wsgi}}}: {{{#!python numbers=disable
import sys
sys.path.insert(0, '/srv/wiki.debian.org/etc/moin')
#from MoinMoin.server.server_wsgi import moinmoinApp
from MoinMoin.web.serving import make_application
#application = moinmoinApp
application = make_application(shared=True)
}}}

Publish modernized theme (using apache)
 1. Edit {{{/srv/wiki.debian.org/etc/moin/wikiconfig.py}}}, replace {{{url_prefix = '/htdocs'}}}, with: {{{
url_prefix_local = '/htdocs'

# Moin (>1.6) use a prefix like '/moin_staticXYZ' to ensure file versioning
# (en therefore avoid client file caching issue)
#url_prefix_static = '/htdocs'
}}}
 1. Edit {{{/srv/wiki.debian.org/etc/apache2/apache2.conf}}}, add this alias {{{
Alias /moin_static190 /usr/share/moin/htdocs/
}}}
 1. We can get rid of the old symlinks in {{{/srv/wiki.debian.org/usr/htdocs/}}}: {{{
rm /srv/wiki.debian.org/usr/htdocs/common
rm /srv/wiki.debian.org/usr/htdocs/classic
rm /srv/wiki.debian.org/usr/htdocs/modern
rm /srv/wiki.debian.org/usr/htdocs/rightsidebar
}}}

Update {{{/srv/wiki.debian.org/etc/moin/wikiconfig.py}}} (Ideally, we should keep DefaultConfig.password_checker):
{{{#!diff numbers=disable
diff --git a/etc/moin/wikiconfig.py b/etc/moin/wikiconfig.py
index 5dea400..f53a88b 100644
--- a/etc/moin/wikiconfig.py
+++ b/etc/moin/wikiconfig.py
@@ -50,11 +50,11 @@ class Config(DefaultConfig):
     # Spammers
     hosts_deny = local_secrets.hosts_deny
 
- def password_checker(username, passwd):
+ def password_checker(request, username, passwd):
         result = local_secrets.password_checker(username, passwd)
         if result != None:
             return result
- return DefaultConfig.password_checker(username, passwd)
+ return None
 
     password_checker = staticmethod(password_checker)
}}}

Update wiki underlay:
 1. {{{mv /srv/wiki.debian.org/var/moin/underlay/pages/ /srv/wiki.debian.org/var/moin/underlay/pages.pre-19}}}
 1. {{{cp -R /usr/share/moin/underlay/pages /srv/wiki.debian.org/var/moin/underlay/}}}
 1. {{{chown -R wiki:wikiadm /srv/wiki.debian.org/var/moin/underlay/pages}}}
 1. {{{chmod ug+w /srv/wiki.debian.org/var/moin/underlay/pages}}}
 1. Using a SuperUser account, Navigate to [[LanguageSetup]] (actually [[DebianWiki:LanguageSetup?action=language_setup|?action=language_setup]], and install languages packs: {{{{#!wiki comment
It is probably sensible to provide moinmoin system and help page for the same languages as the one we provide content for...
~- {{{#!text
% find . -maxdepth 1 -regex './[a-z][a-z]\(_..\)?(.*' | sed -e 's/..\(..\).*/\1/' | sort | uniq -c | sort -n
    277 fr
    105 de
     57 pt <-- includes pt and pt_BR
     37 es
     35 ja
     31 it
     26 ru
     26 id
     25 zh
     23 qa <-- this is a bug: qa.debian.org
     21 ms <-- Malaysian isn't available
     19 el <-- Greek isn't available
     18 pl
#... +17 other languages with <10 pages.
## To list Language packs contents,
## % for x in French*.zip ; do unzip -p $x MOIN_PACKAGE > /tmp/$x.txt; done
}}} -~
  * English [[http://wiki.debian.org/LanguageSetup?action=language_setup&target=English_all_system_pages.zip&language=English|all_system]], [[http://wiki.debian.org/LanguageSetup?action=language_setup&target=English_essential_category_pages.zip&language=English|essential_category]], [[http://wiki.debian.org/LanguageSetup?action=language_setup&target=English_essential_template_pages.zip&language=English|essential_template]], [[http://wiki.debian.org/LanguageSetup?action=language_setup&target=English_all_help_pages.zip&language=English|all_help]], [[http://wiki.debian.org/LanguageSetup?action=language_setup&target=English_admin_pages.zip&language=English|admin]]
  * French [[http://wiki.debian.org/LanguageSetup?action=language_setup&target=French_essential_system_pages.zip&language=French|essential_system]] [[http://wiki.debian.org/LanguageSetup?action=language_setup&target=French_essential_help_pages.zip&language=French|essential_help]]
  * German [[http://wiki.debian.org/LanguageSetup?action=language_setup&target=German_essential_system_pages.zip&language=German|essential_system]] [[http://wiki.debian.org/LanguageSetup?action=language_setup&target=German_essential_help_pages.zip&language=German|essential_help]]
  * Brazilian_Portuguese [[http://wiki.debian.org/LanguageSetup?action=language_setup&target=Brazilian_Portuguese_essential_system_pages.zip&language=Brazilian_Portuguese|essential_system]] --([[http://wiki.debian.org/LanguageSetup?action=language_setup&target=Brazilian_Portuguese_essential_help_pages.zip&language=Brazilian_Portuguese|essential_help]])--
  * Portuguese [[http://wiki.debian.org/LanguageSetup?action=language_setup&target=Portuguese_essential_system_pages.zip&language=Portuguese|essential_system]] --([[http://wiki.debian.org/LanguageSetup?action=language_setup&target=Portuguese_essential_help_pages.zip&language=Portuguese|essential_help]])--
  * Spanish [[http://wiki.debian.org/LanguageSetup?action=language_setup&target=Spanish_essential_system_pages.zip&language=Spanish|essential_system]] --([[http://wiki.debian.org/LanguageSetup?action=language_setup&target=Spanish_essential_help_pages.zip&language=Spanish|essential_help]])--
  * Japanese [[http://wiki.debian.org/LanguageSetup?action=language_setup&target=Japanese_essential_system_pages.zip&language=Japanese|essential_system]] [[http://wiki.debian.org/LanguageSetup?action=language_setup&target=Japanese_essential_help_pages.zip&language=Japanese|essential_help]]
  * Italian [[http://wiki.debian.org/LanguageSetup?action=language_setup&target=Italian_essential_system_pages.zip&language=Italian|essential_system]] [[http://wiki.debian.org/LanguageSetup?action=language_setup&target=Italian_essential_help_pages.zip&language=Italian|essential_help]]
  * Russian [[http://wiki.debian.org/LanguageSetup?action=language_setup&target=Russian_essential_system_pages.zip&language=Russian|essential_system]] [[http://wiki.debian.org/LanguageSetup?action=language_setup&target=Russian_essential_help_pages.zip&language=Russian|essential_help]]
  * Indonesian [[http://wiki.debian.org/LanguageSetup?action=language_setup&target=Indonesian_essential_system_pages.zip&language=Indonesian|essential_system]] --([[http://wiki.debian.org/LanguageSetup?action=language_setup&target=Indonesian_essential_help_pages.zip&language=Indonesian|essential_help]])--
  * Simplified_Chinese [[http://wiki.debian.org/LanguageSetup?action=language_setup&target=Simplified_Chinese_essential_system_pages.zip&language=Simplified_Chinese|essential_system]] --([[http://wiki.debian.org/LanguageSetup?action=language_setup&target=Simplified_Chinese_essential_help_pages.zip&language=Simplified_Chinese|essential_help]])--
  * Chinese_Taiwan [[http://wiki.debian.org/LanguageSetup?action=language_setup&target=Chinese_Taiwan_essential_system_pages.zip&language=Chinese_Taiwan|essential_system]] --([[http://wiki.debian.org/LanguageSetup?action=language_setup&target=Chinese_Taiwan_essential_help_pages.zip&language=Chinese_Taiwan|essential_help]]))--
  * Polish [[http://wiki.debian.org/LanguageSetup?action=language_setup&target=Polish_essential_system_pages.zip&language=Polish|essential_system]] --([[http://wiki.debian.org/LanguageSetup?action=language_setup&target=Polish_essential_help_pages.zip&language=Polish|essential_help]])--

}}}}

Update Interwiki
 1. {{{mv /srv/wiki.debian.org/var/moin/data/intermap.txt /srv/wiki.debian.org/var/moin/data/intermap.old}}}
 2. {{{cp /usr/share/moin/data/intermap.txt /srv/wiki.debian.org/var/moin/data/}}}


Cleanup moinmoin's cache
 1. {{{/srv/wiki.debian.org/bin/moin maint cleancache}}} (Estimated time for migration: 5~10minutes)

=== Post upgrade ===
 * Update/remove/revert [[EditedSystemPages]]
 * Fix !TableOfContents, for pages with h1. see [[http://moinmo.in/MoinMoinBugs/TableOfContentsIgnoresSectionNumbersPragma|TableOfContentsIgnoresSectionNumbersPragma]]
 * Update/use {{{{ {{{#!highlight [..]}}} }}}}
 * Make sure Default front-page for installed languages exists ([[PageD'Accueil]]...)

== migrating moinmoin 1.5 -> 1.7 ==

The system hosting the wiki has been migrated to Lenny, so Moinmoin was upgraded ([[DebianWiki/MigratedToMoinmoin17]]).

The purpose of this page was to prepare and track that migration of the wiki.

'''Wiki Configuration'''
 * --( I18n: sister sites ([[http://lists.debian.org/debian-www/2009/03/msg00041.html|prototype]])? => wont-fix)--
 * --( Provide a Favicon (DebianBug:520178, fixed by pabs). )--
 * --( Update pages to use the new [[DebianWiki/EditorGuide#official|Debian "official material" banner]] (i.e search pages containing "official-doc.png"). )--
 * --( Fix {{{ {{ #!/bin/sh }}} [[http://sourceforge.net/mailarchive/forum.php?thread_name=1237166633.24642.244.camel%40timo-desktop&forum_name=moin-user|bug]] (mostly fixed by PaulWise). )--
 * Enable [[http://moinmo.in/HelpOnConfiguration/SupplementationPage|SupplementationPage]] (see [[http://lists.debian.org/debian-www/2009/03/msg00144.html|mail]]) and migrate existing pages.
 * Authentication against ldap.d.o, alioth sql, or openid ( see [[http://moinmo.in/HelpOnAuthentication|doc]])? {{{#!wiki comment
This task is postponed until the license of the wiki is fixed.
}}}

'''Wiki Content'''
 * --( Drop AyudaSobreEdiccion/* ? )--
 * --( Use [[http://moinmo.in/HelpOnAdmonitions|HelpOnAdmonitions]], for [[http://wiki.debian.org/DebianWiki/EditorGuide#head-70e5ab2f9bbefb68886c25cf352eef6b7801efd0|Debian "official material" banner]]. )--
 * --( Review "EditedSystemPages" )--
 * --( Review/update InterWikiMap ([[http://lists.debian.org/debian-www/2009/03/msg00128.html|mail]]) )--
 * --( Update the DebianWiki/EditorGuide ''(done by FranklinPiat)'' )--
 * --( Send an announcement on [[http://lists.debian.org/debian-devel/2009/03/msg00884.html|debian-devel]] <<BR>> (./) and [[DeveloperNews]]. )--
 * --( Fix the [[https://wiki.debian.org/Games/TheBattleForWesnoth?action=fullsearch&context=180&value=re%3AFullSearchCached&fullsearch=Text|Games/de...]] pages, like for [[https://wiki.debian.org/de/Games/TheBattleForWesnoth?action=diff&rev2=4&rev1=2|TheBattleForWesnoth]] )--
 * Replace {{{<<PageList(re:^FooBar)>>}}} macro with {{{<<FullSearchCached(t:re:^FooBar.*)>>}}}, because the first one now lists attachments too :-(
 * Update the [[CategoryCategory|Category]] pages, based on moin 1.6's [[CategoryTemplate]]
 * Drop Category``!FrSomething : use !FullSearch(Category``Something + language:fr).. Looks even slower that Category searches.



== OLD wiki.debian.net migration ==

=== Status ===

 Completed.

=== Cleanup Project ===

I've been going through a bunch of the pages and reformatting them for [[KWiki]]. (I got half-way through OliverGeorge but got tired, and gave up.) Anyway, ''please'' join in and cleanup any pages that need cleaning. If you find a page that needs cleaning, but don't have time, just tag it CleanMe. If you're looking for something to do, search for CleanMe and go fix one of those. --MichaelIvey
''This text was formerly on NewsCleanup.. but i'am cleaning that too ;) ''

=== TODO ===

 * Deal with Licencing terms[[copyright.html]] by at least proposing a license for new content. -- FilipusKlutiero

=== Done ===

 * Kwiki had switched URL formats and supported through some hack (probably URL rewrite) old links in the form index.cgi?Foo (example : http``://wiki.debian.net/index.cgi?DebianInstallerFAQ). This was a switch recent enough so that we still find links with such a form in doc and should support them IMO. Currently these bring to a non-existing index.cgi page. -- FilipusKlutiero
   * I agree, it would be nice if http``://wiki.debian.net/'''index.cgi?'''foo and http``://wiki.debian.net/'''?'''foo were redirected to http``://wiki.debian.org/foo -- FranklinPiat

 * The new wiki supports links such as w.d.o/?Foo to bring to Foo. However there's no actual redirection. This seems to highlight a small Moin bug. If you access a page this way, and try deleting the page, you'll be asked for confirmation on the homepage for your language. I wasn't careful or thought that was just a bug and confirmed the deletion. The French PageD'Accueil was deleted (but still exists, since it was regenerated automatically). Hopefully that doesn't happen to the english homepage until it's locked. -- FilipusKlutiero

<<Date(2008-02-18T23:40:57Z)>>
 * Remove old kwiki help pages, like [[TextFormattingRules]] and switch to [[HelpOnEditing]] (''done''), etc :
   Many old page have been expanded and translated, still some cleanup is needed. see
   * HelpPage* (HelpPage,HelpPageGerman,HelpPageFrench)
   * ReadmeFirst (+ ReadmeFirstFrench, ReadmeFirstDanish, ReadmeFirstSpanish, ReadmeFirstGerman, ReadmeFirstHebrew)
   * HowDoIEdit, EditarPagina + AyudaSobreEdiccion/*
   * DanishLanguage

 * The german equivalent of "FrontPage" is still the default page. Probably the same thing applies for other languages. We should get rid of such "bogus" translations! -- ErichSchubert
   * As I mentionned in [[FrontPage/Discussion]], I think we should use MoinMoin's official names for translated front pages. For example, FrontPageFrench duplicates much of [[PageD'Accueil]] (the equivalent of FrontPage in french). -- TheAnarcat <<DateTime(2006-05-15T02:18:10Z)>>

Sat Sep 8 11:24:53 UTC 2007
 * all links to wiki.debian.net are now converted to wiki.debian.org (within wiki.d.o !) -- FranklinPiat

Fri Sep 7 21:32:00 UTC 2007
 * converted all !DebianPackage:, !DebianPts:, !DebianPackages: i.e kwiki's [[http://zwiki.org/RemoteWikiURL|RemoteWikiURL]] to Moinmoin's [[http://moinmoin.wikiwikiweb.de/InterWiki|InterWiki]] links -- FranklinPiat
 * former help pages cleanup (see below)


Sun Aug 5 11:51:00 UTC 2007
 * converted all bts: and package: to InterWiki links -- FranklinPiat

Sat Oct 8 00:03:05 UTC 2005: wiki.debian.net content is converted over, wiki.debian.net is now permanently read-only, and will soon start to http-redirect people to here --[[Jeroen]]
 * Some pages were not converted perfectly, those should be manually fixed.
 * Some pages existed on both wiki.debian.org and wiki.debian.net, I ([[Jeroen]]) needed to do something with that. I documented it all, and you can double-check me, and correct where needed:
  * Some page's history got merged, the .org version becoming the last (current) version. You might want to check the last wiki.debian.net version to see if it has info that was dropped in the first wiki.debian.org version. List and raw data: http://spohr.debian.org/~jeroen/wiki/merged/
  * Some pages were seeming manually copied from wiki.debian.net, I deleted the wiki.debian.org version and put down the wiki.debian.net version with history. The .org version might have had markup fixes that are now gone again. You might want to check that. List and raw data: http://spohr.debian.org/~jeroen/wiki/replaced/
  * Some pages had seeming a much better version history in the .org version, and the .net version was a completely seperate branch, I deleted the wiki.debian.net version, but there still might be good info over there that should be merged into the .org version. List and raw data: http://spohr.debian.org/~jeroen/wiki/skipped-backmergemanually/
  * Quite a number of users had on both wiki's a user page, I dropped the .net version for all of them. List and raw data: http://spohr.debian.org/~jeroen/wiki/skipped-personal/

migrating moinmoin 1.7 -> 1.9+

This is a list of action for the next migration (lenny -> squeeze!) (currently tested on http://wiki-debian-net.klabs.be/).

TODO / Ideas

  • ?? Allow Embedding objects (Ogg,PDF...), see EmbedObject

Actual wiki Migration steps

Pre-upgrade

  1. Get the list of EditedSystemPages (they may need to be updated after the upgrade)

  2. Update the links, to use <<Anchor(foo)>>}} instead of {{{#head-1234567 anchors generated by moinmoi-1.7's <TableOfContents> feature.

D-day

The pages folder is quite large... make sure it's in the cache...

  1. for x in 1 2 3 4 5 6 7 8 9 ; do ls /srv/wiki.debian.org/var/moin/data/pages > /dev/null ; done

And Meanwhile...

Turn the wiki read-only

  1. edit /srv/wiki.debian.org/etc/moin/wikiconfig.py and append:

        page_header1 = """<table width='100%'><tr><td style="background:#ffd0d0; text-align: center;padding:15pt">wiki.debian.org is in read-only mode for a maintenance operation. We will be back in 60 minutes. </td></tr></table>"""
        acl_enabled = 1
        acl_rights_default = 'Known:read All:read'
    

Upgrade moinmoin

  1. aptitude install --without-recommends python-flup python-tz python-xapian python-xappy poppler-utils
    aptitude remove python-4suite-xml

Migrate moinmoin data (i.e update existing pages, for new syntax)

#Estimated time for migration: ~~10minutes.
/srv/wiki.debian.org/bin/moin --config-dir=/srv/wiki.debian.org/etc/moin/ --wiki-url=wiki.debian.org migration data

Update WSGI application name:

  1. Edit /srv/wiki.debian.org/bin/moin.wsgi:

    import sys
    sys.path.insert(0, '/srv/wiki.debian.org/etc/moin')
    #from MoinMoin.server.server_wsgi import moinmoinApp
    from MoinMoin.web.serving import make_application
    #application = moinmoinApp
    application = make_application(shared=True)
    

Publish modernized theme (using apache)

  1. Edit /srv/wiki.debian.org/etc/moin/wikiconfig.py, replace url_prefix = '/htdocs', with:

    url_prefix_local = '/htdocs'
    
    # Moin (>1.6) use a prefix like '/moin_staticXYZ' to ensure file versioning
    # (en therefore avoid client file caching issue)
    #url_prefix_static = '/htdocs'
  2. Edit /srv/wiki.debian.org/etc/apache2/apache2.conf, add this alias

    Alias /moin_static190    /usr/share/moin/htdocs/
  3. We can get rid of the old symlinks in /srv/wiki.debian.org/usr/htdocs/:

    rm /srv/wiki.debian.org/usr/htdocs/common
    rm /srv/wiki.debian.org/usr/htdocs/classic
    rm /srv/wiki.debian.org/usr/htdocs/modern
    rm /srv/wiki.debian.org/usr/htdocs/rightsidebar

Update /srv/wiki.debian.org/etc/moin/wikiconfig.py (Ideally, we should keep ?DefaultConfig.password_checker):

diff --git a/etc/moin/wikiconfig.py b/etc/moin/wikiconfig.py
index 5dea400..f53a88b 100644
--- a/etc/moin/wikiconfig.py
+++ b/etc/moin/wikiconfig.py
@@ -50,11 +50,11 @@ class Config(DefaultConfig):
     # Spammers
     hosts_deny = local_secrets.hosts_deny
 
-    def password_checker(username, passwd):
+    def password_checker(request, username, passwd):
         result = local_secrets.password_checker(username, passwd)
         if result != None:
             return result
-        return DefaultConfig.password_checker(username, passwd)
+        return None
 
     password_checker = staticmethod(password_checker)

Update wiki underlay:

  1. mv /srv/wiki.debian.org/var/moin/underlay/pages/ /srv/wiki.debian.org/var/moin/underlay/pages.pre-19

  2. cp -R /usr/share/moin/underlay/pages /srv/wiki.debian.org/var/moin/underlay/

  3. chown -R wiki:wikiadm /srv/wiki.debian.org/var/moin/underlay/pages

  4. chmod ug+w /srv/wiki.debian.org/var/moin/underlay/pages

  5. Using a ?SuperUser account, Navigate to LanguageSetup (actually ?action=language_setup, and install languages packs:

Update Interwiki

  1. mv /srv/wiki.debian.org/var/moin/data/intermap.txt /srv/wiki.debian.org/var/moin/data/intermap.old

  2. cp /usr/share/moin/data/intermap.txt  /srv/wiki.debian.org/var/moin/data/

Cleanup moinmoin's cache

  1. /srv/wiki.debian.org/bin/moin maint cleancache (Estimated time for migration: 5~10minutes)

Post upgrade

migrating moinmoin 1.5 -> 1.7

The system hosting the wiki has been migrated to Lenny, so Moinmoin was upgraded (DebianWiki/MigratedToMoinmoin17).

The purpose of this page was to prepare and track that migration of the wiki.

Wiki Configuration

  • I18n: sister sites (prototype)? => wont-fix

  • Provide a Favicon (520178, fixed by pabs).

  • Update pages to use the new Debian "official material" banner (i.e search pages containing "official-doc.png").

  • Fix  {{ #!/bin/sh  bug (mostly fixed by PaulWise).

  • Enable SupplementationPage (see mail) and migrate existing pages.

  • Authentication against ldap.d.o, alioth sql, or openid ( see doc)?

Wiki Content

OLD wiki.debian.net migration

Status

  • Completed.

Cleanup Project

I've been going through a bunch of the pages and reformatting them for ?KWiki. (I got half-way through ?OliverGeorge but got tired, and gave up.) Anyway, please join in and cleanup any pages that need cleaning. If you find a page that needs cleaning, but don't have time, just tag it CleanMe. If you're looking for something to do, search for CleanMe and go fix one of those. --MichaelIvey This text was formerly on ?NewsCleanup.. but i'am cleaning that too ;)

TODO

Done

  • Kwiki had switched URL formats and supported through some hack (probably URL rewrite) old links in the form index.cgi?Foo (example : http://wiki.debian.net/index.cgi?DebianInstallerFAQ). This was a switch recent enough so that we still find links with such a form in doc and should support them IMO. Currently these bring to a non-existing index.cgi page. -- FilipusKlutiero

    • I agree, it would be nice if http://wiki.debian.net/index.cgi?foo and http://wiki.debian.net/?foo were redirected to http://wiki.debian.org/foo -- FranklinPiat

  • The new wiki supports links such as w.d.o/?Foo to bring to Foo. However there's no actual redirection. This seems to highlight a small Moin bug. If you access a page this way, and try deleting the page, you'll be asked for confirmation on the homepage for your language. I wasn't careful or thought that was just a bug and confirmed the deletion. The French PageD'Accueil was deleted (but still exists, since it was regenerated automatically). Hopefully that doesn't happen to the english homepage until it's locked. -- FilipusKlutiero

2008-02-18

  • Remove old kwiki help pages, like ?TextFormattingRules and switch to HelpOnEditing (done), etc :

    • Many old page have been expanded and translated, still some cleanup is needed. see
    • ?HelpPage* (?HelpPage,?HelpPageGerman,?HelpPageFrench)

    • ?ReadmeFirst (+ ?ReadmeFirstFrench, ?ReadmeFirstDanish, ?ReadmeFirstSpanish, ?ReadmeFirstGerman, ?ReadmeFirstHebrew)

    • HowDoIEdit, ?EditarPagina + AyudaSobreEdiccion/*

    • ?DanishLanguage

  • The german equivalent of "FrontPage" is still the default page. Probably the same thing applies for other languages. We should get rid of such "bogus" translations! -- ErichSchubert

    • As I mentionned in ?FrontPage/Discussion, I think we should use MoinMoin's official names for translated front pages. For example, ?FrontPageFrench duplicates much of PageD'Accueil (the equivalent of FrontPage in french). -- TheAnarcat 2006-05-15 02:18:10

Sat Sep 8 11:24:53 UTC 2007

  • all links to wiki.debian.net are now converted to wiki.debian.org (within wiki.d.o !) -- FranklinPiat

Fri Sep 7 21:32:00 UTC 2007

Sun Aug 5 11:51:00 UTC 2007

Sat Oct 8 00:03:05 UTC 2005: wiki.debian.net content is converted over, wiki.debian.net is now permanently read-only, and will soon start to http-redirect people to here --Jeroen

  • Some pages were not converted perfectly, those should be manually fixed.
  • Some pages existed on both wiki.debian.org and wiki.debian.net, I (Jeroen) needed to do something with that. I documented it all, and you can double-check me, and correct where needed:

    • Some page's history got merged, the .org version becoming the last (current) version. You might want to check the last wiki.debian.net version to see if it has info that was dropped in the first wiki.debian.org version. List and raw data: http://spohr.debian.org/~jeroen/wiki/merged/

    • Some pages were seeming manually copied from wiki.debian.net, I deleted the wiki.debian.org version and put down the wiki.debian.net version with history. The .org version might have had markup fixes that are now gone again. You might want to check that. List and raw data: http://spohr.debian.org/~jeroen/wiki/replaced/

    • Some pages had seeming a much better version history in the .org version, and the .net version was a completely seperate branch, I deleted the wiki.debian.net version, but there still might be good info over there that should be merged into the .org version. List and raw data: http://spohr.debian.org/~jeroen/wiki/skipped-backmergemanually/

    • Quite a number of users had on both wiki's a user page, I dropped the .net version for all of them. List and raw data: http://spohr.debian.org/~jeroen/wiki/skipped-personal/