업그레이드 유형별 AP 재컴파일 안내

1. 개요

Tmax 및 OS 업그레이드 시 Tmax 애플리케이션(Application, 이하 "AP")의 재컴파일 필요 여부를 반드시 확인해야 한다. 이는 안정적인 시스템 운영과 예기치 않은 오류 방지를 위해 필수적이다.

주요 상황에 따른 AP 재컴파일 필요 여부는 다음과 같다.

상황 재컴파일 필요 여부

Tmax Major/SP 업그레이드

필수

Tmax Fix 업그레이드

권장

Static 라이브러리 사용

필수

OS Major 업그레이드

권장

OS Minor 업그레이드

불필요 (단, 하위 호환 시)

Tmax 4 → Tmax 5 업그레이드

필수 (미수행 시 일부 기능을 사용 불가)

업그레이드 후에는 반드시 테스트 환경에서 AP를 재컴파일하고 주요 기능을 검증한 후 운영 환경에 적용한다. 또한 최신 Tmax 가이드라인에 따라 라이브러리 링크 방식을 점검한다.

2. Tmax 업그레이드 시 AP 재컴파일

다음은 Tmax 업그레이드 상황에 따른 AP 재컴파일 필요 여부에 대한 설명이다.

상황 재컴파일 설명

Major 또는 SP 업그레이드

필수

내부 구조나 라이브러리가 변경될 가능성이 높아 기존 AP가 정상 동작하지 않을 수 있으므로, 반드시 재컴파일을 한다.

Fix 업그레이드

권장

기존 AP도 동작할 수 있지만, Fix로 인한 동작 변경이나 수정 사항 반영을 위해 재컴파일을 하는 것이 좋다.

Static 라이브러리 사용

필수

정적 링크된 라이브러리는 새로운 라이브러리 변경 사항을 반영하지 않으므로 반드시 재컴파일을 한다.

3. OS 업그레이드 시 AP 재컴파일

다음은 OS 업그레이드 상황에 따른 AP 재컴파일 필요 여부에 대한 설명이다.

상황 재컴파일 설명

Major 버전 업그레이드

권장

Major 버전 업그레이드(예: AIX 6.1 → AIX 7.1) 시, Tmax도 해당 OS 버전에 맞게 재설치를 권장하며, AP도 재컴파일하여 호환성과 안정성을 확보한다.

Minor 버전 업그레이드

불필요

Minor 버전 업그레이드(예: RHEL 7.5 → RHEL 7.9) 시, OS가 하위 호환성을 보장하는 경우 AP 재컴파일은 필요하지 않다.

4. Tmax 4에서 Tmax 5로 업그레이드 시 AP 재컴파일

Tmax 4와 Tmax 5는 아키텍처 및 라이브러리 구조가 다르므로 업그레이드 시 반드시 AP를 재컴파일해야 한다.

만약 AP를 재컴파일하지 않으면 다음과 같이 일부 기능이 동작하지 않거나 예기치 않은 오류가 발생할 수 있다.

  • 'tmadmin 함수' 기능 사용 불가

    Tmax 5에서 tmadmin 관련 구조체가 변경되어 사용 시 오류가 발생한다.

  • tdl 함수 오동작

    Server 또는 Client에서 재컴파일을 하지 않으면 tdl 함수 호출 시 오동작하거나 호출 실패가 발생할 수 있다.

    또한 Tmax 5에서는 libsvr*, libcli*libtdlcall* 라이브러리를 함께 링크하지 않도록 한다.

  • tcpgw 사용 불가

    Tmax 5에서는 libtcpgwlibtmaxgw를 반드시 함께 링크해야 하며, 기존 Tmax 4 방식으로 구성된 tcpgw 프로그램은 Tmax5에서 정상 동작하지 않는다.