에러 코드

본 장에서는 TCache 에러 코드 대한 내역 및 대처 방안에 대해 설명한다.

  • ERR_VER(-1)

    설명

    TCache 메모리 버전과 TCache 바이너리 버전이 불일치하는 경우 발생하는 오류이다.

    대응 방법

    TCache 메모리를 재생성한다.

  • ERR_UNAVAILABLE(-2)

    설명

    TCache 메모리를 Create 또는 Remove 작업하는 중 발생하는 오류이다.

    대응 방법

    약간의 시간이 지나면 자동으로 해결된다. 동일 상황이 장시간 유지되고 있으면, TCache 메모리에 문제가 생긴 것이므로 재생성한다.

  • ERR_NOACCESS(-3)

    설명

    "pfmtcacheadmin -t"를 사용하여, TCache 메모리를 사용 불가로 만든 상태에서 발생하는 오류이다.

    대응 방법

    다시 pfmtcacheadmin -t를 사용하여 사용 가능 상태로 만들어 준다.

    다음 명령을 사용하여 TCache 메모리 상태를 확인할 수 있다.

    $ pfmtcacheadmin -s | grep status

    • status = AVAILABLE (정상)

    • status = NO ACCESS (사용불가)

  • ERR_NOTFOUND(-101)

    설명

    TCache에 해당 데이터 존재하지 않는 경우 발생하는 오류이다.

    대응 방법

    실제 Key 값에 데이터가 없다.

  • ERR_SHM(-102)

    설명

    Shared Memory 핸들링 상의 문제가 발생한 경우이다.

    (create, attach, remove, detach 등등)

    대응 방법

    TCache 메모리를 재생성한다.

  • ERR_LOCK(-103)

    설명

    Lock 획득에 실패한 경우(비정상적인 원인으로 실패)에 발생하는 오류이다.

    대응 방법

    TCache 메모리를 재생성한다.

  • ERR_WRONG_INPUT(-104)

    설명

    잘못된 CacheName을 사용하거나, SIZE_KEY보다 작은 크기의 데이터를 사용할 때 발생하는 오류이다.

    대응 방법

    입력값을 확인하거나 수정한다.

  • ERR_OUTOFMEM(-105)

    설명

    pfmTCachePut를 수행할 때 TCache 메모리 부족으로 인해 발생하는 오류이다.

    대응 방법

    약간의 시간이 지나면 자동으로 해결된다. 만약 특정 CacheName에서 계속 발생하는 경우 해당 캐시 설정의 SIZE_MEM 값을 늘린다.

  • ERR_NOCONFIG(-106)

    설명

    TCACHECONF 환경변수가 설정되지 않았거나, TCache 환경설정 파일에 문제가 있는 경우 발생하는 오류이다.

    대응 방법

    • 환경변수 및 해당 파일 존재를 확인한다.

    • 파일의 상태가 정상적인지를 확인한다.

    • 읽기 권한을 확인한다.

    • 파일이 vi로 열리는지 확인한다.

  • ERR_PARSE_CONF(-107)

    설명

    TCache 환경설정을 읽기 또는 처리 실패한 경우 발생하는 오류이다.

    대응 방법

    • 환경설정 파일에 필수 항목이 제대로 설정되어 있는지 확인한다.

    • 캐시 개수가 128개 이상인지 확인한다.

  • ERR_INV(-108)

    설명

    현재 해당 Item이 Invalidate 처리 중인 경우 발생하는 오류이다.

    대응 방법

    TCache 환경설정에 설정한 INV_TIMEOUT 값만큼의 시간이 흐르면 풀린다. INV_TIMEOUT의 단위는 초이다.

  • ERR_SYS(-109)

    설명

    OS 또는 TP 관련 오류가 발생한 경우이다.

    대응 방법

    • 시스템 상태를 확인한다.

    • pfmTCacheInvalidate를 수행할 때 ERR_SYS가 발생했다면 TP 설정을 확인한다. (SPFMAGENT 설정이 잘되어 있는지 확인)

  • ERR_INTERNAL(-111)

    설명

    pfmTCacheReplace를 수행할 때 발생하는 내부적인 오류이다.

    대응 방법

    메모리 재생성 후에도 동일한 상황이 반복되는지 확인 후 지원 요청한다.

  • ERR_BUSY(-112)

    설명

    Lock 획득에 실패한 경우(정상적인 LockWait 상황) 발생하는 오류이다.

    대응 방법

    약간의 시간이 지나면 자동으로 해결된다. 만약 동일한 상황이 장시간 유지되면, TCache 메모리에 문제가 생긴 것이므로 재생성한다.

  • ERR_OFFSET(-114)

    설명

    pfmTCacheReplace를 수행할 때 offset_data 값이 실제 데이터보다 클 경우 발생하는 오류이다.

    대응 방법

    AP에서 데이터 크기를 확인한다.

  • ERR_ARG(-115)

    설명

    TCache API를 수행할 때 Invalid argument를 사용한 경우 발생하는 오류이다.

    대응 방법

    AP 코드를 확인한다. cacheName, key, data 포인터 등이 NULL인지 size가 양수가 아닌지 확인한다.