Tibero tbprobe 사용법과원격지포트체크 2014. 04. 23.
목차 1. tbprobe 사용... 3 1.1. 로컬호스트 tibero 체크... 3 1.2. 원격호스트 tibero 체크... 3 2. tbprobe 상태값... 5 3. tbprobe 연결방법... 6 3.1. IP 와 listener_port 기재시... 6 3.2. IP 와 listener_port 미기재시... 6 4. 유의사항... 8 4.1. ERROR_SESS_DISCONNECT(-512046) 로그... 8 4.2. TIMEOUT 사용... 8 2
Tibero tbprobe 사용법과원격지포트체크 tbprobe 는 tibero 서버의상태를체크해주는유틸리티이다. tbprobe 를이용하여로컬서버와원격지서버의 tibero 상태를확인할수있다. 1. tbprobe 사용 tbprobe 는 $TB_HOME/bin 아래에위치하고있으며, 그사용법은아래와같다. h Usage: tbprobe [-h] [ip:port] tbprobe -h: show this help tbprobe : probe localhost tbprobe [ip:port] : probe specified ip & listener port 1.1. 로컬호스트 tibero 체크 로컬호스트 tibero 체크시아래와같이확인하면된다. 로컬호스트의경우서버의 IP 와포트번호는생략할수있다. 사용법 : tbprobe [ localhost:listener_port ] Unix/Linux 환경에서사용법 0 정상 Windows 환경에서사용법 C:\>tbprobe C:\>echo %ERRORLEVEL% 0 정상 1.2. 원격호스트 tibero 체크 원격지호스트 tibero 체크시아래와같이확인하면된다. 체크하려는서버의 IP 와포트번호를필수로넣어준다. 사용법 : tbprobe remote_ip:listener_port 3
Unix/Linux 환경에서사용법 192.168.10.1:8628 0 192.168.10.1 번서버의 8629 번포트로접속을시도하여 tibero 서버가정상임을확인 Windows 환경에서사용법 C:\>tbprobe 192.168.10.1:8628 C:\>echo %ERRORLEVEL% 0 192.168.10.1 번서버의 8629 번포트로접속을시도하여 tibero 서버가정상임을확인 IP 와포트번호를입력하여 tibero 포트체크시 tbprobe 는스페셜포트 (Special port) 로접속하기위해입력된 포트번호 + 1 로접속하기때문에실제접속체크를원하는포트로체크하기위해선접속체크를원하는포트번호에서 -1 을해야한다. 예를들어원격호스트에서리스너포트를 8629 로사용하여오픈된 tibero 상태를확인하고싶다면, 8628 로포트 번호를기재해야한다. 스페셜포트 (Special port) : Session Full 과같은상황에서응급조치를하기위해사용하는포트로기본값은 리스너포트 + 1 이다. 4
2. tbprobe 상태값 tbprobe 를실행하면리턴되는종료값을통해다음과같은상태를알수있다. 종료코드 상태설명 0 TBCM_PROBE_NORMAL 티베로접속정상 1 TBCM_PROBE_STANDBY 부트모드가 normal 이아닌 recovery 상태이거나 readonly 인경우 2 TBCM_PROBE_UNKNOWN 부트모드가 readonly, recovery, normal 이외의값인경우 nomount, mount 모드등경우 3 TBCM_PROBE_DEAD 티베로접속에실패한모든경우 4 TBCM_PROBE_TIMEOUT 환경변수 TB_PROBE_TIMEOUT 시간까지 hang 으로인해 티베로에서응답이없는경우 0 ~ 2 까지는서버에정상접속이되어메세지를주고받는데까지성공했음을의미하고, 3 은접속자체에실패한경우를 나타내며, 최근추가된 4 는응답메시지를지정된시간만큼기다리다가종료된 (time out) 경우이다. 단, 티베로접속후에메세지한번주고받는것으로확인하기때문에다른이유로인한 hang 상태는확인할수없다. 스페셜포트 (Special port) 로접속하기때문에 session full 상태여도티베로상태체크가가능하다. 단, _LSNR_SPECIAL_PORT 파라미터를설정하여임의의포트를스페셜포트로사용하는경우 tbporbe 가스페셜포트로체크할수없기때문에잘못된결과값을나타낼수도있다. tbporbe 사용전 _LSNR_SPECIAL_PORT 파라미터설정여부를확인하도록한다. 5
3. tbprobe 연결방법 3.1. IP 와 listener_port 기재시 tbprobe 실행시 IP 와 listener_port 를인자값으로주게되면해당 IP 와 listener_port + 1 로접속요청을하게된다. listener_port + 1 로접속요청을하는이유는일반세션과경쟁하지않도록 special_port 로접속하기위해서이다. -- 실제로 192.168.10.1 의 8630 번포트로접속요청 192.168.10.1:8629 -- 원격지서버 (192.168.10.1) 의 Tibero 가 8629 번포트로 open 되어있는상태에서테스트 192.168.10.1:8628 0 8629 번포트로접속을요청하기때문에접속성공을리턴 192.168.10.1:8629 0 8630 번포트 (special_port) 로접속을요청하기때문에접속성공을리턴 192.168.10.1:8630 3 8631 번포트로접속을요청하기때문에접속실패를리턴 3.2. IP 와 listener_port 미기재시 tbprobe 실행시 IP 와 listener_port 를인자값으로주지않게되면로컬서버로접속을요청하게되며, $TB_HOME/instance/$TB_SID/.proc.list 의 listener_port 를참조하여접속요청을하게된다. 만약한서버에인스턴스가여러개인경우라도 $TB_HOME, $TB_SID 를통해구분하여체크할수있다. -- tbprobe <= $TB_HOME/instance/$TB_SID/.proc.list 에기재된포트로접속요청. -- 로컬서버의티베로가 8629 번포트로 open 되어있는상태에서의테스트 $> cat $TB_HOME/instance/$TB_SID/.proc.list Tibero 5 start at (2014-01-21 18:01:59) by 500 shared memory: 139994162909184 size: 536870912 shm_key: 1415571906 sem_key: -1000365745 1 listener_pid: 12494 listener_port: 8629 listener_special_port: 8630 epa_pid: -1 12495 MTHR 12499 WT001 12500 WT002 12501 SEQW 12502 LOGW 12503 LOGA 12504 CKPT 6
12505 BLKW000 0 -- listener_special_port 를 8630 에서 8690 으로수정 $> cat $TB_HOME/instance/$TB_SID/.proc.list Tibero 5 start at (2014-01-21 18:01:59) by 500 shared memory: 139994162909184 size: 536870912 shm_key: 1415571906 sem_key: -1000365745 1 listener_pid: 12494 listener_port: 8629 listener_special_port: 8690 epa_pid: -1 12495 MTHR 12499 WT001 12500 WT002 12501 SEQW 12502 LOGW 12503 LOGA 12504 CKPT 12505 BLKW000 0 listener_special_port 가아닌 listener_port 를참고하므로접속에문제없음 -- listener_port 를 8629 에서 8680 으로수정 $> cat $TB_HOME/instance/$TB_SID/.proc.list Tibero 5 start at (2014-01-21 18:01:59) by 500 shared memory: 139994162909184 size: 536870912 shm_key: 1415571906 sem_key: -1000365745 1 listener_pid: 12494 listener_port: 8680 listener_special_port: 8681 epa_pid: -1 12495 MTHR 12499 WT001 12500 WT002 12501 SEQW 12502 LOGW 12503 LOGA 12504 CKPT 12505 BLKW000 3 listener_port 는 8680 를참고하나 tibero 는 8629 로기동되어있기때문에접속불가로나옴 7
4. 유의사항 4.1. ERROR_SESS_DISCONNECT(-512046) 로그 tbprobe 가티베로서버에접속할때마다 tracelog 에 ERROR_SESS_DISCONNECT(-512046) 메시지가찍히게된다. 이것은인증과정중에발생하는 throw 에대해남기는메세지이며 tbprobe 에서 ping 메세지처리후 throw 를하기때문에 tbprobe 실행시마다 ERROR_SESS_DISCONNECT(-512046) 메세지가남게된다. 이것은정상적인동작이지만 tbprobe 를클러스터 SW 등에서티베로체크하는용도로사용하게되면, 수십초마다한번씩로그가발생하기때문에이것을남기지않기위해선패치가필요하다. S1348 버전부터는패치가기본적용되어있고, 그이전버전은 80920a 패치를하여야한다. 4.2. TIMEOUT 사용 tbprobe 의 Timeout 기능은 S1401 버전부터는기본으로포함되어있고, 그이전버전에서사용하기위해선 82529a 패치가필요하다. 또한, timeout 시간을설정하기위해환경변수 TB_PROBE_TIMEOUT 설정이필요하다. $ export TB_PROBE_TIMEOUT=5 # hang 상태유발 $ tbprobe.. 5 초후.. $ echo $? 4 8
Copyright 2014 TmaxData Co., Ltd. All Rights Reserved. Trademarks Tibero RDBMS is a registered trademark of TmaxData Co., Ltd. Other products, titles or services may be registered trademarks of their respective companies. Contact Information TmaxData can be contacted at the following addresses to arrange for a consulting team to visit your company and discuss your options. Korea TmaxData Co., Ltd 5, Hwangsaeul-ro 329beon-gil, Bundang-gu, Seongnam-si, Gyeonggi-do. South Korea Tel: +82-31-779-7113 Fax: +82-31-779-7119 Email: info@tmax.co.kr Web (Korean): http://www.tmaxdata.com Technical Support: http://technet.tmaxsoft.com USA TmaxSoft, Inc. 560 Sylvan Avenue Englewood Cliffs, NJ 07632. U.S.A Tel: +1-201-567-8266 Fax: +1-201-567-7339 Email: info@tmaxsoft.com Web (English): http://www.tmaxsoft.com Russia Tmax Russia L.L.C. Grand Setun Plaza, No A204 Gorbunova st.2, Moscow, 121596 Tel: +7(495)970-01-35 Email: info.rus@tmaxsoft.com Web (Russian): http://ru.tmaxsoft.com Singapore Tmax Singapore Pte. Ltd. 430 Lorong 6, Toa Payoh #10-02, OrangeTee Building. Singapore 319402 Tel: +65-6259-7223 Email: info.sg@tmaxsoft.com United Kingdom TmaxSoft UK Ltd. Surrey House, Suite 221, 34 Eden Street, Kingston-Upon- Thames, KT1 1ER United Kingdom Tel: + 44-(0)20-8481-3776 Email: info.uk@tmaxsoft.com Web (English): http:/www.tmaxsoft.com Japan TmaxSoft Japan Co., Ltd. 5F Sanko Bldg, 3-12-16 Mita, Minato-Ku, Tokyo, 108-0073 Japan Tel: +81-3-5765-2550 Fax: +81-3-5765-2567 Email: info.jp@tmaxsoft.com Web (Japanese): http://www.tmaxsoft.co.jp China TmaxSoft China Co., Ltd. Beijing Silver Tower, RM 1508, 2 North Rd Dong San Huan, Chaoyang District, Beijing, China, 100027. China Tel: +86-10-6410-6145~8 Fax: +86-10-6410-6144 Email: info.cn@tmaxsoft.com Web (Chinese): http://www.tmaxsoft.com.cn Brazil TmaxSoft Brazil Avenida Copacabana, 177-3 andar 18 do Forte Empresarial, Alphaville - Barueri, Sao Paulo, SP-Brasil CEP 06472-001 Email: contato.brasil@tmaxsoft.com TN-TRDV-D0423101 9