Karaf - 퀵 스타트

[원본 출처] http://karaf.apache.org/manual/latest/quick-start.html

Quick Start(퀵스타트)

This instructions should help you get Apache Karaf up and running in 5 to 15 minutes.
이 설명은 당신이 Apache Karaf 를 5~15분에 올려서(설치해서) 실행하는 것을 돕는다.

Prerequisites(전제조건)

Karaf requires a Java SE 7 environment to run. Refer to http://www.oracle.com/technetwork/java/javase/ for details on how to download and install Java SE 1.7 or greater.
Karaf 는 실행하기 위해 Java SE 7 환경이 필요하다.  Java SE1.7 이나 그 이상을 어떻게 다운로드 하고 설치 하는지에 대한 상세는 http://www.oracle.com/technetwork/java/javase/를 참조하라.  

• Open a Web browser and access the following URL: http://karaf.apache.org/index/community/download.html
  브라우져를 열어 다음 URL에 접속하라 : http://karaf.apache.org/index/community/download.html
• Download the binary distribution that matches your system (zip for windows, tar.gz for unixes)
  당신의 시스템과 일치하는 바이너리 배포판을 다운로드 받아라. (윈도우는 zip, 유닉스는 tar.gz)
• Extract the archive a new folder on your hard drive; for example in c:\karaf - from now on this directory will be referenced as <KARAF_HOME>.
  하드디스크에 새폴더에 압축을 해제하라. 예를 들면 c:\karaf 안에 - 지금부터 이 디렉토리는 나중에 <KARAF_HOME> 으로 참조하게 될 것이다.

Start the server(서버 실행)

Open a command line console and change the directory to <KARAF_HOME>.
명령어 라인 콘솔을 열어라 그리고 <KARAF_HOME>으로 디렉토리를 변경하라.

To start the server, run the following command in Windows:
서버를 실행하기 위해 윈도우에서 아래 명령어를 실행하라.

bin\karaf.bat

respectively on Unix:
각각 유닉스에서

bin/karaf

You should see the following information on the command line console:
명령어 라인 콘솔에서 아래와 같은 정보를 보게 될 것이다.

        __ __                  ____
       / //_/____ __________ _/ __/
      / ,<  / __ `/ ___/ __ `/ /_
     / /| |/ /_/ / /  / /_/ / __/
    /_/ |_|\__,_/_/   \__,_/_/

  Apache Karaf (3.0.0)

Hit '<tab>' for a list of available commands
and '[cmd] --help' for help on a specific command.
Hit '<ctrl-d>' or type 'system:shutdown' or 'logout' to shutdown Karaf.

karaf@root()>

Some shell Basics( 몇가지 기본 쉘)

You can now run your first command. Simply type the <tab> key in the console.
이제 첫번째 명령어를 실행 할수 있다. 단순히 그 콘솔에서 <tab> 카를 입력하라.

karaf@root> Display all 183 possibilities? (y or n)
*:config          *:dev           *:feature        *:instance    *:jaas          *:kar         *:log         *:package
*:region          *:service        *:shell         *:ssh         addbundle        addfilter    addregion     alias
cancel     cl        clear    clone  config      config:cancel    config:delete  config:edit   config:list     config:property-append   config:property-delete    config:property-list    config:property-set    config:update  connect create
date       delete  destroy   dev    dev:dump-create  display     dump-create         each
...

You can then grab more specific help for a given command using the --help option for this command:
그 명령어 창에 --help 옵션을 사용하여 명령어창에서 주어진 더 특별한 도움을 얻을 수 있다. 

karaf@root()> bundle:list --help
DESCRIPTION
        bundle:list

        Lists all installed bundles.

SYNTAX
        bundle:list [options]

OPTIONS
        -u
                Shows the update locations
        --help
                Display this help message
        --table
                Show bundles using a shell table
        -t
                Specifies the bundle threshold; bundles with a start-level less than this value will not get printed out.
        -l
                Show the locations
        -s
                Shows the symbolic name

Note that the console supports tab completion so if your start typing a command it will show possible completions and also auto complete if there is only one completion.
콘솔은 탭 완성를 지원하고 그래서 만약 당신이 명령어를 입력하기 시작하면 그것은 가능한 완성을 보여주고 또한 만약 단 하나의 완성이면 자동 완료된다. 

Deploy a sample application(어플리케이션의 배포)

While you will learn in the Karaf user's guide how to fully use and leverage Apache Karaf, let's install a sample Apache Camel application for now:
당신이 Karaf 사용자 가이드에서 Apache Karaf를 완벽히 이용하고 활용하는 방법을 배우게 될 동안 단순한 Apache Camel  어플리션을 설치해 보자

In the console, run the following commands:
콘솔에서 아래 명령어를 실행하라.

karaf@root()> feature:repo-add camel 2.10.0
Adding feature url mvn:org.apache.camel.karaf/apache-camel/2.10.0/xml/features
karaf@root()> feature:install camel-spring
karaf@root()> bundle:install -s mvn:org.apache.camel/camel-example-osgi/2.10.1

The example installed is using Camel to start a timer every 2 seconds and output a message on the console.
설치된 샘플은 매 2초마다 타이버를 시작하고 콘솔에 메시지를 출력하기 위해 Camel 사용하게 될 것이다.
The previous commands download the Camel features descriptor and install the example feature.
앞의 명령어들은  카멜 기능 설명을 다운로드하고 샘플 기능을 설치한다.

>>>> SpringDSL set body:  Fri Jan 07 11:59:51 CET 2011
>>>> SpringDSL set body:  Fri Jan 07 11:59:53 CET 2011
>>>> SpringDSL set body:  Fri Jan 07 11:59:55 CET 2011

Stopping and uninstalling the sample application(샘플 어플리케이션의 정지와 제거하기)

To stop this demo, run the following command:
이 데모를 멈추기 위해 아래의 명령어를 실행하라.

karaf@root()> bundle:stop org.apache.camel.camel-example-osgi

Stopping Karaf(Karaf 정지하기)

To stop Karaf from the console, enter ^D in the console:
콘솔로 부터 Karaf를 정지하기 위해 콘솔에 ^D 을 입력하라. 

^D

Alternatively, you can also run the following command:
또한 아래 명려어를 입력 할 수 있다.

system:shutdown

Cleaning the Karaf state(Karaf 상태 초기화하기)

Normally Karaf remembers the features and bundles you installed and started. The reset Karaf into a clean state just delete the data directory when karaf is not running.
보통 Karaf 는 당신이 설치했고 시작했던 기능과 번들을 기억하고 있다.  깨끗한 상태로 Karaf  리셋은 karaf가 실행중이 아닐때 단지 data 디렉토리를 지운다.

Summary(요약)

This document showed how simple it is to have Apache Karaf up and running and install a simple Apache Camel application.
이 단순히 어떻게 Apache Karaf를 얻고 실행하고 또 단순 Apache Camel 어플리케이션을 설치하는지를 보여준다.