1. OSGi 관련 명령어

OSGi 기능과 관련한 명령어의 목록은 다음과 같다.

명령어 설명

add-osgi-framework

도메인에 OSGi 프레임워크 설정을 추가한다.

install-bundle

지정한 위치에 있는 번들을 지정한 OSGi 프레임워크에 설치한다.

list-osgi-frameworks

도메인에 설정되어 있는 OSGi 프레임워크들에 대한 목록을 출력한다.

modify-osgi-framework

OSGi 프레임워크 설정을 수정한다.

remove-osgi-framework

OSGi 프레임워크 설정을 삭제한다.

show-osgi-framework-info

지정한 서버에서 실행 중인 OSGi 프레임워크들에 대한 정보를 출력한다.

start-bundle

지정한 번들을 시작한다.

stop-bundle

지정한 번들을 정지한다.

uninstall-bundle

지정한 번들을 삭제한다.

update-bundle

지정한 번들을 갱신한다.

1.1. add-osgi-framework

도메인에 OSGi 프레임워크 설정을 추가한다.

  • alias

    addfwk

  • 사용법

    add-osgi-framework -n,--name <framework-name>
                   [-en,--exportName <jndi-export-name>]
                   [-s,--servers <server-list>]
                   [-iib <true | false>]
                   [-ibd <path>]
                   [-dsl <start-level>]
                   [-foe <true | false>]
                   [-bid <path-list>]
                   [-f,--forceLock]
                   [-detail]

  • 파라미터

    파라미터 설명

    -n,--name <framework-name>

    OSGi 프레임워크에 대한 고유한 이름을 지정한다.

    [-en,--exportName <jndi-export-name>]

    OSGi 프레임워크에 대한 JNDI 이름을 지정한다.

    [-s,--servers <server-list>]

    OSGi 프레임워크를 사용할 서버 목록을 지정한다. 여러 서버를 지정할 경우 각 이름은 콤마(,)를 사용하여 구분한다.

    [-iib <true | false>]

    Initial Bundles Directory에 있는 번들의 설치 여부를 지정한다. (true | false)

    [-ibd <path>]

    Initial Bundles Directory의 경로를 지정한다. 지정하지 않은 경우 기본 경로로 JEUS_HOME/lib/osgi/FRAMEWORK_NAME을 사용한다.

    [-dsl <start-level>]

    초기 번들 디렉터리에 위치한 번들들에 대한 start level 기본값을 지정한다.

    [-foe <true | false>]

    초기 번들 설치가 제대로 이루어지지 않았을 경우 이를 오류로 간주할지 여부를 설정한다. (true | false)

    [-bid <path-list>]

    Bundle Installation Descriptor XML 파일들의 위치를 지정한다. 여러 파일을 지정할 경우 콤마(,)를 구분자로 사용한다.

    [-f,--forceLock]

    설정 변경을 강제로 진행하여 반영한다.

    [-detail]

    동적 변경 결과에 대한 상세한 정보가 출력된다.

  • 예제

    [MASTER]domain1.adminServer>list-osgi-frameworks
No OSGi Frameworks exists.

[MASTER]domain1.adminServer>add-osgi-framework -name framework-0 -servers server1
Successfully performed the ADD operation for OSGi Framework framework-0, but all changes were non-dynamic. They will be applied after restarting.
Check the results using "list-osgi-frameworks".

[MASTER]domain1.adminServer>list-osgi-frameworks
List of OSGi Frameworks
================================================================================
+------------------------+----------------------------+------------------------+
|     Framework Name     |      JNDI Export Name      |     Target Servers     |
+------------------------+----------------------------+------------------------+
| framework-0            |                            | server1                |
+------------------------+----------------------------+------------------------+
================================================================================
[MASTER]domain1.adminServer>

1.2. install-bundle

지정한 위치에 있는 번들을 지정한 OSGi 프레임워크에 설치한다.

  • alias

    installb

  • 사용법

    install-bundle -l,--location <location>
               -f,--framework <framework-name>
               -s,--server <server-name>

  • 파라미터

    파라미터 설명

    -l,--location <location>

    설치할 번들에 대한 URL을 지정한다.

    -f,--framework <framework-name>

    번들을 설치할 OSGi 프레임워크의 이름을 지정한다.

    -s,--server <server-name>

    번들을 설치할 서버를 지정한다.

  • 예제

    [MASTER]domain1.adminServer>install-bundle -location https://repo.maven.apache.org/maven2/org/ops4j/pax/url/pax-url-mvn/1.3.7/pax-url-mvn-1.3.7.jar
-framework framework-0 -server server1
Installation completed successfully.
[MASTER]domain1.adminServer>

1.3. list-osgi-frameworks

도메인에 설정되어 있는 OSGi 프레임워크들에 대한 목록을 출력한다.li

  • alias

    lsfwks

  • 사용법

    list-osgi-frameworks [-f,--framework <framework-name>]

  • 파라미터

    파라미터 설명

    [-f,--framework <framework-name>]

    지정한 OSGi 프레임워크 설정에 대한 상세를 출력한다.

  • 예제

    [MASTER]domain1.adminServer>list-osgi-frameworks
