Appendix A. 에러 코드

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

ERR_VER(-1)

설명	TCache 메모리 버전과 TCache 바이너리 버전이 불일치하는 경우 발생하는 오류이다.
대응 방법	TCache 메모리를 재생성한다.

설명	TCache 메모리를 Create 또는 Remove 작업하는 중 발생하는 오류이다.
대응 방법	약간의 시간이 지나면 자동으로 해결된다. 동일 상황이 장시간 유지되고 있으면, TCache 메모리에 문제가 생긴 것이므로 재생성한다.

설명

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

대응 방법

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

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

$ pfmtcacheadmin -s | grep status

설명	TCache에 해당 데이터 존재하지 않는 경우 발생하는 오류이다.
대응 방법	실제 Key 값에 데이터가 없다.

설명

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

(create, attach, remove, detach 등등)

대응 방법

TCache 메모리를 재생성한다.

설명	Lock 획득에 실패한 경우(비정상적인 원인으로 실패)에 발생하는 오류이다.
대응 방법	TCache 메모리를 재생성한다.

설명	잘못된 CacheName을 사용하거나, SIZE_KEY보다 작은 크기의 데이터를 사용할 때 발생하는 오류이다.
대응 방법	입력값을 확인하거나 수정한다.

설명	pfmTCachePut를 수행할 때 TCache 메모리 부족으로 인해 발생하는 오류이다.
대응 방법	약간의 시간이 지나면 자동으로 해결된다. 만약 특정 CacheName에서 계속 발생하는 경우 해당 캐시 설정의 SIZE_MEM 값을 늘린다.

설명	TCACHECONF 환경변수가 설정되지 않았거나, TCache 환경설정 파일에 문제가 있는 경우 발생하는 오류이다.
대응 방법	환경변수 및 해당 파일 존재를 확인한다. 파일의 상태가 정상적인지를 확인한다. 읽기 권한을 확인한다. 파일이 vi로 열리는지 확인한다.

설명	TCache 환경설정을 읽기 또는 처리 실패한 경우 발생하는 오류이다.
대응 방법	환경설정 파일에 필수 항목이 제대로 설정되어 있는지 확인한다. 캐시 개수가 128개 이상인지 확인한다.

설명	현재 해당 Item이 Invalidate 처리 중인 경우 발생하는 오류이다.
대응 방법	TCache 환경설정에 설정한 INV_TIMEOUT 값만큼의 시간이 흐르면 풀린다. INV_TIMEOUT의 단위는 초이다.

설명	OS 또는 TP 관련 오류가 발생한 경우이다.
대응 방법	시스템 상태를 확인한다. pfmTCacheInvalidate를 수행할 때 ERR_SYS가 발생했다면 TP 설정을 확인한다. (SPFMAGENT 설정이 잘되어있는지 확인)

설명	pfmTCacheReplace를 수행할 때 발생하는 내부적인 오류이다.
대응 방법	메모리 재생성 후에도 동일한 상황이 반복되는지 확인 후 지원 요청한다.

설명	Lock 획득에 실패한 경우(정상적인 LockWait 상황) 발생하는 오류이다.
대응 방법	약간의 시간이 지나면 자동으로 해결된다. 만약 동일한 상황이 장시간 유지되면, TCache 메모리에 문제가 생긴 것이므로 재생성한다.

설명	pfmTCacheReplace를 수행할 때 offset_data 값이 실제 데이터보다 클 경우 발생하는 오류이다.
대응 방법	AP에서 데이터 크기를 확인한다.

설명	TCache API를 수행할 때 Invalid argument를 사용한 경우 발생하는 오류이다.
대응 방법	AP 코드를 확인한다. cacheName, key, data 포인터 등이 NULL인지 size가 양수가 아닌지 확인한다.