노드 관리 관련 명령어

본 절에서는 노드 관리와 관련된 명령어에 대해 설명한다. 노드는 하나의 머신에 존재하는 하나의 JEUS 설치본을 의미한다. DAS의 원격 서버 관리를 위한 기능으로 DAS에 접속했을 때만 명령어 사용이 가능하다. 노드에 대한 자세한 설명은 JEUS Node Manager 안내서를 참고한다.

노드 관리 관련 명령어의 목록은 다음과 같다.

명령어 설명

add-java-node

동적으로 Java 노드를 추가한다.

add-ssh-node

동적으로 SSH 노드를 추가한다.

apply-patch

해당 노드에 패치를 적용한다.

check-jeus-installed

해당 노드에 JEUS가 설치되어 있는지 확인한다.

check-ssh-node

해당 SSH 노드의 SSH 설정이 제대로 동작하는지 확인한다.

install-jeus

해당 노드에 현재 도메인 구성을 포함하여 JEUS를 설치한다.

list-nodes

노드의 목록을 확인한다.

modify-java-node

저장된 Java 노드를 수정한다.

modify-node

저장된 노드를 수정한다.

modify-ssh-node

저장된 SSH 노드를 수정한다.

patch-info

해당 노드에 적용된 패치정보를 확인한다.

remove-node

저장된 노드를 삭제한다.

remove-patch

해당 노드에 적용된 패치를 삭제한다.

show-node

해당 노드의 설정을 확인한다.

uninstall-jeus

해당 노드에서 JEUS를 삭제한다.

1. add-java-node

동적으로 새로운 Java 노드를 추가한다. 각 옵션에 대해 알맞는 값을 입력하여 노드에 설정된 Java NodeManager 접속에 문제가 없도록 한다.

  • alias

    addjavanode

  • 사용법

    add-java-node <node-name>
                  -host <host-name>
                  [-port <port-number>]
                  [-ssl]
                  [-truststore <truststore-path>]
                  [-truststorepassword <truststore-password>]
  • 파라미터

    파라미터 설명

    <node-name>

    추가할 노드의 이름이다. ID로 사용되는 값이므로 유일해야 한다.

    -host <host-name>

    해당 노드의 노드 매니저에서 사용할 호스트 주소이다.

    [-port <port-number>]

    해당 노드의 노드 매니저에서 사용할 포트 번호이다. (기본값: 7730)

    [-ssl]

    SSL을 사용할 지 여부를 설정한다.

    [-truststore <truststore-path>]

    Truststore file의 경로를 설정한다.

    [-truststorepassword <truststore-password>]

    Truststore file의 password를 설정한다.

  • 예제

    [MASTER]domain1.adminServer> add-java-node node1 -host 192.168.34.55 -port 7730
    The node [node1] was successfully added.

2. add-ssh-node

동적으로 새로운 SSH 노드를 추가한다. 각 옵션에 대해 알맞는 값을 입력하여 SSH 접속에 문제가 없도록 한다. SSH 접속 가능 여부는 check-ssh-node 명령어를 통해 가능하며, 생성된 SSH 노드는 modify-ssh-node를 통해 수정 가능하다.

  • alias

    addsshnode

  • 사용법

    add-ssh-node <node-name> 
                 -host <host-name> 
                 [-dir <install-dir>]
                 [-port <port-number>]
                 [-user <user-name>]
                 [-privatekey <file-path>]
  • 파라미터

    파라미터 설명

    <node-name>

    추가할 원격 노드의 이름이다. ID로 사용되는 값이므로 유일해야 한다.

    -host <host-name>

    해당 원격 노드의 호스트 주소이다.

    [-dir <install-dir>]

    해당 원격 노드의 JEUS 설치 디렉터리이다.

    [-port <port-number>]

    SSH 접속 포트 번호이다. (기본값: 22)

    [-user <user-name>]

    SSH 접속 사용자명이다.

    [-privatekey <file-path>]

    SSH 접속을 위한 개인키 파일 경로이다.

  • 예제

    [MASTER]domain1.adminServer> add-ssh-node node1 -host 192.168.34.55 -dir /home/sshUser/jeus -user sshUser
    The node [node1] was successfully added.

