1. Local 명령어

다음은 서버 접속, 도움말, 히스토리 기능 등을 제공하는 기본 명령어들이다.

명령어 설명

connect

JEUS Master Server나 Managed Server에 접속을 시도한다.

disconnect

접속을 끊고 Off-line 상태로 돌아간다.

help

명령어에 대한 도움말을 출력한다.

history

입력했던 명령어들에 대한 기록을 출력한다.

p

입력했던 명령어들 중 하나를 골라 실행한다. 옵션을 주지 않고 실행하는 경우 직전에 실행했던 명령어를 다시 실행한다.

remove-login-cache

cachelogin 기능을 통해 저장된 특정 사용자 로그인 정보를 캐시 파일에서 제거한다.

set-server-option

server 옵션에 대한 기본값을 설정한다.

set-servers-option

servers 옵션에 대한 기본값을 설정한다.

start-record

입력하는 명령어들을 스크립트 형태로 저장하는 레코딩 기능을 시작한다.

stop-record

레코딩 기능을 중지한다.

unset-server-option

set-server-option으로 설정한 기본값을 삭제한다.

unset-servers-option

set-servers-option으로 설정한 기본값을 삭제한다.

verbose

명령어를 수행할 때 상세 출력 모드를 켜거나 끈다.

1.1. connect

