HidekazuHara/MigratingFromMoin15ToMoin16InJapanese

Updating 1.5.7 to 1.6.4 in Japanese

(see also: RickVanderveer/UpgradingFromMoin15ToMoin16)

実施環境

実施前に

Phase 1 - 1.6.4をインストールする

解凍した moin-1.6.4 フォルダの中に、簡単な説明が書かれている docs\README.migration ファイルと、リアルなヒントが書かれている docs\CHANGES ファイルがあります。

  1. MoinMoin 1.6.4 を、既存のMoinMoin上にインストールする

    • コマンドプロンプトにて、コマンドを実行

    • python setup.py install  --prefix="D:\Inetpub\Moin164" --record=install.log (環境に合わせてpathを変更ください)。

    • HELPを見るときはpython setup.py --help

    • 次のフォルダが作成される。 
       D:\Inetpub\Moin164\Lib
 D:\Inetpub\Moin164\Scripts
 D:\Inetpub\Moin164\Share
    • --prefixをつけないと、python25フォルダ配下にもろもろインストールされる（一度失敗してしまった！これで正しい環境の人もいると思うが。。。） 
      例）
 C:\Python25\Lib\site-packages
 C:\Python25\Lib\site-packages\moin-1.6.4-py2.5.egg-info
 C:\Python25\share

  2. moin.cgi ファイルを置換

    • 新しいmoin.cgi：D:\Inetpub\Moin184\share\moin\serverを、古いmoin.cgiと置き換える。置き換える際に、古いmoin.cgiで指定していたパラメーターを反映する事を忘れずに。

  3. farmconfig.py/wikiconfig.py ファイルを設定:

    • この行 from MoinMoin.multiconfig import DefaultConfig を、from MoinMoin.config.multiconfig import DefaultConfig に、置き換える

  4. FastCGI設定を修正:

    • Windows向けとLinux向けとでは、設定方法が違うらしい。FastCGIは現状使っていないので、割愛。

Phase 2 - Wiki Markup コンバート 1.5.7 to 1.6.4

  1. システムとヘルプページをアップグレードする:

    • D:\Inetpub\Moin184\share\moinにあるunderlayフォルダを、古いunderlayフォルダと置き換える。

      • 今回はD:\Inetpub\Moin164\mywiki中のunderlayを_underlayとして、新しいunderlayフォルダを置いた。

  2. 移行スクリプトを実行する：

    • D:\Inetpub\Moin164\mywiki ）に移動してから、次のスクリプトを実行

      >python D:\Inetpub\Moin164\Lib\site-packages\MoinMoin\script\moin.py --config-dir=D:\Inetpub\Moin164\mywiki --wiki-url=server.domain.com/mywiki migration data

    • 次のような事をしていると、Tracebackがでる。
      • 古いMoinのフォルダを引数で渡していて、Tracebak。

      • 次は、data_dir "data" が無いか、アクセス権が正しくないとのこと。dataフォルダがあるフォルダ（今回だと、 D:\Inetpub\Moin164\mywiki ）に移動してから実行していなかった時に出た。

  3. 出力サンプル: 

    • D:\Inetpub\Moin164\mywiki>python D:\Inetpub\Moin164\Lib\site-packages\MoinMoin\s
cript\moin.py --config-dir=D:\Inetpub\Moin164\mywiki migration data
Calling migration script for data, base revision 1050700
Returned. New rev is 1050800.
Calling migration script for data, base revision 1050800
Returned. New rev is 1059999.
Calling migration script for data, base revision 1059999
You must first edit data\rename1.txt.
For editing it, please use an editor that is able to edit UTF-8 encoded files.
Carefully edit - the fields are separated by a | char, do not change this!
Entries in this file look like:
PAGE OLDPAGENAME NEWPAGENAME
FILE OLDPAGENAME OLDFILENAME NEWFILENAME
You may ONLY edit the rightmost field (the new name - in case you want to rename
 the page or file).

After you have finished editing, rename the file to data\rename2.txt and re-issu
e the moin migrate command.
Final mig script reached, migration is complete.

  4. ページ名・ファイル名のスペースを確認

    • 移行スクリプトの出力を確認。移行は、まだ完全に完了していません。

    • 移行スクリプトにより出力された data\rename1.txt に書かれた PAGE/FILE について、修正を行う必要があります。現在のMoinMoinでは、スペースとアンダースコアを同様とは見なさなくなり、移行スクリプトは スペースとアンダースコア を含む PAGE/FILE を data/rename1.txt にリストアップします。注意深くこのファイルを確認して、本来どうあってほしいかを考え、必要であれば修正をします。

    • （例： This_is_a_page_with_blanksは、This is a page with blanksであるべきでしょうし、example_image.pngファイルは、ファイル名なのでアンダースコアをそのままにしておくべきでしょう。）

    • data\rename1.txtは、|を区切りとして、次のフォーマットで記述されています。NEWPAGE/NEWFILENAMEの部分を、意図するように修正しましょう。|は、削除しないように。 

      PAGE OLDPAGENAME NEWPAGENAME
FILE OLDPAGENAME OLDFILENAME NEWFILENAME

  5. 再度、先ほど実行した移行スクリプトを実行する：

    • 修正が終わったら、 data\rename1.txt を data\rename2.txt にリネームして、再度コマンドを実行します。順次、ページ/添付ファイルのコンバートが実施されます。最後まで実施されれば終了。 
      ・・・
ページ/添付ファイルのコンバートログ
・・・
Returned. New rev is 1060000.
Calling migration script for data, base revision 1060000
Returned. New rev is 1060100.
Calling migration script for data, base revision 1060100
Returned. New rev is 1060200.
Calling migration script for data, base revision 1060200
Returned. New rev is 1060300.
Calling migration script for data, base revision 1060300
Returned. New rev is 1060400.
Calling migration script for data, base revision 1060400
Final mig script reached, migration is complete.

  6. Third-party macros?

    • もし Third-party マクロを使っている場合、それらのページが正常に動作しているかを確認する必要があります。場合によっては、そのページのマクロが新しいマクロの書式 (<<macro>>)になるように修正するか、新しいバージョンのマクロを取得する必要があります。新しいマクロを取得する場合は、 MoinMoinExtensions でアップデートをチェックします。

    • 今回 MacroMarket/PageComment2 を利用していました。古いままだとTraceBackが出てしまうので、1.6対応版をダウンロードしてMacroフォルダに配置して解消。

これでアップグレードが完了！

その他

MoinMoin: HidekazuHara/MigratingFromMoin15ToMoin16InJapanese (last edited 2009-08-13 00:37:51 by HidekazuHara)