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

무해화 연동 포트 변경

개요​

무해화 연동 서비스의 기본 포트는 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_UPLOAD server.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