> For the complete documentation index, see [llms.txt](https://manuals.i-reporter.jp/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manuals.i-reporter.jp/server-construction-maintenance/maintenance/postgresql-upgrade-instructions.md).

# PostgreSQL14へのアップグレード手順書

{% hint style="warning" %}
作業前に必ずバックアップを実施してください。
{% endhint %}

<div align="left"><figure><img src="https://content.gitbook.com/content/9GB3gcd9HVYUxfpndv5d/blobs/WKV1xMHU7HlYT58IJHpe/image.png" alt="" width="563"><figcaption></figcaption></figure></div>

## **必要なもの**

* 本手順
* PostgreSQLアップグレードモジュール

{% hint style="success" %}
【PostgreSQLアップグレードモジュール について】

下記「モジュールダウンロード（PostgreSQL\*\*用）」より、アップグレード先であるPostgreSQLバージョンのモジュールをダウンロードします。

解凍して展開されたToolsフォルダを 「C:\ConMas\Tools」 に上書きしてください。
{% endhint %}

{% hint style="info" %}

* [モジュールダウンロード（PostgreSQL14用）](https://i-reporter-support.com/i-Reporter/ir_manuals/jp/manager/Tools14.zip)
* [モジュールダウンロード（PostgreSQL16用）](https://i-reporter-support.com/i-Reporter/ir_manuals/jp/manager/Tools16.zip)
* [モジュールダウンロード（PostgreSQL18用）](https://i-reporter-support.com/i-Reporter/ir_manuals/jp/manager/Tools18.zip)
  {% endhint %}

## **条件**

* PostgreSQL11で使用されている容量の倍以上の空き容量が必要。

  <div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p>別ディスク推奨。</p></div>

* バックアップダンプを出力できる領域があること。

  <div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p>出力先は外付けHDDでも可能です。</p></div>

* i-Repo Serverバージョンはアップグレード先PostgreSQLのメジャーバージョンに対応したバージョン以上であること。

PostgreSQLに対応しているi-Repo Server(ConMas Server)のバージョンは以下の通りです。

* PostgreSQL14 : i-Repo Server(ConMas Server) 8.1.23040 以降
* PostgreSQL16 : i-Repo Server(ConMas Server) 8.1.24070 以降
* PostgreSQL18 : i-Repo Server(ConMas Server) 8.2.26020 以降

{% hint style="warning" %}
【注意】

同一サーバー上にPostgreSQL14をインストールします。\
複数のPostgreSQLデータベースが存在する状態となるため、ポート番号に注意して作業を行ってください。
{% endhint %}

## **アップグレード手順**

**【手順概要】**

1. IIS停止。
2. PostgreSQL11のサービス停止。
3. 既存のサーバーにPostgreSQL14をインストール。
4. PostgreSQL14のサービス停止、11のサービス開始。
5. PostgreSQL11のバックアップダンプを取得する。
6. PostgreSQL11のサービスを停止し、PostgreSQL14のサービスを開始。
7. PostgreSQL14にデーターベースirepodbを生成する。
8. PostgreSQL14のデーターベースirepodbに5．で取得したダンプをリストアする。
9. Devertプログラムを入れ替える。
10. アプリケーション構成ファイルの変更。

**【手順】**

1. IISを停止します。\
   ※下記画像は WindowsServer2012R2 の例です。

   <div align="left"><figure><img src="https://content.gitbook.com/content/9GB3gcd9HVYUxfpndv5d/blobs/0m2eTNqHor7JE4r8j9A5/image.png" alt=""><figcaption></figcaption></figure></div>

   <br>
2. PostgreSQL11のサービスを停止します。

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>これを実施しないと、PostgreSQL14の既定ポート番号である5432ポートが選択できません。</p></div>

   \ <br>
3. 以下のファイルを実行し、既存のサーバーにPostgreSQL14をインストールします。\
   \
   C:\ConMas\Tools\db\postgresql-14.7-2-windows-x64.exe<br>

   <div align="left"><figure><img src="https://content.gitbook.com/content/9GB3gcd9HVYUxfpndv5d/blobs/HbQxTNmZyMslv0NNcxu3/image.png" alt="" width="335"><figcaption></figcaption></figure></div>

   \
   インストールディレクトリを選択します。特別な理由がない限り以下とします。\
   C:\Program Files\PostgreSQL\14

   <div align="left"><figure><img src="https://content.gitbook.com/content/9GB3gcd9HVYUxfpndv5d/blobs/yrbbjpLH3x9Q6Emu6jvi/image.png" alt="" width="404"><figcaption></figcaption></figure></div>

   <div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p>ここはPostgreSQL14のプログラムファイルが配置されるのみで、データーの格納場所ではありません。</p></div>

   \
   \
   「stack Buider」以外はチェックします。

   <div align="left"><figure><img src="https://content.gitbook.com/content/9GB3gcd9HVYUxfpndv5d/blobs/t7p2Z4UGNZIo9XJ0tTpD/image.png" alt="" width="402"><figcaption></figcaption></figure></div>

   <div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p>pgAdminはPostgreSQLインストーラに付属の、データベースの内容を確認・操作するためのアプリケーションです。 以下の点にご注意ください。</p><ul><li>システムの稼働には影響しません。必要ない場合はインストール不要です。</li><li>弊社サポート対象外です。</li></ul></div>

   \
   \
   データー格納先のディレクトリとなります。

   <div align="left"><figure><img src="https://content.gitbook.com/content/9GB3gcd9HVYUxfpndv5d/blobs/0dZH5mZZDpVrE3S6RxlX/image.png" alt="" width="400"><figcaption></figcaption></figure></div>

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>既存のPostgreSQLディレクトリには11版のデーターが格納されていますので、別の場所を指定します。</p><p>なお、データの格納場所のため容量が十分な場所を指定ししてください。</p></div>

   \
   \
   11の時と同じパスワードを指定します。

   <div align="left"><figure><img src="https://content.gitbook.com/content/9GB3gcd9HVYUxfpndv5d/blobs/kN1EO1yc2pJrai33TTFo/image.png" alt="" width="400"><figcaption></figcaption></figure></div>

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>変更した場合、アプリケーション構成ファイル内の設定を変更します。</p></div>

   \
   \
   5432ポートを指定します。

   <div align="left"><figure><img src="https://content.gitbook.com/content/9GB3gcd9HVYUxfpndv5d/blobs/1vkvdrIdnNmfGfg8G11C/image.png" alt="" width="400"><figcaption></figcaption></figure></div>

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>変更する場合はアプリケーション構成ファイル内の設定を変更します。</p></div>

   \
   \
   「Advanced Options」にて、ローケルを「C」 に変更してください。

   <div align="left"><figure><img src="https://content.gitbook.com/content/9GB3gcd9HVYUxfpndv5d/blobs/fTuywp9aI06FW24gwKku/image.png" alt="" width="400"><figcaption></figcaption></figure></div>

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>ドライブの指定ではなくロケールの指定になります。</p></div>

   <br>

   <div align="left"><figure><img src="https://content.gitbook.com/content/9GB3gcd9HVYUxfpndv5d/blobs/RC8GwlvyKai3Ntx8TtDN/image.png" alt="" width="401"><figcaption></figcaption></figure></div>

   <div align="left"><figure><img src="https://content.gitbook.com/content/9GB3gcd9HVYUxfpndv5d/blobs/FrLBQ2cbWIeaMgwaSRHc/image.png" alt="" width="403"><figcaption></figcaption></figure></div>

   <div align="left"><figure><img src="https://content.gitbook.com/content/9GB3gcd9HVYUxfpndv5d/blobs/sCARcTBTemCXjpN6t2vA/image.png" alt="" width="403"><figcaption></figcaption></figure></div>

   <div align="left"><figure><img src="https://content.gitbook.com/content/9GB3gcd9HVYUxfpndv5d/blobs/WWZIOWv5eeVkvUvBESGA/image.png" alt="" width="403"><figcaption></figcaption></figure></div>

   <br>
4. PostgreSQL14のサービスを停止し、PostgreSQL11のサービスを開始します。\ <br>
5. PostgreSQL14のpg\_dumpを使用して、PostgreSQL11データーベースのバックアップダンプを取得します。\
   以下バッチを使用します。<br>

   \
   chcp 65001

   SET PGPASSWORD=cimtops

   SET PGPATH=C:\Program Files\PostgreSQL\14\bin\pg\_dump

   SET DUMPPATH=D:\db\temp\irepodb.dump

   SET LOGPATH=D:\db\temp\dump.log

   SET PORT=5432\
   \
   "%PGPATH%" -Fc -Z5 -c -h localhost -p %PORT% -U postgres -d irepodb -f %DUMPPATH% > %LOGPATH%\
   echo errorlevel=%ERRORLEVEL% >> %LOGPATH%<br>

   <table><thead><tr><th width="181">環境変数</th><th>設定値</th></tr></thead><tbody><tr><td>PGPASSWORD</td><td>PostgreSQL11のパスワード</td></tr><tr><td>PGPATH</td><td>"<strong>PostgreSQL14</strong>"pg_dump.exeのフルパス。</td></tr><tr><td>DUMPPATH</td><td>ダンプファイルを出力するフルパス</td></tr><tr><td>LOGPATH</td><td>実行ログを出力する場所をフルパスで入力</td></tr><tr><td>PORT</td><td><strong>PostgreSQL11のポート番号（既定では5432）</strong></td></tr></tbody></table>

   バッチを実行します。\
   ログ内容がErrorLevel=0であれば成功です。\ <br>
6. PostgreSQL11のサービスを停止し、PostgreSQL14のサービスを開始します。\ <br>
7. PostgreSQL14データーベース生成します。\
   以下バッチを使用します。

   <div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p>1.createdb.batファイルをご利用ください。</p></div>

   \
   chcp 65001

   SET PGPASSWORD=cimtops

   SET NEWDATABASE=irepodb

   SET PGPATH=C:\Program Files\PostgreSQL\14\bin\createdb

   SET LOGPATH=C:\xxxxx\1.createdb.log

   SET PORT=5432<br>

   "%PGPATH%" -h localhost -p %PORT% -U postgres %NEWDATABASE% 2> %LOGPATH%

   echo CreateDb ErrorLevel=%ERRORLEVEL% >> %LOGPATH%<br>

   <table><thead><tr><th width="172">環境変数</th><th>設定値</th></tr></thead><tbody><tr><td>PGPASSWORD</td><td>PostgreSQL14のパスワード</td></tr><tr><td>NEWDATABASE</td><td>irepodb</td></tr><tr><td>PGPATH</td><td>createdb.exeのフルパス。 <br>※Fig.2-2で設定したパスの先にあります。変更していない場合はそのまま</td></tr><tr><td>LOGPATH</td><td>実行ログを出力する場所をフルパスで入力</td></tr><tr><td>PORT</td><td><strong>PostgreSQL14のポート番号</strong></td></tr></tbody></table>

   バッチを実行します。\
   実行するとLOGPATHで設定したファイルができるのでメモ帳で成否を確認します。\
   ログ内容がErrorLevel=0であれば成功です。\ <br>
8. PostgreSQL14データーベースへのリストアを行います。\
   以下内容でバッチファイルを作成し、環境変数を環境に合わせて変更します。<br>

   chcp 65001

   SET PGPASSWORD=cimtops

   SET PGPATH=C:\Program Files\PostgreSQL\14\bin\pg\_restore

   SET DUMPPATH=C:\xxxxx\irepodb.dump

   SET LOGPATH=C:\xxxxx\dump.log

   SET PORT=5432<br>

   "%PGPATH%" -h localhost -U postgres -p %port% -d irepodb %DUMPPATH% > %LOGPATH% 2>&1

   echo Restore ErrorLevel=%ERRORLEVEL% >> %LOGPATH%

   <table><thead><tr><th width="168">環境変数</th><th>設定値</th></tr></thead><tbody><tr><td>PGPASSWORD</td><td><strong>PostgreSQL14</strong>のパスワード</td></tr><tr><td>PGPATH</td><td>"<strong>PostgreSQL14</strong>"pg_restore.exeのフルパス。</td></tr><tr><td>DUMPPATH</td><td>リストアするダンプファイルのフルパス</td></tr><tr><td>LOGPATH</td><td>実行ログを出力する場所をフルパスで入力</td></tr><tr><td>PORT</td><td><strong>PostgreSQL14のポート番号</strong></td></tr></tbody></table>

   バッチを実行します。\
   実行するとLOGPATHで設定したファイルができるのでメモ帳で成否を確認します。\
   ログ内容がErrorLevel=0であれば成功です。

   <div data-gb-custom-block data-tag="hint" data-style="success" class="hint hint-success"><p>ログの一番下にあります。</p></div>

   &#x20;\ <br>
9. 以下のファイルを実行し、dotConnectをインストールします。\
   **事前に、以前のバージョンのものをアンインストールします。**&#x43;:\ConMas\Tools\ap\dcpostgresqlfree7.24.2066.exe<br>

   <div align="left"><figure><img src="https://content.gitbook.com/content/9GB3gcd9HVYUxfpndv5d/blobs/C4MBM217j0xpFmFfEVXc/image.png" alt="" width="503"><figcaption><p><br></p></figcaption></figure></div>

   <div align="left"><figure><img src="https://content.gitbook.com/content/9GB3gcd9HVYUxfpndv5d/blobs/DiVPHsIwVR8RRH97Zdhe/image.png" alt="" width="510"><figcaption></figcaption></figure></div>

   <div align="left"><figure><img src="https://content.gitbook.com/content/9GB3gcd9HVYUxfpndv5d/blobs/hCj1TjzIsMqJ5zKIOaBQ/image.png" alt="" width="478"><figcaption><p><br></p></figcaption></figure></div>

   SampleとHelpはチェックを外しても構いません。

   <div align="left"><figure><img src="https://content.gitbook.com/content/9GB3gcd9HVYUxfpndv5d/blobs/nGz7vZgXaEIttP14K7VE/image.png" alt="" width="479"><figcaption></figcaption></figure></div>

   <div align="left"><figure><img src="https://content.gitbook.com/content/9GB3gcd9HVYUxfpndv5d/blobs/LjlWhazxrAUyD34Mc6wZ/image.png" alt="" width="475"><figcaption></figcaption></figure></div>

   <div align="left"><figure><img src="https://content.gitbook.com/content/9GB3gcd9HVYUxfpndv5d/blobs/T8qlfO6G65o4vX3ci21R/image.png" alt="" width="482"><figcaption></figcaption></figure></div>

   <div align="left"><figure><img src="https://content.gitbook.com/content/9GB3gcd9HVYUxfpndv5d/blobs/6mKfz0j2DaQHXYXmuWVP/image.png" alt="" width="476"><figcaption></figcaption></figure></div>

   <div align="left"><figure><img src="https://content.gitbook.com/content/9GB3gcd9HVYUxfpndv5d/blobs/wQUW5iWg8kMQjWvZ8zc7/image.png" alt="" width="482"><figcaption></figcaption></figure></div>

   <br>
10. アプリケーション構成ファイルの変更を行います。

    <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>PostgreSQL14のポート番号を<strong>5432以外</strong>に変更した場合のみ実施します。</p></div>

    \
    ConMasAPI,ConMasManager,ConMasWebのweb.configを修正します。<br>

    <div align="left"><figure><img src="https://content.gitbook.com/content/9GB3gcd9HVYUxfpndv5d/blobs/9iuNXLAn658HG6ufvKRz/image.png" alt=""><figcaption></figcaption></figure></div>

    Port番号をPostgreSQL14の番号に切り替えます。

{% hint style="success" %}
【補足】

上記すべての作業を実施することで、PostgreSQL14アップグレードは完了です。

なお、過去のPostgreSQL11のプログラム、データーはそのまま残ります。\
破棄する場合は、以下手順を実施してください。

１．プログラムと機能より、PostgreSQL11をアンインストール\
２．PostgreSQL11を利用していたデーター格納ディレクトリを削除

※PostgreSQL14で動作確認、データー確認したのち、実施してください。
{% endhint %}