List of OSGi Frameworks
================================================================================
+------------------------+----------------------------+------------------------+
|     Framework Name     |      JNDI Export Name      |     Target Servers     |
+------------------------+----------------------------+------------------------+
| framework-0            |                            | server1                |
+------------------------+----------------------------+------------------------+
================================================================================

[MASTER]domain1.adminServer>list-osgi-frameworks -framework framework-0
OSGi Framework [framework-0]
================================================================================
+--------------------------------------------------------------+---------------+
|                        Attribute Name                        |     Value     |
+--------------------------------------------------------------+---------------+
| Framework Name                                               | framework-0   |
| JNDI Export Name                                             | Not Specified |
| Target Servers                                               | server1       |
| Install Initial Bundles                                      | true          |
| Initial Bundles Directory Location                           | Not Specified |
| Default Start Level                                          |            30 |
| Fail On Error                                                | true          |
+--------------------------------------------------------------+---------------+
================================================================================

Framework Configuration Properties
====================================================
+-----+--------------------------------------------+
| Key |                    Value                   |
+-----+--------------------------------------------+
(No data available)
====================================================

Bundle Installation Descriptors
================================================================================
+------------------------------------------------------------------------------+
|                                   Location                                   |
+------------------------------------------------------------------------------+
(No data available)
================================================================================

1.4. modify-osgi-framework

OSGi 프레임워크 설정을 수정한다.

  • alias

    modfwk

  • 사용법

    modify-osgi-framework -n,--name <framework-name>
                      [-en,--exportName <jndi-export-name>]
                      [-s,--servers <server-list>]
                      [-iib <true | false>]
                      [-ibd <path>]
                      [-dsl <start-level>]
                      [-foe <true | false>]
                      [-bid <path-list>]
                      [-f,--forceLock]
                      [-detail]

  • 파라미터

    파라미터 설명

    -n,--name <framework-name>

    OSGi 프레임워크에 대한 고유한 이름을 지정한다.

    [-en,--exportName <jndi-export-name>]

    OSGi 프레임워크에 대한 JNDI 이름을 지정한다.

    [-s,--servers <server-list>]

    OSGi 프레임워크를 사용할 서버 목록을 지정한다. 여러 서버를 지정할 경우, 각 이름은 콤마(,)를 사용하여 구분한다.

    [-iib <true | false>]

    Initial Bundles Directory에 있는 번들들을 설치 여부를 지정한다. (true | false)

    [-ibd <path>]

    Initial Bundles Directory의 경로를 지정한다. 지정하지 않은 경우 기본 경로로 JEUS_HOME/lib/osgi/FRAMEWORK_NAME을 사용한다.

    [-dsl <start-level>]

    초기 번들 디렉터리에 위치한 번들들에 대한 start level 기본값을 지정한다.

    [-foe <true | false>]

    초기 번들 설치가 제대로 이루어지지 않았을 경우 이를 오류로 간주할지 여부를 설정한다. (true | false)

    [-bid <path-list>]

    Bundle Installation Descriptor XML 파일들의 위치를 지정한다. 여러 파일을 지정할 경우 콤마(,)를 구분자로 사용한다.

    [-f,--forceLock]

    설정 변경을 강제로 진행하여 반영한다.

    [-detail]

    동적 변경 결과에 대한 상세한 정보가 출력된다.

  • 예제

    [MASTER]domain1.adminServer>modify-osgi-framework -name framework-0 -dsl 45 
Successfully performed the MODIFY operation for OSGi Framework framework-0, but some changes were non-dynamic. They will be applied after restarting.
Check the results using "list-osgi-frameworks".
[MASTER]domain1.adminServer>

1.5. remove-osgi-framework

OSGi 프레임워크 설정을 삭제한다.

  • alias

    rmfwk

  • 사용법

    remove-osgi-framework -n,--name <framework-name>

  • 파라미터

    파라미터 설명

    -n,--name <framework-name>

    삭제할 OSGi 프레임워크의 이름을 지정한다.

  • 예제

    [MASTER]domain1.adminServer>remove-osgi-framework -name framework-0
Successfully performed the REMOVE operation for OSGi Framework framework-0.
Check the results using "list-osgi-frameworks".
[MASTER]domain1.adminServer>

1.6. show-osgi-framework-info

지정한 서버에서 실행 중인 OSGi 프레임워크들에 대한 정보를 출력한다.

  • alias

    osgiinfo, fwkinfo

  • 사용법

    show-osgi-framework-info -s,--server <server-name>
                         [-f,--framework <framework-name>]
                         [-lb]

  • 파라미터

    파라미터 설명

    -s,--server <server-name>

    대상 서버를 지정한다.

    [-f,--framework <framework-name>]

    정보를 출력할 OSGi 프레임워크의 이름을 지정한다.

    [-lb]

    설치되어 있는 번들들에 대한 정보를 출력할지 여부를 지정한다. f 옵션과 함께 사용해야 한다.

  • 예제

    [MASTER]domain1.adminServer>show-osgi-framework-info -server server1 -framework framework-0 -lb