3. apply-patch

설정한 노드에 패치 파일을 적용한다.

  • alias

    applypatch

  • 사용법

    apply-patch [<file-name>]
                [-nodes <node-name>]
                [-rolling]
                [-nomaster]
                [-action <action-on-error>]
  • 파라미터

    파라미터 설명

    [<file-name>]

    적용할 패치 파일을 설정한다. 설정하지 않은 경우 JEUS_HOME/lib/jext 디렉터리 전체를 전송한다.

    [-nodes <node-name>]

    패치를 적용할 노드 리스트를 설정한다. 설정하지 않은 경우 모든 도메인 내에 존재하는 노드에 적용한다.

    [-rolling]

    패치 파일 전송 후 서버를 재기동해 적용할지 여부를 설정한다.

    [-nomaster]

    MASTER는 재기동하지 않는다.

    [-action <action-on-error>]

    패치 파일 적용에 실패하는 경우 액션에 대해 설정한다.

    다음 중에 하나를 설정한다.

    • CONTINUE

    • ROLLBACK

    • STOP

  • 예제

    [MASTER]domain1.adminServer>apply-patch -nodes node2 jext.jar
    The patch was successfully applied to the nodes [node1].

4. check-jeus-installed

특정 노드에 JEUS가 설치되었는지를 확인한다. 결과값으로 해당 노드의 JEUS 버전 정보가 나온다.

  • alias

    checkjeusinstalled, isjeusinstalled

  • 사용법

    check-jeus-installed <node-name>
  • 파라미터

    파라미터 설명

    <node-name>

    노드의 이름이다.

  • 예제

    [MASTER]domain1.adminServer> check-jeus-installed node1
    The JEUS version on the node [node1]: JEUS 9 Fix#1

5. check-ssh-node

특정 SSH 노드에 Java 명령어를 수행해서 SSH 설정이 제대로 되어있는지 확인한다.

  • alias

    checksshnode, checknode

  • 사용법

    check-ssh-node <node-name>
  • 파라미터

    파라미터 설명

    <node-name>

    노드의 이름이다.

  • 예제

    [MASTER]domain1.adminServer> check-ssh-node node1
    The Domain Administration Server can execute the "java" process via SSH.

6. install-jeus

특정 노드에 현재 도메인의 설정을 포함하여 JEUS를 설치한다. 파일 압축 및 복사 작업이 이루어지므로 환경에 따라 시간이 오래 필요할 수 있다.

  • alias

    installjeus

  • 사용법

    install-jeus <node-name>
  • 파라미터

    파라미터 설명

    <node-name>

    노드의 이름이다.

  • 예제

    [MASTER]domain1.adminServer> install-jeus node1
    JEUS was successfully installed on the node [node1].

7. list-nodes

현재 구성되어 있는 노드의 목록을 조회한다. 노드의 이름, 종류, 제어 가능 여부, JEUS 설치 버전이 결과값으로 출력된다.

  • alias

    listnodes, nodelist

  • 사용법

    list-nodes [-onlyname]
  • 파라미터

    파라미터 설명

    [-onlyname]

    노드의 이름만을 나열하여 조회한다.

  • 예제

    [MASTER]domain1.adminServer> list-nodes
    ========================================================================
    +-------------+-----+---------------------+----------------------------+
    |  Node name  | Type|    Under control    |        JEUS version        |
    +-------------+-----+---------------------+----------------------------+
    | node1       | SSH | Y                   | -                          |
    | node2       | SSH | Y                   | JEUS 8.5                   |
    | node3       | JAVA| N                   | -                          |
    +-------------+-----+---------------------+----------------------------+
    ========================================================================

8. modify-java-node

