メインコンテンツまでスキップ

PostgreSQL ポート変更

概要​

この文書は無害化製品で使用する**PostgreSQL 基本ポート(5432)**顧客の方針に合わせて__PH_0__を変更する方法を案内します。

PostgreSQLのポートを変更すると、DBに接続する影響を受けるサービスの設定ファイルにも変更されたポートが反映される必要があります。

基本情報​

項目値
基本ポート5432
変更例15432
対象サービスPostgreSQL
影響サービスApache Tomcat 10.1 CDR_SERVICE_UPLOAD
Apache Tomcat 10.1 CDR_SERVICE_API
Apache Tomcat 9.0 CDR_WEBCONSOLE
製品基本DB設定ファイルのパスE:\softcamp\DB\PostgreSQL\data\postgresql.conf
サービス設定ファイルのパスE:\softcamp\sanitrans\sanitrans\config\cdrbroker.properties
E:\softcamp\sanitrans\sanitrans\config\WebConsoleApi.properties

ポート変更手順​

1段階: PostgreSQL 設定ファイルの修正​

設定ファイルのパス:E:\softcamp\DB\PostgreSQL\data\postgresql.conf

DBが別のサーバー（Linux）の場合​

DBサービスが別途Linuxサーバーに構築された場合でも同様に**インストールパス(データディレクトリ)以下のpostgresql.conf**を修正すれば大丈夫です。

// 一般的に postgresql.conf は $PGDATA（データディレクトリ）の下に位置します。
// 例: /var/lib/pgsql/data/postgresql.conf または /var/lib/postgresql/<version>/main/postgresql.conf

変更項目​

60行の近くの次の項目を変更します。

# PostgreSQL 서버 포트
port = 5432

変更例:

# PostgreSQL 서버 포트
port = 15432

2段階: PostgreSQLサービスの再起動​

設定ファイルを保存した後、PostgreSQLサービスを再起動します。

  • Windows サービス マネージャー(services.msc)でPostgreSQLサービスを再起動

または（環境に応じて）PowerShellで再起動できます。

# PowerShell 관리자 권한으로 실행
# NOTE: 서비스 이름은 설치 환경에 따라 다를 수 있습니다.
Get-Service | Where-Object { $_.DisplayName -like "*PostgreSQL*" }

# 예시(서비스 이름 확인 후 사용)
# Restart-Service "postgresql-x64-16"
// PostgreSQL ポートの変更は再起動前には反映されません。

DBが別のサーバー（Linux）の場合​

リナックスサーバーではpostgresql.conf修正後、PostgreSQLサービスを再起動します（ディストリビューション/インストール方式によってサービス名が異なる場合があります）。

# systemd 기반(예시) - 환경에 맞게 사용
# sudo systemctl restart postgresql
# sudo systemctl restart postgresql-16
# sudo systemctl restart postgresql@16-main

# 상태 확인
# sudo systemctl status postgresql

3段階: 影響サービス設定ファイル修正​

PostgreSQLのポートを変更すると、DBに接続するサービス設定にも同じポートが反映される必要があります。

3-1) CDR_SERVICE_UPLOAD / CDR_SERVICE_API: cdrbroker.properties​

設定ファイルのパス:E:\softcamp\sanitrans\sanitrans\config\cdrbroker.properties

postgresql.portがポート設定です。

  • postgresql.portが存在する場合は値のみを変更
  • postgresql.portが**新規に追加する場合は、存在しない場合。**後に変更したポートを入力

例:

# PostgreSQL 포트 설정
postgresql.port=15432

3-2) CDR_WEBCONSOLE: WebConsoleApi.properties​

設定ファイルのパス:E:\softcamp\sanitrans\sanitrans\config\WebConsoleApi.properties

dbserver.portがポート設定です。

  • dbserver.portが存在する場合は値のみを変更
  • dbserver.portが**新規に追加する場合は、存在しない場合。**後に変更したポートを入力

例:

# PostgreSQL 포트 설정
dbserver.port=15432

4段階: 影響サービス再起動​

設定ファイルを保存した後、次の順序でサービスを再起動します:

  1. Apache Tomcat 10.1 CDR_SERVICE_UPLOAD
  2. Apache Tomcat 10.1 CDR_SERVICE_API
  3. Apache Tomcat 9.0 CDR_WEBCONSOLE

Windows サービス 再起動 方法​

# PowerShell 관리자 권한으로 실행
Restart-Service "Apache Tomcat 10.1 CDR_SERVICE_UPLOAD"
Restart-Service "Apache Tomcat 10.1 CDR_SERVICE_API"
Restart-Service "Apache Tomcat 9.0 CDR_WEBCONSOLE"

または Windows サービス マネージャー(services.msc)で順次再起動します。

設定検証​

正常動作確認​

  1. すべてのサービスが正常に開始されたか確認
  2. 無害化テストの実施
  3. モニタリングログの確認

ポートリスニング確認（選択）​

# 변경한 포트(예: 15432) 리스닝 여부 확인
netstat -ano | findstr :15432

注意事項​

設定が反映されていない時の症状（重要）​

PostgreSQL ポートを変更したが、サービス設定ファイル(cdrbroker.properties, WebConsoleApi.properties)にポートが反映されない場合、 次のようなDB接続失敗ログが発生する可能性があります。

ログ確認パス: E:\log\cdrApiService\cdrApiService.log

エラーログの例:

2026-02-11 14:46:47.252 ERROR [                  main] com.zaxxer.hikari.pool.HikariPool        : HikariPool-1 - Exception during pool initialization.
org.postgresql.util.PSQLException: Connection to 127.0.0.1:5432 refused. Check that the hostname and port are correct and that the postmaster is accepting TCP/IP connections.

原因:

  • PostgreSQLは変更されたポートで動作中ですが
  • 影響サービスがまだ基本ポート5432に接続を試みましたが、接続が拒否されました。

解決方法:

  1. cdrbroker.propertiesのpostgresql.portが変更されたポートに設定されているか確認
  2. WebConsoleApi.propertiesのdbserver.portが変更されたポートに設定されているか確認
  3. 影響サービス(UPLOAD → API → WEBCONSOLE)の順で再起動

参考事項​

  • ポート変更作業はシステム負荷が少ない時間帯に実施することを推奨します。
  • 変更前 現在の設定バックアップ推奨
  • ファイアウォール設定がある場合、新しいポートに対するファイアウォールルールの追加が必要です
  • 他のアプリケーションがそのポートを使用していないか事前に確認