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

無害化連動ポート変更

概要​

無害化連携サービスの基本ポートは8060です。顧客の環境に応じてポートの変更が必要な場合は、以下の手順に従って設定します。

基本情報​

項目値
基本ポート8060
変更例8081(環境によって異なる)
対象サービスApache Tomcat 10.1 CDR_SERVICE_UPLOAD
サービス設定ファイルのパスE:\softcamp\sanitrans\sanitrans\config\cdrbroker.properties
Tomcat 設定ファイルのパスE:\App\Tomcat_10.1_CDR_SERVICE_UPLOAD\conf\server.xml

ポート変更手順​

1ステップ: Apache Tomcat 10.1 CDR_SERVICE_UPLOADserver.xml修正（必須）​

修正ファイルの位置:E:\App\Tomcat_10.1_CDR_SERVICE_UPLOAD\conf\server.xml

下Connectorのport値を8060で8081に変更します。

<Connector port="8081" protocol="HTTP/1.1"
           connectionTimeout="20000"
           URIEncoding="UTF-8" />

ステップ2: サービス設定ファイルの修正​

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

変更項目​

以下の設定値を変更します。

# 무해화 연동 브로커 포트 변경
cdrbroker.port=8081

ステップ3: サービスの再起動​

設定ファイルを変更した後、次の手順でサービスを再起動します。

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

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"
Restart-Service "SDMonitoring_Service_API"

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

設定検証​

正常動作確認​

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

注意事項​

設定を変更しない場合に発生する問題​

ポートを別の値（例：8081）に変更しましたがcdrbroker.propertiesを変更しないと、以下の問題が発生します。

1. モニタリングサービス接続失敗​

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

エラーログ:

2026-02-09 11:01:04.891 ERROR 820 --- [main] c.s.m.c.SchedulingPropertieConfiguration : I/O error on GET request for "http://127.0.0.1:8060/v6/updateServerId/A64B2A42-99AF-CF00-29C1-366B9CCFE002": Connection refused: connect; nested exception is java.net.ConnectException: Connection refused: connect

2. キュー処理失敗 (重要)​

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

エラーログ:

2026-02-09 11:29:18.470  INFO [  http-nio-8090-exec-3] c.s.s.cloud.broker.http.WebAPIClient     : [GET] SEND start uri=http://127.0.0.1:8060/v6/queue/proc (connectTimeout=5000ms, readTimeout=15000ms) [config: defaultConnect=5000ms, defaultRead=15000ms, maxConnTotal=32, maxConnPerRoute=16]
2026-02-09 11:29:19.004  INFO [  http-nio-8090-exec-3] c.s.s.cloud.broker.http.WebAPIClient     : [GET][Time taken : 534 ms] executeRequest : http://127.0.0.1:8060/v6/queue/proc
2026-02-09 11:29:19.004 ERROR [  http-nio-8090-exec-3] c.s.s.c.b.s.f.TaskNotificationService    : triggerNextQueuedTask exception {}
org.apache.http.conn.HttpHostConnectException: Connect to 127.0.0.1:8060 [/127.0.0.1] failed: Connection refused: no further information
	at org.apache.http.impl.conn.DefaultHttpClientConnectionOperator.connect(DefaultHttpClientConnectionOperator.java:156)

影響:

  • 無害化連携作業キューが処理されていません
  • 作業が待機状態で停滞しています

原因:

  • 実際のサービスは8081ポートで動作中です。
  • cdrbroker.propertiesは基本ポート8060に設定されています
  • モニタリングおよびAPIサービスが8060ポートへの接続を試みましたが、接続に失敗しました。

解決方法:

  1. E:\softcamp\sanitrans\sanitrans\config\cdrbroker.propertiesファイルを開く

  2. ポート設定の変更

    cdrbroker.port=8081

  3. 関連サービスの再起動

    • Apache Tomcat 10.1 CDR_SERVICE_UPLOAD
    • Apache Tomcat 10.1 CDR_SERVICE_API
    • Apache Tomcat 9.0 CDR_WEBCONSOLE
    • SDMonitoring_Service_API

  4. monitoring.logでエラーが解消されるか確認

参考事項​

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

ポート使用確認方法​

# PowerShell에서 포트 사용 여부 확인
netstat -ano | findstr :8081