서버에 접속을 시도한다. 사용자 이름과 비밀번호를 입력해 주어야한다. host를 입력받지 않으면 localhost로 접속을 시도한다.

  • alias

    login

  • 사용법

    connect [-u,--username <user-name>]
            [-p,--password <password>]
            [-f <file-name>]
            [-cachelogin]
            [-h,--host <server-address>]
            [-port <server port>]
            [-d,--domain <domain name>]
  • 파라미터

    파라미터 설명

    [-u, --username <user-name>]

    접속할 때 사용할 사용자 이름을 지정한다.

    [-p, --password <password>]

    접속할 때 사용할 비밀번호를 지정한다.

    [-f <file-name>]

    접속할 때 사용할 사용자 이름과 비밀번호를 저장한 파일을 지정한다.

    [-cachelogin]

    접속할 때 사용한 사용자 이름과 비밀번호를 파일에 기록한다.

    [-h, --host <server-address>]

    접속할 서버의 주소를 지정한다. 아무 것도 입력하지 않으면 localhost로 접속을 시도한다.

    [-port <server-port>

    접속할 서버의 포트를 지정한다. 별도로 지정하지 않는 경우 물어보지 않고 기본값을 사용한다. (기본값: 9736)

    [-d, --domain <domain name>

    도메인 이름을 지정한다. security.key 파일을 찾기 위해 사용된다.

  • 예제

    • [-u] 옵션과 [-p] 옵션을 주고, [-h] 옵션으로 접속할 호스트 정보를 입력하여 명령을 실행한다.

      offline>connect -u administrator -p jeus -h 127.0.0.1
      Attempting to connect to 127.0.0.1:9736.
      The connection has been established to JEUS Master Server [adminServer] in the domain [domain1].
      [MASTER]domain1.adminServer>
    • [-h] 옵션을 넣지 않은 경우 localhost로 접속하게 된다.

      offline>connect -u administrator -p jeus
      Attempting to connect to 127.0.0.1:9736.
      The connection has been established to JEUS Master Server [adminServer] in the domain [domain1].
      [MASTER]domain1.adminServer>
  • 참고

    본 명령어는 서버에 접속하지 않은 상태에서도 사용할 수 있다.

1.2. disconnect

접속을 끊고 Off-line 상태로 돌아가는 명령어이다.

  • alias

    logout

  • 사용법

    disconnect
  • 예제

    offline>connect
    Enter the server address:
    User name: administrator
    Password:
    Attempting to connect to 127.0.0.1:9736.
    The connection has been established to JEUS Master Server [adminServer] in the domain [domain1].
    
    [MASTER]domain1.adminServer>disconnect
    The connection has been closed.
    offline>
  • 참고

    본 명령어는 서버에 접속하지 않은 상태에서도 사용할 수 있다.

1.3. help

명령어들에 대한 도움말을 출력한다. 별도의 옵션을 주지 않고 실행할 경우 도움말과 함께 현재 사용할 수 있는 명령어 목록, 명령어 기본 문법에 대한 설명을 조회한다.

  • 사용법

    help [-g,--group <group-name> | <command-name> | -l,--list]
  • 파라미터

    파라미터 설명

    [-g,--group <group-name>]

    주어진 그룹(group name)에 속한 명령어에 대한 목록과 간단한 설명을 출력한다.

    [<command-name>]

    특정 명령어(command name)에 대한 도움말을 출력한다.

    명령어 이름, 별칭(alias), 사용법, 옵션에 대한 정보를 조회한다.

    옵션을 생략하고 사용할 수도 있다.

    [-l,--list]

    모든 명령어에 대한 간단한 설명을 출력한다.

  • 예제

    • help 명령어만 사용할 경우

      offline>help
      LIST OF AVAILABLE COMMANDS
      [Local]____________________________________________________________________
        connect                             disconnect
        exit                                help
        history                             p
        remove-login-cache                  set-server-option
        set-servers-option                  start-record
        stop-record                         unset-server-option
        unset-servers-option                verbose
      
      [Server Management]________________________________________________________
        local-shutdown
      
      [Domain Configuration]_____________________________________________________
        apply-configuration-plan            create-domain
        delete-domain                       list-domains
        pack-domain                         unpack-domain
      
      [Application]______________________________________________________________
        install-application                 install-deployment-plan
        redeploy-application
      
      [Library]__________________________________________________________________
        install-library
      
      [Web]______________________________________________________________________
        precompile-jsp
      
      COMMAND GRAMMAR
          Command Usage
              COMMAND [COMMAND_OPTIONS] [GLOBAL_OPTIONS] [(>|>>) FILENAME]
          Details
              COMMAND: target command to execute.
              [COMMAND_OPTIONS]: Options for target command.
              [GLOBAL_OPTIONS]: Common options for all commands.
                  -verbose
                      Prints the stack trace for errors.
                  -repeat <count>
                      Repeats the target command X times.
                  -interval <seconds>
                      Specifies the interval at which to repeat execution, in
                      seconds.
              [(>|>>) FILENAME]
                  Prints the result of the target command to the specified file.
          Examples
              help -l -repeat 3 -interval 10 > result.txt
      
      To show detailed information for a command, use 'help [COMMAND_NAME]'.
      ex) help connect
      offline>
    • help 명령어에 [-l] 옵션과 같이 사용하는 경우

      offline>help -l
      [Local]____________________________________________________________________
        connect                  Attempting to authenticate with the target
                                 server.
        disconnect               Disconnects from the currently connected server.
      
        ......
      
      [Server Management]________________________________________________________
        local-shutdown           Shuts down the currently connected server.
      
        ......
      
      
      To show detailed information for a command, use 'help [COMMAND_NAME]'.
      ex) help connect
      offline>
    • help 명령어에 [-g] 옵션과 같이 사용하는 경우

      다음은 'Server Management' 그룹 명령어 목록을 출력하는 예제이다.

      offline>help -g "Server Management"
      [Server Management]________________________________________________________
        local-shutdown    Shuts down the currently connected server.
      
      To show detailed information for a command, use 'help [COMMAND_NAME]'.
      ex) help connect
      offline>
    • [<command-name>] 옵션을 사용해 특정 명령어에 대한 도움말을 조회하는 경우

      다음은 add-server 명령어 설명을 출력하는 예제이다.

      [MASTER]domain1.adminServer>help add-server
      NAMES
          add-server
              Adds a new server to the domain configuration. If a server name is
              not provided, the current server list in this domain will be shown.
      ALIAS
          addserver
      USAGE
          add-server <server-name>
              [-target,--duptargetserver <target-server>]
              [-port,--baseport <base-port>]
              [-addr,--baseaddr <base-addr>]
              [-http,--httpport <http-port>]
              [-node,--nodeName <node-name>]
              [-jvm,--jvmOptions <jvm-options>]
              [-logdir,--logHomeDirectory <server-log-home-directory>]
              [-a,--actionOnResourceLeak <action-on-resource-leak>]
              [-l,--logStdoutToRawFormat <print-stdout-to-raw-format>]
              [-m,--mejb <enable-MEJB>]
              [-c,--classFtp <enable-class-ftp-service>]
              [-f,--forceLock]
              [-detail]
      OPTIONS
          <server-name>
              the name of server you want to modify configuration of
      
          [-target,--duptargetserver <target-server>]
              duplicate the configuration of the target server
      
          [-port,--baseport <base-port>]
              base service listen port of the server
      
          [-addr,--baseaddr <base-addr>]
              base service listen address of the server
      
          [-http,--httpport <http-port>]
              http listen port of the server
      
          [-node,--nodeName <node-name>]
              name of the node this server is located
      
          [-jvm,--jvmOptions <jvm-options>]
              jvm configurations applied to this server jvm
      
          [-logdir,--logHomeDirectory <server-log-home-directory>]
              the log directory which has all the log files created by this server
      
          [-a,--actionOnResourceLeak <action-on-resource-leak>]
              strategy when resource leak is detected. it must be one of
              AutoClose, NoAction, Warning
      
          [-l,--logStdoutToRawFormat <print-stdout-to-raw-format>]
              [Dynamic] whether stdout is printed in row format or in JEUS Logger
              format.
      
          [-m,--mejb <enable-MEJB>]
              [Dynamic] whether using MEJB or not .true, false
      
          [-c,--classFtp <enable-class-ftp-service>]
              [Dynamic] whether using class ftp service or not .true, false
      
          [-f,--forceLock]
              Acquires the configuration lock forcibly.
      
          [-detail]
              Show detail results
  • 참고

    본 명령어는 서버에 접속하지 않은 상태에서도 사용할 수 있다.