특정 Java 노드의 설정을 변경한다.

  • alias

    modifyjavanode

  • 사용법

    modify-java-node <node-name>
                    [-host <host-name>]
                    [-port <port-number>]
                    [-ssl <enable-SSL>]
                    [-truststore <truststore-path>]
                    [-truststorepassword <truststore-password>]
  • 파라미터

    파라미터 설명

    <node-name>

    노드의 이름이다.

    [-host <host-name>]

    해당 노드의 노드 매니저에서 사용할 호스트 주소이다.

    [-port <port-number>]

    해당 노드의 노드 매니저에서 사용할 포트 번호이다. (기본값: 7736)

    [-ssl <enable-SSL>]

    SSL을 사용할지 여부를 설정한다.

    [-truststore <truststore-path>]

    Truststore file의 경로를 설정한다.

    [-truststorepassword <truststore-password>]

    Truststore file의 password를 설정한다.

  • 예제

    [MASTER]domain1.adminServer> modify-java-node node1 -port 7731
    The node [node1] was modified successfully. Check the results using "show-node"

9. modify-node

특정 노드의 설정을 변경한다. 노드 매니저 타입을 변경할 수 있다.

  • 사용법

    modify-node <node-name>
                [-type <node-type>]
                [-host <host-name>]
                [-port <port-number>]
                [-ssl <enable-ssl>]
                [-truststore <truststore-path>]
                [-truststorepassword <truststore-password>]
                [-dir <install-dir>]
                [-user <user-name>]
                [-privatekey <file-path>]
  • 파라미터

    파라미터 설명

    <node-name>

    노드의 이름이다.

    [-type <node-type>]

    해당 노드의 타입을 변경한다. java 또는 ssh 중 하나의 값을 입력할 수 있다.

    [-host <host-name>]

    해당 노드의 노드 매니저에서 사용할 호스트 주소이다.

    [-port <port-number>]

    해당 노드의 노드 매니저에서 사용할 포트 번호이다.

    (기본값: Java 타입의 경우 7730, SSH 타입의 경우 22)

    [-ssl <enable-ssl>]

    SSL을 사용할지 여부를 설정한다.

    [-truststore <truststore-path>]

    Truststore file의 경로를 설정한다.

    [-truststorepassword <truststore-password>]

    Truststore file의 password를 설정한다.

    [-dir <install-dir>]

    해당 노드에 JEUS가 설치된 경로를 설정한다.

    [-user <user-name>]

    SSH 접속 사용자명이다.

    [-privatekey <file-path>]

    SSH 접속을 위한 개인키 파일 경로이다.

  • 예제

    [MASTER]domain1.adminServer> modify-node node1 -type ssh -port 23
    The node [node1] was modified successfully. Check the results using "show-node"

10. modify-ssh-node

특정 SSH 노드의 설정을 변경한다.

  • alias

    modifysshnode, modifynode

  • 사용법

    modify-ssh-node <node-name>
                   [-host <host-name>]
                   [-dir <install-dir>]
                   [-port <port-number>]
                   [-user <user-name>]
                   [-privatekey <file-path>]
  • 파라미터

    파라미터 설명

    <node-name>

    노드의 이름이다.

    [-host <host-name>]

    해당 원격 노드의 호스트 주소이다.

    [-dir <install-dir>]

    해당 원격 노드의 JEUS 설치 디렉터리이다.

    [-port <port-number>]

    SSH 접속 포트 번호이다. (기본값: 22)

    [-user <user-name>]

    SSH 접속 사용자명이다.

    [-privatekey <file-path>]

    SSH 접속을 위한 개인키 파일 경로이다.

  • 예제

    [MASTER]domain1.adminServer> modify-ssh-node node1 -port 23
    The node [node1] was modified successfully. Check the results using "show-node"

11. patch-info