OSGi Framework [framework-0] Information in the server[framework-0]
Framework [framework-0] Overview
======================================================================
+----------------------------------------------------------+---------+
|                    System Bundle Name                    | Version |
+----------------------------------------------------------+---------+
| org.apache.felix.framework                               | 5.4.0   |
+----------------------------------------------------------+---------+
======================================================================

Installed Bundles in the framework [framework-0].
================================================================================
+----+-------------------+---------+--------------------+--------+-------------+
| Id |   Symbolic Name   | Version |      Location      |  State | Start-level |
+----+-------------------+---------+--------------------+--------+-------------+
|  0 | org.apache.felix. | 5.4.0   | System Bundle      | ACTIVE |           0 |
|    |framework          |         |                    |        |             |
+----+-------------------+---------+--------------------+--------+-------------+
|  2 | org.ops4j.pax.url | 1.3.7   | https://repo.maven | ACTIVE |          30 |
|    |.mvn               |         |.apache.org/maven2/ |        |             |
|    |                   |         |org/ops4j/pax/url/p |        |             |
|    |                   |         |ax-url-mvn/1.3.7/pa |        |             |
|    |                   |         |x-url-mvn-1.3.7.jar |        |             |
+----+-------------------+---------+--------------------+--------+-------------+
================================================================================

[MASTER]domain1.adminServer>

1.7. start-bundle

지정한 번들을 시작한다.

  • alias

    startb

  • 사용법

    start-bundle -name <bundle-symbolic-name>
             [-version <bundle-version>]
             -f,--framework <framework-name>
             -s,--server <server-name>

  • 파라미터

    파라미터 설명

    -name <bundle-symbolic-name>

    시작할 번들의 이름을 지정한다.

    [-version <bundle-version>]

    시작할 번들의 버전을 지정한다.

    -f,--framework <framework-name>

    OSGi 프레임워크의 이름을 지정한다.

    -s,--server <server-name>

    대상 서버를 지정한다.

  • 예제

    [MASTER]domain1.adminServer>start-bundle -name org.ops4j.pax.url.mvn -framework framework-0 -server server1
The bundle has been started successfully.
[MASTER]domain1.adminServer>

1.8. stop-bundle

지정한 번들을 정지한다.

  • alias

    stopb

  • 사용법

    stop-bundle -name <bundle-symbolic-name>
             [-version <bundle-version>]
             -f,--framework <framework-name>
             -s,--server <server-name>

  • 파라미터

    파라미터 설명

    -name <bundle-symbolic-name>

    정지할 번들의 이름을 지정한다.

    [-version <bundle-version>]

    정지할 번들의 버전을 지정한다.

    -f,--framework <framework-name>

    OSGi 프레임워크의 이름을 지정한다.

    -s,--server <server-name>

    대상 서버를 지정한다.

  • 예제

    [MASTER]domain1.adminServer>stop-bundle -name org.ops4j.pax.url.mvn -framework framework-0 -server server1
The bundle has been stopped successfully.
[MASTER]domain1.adminServer>

1.9. uninstall-bundle

지정한 번들을 삭제한다.

  • alias

    uninstallb

  • 사용법

    uninstall-bundle -name <bundle-symbolic-name>
                 [-version <bundle-version>]
                 -f,--framework <framework-name>
                 -s,--server <server-name>

  • 파라미터

    파라미터 설명

    -name <bundle-symbolic-name>

    삭제할 번들의 이름을 지정한다.

    [-version <bundle-version>]

    삭제할 번들의 버전을 지정한다.

    -f,--framework <framework-name>

    OSGi 프레임워크의 이름을 지정한다.

    -s,--server <server-name>

    대상 서버를 지정한다.

  • 예제

    [MASTER]domain1.adminServer>uninstall-bundle -name org.ops4j.pax.url.mvn -framework framework-0 -server server1
The bundle has been uninstalled successfully.
[MASTER]domain1.adminServer>

1.10. update-bundle

지정한 번들을 갱신한다.

  • alias

    updateb

  • 사용법

    update-bundle -name <bundle-symbolic-name>
              [-version <bundle-version>]
              -f,--framework <framework-name>
              -s,--server <server-name>
              [-l,--location <location>]

  • 파라미터

    파라미터 설명

    -name <bundle-symbolic-name>

    갱신할 번들의 이름을 지정한다.

    [-version <bundle-version>]

    갱신할 번들의 버전을 지정한다.

    -f,--framework <framework-name>

    OSGi 프레임워크의 이름을 지정한다.

    -s,--server <server-name>

    대상 서버를 지정한다.

    [-l,--location <location>]

    갱신할 때 사용할 번들에 대한 URL을 지정한다.

  • 예제

    [MASTER]domain1.adminServer>update-bundle -name org.ops4j.pax.url.mvn -framework framework-0 -server server1
The bundle has been updated successfully.
[MASTER]domain1.adminServer>