1.4. history

이전에 실행했던 명령어 목록을 조회한다.

명령어 목록은 ${user.home}/.jeusadmin/commandHistory에 저장된다. 기록한 명령어를 다시 실행할 경우에는 p 명령어를 사용한다. 실행했던 명령어 기록은 최대 100개까지 가능하다.

  • 사용법

    history [-clear | <size>]
  • 파라미터

    파라미터 설명

    [-clear]

    실행했던 명령어 목록을 지우고 초기화한다.

    [<size>]

    출력할 명령어 개수를 설정한다. 최근에 실행한 순으로 size만큼 출력한다.

  • 예제

    offline>history
    1 : help history
    2 : connect -u administrator -p jeus
    3 : disconnect
    
    To execute a command in the history, please use '!' command (e.g. ! 7)
    offline>history 3
    3 : disconnect
    
    To execute a command in the history, please use '!' command (e.g. ! 7)
    offline>history -clear
    The command history has been cleared.
    offline>
  • 참고

    본 명령어는 서버에 접속하지 않은 상태에서도 사용할 수 있다.

1.5. p

실행했던 명령어를 다시 실행하려고 할 때 사용한다. 실행했던 명령어 목록은 history 명령어를 통해 확인할 수 있다.

  • alias

    !

  • 사용법

    p [<history-number>]
  • 파라미터

    파라미터 설명

    [<history-number>]

    명령어 기록에서 실행할 명령어의 번호를 지정한다.

  • 예제

    offline>history
    1 : connect -u jeus -p jeus
    2 : disconnect
    
    To execute a command in the history, please use '!' command (e.g. ! 7)
    offline>p 1
    connect -u jeus -p jeus
    Attempting to connect to 127.0.0.1:9736.
    The connection has been established to JEUS Master Server [adminServer] in the domain [domain1].
    [MASTER]domain1.adminServer>! 2
    disconnect
    The connection has been closed.
    offline>
  • 참고

    본 명령어는 서버에 접속하지 않은 상태에서도 사용할 수 있다.

1.6. remove-login-cache

cachelogin 기능을 통해 저장된 특정 사용자 로그인 정보를 캐시 파일에서 제거한다.

cachelogin 기능에 의해 저장된 로그인 정보는 <domain-name>과 <user-name>에 의해 구분된다.

  • 사용법

    remove-login-cache [-domain <domain-name>]
                       [-u <user-name>]
                       [-f <file-name>]
  • 파라미터

    파라미터 설명

    [-domain <domain-name>]

    로그인 정보를 저장할 때 사용했던 도메인 이름을 지정한다.

    [-u <user-name>]

    로그인 정보를 저장할 때 사용했던 사용자 이름을 지정한다.

    [-f <file-name>]

    사용자 이름과 비밀번호가 저장된 비밀번호 파일 이름을 지정한다.

  • 예제

    offline>remove-login-cache -domain domain1 -u user1
    The cached login information [domain1:user1] has been successfully removed from /home/OSUser/.jeusadmin/.jeuspasswd.
  • 참고

    본 명령어는 서버에 접속하지 않은 상태에서도 사용할 수 있다.

