1. 사전 준비

1.1 최소 사양

1. Java 8 이상
2. AUD플랫폼 7.0.500.20260226-11 이상
   1. AUD플랫폼 설치 버전이 과거 버전일 경우 아래 [5. 문제 해결 가이드]를 참고합니다.

1.2 방화벽 포트 확인

1. WAS → AUD Conflux 서버
   1. WAS(AUD플랫폼 서버)에서 AUD Conflux 서버로 통신이 가능해야 합니다.
   2. WAS 이중화 환경의 경우, WAS 간 양방향 통신이 가능해야 합니다.
      ※ [AUD Platform 서버 간 통신 포트] 참고

1.3 파일 준비

1. 배포 파일을 {AUD플랫폼 CONTEXT PATH}\WEB-INF\_AUD_CONFLUX_ 하위에 붙여넣기 합니다.
2. _AUD_CONFLUX_ 폴더가 없으면 신규로 생성합니다.
   1. Windows 서버
      
   2. Linux 서버
      

2. 설정 파일 수정

2.1 공통

1. application.json_sample 파일의 확장자를 json으로 변경합니다.
2. [4. AUD Conflux 옵션]을 참고하여 옵션을 설정합니다.

2.2 유의 사항 (Windows 서버)

1. Log > LogPath : 로그 경로
   예) "C:\\AUDPlatform_7\\logs\\matrix\\logs"

   코드 블럭
   language js
   "Log": { "LogPath": "C:\\AUDPlatform_7\\logs\\matrix\\logs", "LogFileSize": 10, "LogBackupCount": 10, "LogFileName": "aud-conflux", "LogConsoleOut": false }

   
   

2. Folder > ReportFolder : AUD-Platform report경로 
   예) "C:\\AUDPlatform_7\\reports"

   코드 블럭
   language js
   "Folder": { "ReportFolder": "C:\\AUDPlatform_7\\reports", "TempFolder": "", "LinkFolder":[ {"LinkName":"","Path":""} ] }

   
   

3. Python > ServerList > Modules > PythonPath(Code=DEFAULT_MODULE) : 기본 설치된 파이썬 모듈 경로 py310_win_deploy.bat를 실행하여 생성된 파일 경로를 입력합니다.
   예) "C:\\AUDPlatform_7\\matrix\\WEB-INF\\_AUD_CONFLUX_\\py310_win\\python.exe"

   코드 블럭
   language js
   "Python": { "ExecuteTimeoutMin" : 60, "ServerList" : [ { "Code" : "PYTHON_SERVER_1", "Name" : "PYTHON", "Ip" : "127.0.0.1", "Port" : 0, "Modules" : [ { "Code": "DEFAULT_MODULE", "Name": "v3.10_MINICONDA", "PythonPath" : "C:\\AUDPlatform_7\\matrix\\WEB-INF\\_AUD_CONFLUX_\\py310_win\\python.exe" } ] } ] }

   
   

2.3 유의 사항 (Linux 서버)

1. Log > LogPath : 로그 경로
   예) "/AUDPlatform_7/logs/matrix/logs"

   코드 블럭
   language js
   "Log": { "LogPath": "/AUDPlatform_7/logs/matrix/logs", "LogFileSize": 10, "LogBackupCount": 10, "LogFileName": "aud-conflux", "LogConsoleOut": false }

   
   

2. Folder > ReportFolder : AUD-Platform report경로 
   예) "/AUDPlatform_7/reports"

   코드 블럭
   language js
   "Folder": { "ReportFolder": "/AUDPlatform_7/reports", "TempFolder": "", "LinkFolder":[ {"LinkName":"","Path":""} ] }

   
   

3. Python > ServerList > Modules > PythonPath(Code=DEFAULT_MODULE) : 기본설치된 파이썬 모듈 경로 py310_linux_deploy.sh를 실행하여 생성된 파일 경로를 입력합니다.
   예) "/AUDPlatform_7/matrix/WEB-INF/_AUD_CONFLUX_/py310_linux/python"

   코드 블럭
   language js
   "Python": { "ExecuteTimeoutMin" : 60, "ServerList" : [ { "Code" : "PYTHON_SERVER_1", "Name" : "PYTHON", "Ip" : "127.0.0.1", "Port" : 0, "Modules" : [ { "Code": "DEFAULT_MODULE", "Name": "v3.10_MINICONDA", "PythonPath" : "/AUDPlatform_7/matrix/WEB-INF/_AUD_CONFLUX_/py310_linux/bin/python3.10" } ] } ] }

   
   

3. 기동/종료 파일 수정

3.1 Windows 서버