노드에 적용된 패치를 확인한다.

  • alias

    patchinfo, patch-list, patchlist, list-patch, listpatch

  • 사용법

    patch-info [<node-names>]
  • 파라미터

    파라미터 설명

    [<node-names>]

    노드의 이름이다. 노드가 한 개 이상인 경우는 콤마(,)로 구분한다.

  • 예제

    [MASTER]domain1.adminServer>patch-info
    Successfully got patch information for the nodes.
    ==========================================================
    Node Name[node1]
    
    +---------------------------------------+----------------+
    |            Patch File Name            | Patch Contents |
    +---------------------------------------+----------------+
    (No data available)
    
    Unable to get patch information to SSH NodeManager
    ==========================================================
    
    ===============================================================
    Node Name[node2]
    
    +--------------------------------------------+----------------+
    |               Patch File Name              | Patch Contents |
    +--------------------------------------------+----------------+
    | jext_patch_test.jar                        | patch test     |
    +--------------------------------------------+----------------+
    ===============================================================

12. remove-node

특정 노드를 삭제한다.

  • alias

    removenode, rmnode, rm-node

  • 사용법

    remove-node <node-name>
  • 파라미터

    파라미터 설명

    <node-name>

    노드의 이름이다.

  • 예제

    [MASTER]domain1.adminServer>remove-node node1
    The node [node1] was successfully removed.

13. remove-patch

설정한 노드에 적용된 패치 파일을 삭제한다.

  • alias

    removepatch, rmpatch, rm-patch

  • 사용법

    remove-patch [<file-name>]
                 [-nodes <node-name>]
                 [-rolling]
                 [-nomaster]
                 [-action <action-on-error>]
  • 파라미터

    파라미터 설명

    [<file-name>]

    삭제할 패치 파일을 설정한다. 설정하지 않은 경우 JEUS_HOME/lib/jext 디렉터리 전체를 삭제한다.

    [-nodes <node-name>]

    패치를 삭제할 노드 리스트를 설정한다. 설정하지 않은 경우 모든 도메인 내에 존재하는 노드에서 삭제한다.

    [-rolling]

    패치 파일 삭제 후 서버를 재기동할 때 삭제 내용을 적용할지 여부를 설정한다.

    [-nomaster]

    MASTER는 재기동하지 않는다.

    [-action <action-on-error>]

    패치 파일가 삭제 실패하는 경우의 액션에 대해 설정한다.

    다음 중에 하나를 설정한다.

    • CONTINUE

    • STOP

    • ROLLBACK

  • 예제

    [MASTER]domain1.adminServer>remove-patch -nodes node2 jext.jar
    The nodes [node2] have successfully removed patch file.

14. show-node

특정 노드의 정보를 조회한다. 노드의 기본 정보 외에 해당 노드에 매핑된 서버의 정보도 조회한다.

기본 SSH 노드 정보는 modify-ssh-node 명령어를 통해 변경 가능하다. 매핑된 서버의 정보는 modify-server 명령어를 통해 변경 가능하다.

  • alias

    shownode, nodeinfo

  • 사용법

    show-node <node-name>
  • 파라미터

    파라미터 설명

    <node-name>

    노드의 이름이다.

  • 예제

    [MASTER]domain1.adminServer> show-node node1
    ================================================================================
    +------------------+-----------------------------------------------------------+
    |     Property     |                           Value                           |
    +------------------+-----------------------------------------------------------+
    | Node Name        | node1                                                     |
    | Host             | 192.168.34.55                                             |
    | Mapped Servers   | adminServer server1                                       |
    | Node Type        | JAVA                                                      |
    | NodeManager Port |                                                      7730 |
    | Use SSL          | false                                                     |
    +------------------+-----------------------------------------------------------+
    ================================================================================

15. uninstall-jeus

특정 노드에 설치된 JEUS를 삭제한다.

  • alias

    uninstalljeus

  • 사용법

    uninstall-jeus <node-name>
  • 파라미터

    파라미터 설명

    <node-name>

    노드의 이름이다.

  • 예제

    [MASTER]domain1.adminServer> uninstall-jeus node1
    JEUS was successfully uninstalled from the node [node1].