1.7. set-server-option

-server 옵션에 대한 기본값을 설정할 수 있는 기능을 제공한다. 옵션을 주지 않고 사용할 경우 현재 설정한 기본값을 출력한다.

  • alias

    setserver

  • 사용법

    set-server-option <server-name>
  • 파라미터

    파라미터 설명

    <server-name>

    server 옵션에 대해 기본값으로 사용할 서버 이름을 설정한다.

  • 예제

    adminServer를 기본값으로 설정하여 jndi-info 명령어를 실행한다. set-server-option 명령어를 사용해 <server-name>를 지정해주기 전에는 jndi-info 명령어를 실행하면 -server 옵션이 주어지지 않았다는 오류가 발생하지만, 지정해 준 후에는 별도로 -server 옵션을 주지 않아도 adminServer에 대해 jndi-info 명령어가 동작함을 확인할 수 있다.

    [MASTER]domain1.adminServer>jndi-info
    The following options are missing: server
    
    [MASTER]domain1.adminServer>set-server-option
    The default server name is not set.
    
    [MASTER]domain1.adminServer>set-server-option adminServer
    The default server name has been set: adminServer.
    
    [MASTER]domain1.adminServer>set-server-option
    The current default server name: adminServer.
    
    [MASTER]domain1.adminServer>jndi-info
    The JNDI list on the adminServer
    List of the context /
    ================================================================================
    +---------------------+----------------------------------------+---------------+
    |         Name        |                  Value                 | Local Binding |
    +---------------------+----------------------------------------+---------------+
    | ConnectionFactory   | jeus.jms.client.facility.factory.JeusC | false         |
    |                     |onnectionFactory                        |               |
        ......
    
    [MASTER]domain1.adminServer>
  • 참고

    본 명령어는 서버에 접속하지 않은 상태에서도 사용할 수 있다.

1.8. set-servers-option

-servers 옵션에 대한 기본값을 설정한다. 옵션을 주지 않고 실행한 경우 현재 설정되어 있는 기본값을 출력한다.

  • alias

    setservers

  • 사용법

    set-servers-option [<server-list>]
  • 파라미터

    파라미터 설명

    [<server-list>]

    servers 옵션에 대해 기본값으로 사용할 서버 이름들을 지정한다. 각 서버 이름은 콤마(,)로 구분한다.

  • 예제

    set-servers-option 명령어를 사용하여 deploy할 서버 목록을 지정한 후 deploy 명령어를 통해 지정한 서버 애플리케이션을 배포하는 예제이다.

    [MASTER]domain1.adminServer>set-servers-option
    The default server list is not set.
    
    [MASTER]domain1.adminServer>set-servers-option adminServer,server1
    The default server list has been set: adminServer,server1.
    
    [MASTER]domain1.adminServer>set-servers-option
    The current default server list: adminServer,server1.
    
    [MASTER]domain1.adminServer>deploy sample
    deploy the application for the application [sample] succeeded.
    
    [MASTER]domain1.adminServer>appinfo
    Application information for the domain [domain1].
    ================================================================================
    +----------+-----------+---------+-------------+----------+--------------------+
    | Applicati|Application|  State  |    Target   |  Target  |  Application Path  |
    |  on ID   |   Type    |         |   Servers   | Clusters |                    |
    +----------+-----------+---------+-------------+----------+--------------------+
    | sample   | WAR       | RUNNING | server1,admi|          | ${INSTALL_HOME}/sam|
    |          |           |         |nServer      |          |ple/sample.war      |
    +----------+-----------+---------+-------------+----------+--------------------+
    ================================================================================
  • 참고

    본 명령어는 서버에 접속하지 않은 상태에서도 사용할 수 있다.

1.9. start-record