1. 서버 기동 및 종료 파일: startup.bat_sample, shutdown.bat_sample
2. 서버 기동/종료 파일의 확장자를 bat로 변경합니다.
3. py310_win_deploy.bat 를 실행하여 Windows용 파이썬 실행 모듈을 설치합니다.
4. startup.bat 파일을 열어 JAVA_HOME을 설정합니다.
   
   1. echo %JAVA_HOME% 으로 설정된 값이 있는지 확인합니다.
   2. 설정된 값이 없을 경우, [제어판 > 고급 시스템 속성 > 환경 변수]에 설정하거나, 아래 부분에 사용할 JAVA_HOME 값을 입력 후 주석을 해제합니다.
      예) C:\AUDPlatform_7\apps\openjdk
      

3.2 Linux 서버

1. 서버 기동 및 종료 파일: startup.sh_sample, shutdown.sh_sample
2. 서버 기동/종료 파일의 확장자를 sh로 변경합니다.
3. startup.sh 파일을 열어 JAVA_HOME을 설정합니다.
   1. echo $JAVA_HOME 으로 설정된 값이 있는지 확인합니다.
   2. 설정된 값이 없을 경우, 로그인한 계정의 .bash_profile혹은 .profile에 설정하거나, 아래 부분에 사용할 JAVA_HOME 값을 입력 후 주석을 해제합니다.
      예) /AUDPlatform_7/apps/openjdk
      

4. 서버 기동/종료

4.1 Windows 서버

1. 기동: _AUD_CONFLUX_SCHEDULER_에서 startup.bat를 실행합니다.
2. 종료: _AUD_CONFLUX_SCHEDULER_에서 shutdown.bat를 실행합니다.

4.2 Linux 서버

1. 기동: _AUD_CONFLUX_SCHEDULER_에서 startup.sh를 실행합니다.
2. 종료: _AUD_CONFLUX_SCHEDULER_에서 shutdown.sh를 실행합니다.

5. 문제 해결 가이드

1. 패치 후 주의 사항 
   1. WAS 및 AUD Conflux 서버를 필수로 재기동합니다.
2. 문제 해결 가이드
   1. AUD-Platform 7.0.500.20260226-11 이하 버전일 경우
      
      1. [Admin > 시스템 운영관리 > Repository 테이블 점검] > 옵션 값 점검> [실행] 클릭 : AUD Conflux에 필요한 옵션 값을 넣습니다. (AUD-CONFLUX 데이터베이스 포함)
      2. [Admin > 자원관리 > 데이터베이스 관리] > AUD-CONFLUX : 데이터 베이스가 생성되어 있는지 확인합니다.
      3. matrix.properties 에서 matrix.uploadfilter 에 cfx,cfxz 두개 파일이 명시되어있는지 확인 후 없으면 추가합니다.
         예) matrix.uploadfilter="bmp,jpg,jpeg,gif,png,hwp,hml,cell,doc,docx,ppt,pptx,xls,xlsx,xlsb,xlam,txt,text,csv,pdf,zip,jar,cds,md,mtsd,sc,mtm,mtmz,mtj,mtv,mtvx,mtsz,json,json2,jsonx,ds,mtzb,mtz,mwf,mtw,mts,dat,ttl,cfx,cfxz"
      4. WAS를 재기동합니다.
         
         
   2. 파이썬 추가 설치
      1. [5. AUD Conflux 문제 해결 가이드 > 파이썬 추가 설치] 가이드를 참고합니다.
         
         
   3. 이중화 서버 설정
      1. SERVER_1, SERVER_2 시점으로 세분화하여 아래와 같이 설정합니다. ([4. AUD Conflux 옵션] 참고)
      2. SERVER_1
         
         1. ClusterInfo > MyServerCode : 내 서버 코드
            예) "MyServerCode":"SERVER_1",
         2. ClusterInfo > MyServerName : 내 서버 명
            예) "MyServerName":"Server 1",

         3. ClusterInfo > OtherServerList : 다른 서버 리스트
            예) "OtherServerList" : [{"Code" : "SERVER_2", "Name" : "Server 2", "Ip" : "192.168.0.102", "Port" : "9872"}]

            코드 블럭
            language js
            "ClusterInfo": { "MyServerCode":"SERVER_1", "MyServerName":"Server 1", "OtherServerList" : [ { "Code" : "SERVER_2", "Name" : "Server 2", "Ip" : "192.168.0.102", "Port" : 9872, } ] }

            
            

      3. SERVER_2
         
         1. ClusterInfo > MyServerCode : 내 서버 코드
            예) "MyServerCode":"SERVER_2",
         2. ClusterInfo > MyServerName : 내 서버 명
            예) "MyServerName":"Server 2",

         3. ClusterInfo > OtherServerList : 다른 서버 리스트
            예) "OtherServerList" : [{"Code" : "SERVER_1", "Name" : "Server 1", "Ip" : "192.168.0.101", "Port" : "9872" }]

            코드 블럭
            language js
            "ClusterInfo": { "MyServerCode":"SERVER_2", "MyServerName":"Server 2", "OtherServerList" : [ { "Code" : "SERVER_1", "Name" : "Server 1", "Ip" : "192.168.0.101", "Port" : 9872, } ] }