Denbun POP版マニュアル

■PostgreSQL8.2対応版からPostgreSQL8.3対応版への移行（Windows）

本手順書は、Denbun POP V2.0P R4.3(PostgreSQL8.2対応版)からDenbun POP V2.0P R4.3(PostgreSQL8.3対応版)への移行手順を記述したものです。 V2.0P R4.3以前のバージョンをお使いのお客様はV2.0P R4.3にアップグレード後、本手順書に従ってください。
尚、既にPostgreSQL8.3対応のDenbun POP V2.0P R4.3をお使いの場合は本移行作業は必要ありません。

注意事項
本手順書は、Windows、Apache HTTP Server、PostgreSQL などの知識を有する技術者向けに記述されております。各製品の導入、構成、操作につきましては、該当する製品のマニュアルなどをご参照ください。
また、導入手順及びスクリーンショットなどは、Windows上での移行を前提としておりますため、お客様の環境とは異なる場合があります。

前提条件
後述の移行手順は以下のことを前提条件としています。
・移行元のサーバと移行先のサーバは同一のサーバであること。
・PostgreSQLにはDenbunデータベースのみ存在していること。
・DenbunおよびDenbunに必要なパッケージ(PostgreSQL,MeCab, MeCab用辞書など)を他のアプリケーションで使用していない(アンインストールすることができる。)
・移行作業時にDenbunに対してアクセスがない状態であること。(※スケジューラーが停止されている。)
・移行前のDenbunのバージョンがV2.0P R4.3(PostgreSQL8.2対応版)であること。
・移行後のDenbunのバージョンがV2.0P R4.3(PostgreSQL8.3対応版)であること。
・PostgreSQLの管理ユーザーがpostgresであること。
・PostgreSQL8.2のインストール先が「C:\Program Files\PostgreSQL\8.2」であること。
・PostgreSQL8.3のインストール先が「C:\Program Files\PostgreSQL\8.3」であること。
・Denbunのインストール先が「C:\Inetpub\Scripts\dnpwml」であること。
※Apacheの場合は「C:\Program Files\Apache Software Foundation\Apache2.2\cgi-bin\dnpwml」であること。
※本手順書ではDenbunのインストール先は「C:\Inetpub\Scripts\dnpwml」としています。

１．事前準備（バックアップの作成）

Windowsへの現在のログオンユーザーがAdministratorでない場合には、一旦ログオフし、「Administrator」ユーザーでログオンしなおしてください。

移行時に必要な以下のデータのバックアップを事前に行ってください。
ここではバックアップファイルは「C:\tmp」ディレクトリにバックアップします。
・データベースのバックアップ
・顔写真用ディレクトリのバックアップ

１－１．データベースのバックアップ
移行を行う際に必要である、現在利用されているデータベースのバックアップを取ります。
バックアップ対象のデータベースにて以下のコマンドを使用して、データベースのバックアップを行ってください。

# cd "C:\Program Files\PostgreSQL\8.2\bin"
# pg_dump.exe -U postgres -b -Fc dnpwmldb > C:\tmp\dnpwmldb82.pgdmp

１－２．顔写真用ディレクトリのバックアップ

管理ツール-ユーザー一覧-ユーザー情報の登録(変更)から登録できる顔写真をご利用されている場合は、顔写真用ディレクトリ「C:\Inetpub\Scripts\dnpwml\dnpwmlfile」のバックアップを行ってください。

２．Denbun PostgreSQL8.2対応版のアンインストール

Denbun PostgreSQL8.2対応版のアンインストールはこちらを参考にアンインストールを行ってください。

Denbunのアンインストールを行ってもインストール時に作成したユーザー、作成されたデータは残ります。「C:\Inetpub\Scripts\dnpwml」ディレクトリを削除してください。
PostgreSQLが入った状態ではDenbun POP PostgreSQL8.3対応版のインストールは行えないため、PostgreSQLも同時にアンインストールしてください。
PostgreSQL8.2のアンインストールを行っても、作成されたデータは削除されません。不要な場合は削除してください。(デフォルトでは「C:\Program Files\PostgreSQL\8.2\data」の下にデータが作成されます。)

