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

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）の場合​

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)の順で再起動

参考事項​

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