Intelligent Viewing LoaderConfig Full Guide
loaderconfig
이 문서(도구)의 목적
loaderconfig 도구는 Intelligent Viewing 서버에서 특정 포맷(예: DWG, PDF, DGN 등)을 해석하고 변환하는 로더의 설정값을 관리하는 명령줄 도구입니다.
즉, 이건 단순한 환경 전체 export/import 도구가 아니라,
👉 각 파일 형식을 “어떻게 읽고 표시할 것인지”를 제어하는 로더 구성 도구입니다.
⚙️ 주요 기능 요약
| 기능 | 설명 |
|---|---|
loaderconfig -u > report.txt |
현재 Intelligent Viewing 환경의 로더 버전, 사용자 설정값 요약을 export (지원용 리포트 생성) |
loaderconfig -m |
새 로더 버전 설치 후 기존 사용자 설정과 병합 |
loaderconfig -s loader/parameter value |
특정 로더의 파라미터 변경 |
loaderconfig -r loader/parameter |
특정 파라미터를 기본값으로 복원 |
loaderconfig -S loader extension |
확장자를 특정 로더에 연결 (예: .dwg → dwg2dl) |
loaderconfig -V |
전체 로더 목록과 버전 출력 |
loaderconfig -U |
모든 로더의 전체 설정값 표시 |
🧩 “로더(loader)”란?
- Intelligent Viewing이 파일을 표시할 때 각 포맷별 전용 모듈(DLL/so) 을 사용합니다.
- 예:
DWG2DL→ AutoCAD DWG/DXF 파일용 로더DWF2DL→ AutoCAD DWF/DWFX 파일용 로더PDF2DL→ PDF용OUTSIDEIN2DL→ MS Office, Word 등 다양한 문서 포맷용
- 이 로더들은 XML 설정파일로 동작을 제어하며,
loaderconfig명령으로 수정/내보내기 가능합니다.
As-Is → To-Be 동기화
전제 조건
-
두 서버(Kubernetes 환경, Linux9 환경) 모두 Intelligent Viewing이 설치되어 있고
loaderconfig명령을 쓸 수 있는 상태여야 합니다. -
두 환경의 Intelligent Viewing 버전은 같거나 호환(예: 25.3.x)이어야 합니다.
Kubernetes Intelligent Viewing 서버 (AS-IS 환경)에서 export
cd /opt/opentext/PublisherService/bin # 경로는 설치 위치에 따라 조정
./loaderconfig -U dwg2dl > /tmp/dwg2dl-config.txt
loaderconfig -u > /tmp/loader-report.txt # 전체 export 후 비교도 가능
💡 -U (profilefullsummary)는 DWG2DL 로더의 모든 파라미터와 값을 출력합니다.
이 파일이 import용 원본이 됩니다.
→ /tmp/dwg2dl-config.txt 파일을 Linux9 서버로 복사하세요.
(예: scp /tmp/dwg2dl-config.txt linux9:/tmp/)
Linux9 Intelligent Viewing 서버 (TO-BE 환경)에서 import
Intelligent Viewing의 loaderconfig 도구에는 직접적인 “import” 명령은 없습니다.
즉, export된 파일을 읽어서 한 번에 적용하는 기능은 없어요.
그래서 아래처럼 스크립트로 자동 적용하는 것이 표준 절차입니다.
cd /opt/opentext/PublisherService/bin
# 파일에서 "Name: <param>"와 "Current Value" 줄을 파싱해서 적용
grep -A3 "^Name:" /tmp/dwg2dl-config.txt | \
awk '/^Name:/ {param=$2} /^Current Value:/ {val=$3; if (param && val) print "loaderconfig -s dwg2dl/" param " " val}' \
> /tmp/dwg2dl-import.sh
chmod +x /tmp/dwg2dl-import.sh
# 실제 적용
bash /tmp/dwg2dl-import.sh
⚠️ 주의:
Intelligent Viewing의 Publisher 서비스는 반드시 정지(stop) 후 변경해야 합니다.
``` systemctl stop publisher
```
적용 후 다시 시작:
``` systemctl start publisher
```
확인 (Linux9에서 동일 설정이 반영되었는지)
./loaderconfig -U dwg2dl > /tmp/dwg2dl-after.txt
diff /tmp/dwg2dl-config.txt /tmp/dwg2dl-after.txt
→ 차이가 거의 없거나 동일해야 정상 복제된 것입니다.
🧱 요약 명령 세트
| 단계 | 명령 |
|---|---|
| Export (K8s) | ./loaderconfig -U dwg2dl > /tmp/dwg2dl-config.txt |
| 전송 | scp /tmp/dwg2dl-config.txt linux9:/tmp/ |
| Import (Linux9) | 위 grep+awk 스크립트로 /tmp/dwg2dl-import.sh 생성 후 실행 |
| 검증 | ./loaderconfig -U dwg2dl |