개발및운영 JEUS7 Node Manager 가이드 2014. 12. 15
목차 1. 노드매니저종류... 3 1.1 Java Type... 3 1.2 SSH Type... 3 2. 노드설정파일및로깅... 3 2.1 nodes.xml... 3 2.2 jeusnm.properties... 4 2.3 <servername>.properties... 4 2.4 JeusNodeManager.log... 4 3. 노드관리... 5 3.1 노드설정... 5 3.2 노드삭제... 7 3.3 노드매니저시작... 8 3.4 노드매니저중지... 8 4. 노드테스트... 9 4.1 Java Type... 9 4.2 SSH Type... 11 4.3 Rolling Patch... 13 4.4 원격서버기동... 14 4.5 비정상상태의서버재기동... 17 4.5.1 java type... 17 4.5.2 ssh type... 18 2
JEUS7 NODE Manager 가이드 개요 하나의머신에서서버프로세스를관리하는주체는노드매니저 (Node Manager) 입니다. 도메인단위가아닌머신 단위로서버를관리하고해당머신에존재하는서버들을시작, 종료, 재기동해서서버가정상상태로서비스할수 있게합니다. 이것은 JEUS 마다하나씩존재합니다. 노드매니저의주요목적은하나의노드에서동작하는서버프로세스들을관리하는것입니다. Domain Administration Server( 이하 DAS) 와다른원격머신에서동작하는서버를시작하고서버가비정상종료되거나사용자가설정한비정상상태가되었을때서버를재기동과서버가갑자기다운된경우에는 DAS가 GMS를통해이를감지하여자동으로재시작하는기능을제공합니다. 또서버에적용할 patch 파일을전달받아서적용시켜줄수도있습니다. 1. 노드매니저종류 1.1 Java Type Java로구현된노드매니저로 OS에상관없이실행됩니다. DAS와다른노드에존재하는 Managed Server 를시작시킬수있습니다. 노드매니저는주체적으로서버의상태와비정상종료를감지해서문제가발생한서버의재기동동작이 SSH 타입노드매니저보다빠르고간결하게진행됩니다. 또한도메인에 patch 파일을적용할수있습니다. 그러나 Java 타입노드매니저는 JEUS가설치되어있어야설정해서사용할수있으므로 SSH 타입노드매니저와는달리다른머신에 JEUS를설치할수없습니다 1.2 SSH Type OS에서제공하는 SSH를사용하는노드매니저로 Windows 에서는사용할수없습니다. Windows 머신에서는 Java 타입을사용해야합니다. SSH 타입노드매니저는 Java 타입노드매니저와마찬가지로원격머신에있는서버를시작시키고, 비정상종료를감지하는기능이있는데 DAS GMS를통해서원격서버를재기동하게됩니다. SSH 타입노드매니저는 SSH 노드를통해다른머신에 JEUS를설치할수있습니다. 2. 노드설정파일및로깅 2.1 nodes.xml 어떤타입의노드매니저를사용할것인지노드정보를설정합니다. 이파일은하나의도메인에국한된파일이아니라설치된 JEUS에존재하는여러도메인에서모두공유됩니다. 각도메인의 DAS에서는 node.xml 에설정된노드정보에따라각노드의노드매니저에접속해서필요한명령을수행합니다. Java 타입노드매니저는 nodes.xml 에설정된머신정보와 jeusnm.properties 에설정된 'host', 'port' 정보가일치해야합니다. 3
2.2 jeusnm.properties jeusnm.properties 는노드매니저의동작방식을설정하는설정파일입니다. 2.3 <servername>.properties <servername>.properties 파일은노드매니저에서서버를기동할때필요한정보들에대한캐시파일입니다. 이정보들은콘솔툴을통해노드매니저에직접접속해서서버를기동시킬때만사용된다. DAS 를통해서 MS 를기 동시킬때는해당정보를사용하지않습니다. 2.4 JeusNodeManager.log 노드매니저의로그는 JEUS_HOME/nodemanager/logs 하위에 JeusNodeManager.log 라는파일에남겨집니다. 노드매니저에서서버를기동하거나모니터링하면서발생하는로그메시지들을기록합니다. 노드매니저의로그레벨을설정하려면노드매니저를기동하는스크립트에다음과같이설정합니다. -Djeus.nodemanager.log.level=FINEST 4
3. 노드관리 3.1 노드설정 Webadmin 에서 'node1' 이라는노드추가 5
Console Tool 의 add-java-node 명령을사용해서 'node1' 이라는노드추가 6
추가된노드설정조회 (show-node) 도메인노드조회 (list-nodes) modify-java-node, modify-node 명령을사용해서노드변경 변경된노드정보를확인 (show-node) 3.2 노드삭제 'node1' 이라는노드를삭제 (remove-node) 추가된노드를확인 (list-nodes) 7
. 3.3 노드매니저시작 Java 타입의노드매니저는스크립트를통해서실행시킨다. JEUS_HOME/bin 하위에존재하는 startnode Manager 를실행시키면다음과같이노드매니저가 DAS 나콘솔툴로부터명령을받아서버를제어할준 비를합니다. 3.4 노드매니저중지 스크립트사용 기동할때와마찬가지로스크립트를통해노드매니저를종료할수있다. stopnodemanager 를실행하면 Java 타입 노드매니저가종료됩니다. 노드매니저를종료할때 -properties 옵션을통해 jeusnm.properties 파일의경로를주고노드매니저설정파일로 부터 host 와 port 정보를읽어노드매니저를종료합니다. 8
4. 노드테스트 4.1 Java Type Java Type NodeManager 생성 (Name, Host, Port 입력 ) jeusnm.properties usenodemanager=true 설정 Server1 에 node target 지정 9
노드매니저기동 (startnodemanager) 서버기동 10
4.2 SSH Type SSH Type NodeManager 생성 (Name, Host, SSH 정보입력 ) jeusnm.properties usenodemanager=false 설정 11
Server1 에 node target 지정 공개키와개인키생성 (ssh-keygen, password 없음 ) 공개키파일명 (id_rsa.pub -> authorized_keys) 및권한 (authorized_keys, 600) 변경 12
서버기동 4.3 Rolling Patch Java 타입노드매니저를통해도메인에 patch 를적용할수있습니다. 콘솔툴을사용해서원격머신에있는서버에 Patch 파일을전송또는삭제뿐만아니라 Patch 적용을위해서버의재기동까지진행합니다. DAS에서도메인에속한서버가존재하는원격머신의노드매니저에접속해서 Patch 파일을전달, 삭제, 적용할수있습니다. Patch 파일전달 domain1.adminserver>apply-patch Patch 파일삭제 domain1.adminserver>remove-patch Patch 파일적용 -rolling 옵션을통해각서버에 Patch를적용시킬수있습니다. 이때하나의노드별로순차적으로수행하여서비스가이중화되어있다면장애없이서비스할수있도록합니다. 단, 같은노드안에여러대의서버를운영하고있는상황이라면노드전체의서버를하나씩순차적으로종료하고 Patch 파일을전송또는삭제한후다시서버를하나씩순차적으로기동해야합니다. domain1.adminserver>apply-patch -rolling domain1.adminserver>remove-patch -rolling Patch 적용에실패한경우되돌리는기능 -action 옵션을통해서 Patch 적용에실패한경우의동작에대해서정의할수있습니다. domain1.adminserver>apply-patch -rolling -action CONTINUE STOP ROLLBACK 다음의 CONTINUE, STOP, ROLLBACK 옵션중하나를설정할수있습니다. 13
4.4 원격서버기동 Manager 에서노드추가 (name: node1, host: 원격지주소, java type) Manager 에서서버추가 (server3, node1) 14
추가된서버확인 15
Managed 에서노드매니저기동 (startnodemanager) Manager 에서 server3 기동 정상기동확인 16
4.5 비정상상태의서버재기동 4.5.1 java type jeusnm.properties 설정 usenodemanager=true host= port=7730 usessllistener=false servermonitoringperiod=500 17
serverautorestart=true serverrestarttrycount=5 serverrestartdurationtime=120000 serverretryrestart=false 4.5.2 ssh type gms 를통해 health check 시 server status = running -> failed 가되면동작함 -Djeus.server.autorestart=true Restart 주기나 retry 설정등은존재하지않음 18
Copyright 2014 TmaxSoft Co., Ltd. All Rights Reserved. Trademarks Tmax, WebtoB, WebT, JEUS, ProFrame, SysMaster and OpenFrame are registered trademarks of TmaxSoft Co., Ltd. Other products, titles or services may be registered trademarks of their respective companies. Contact Information TmaxSoft can be contacted at the following addresses to arrange for a consulting team to visit your company and discuss your options. Korea TmaxSoft Co., Ltd 5, Hwangsaeul-ro 329beon-gil, Bundang-gu, Seongnam-si, Gyeonggi-do. South Korea Tel: +82-31-8018-1000 Fax: +82-31-8018-1115 Email: info@tmax.co.kr Web (Korean): http://www.tmaxsoft.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 TD-JSTP-D1215001 19