３．Denbun POP PostgreSQL8.3対応版のインストール: PostgreSQL8.3対応のDenbun POP V2.0P R4.3をインストールしてください。
インストール方法につきましてはこちらを参照してください。

PostgreSQL8.3対応のDenbun POP V2.0P R4.3を「ダウンロード」

４．データの移行

１．でバックアップしたデータをDenbun POP PostgreSQL8.3対応版に移行します。
事前に、データをリストアする際に必要となるファイル(dnpwmlshifttoolpg83.zip)をサーバにアップロードし、「C:\tmp」ディレクトリに解凍してください。解凍すると「dnpwmlshifttool」ディレクトリが作成されます。

４－１．データベースの移行

１－１．で作成したデータベースのバックアップファイルをリストアする前に、以下のコマンドを実行してください。

# cd "C:\Program Files\PostgreSQL\8.3\bin"
# psql.exe -d dnpwmldb -U dnpwml < C:\tmp\dnpwmlshifttool\pre.sql
# Password for user dnpwml:

次に１－１．で作成したデータベースのバックアップファイルのリストアを行います。

# pg_restore.exe -a -U postgres -Fc -d dnpwmldb < C:\tmp\dnpwmldb82.pgdmp

※リストア時に下記のエラーが表示されますが、PostgreSQL8.2対応版で使用していたtsearch2のテーブルがPostgreSQL8.3対応版ではなくなっているために表示されるエラーなので無視していただいてかまいません。

pg_restore: [archiver (db)] Error while PROCESSING TOC:
pg_restore: [archiver (db)] Error from TOC entry 2119; 0 180605 TABLE DATA pg_ts_cfg postgres
pg_restore: [archiver (db)] could not execute query: ERROR: relation "pg_ts_cfg" does not exist
Command was:
COPY pg_ts_cfg (ts_name, prs_name, locale) FROM stdin;
pg_restore: [archiver (db)] Error from TOC entry 2120; 0 180610 TABLE DATA pg_ts_cfgmap postgres
pg_restore: [archiver (db)] could not execute query: ERROR: relation "pg_ts_cfgmap" does not exist
Command was: COPY pg_ts_cfgmap (ts_name, tok_alias, dict_name) FROM stdin;
pg_restore: [archiver (db)] Error from TOC entry 2121; 0 180615 TABLE DATA pg_ts_dict postgres
pg_restore: [archiver (db)] could not execute query: ERROR: column "dict_name"
of relation "pg_ts_dict" does not exist
Command was: COPY pg_ts_dict (dict_name, dict_init, dict_initoption, dict_lexize, dict_comment) FROM stdin;
pg_restore: [archiver (db)] Error from TOC entry 2122; 0 180620 TABLE DATA pg_ts_parser postgres
pg_restore: [archiver (db)] could not execute query: ERROR: column "prs_name" of relation "pg_ts_parser" does not exist
Command was: COPY pg_ts_parser (prs_name, prs_start, prs_nexttoken, prs_end, prs_headline, prs_lextype, prs_comment) FROM stdin;
WARNING: errors ignored on restore: 4

リストア後に以下のコマンドを実行してください。

# psql.exe -d dnpwmldb -U dnpwml < C:\tmp\dnpwmlshifttool\after.sql
# Password for user dnpwml:

最後に不要なファイルの削除を行ってください。
・pre.sql
・after.sql
・dnpwml82.pgdmp

４－２．顔写真用ディレクトリの移動

１－２．で作成した顔写真用ディレクトリを「C:\Inetpub\Scripts\dnpwml」ディレクトリに移動します。

５．完了: 以上でDenbun POP版PostgreSQL8.2対応版からDenbun POP版PostgreSQL8.3対応版への移行作業は完了です。