Apache Karaf使用者指導

Apache Karaf使用者指導 一 安裝karaf

本章講述如何在windows和unix平台安裝Apache Karaf，這裡你將知道預先要安裝什麼軟體，如何下載並且安裝Karaf。 預先安裝需求 硬體： - 20M磁碟剩餘空間。 作業系統： Windows：Windows vista，Windows XP sp2，windows2000。- Unix：Ubuntu Linux，Powerdog Linux,MacOS，AIX,HP-UX,Solaris，任何支援java的unix平台。 環境： Java SE 1.5x或者更高。- 環境變數JAVAHOME必須設定為java運行時的安裝目錄，比如C:\Program Files\Java\jdk1.6.026。按住windows和break鍵切換到進階選項，點擊環境變數，把上面的路徑加入到變數中。 從源碼構建

如果你想從源碼構建KARAF，需求會有點不同： 硬體： - 200M磁碟空間便於apache karaf源碼展開或者是SVN的驗證，以及maven構建和依賴maven組件的下載。 環境： JDK 1.5或者是更高。- Apache maven 2.2.1. 在windows上構建

這過程說明如何下載和安裝windows上的源碼檔案。註：Karaf需要java5編譯，構建和運行。 在瀏覽器輸入http://karaf.apache.org/index/community/download.html. 滾動到“Apache Karaf”地區選取項目需要的連結。源碼檔案名稱類似於：apache-karaf-x.y-src.zip. 解壓縮zip檔案到你選擇的目錄中，請記住非法java路徑的限制，比如。，%等。 用maven 2.2.1 或者更高的java5來構建karaf。 構建karaf的方法如下：
Cd [karaf安裝路徑]\src- Mvn
這兩個步驟均需要10到15分鐘。 用zip工具加壓檔案，windows的路徑是 [karaf安裝路徑]\assembly\target\apache-karaf-x.y.zip 轉到開始karaf一節 在Unix上構建

本過程將講述如何在unix系統上下載和安裝源碼檔案。這裡假定unix機器上有瀏覽器，沒有瀏覽器的請參照前面二進位unix安裝地區。註：Karaf需要java5編譯，構建和運行。 在瀏覽器輸入http://karaf.apache.org/ download.html. 滾動到“Apache Karaf”地區選取項目需要的連結。源碼檔案名稱類似於：apache-karaf-x.y-src.zip. 解壓縮zip檔案到你選擇的目錄中，例如：gunzip apache-karaf-x.y-src.tar.gz tar xvf apache-karaf-x.y-src.tar請記住非法java路徑的限制，比如。，%等 用maven構建karaf建議方法如下: cd [karaf安裝路徑]\src cvn 5.解壓縮剛剛建立的檔案 cd [karaf安裝路徑]/assembly/target gunzip apache-karaf-x.y.tar.gz tar xvf apache-karaf-x.y.tar 轉到開始karaf一節 Windows安裝過程

這裡說明如何在windows系統上下載和安裝二進位檔案。 在瀏覽器輸入http://karaf.apache.org/index/community/download.html. 滾動到“Apache Karaf”地區選取項目需要的連結。源碼檔案名稱類似於：apache-karaf-x.y-src.zip. 解壓縮zip檔案到你選擇的目錄中，請記住非法java路徑的限制，比如。，%等。 轉到開始karaf一節 可選：在Windows中啟用彩色控制台輸出 - 提示：如果你安裝karaf到很深的路徑或者是非法的java路徑，。，%等，你可以建立一個bat檔案來執行：subst S: "C:\your very % problematic path!\KARAF" 這樣karaf的路徑是 s: 這樣的短類型。 Unix安裝過程

這裡屬於如何在unix系統上下載和安裝二進位檔案。 在瀏覽器輸入http://karaf.apache.org/ download.html. 滾動到“Apache Karaf”地區選取項目需要的連結。源碼檔案名稱類似於：apache-karaf-x.y.tar.gz 解壓縮zip檔案到你選擇的目錄中，例如：gunzip apache-karaf-x.y.tar.gz tar xvf apache-karaf-x.y.tar 請記住非法java路徑的限制，比如。，%等。 轉到開始karaf一節 安裝後的步驟

在開始使用karaf之前強烈建議設定指向JDK的JAVA_HOME用來定位java可執行檔，並且應該配置為指向已安裝java se5或者6的根目錄。 二 目錄結構