입력한 명령어들을 스크립트 파일에 기록하는 레코딩 기능을 시작한다.

지정한 레코딩 파일의 확장자에 따라 해당 스크립트로 명령어들이 저장된다. 레코딩이 시작되면 프롬프트에 "-Rec*"이 추가된다.

  • alias

    startrecord

  • 사용법

    start-record [<recfile>]
  • 파라미터

    파라미터 설명

    [<recfile>]

    명령어 기록할 파일을 지정한다. 스크립트 파일로 저장이 되므로 현재 지원하는 스크립트의 확장자인 .py, .rb만 확장자로 사용이 가능하다.

  • 예제

    • 옵션을 주지 않고 실행한 경우는 record_script_[timestamp].py 파일에 저장한다.

      offline>start-record
      Starting recording to file : record_script_20150101123456.py
      offline-Rec*>
    • [<recfile>]을 지정한 경우 해당 파일에 저장한다.

      offline>start-record record.py
      Starting recording to file : record.py
      offline-Rec*>
  • 참고

    본 명령어는 서버에 접속하지 않은 상태에서도 사용할 수 있다.

1.10. stop-record

레코딩 기능을 중지한다.

  • alias

    stoprecord

  • 사용법

    stop-record
  • 예제

    offline-Rec*>stop-record
    Stopping recording to file : recrod.py
    offline>
  • 참고

    본 명령어는 서버에 접속하지 않은 상태에서도 사용할 수 있다.

1.11. unset-server-option

set-server-option 명령어로 설정한 기본값을 삭제한다.

  • alias

    unset-server-option

  • 사용법

    unset-server-option
  • 예제

    unset-server-option을 사용하여 set-server-option으로 설정한 기본값을 해제하였다. 해제한 후 jndi-info 명령어를 실행하면 server 옵션이 필요하다는 오류가 발생하는 것을 확인할 수 있다.

    [MASTER]domain1.adminServer>set-server-option
    The current default server name: adminServer.
    
    [MASTER]domain1.adminServer>unset-server-option
    The default server name has been unset.
    
    [MASTER]domain1.adminServer>set-server-option
    The default server name is not set.
    
    [MASTER]domain1.adminServer>jndi-info
    The following options are missing: server
  • 참고

    본 명령어는 서버에 접속하지 않은 상태에서도 사용할 수 있다.

1.12. unset-servers-option

set-servers-option 명령어로 지정한 -servers 옵션에 대한 기본값 설정을 삭제한다.

  • alias

    unsetservers

  • 사용법

    unset-servers-option
  • 예제

    [MASTER]domain1.adminServer>set-servers-option
    The current default server list: adminServer,server1.
    
    [MASTER]domain1.adminServer>unset-servers-option
    The default server list has been unset.
    
    [MASTER]domain1.adminServer>set-servers-option
    The default server list is not set.
    
    [MASTER]domain1.adminServer>
  • 참고

    본 명령어는 서버에 접속하지 않은 상태에서도 사용할 수 있다.

1.13. verbose

명령어 수행 과정을 상세히 출력할지 여부를 설정한다. 옵션을 주지 않은 경우 현재 상세 출력이 켜져 있는지 꺼져 있는지 알려준다. 상세 출력이 켜져 있는 경우 명령어 수행 중 예외가 발생하면 Stack Trace를 출력하게 된다.

  • 사용법

    verbose [-off | -on]
  • 파라미터

    파라미터 설명

    [-on]

    상세 출력을 켠다.

    [-off]

    상세 출력을 끈다.

  • 예제

    • 현재 상세 출력이 켜져 있는지 여부를 확인하는 예제

      offline>verbose
      Verbose output disabled.
      offline>
    • 실제 사용 예제

      offline>verbose
      Verbose output disabled.
      
      offline>help notexistcommand
      Command notexistcommand not found
      
      offline>verbose -on
      Verbose output is enabled.
      
      offline>help notexistcommand
      Command notexistcommand not found
      jeus.tool.console.executor.CommandException: Command notexistcommand not found
      
        ......
      
      offline>verbose -off
      Verbose output disabled.
      
      offline>help notexistcommand
      Command notexistcommand not found
      offline>
  • 참고

    본 명령어는 서버에 접속하지 않은 상태에서도 사용할 수 있다.