> For the complete documentation index, see [llms.txt](https://docs.tibero.com/tibero-manuals/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tibero.com/tibero-manuals/7.2.6.manuals/installation-guide/appendix/post-install-troubleshooting.md). # Appendix A. 설치 후 문제 해결 Tibero를 설치한 후 발생할 수 있는 문제를 해결하는 방법을 설명합니다. ## 사용자 환경 설정 파일 ### **TB\_HOME** **문제** ``` TBR-2048 : Data source was not found. ``` **tbSQL** 유틸리티에 접속할 때 이러한 메시지가 나타나면 **TB\_HOME**이 설정되지 않았거나 잘못 설정된 경우 또는 Tibero를 설치한 후 환경 설정 파일을 적용하지 않은 경우에 발생하는 문제입니다. **해결 방법** 사용자 환경 설정 파일의 TB\_HOME 환경 변수를 확인하고 변경한 뒤 시스템에 적용시킵니다. ### **LD\_LIBRARY\_PATH** **문제** ``` tbsql: error while loading shared libraries: libtbcli.so: cannot open shared object file: No such file or directory ``` **tbSQL** 유틸리티에 접속할 때 이러한 메시지가 나타나면 **LD\_LIBRARY\_PATH**가 설정되지 않았거나 잘못 설정된 경우 또는 Tibero를 설치한 후 환경 설정 파일을 적용하지 않은 경우에 발생하는 문제입니다. **해결 방법** 사용자 환경 설정 파일의 LD\_LIBRARY\_PATH를 확인하고 변경한 뒤 시스템에 적용시킵니다. ### **TB\_SID** **문제** ``` ERROR: environment variable $TB_SID is not set ``` ``` tbdown: environment variable TB_HOME or TB_SID is not set. ``` ``` Tip file open failure.: No such file or directory ``` ``` tbdown failed. proc info file is deleted. ``` **tbboot** 또는 **tbdown** 명령어를 실행할 때 위와 같은 메시지 중 하나가 나타나면 **TB\_SID**가 설정되지 않은 경우에 발생하는 문제입니다. **해결 방법** 사용자 환경 설정 파일의 TB\_SID를 확인하고 변경한 뒤 시스템에 적용시킵니다. *** ## **TAC** 설치 본 절에서는 TAC 환경에서 Tibero를 설치한 후 발생할 수 있는 문제와 해결 방법을 설명합니다. ### 노드 추가 #### **tip 파일 접근 문제** #### **문제** ``` tip file does not exist / reading tip file failed / malformed tip file ``` 노드를 추가할 때 설정 파일(.tip)을 찾지 못하여 발생하는 문제입니다. #### **해결 방법** TB\_HOME, TB\_SID를 참고하여 해당 경로에 기존 Tibero 인스턴스의 $TB\_SID.tip이 위치해 있는지 확인합니다. #### **TAC 접근 문제** **문제** ``` extracting information from the existing cluster failed ``` 노드를 자동으로 추가할 때 설정값을 읽기 위해 기존 노드에 접속하는 데 실패하여 발생하는 문제입니다. **해결 방법** * TB\_HOME과 TB\_SID가 제대로 설정되어 있는지 확인합니다. * tbSQL로 기존 노드에 접속 가능한지 확인합니다. * 기존 노드가 작동하고 있지 않은 경우 **tbcm**, **tbboot** 명령어로 기동한 후 노드 추가를 재시도합니다. #### **scp 파일 전송 문제** **문제** ``` Remote file transfer failed! / Remote configuration export failed! ``` 새로운 노드에 Tibero 설치 파일을 전송하는 도중 실패하여 발생하는 문제입니다. **해결 방법** * 추가하려는 노드에 현재 노드에서 접근할 수 있는지 ping 또는 ssh 등으로 확인합니다. * 원활하게 이루어지지 않을 경우 계정 동기화 설정과 네트워크 설정, 방화벽 설정 등을 확인합니다. ### **TAC Raw Device** 환경 내 **TPR** 관련 주의 사항 **문제** Tibero 5.0 r61295 이후부터는 TPR 관련 테이블을 담는 TPR 전용 테이블스페이스(SYSSUB)가 추가되었습니다. 설치 또는 패치할 때 시스템 스키마를 구성하는 단계에서 자동으로 $TB\_HOME/database/$TB\_SID 아래에 파일(syssub001.dtf)을 만듭니다. 단, DB\_CREATE\_FILE\_DEST가 명시되어 있는 경우에는 해당 위치에 만듭니다.\ \ 하지만 TAC Raw Device 사용 환경이라면 그 시스템 스키마를 수행하는 노드의 로컬 디스크에 해당 파일이 생성되어 다른 노드에서는 TPR 테이블스페이스에 접근하지 못하는 오류가 발생합니다. 공유 파일 시스템이면서 DB\_CREATE\_FILE\_DEST가 적절한 경로로 지정되지 않은 환경에서도 마찬가지입니다. **해결 방법** 아래와 같은 방법으로 SYSSUB 테이블스페이스를 재생성합니다. 1. 테이블스페이스를 삭제합니다. ``` SQL> DROP TABLESPACE SYSSUB INCLUDING CONTENTS AND DATAFILES; ``` 2. 테이블스페이스를 생성합니다. ``` SQL> CREATE TABLESPACE SYSSUB DATAFILE '/syssub001.dtf' ...; ``` 3. 다음의 스크립트를 실행합니다. ``` $TB_HOME/scripts/tpr.sql $TB_HOME/scripts/pkg/_pkg_dbms_tpr.tbw ``` *** ## **기타** ### 포트 번호 **문제** ``` Listener port = 8629 bind() failed: Address already in use. Error: Timedout while trying to open port 8629 Check if there are any Tibero instances running. Tibero instance startup failed! ``` **tbboot** 명령어를 실행할 때 사용하려는 포트 번호가 이미 사용 중인 경우에 발생하는 문제입니다. **해결 방법** 해당 인스턴스가 이미 실행 중인지 확인하거나 $TB\_HOME/client/config 디렉터리에 있는 $TB\_SID.tip 파일에 설정된 포트 번호를 수정합니다. ### **dbtimezone** **권고 사항** dbtimezone 값은 timestamp with local timezone 데이터 타입을 DB에 저장할 때 기준이 되는 timezone 값입니다. DB 내부에서 처리되는 값이므로 임의로 변경하면 불필요한 연산이 추가되어 성능에 좋지 않은 영향을 줄 수 있습니다. 따라서 임의 변경은 권고하지 않습니다.