Karaf安裝目錄結構如下： /bin: 啟動指令碼 /etc: 初始設定檔案 /data: 工作目錄 /cache: OSGi架構套件緩衝 /generated-bundles: 部署使用的臨時檔案夾 /log: 記錄檔 /deploy: 熱部署目錄 /instances: 含有子執行個體的目錄 /lib: 包含引導庫 /lib/ext:JRE擴充目錄 /lib/endorsed: 贊同庫目錄 /system: OSGi包庫，作為一個Maven2存放庫

Data檔案夾包括karaf所有的工作和臨時檔案，如果你想從一個初始狀態重啟，你可以清空這個目錄，這和“恢複初始化設定”一樣的效果。 三 啟動和停止karaf

本章介紹如何啟動和停止Apache Karaf和各種可用的選項。 啟動karaf

Windows下：開啟一個控制台視窗，更改到安裝目錄，並運行Karaf。對於二進位檔案，運行 Cd [karaf安裝目錄] 然後輸入：bin\karaf.bat

Linux下：開啟一個控制台視窗，更改到安裝目錄，並運行Karaf。運行 Cd [karaf安裝目錄] 然後輸入：bin\karaf 警告：karaf運行後不要關閉控制台，否則會終止karaf（除非用非控制台啟動karaf）。 非控制台啟動karaf

沒有控制台也可以啟動karaf，它總可以是用遠程SSH訪問，是用下面的命令： bin\karaf.bat server 或者是unix下：bin/karaf server 在後台啟動karaf

採用以下命令可以輕易地在後台進程啟動karaf： Bin\start.bat 或者在unix下：bin/start 重設模式啟動karaf

清空[karaf安裝目錄]\data檔案夾就可以簡單的在重設模式啟動karaf，為方便起見，在karaf啟動指令碼使用以下參數也可以實現重設啟動：bin/start clean 停止karaf

無論是windows還是unix，你都可以在karaf控制台採用以下命令來停止它： osgi:shutdown， 或者簡單的是：shutdown。

Shutdown命令會詢問你是否真的想要停止，如果你確認停止並且拒絕確認資訊，你可以用-f或者-force選項： osgi：shutdown –f， 也可以用時間參數來延遲停止，時間參數有不同的形式。

首先，可以是絕對時間各式hh：mm。第二，也可以是+m，其中m是等待的分。現在就是+0。

下面的命令可以在10:35am關閉karaf:

osgi:shutdown 10:35。

下面的命令在10分鐘後關閉karaf：

osgi:shutdown +10。

如果你在主控制台運行，用登出或者Ctrl+D退出控制台也可以終止karaf執行個體。 在控制台你可以運行如下命令：

bin\stop.bat

或者在unix下：

bin/stop。 四 使用控制台 查看可用的命令

按提示鍵tab可以在控制台看到可用的命令列表：

root@root> <tab>Display all 182 possibilities? (y or n)*:help                           addurl                           admin:change-optsadmin:change-rmi-registry-port   admin:change-ssh-port            admin:connectadmin:create                     admin:destroy                    admin:listadmin:rename                     admin:start                      admin:stopbundle-level                     cancel                           catchange-opts                      change-rmi-registry-port         change-ssh-portclear                            commandlist                      config:cancelconfig:edit                      config:list                      config:propappendconfig:propdel                   config:proplist                  config:propsetconfig:update                    connect                          createcreate-dump                      destroy                          dev:create-dumpdev:dynamic-import               dev:framework                    dev:print-stack-tracesdev:restart                      dev:show-tree                    dev:watchdisplay                          display-exception                dynamic-importeach                             echo                             editexec                             exports                          features:addurlfeatures:info                    features:install                 features:listfeatures:listrepositories        features:listurl                 features:listversionsfeatures:refreshurl              features:removerepository        features:removeurlfeatures:uninstall               framework                        getgrep                             head                             headershelp                             history                          ifimports                          info                             installjaas:cancel                      jaas:commandlist                 jaas:listjaas:manage                      jaas:roleadd                     jaas:roledeljaas:update                      jaas:useradd                     jaas:userdeljaas:userlist                    java                             listlistrepositories                 listurl                          listversionslog:clear                        log:display                      log:display-exceptionlog:get                          log:set                          log:taillogout                           ls                               managemore                             new                              osgi:bundle-levelosgi:headers                     osgi:info                        osgi:installosgi:list                        osgi:ls                          osgi:refreshosgi:resolve                     osgi:restart                     osgi:shutdownosgi:start                       osgi:start-level                 osgi:stoposgi:uninstall                   osgi:update                      packages:exportspackages