目錄位置和內容

在 Liberty 設定檔中,許多目錄都有相關聯的內容。 當您配置伺服器時,這些內容可用來指定檔案位置。

表 1. 執行時期環境預設目錄結構. 直欄 1 包含檔案和目錄樹。 如果目錄有相關聯的內容,這會出現在直欄 2。直欄 3 提供各檔案或目錄的說明。
目錄或檔案 內容 說明
wlp/ wlp.install.dir 安裝根目錄
+- bin/   用來管理安裝的 Script。 例如:server
+- clients/   Liberty 設定檔用戶端和小型用戶端檔案庫。例如,restConnector.jar
   +- jython/   Jython 型 Script
+- dev/   開發人員資源(API、SPI、規格和工具)的根目錄
   +- api/   依預設,在編譯和執行時期都能使用的公用 API
     +- ibm/   Liberty 設定檔中可用的 API
        +- javadoc/   Java™ 文件保存檔
     +- spec/   依預設,在編譯和執行時期都能使用的公用規格 API
     +- third-party/   在編譯時期預設為可用,在執行時期,必須指定在配置中(利用應用程式 classloader 元素的 apiTypeVisibility 屬性來指定)的協力廠商 API。
   +- spi/   依預設在編譯和執行時期都能使用的公用 SPI
     +- ibm/   Liberty 設定檔中可用的 SPI
        +- javadoc/   用於 SPI 的 Java 文件保存檔
     +- spec/   依預設在編譯和執行時期都能使用的公用規格 SPI
   +- tools/   Liberty 設定檔的 Ant 外掛程式
+- etc/   適用於所有伺服器的使用者自訂伺服器變數(選用)
   +- server.env   預設伺服器 Script 環境變數(選用)
   +- client.env   預設用戶端 Script 環境變數(選用)
   +- jvm.options   預設 JVM 選項(選用)
+- lafiles/   授權資訊檔
+- lib/   平台執行時期環境
+- templates/   執行時期自訂作業範本和範例
[8.5.5.6 或更新版本]   +- client/ [8.5.5.6 或更新版本]  [8.5.5.6 或更新版本][8.5.5.6 或更新版本]建立用戶端時的用戶端範本
   +- server/   建立伺服器時的伺服器範本
+- usr/ wlp.user.dir 使用者目錄
   +- extension/ usr.extension.dir 使用者開發的特性
   +- shared/    
      +- apps/ shared.app.dir 共用應用程式
      +- config/ shared.config.dir 共用配置檔
      +- resources/ shared.resource.dir 共用資源定義:配接器、資料來源
   +- servers/   共用伺服器目錄
      +- server_name server.config.dir 伺服器配置目錄。利用 ${server.config.dir} 來參照伺服器特定配置(應用程式)。
         +- bootstrap.properties   伺服器引導內容(選用)
         +- jvm.options   伺服器 JVM 選項,用來取代 wlp/etc/jvm.options 中的值(選用)
         +- server.env   wlp/etc/server.env 合併的伺服器 Script 環境變數(選用)
         +- server.xml   伺服器配置重疊(必要)
         +- apps/   應用程式的伺服器配置
         +- dropins/   伺服器預設應用程式 dropins 資料夾(選用)
            +- application_name   應用程式資料夾或保存檔(選用)
[8.5.5.5 或更新版本]         +- configDropins/ [8.5.5.5 或更新版本]  [8.5.5.5 或更新版本]伺服器配置 dropins 資料夾(選用)
[8.5.5.5 或更新版本]            +- defaults [8.5.5.5 或更新版本]  [8.5.5.5 或更新版本]預設伺服器配置 dropins 資料夾(選用)
[8.5.5.5 或更新版本]            +- overrides [8.5.5.5 或更新版本]  [8.5.5.5 或更新版本]伺服器配置置換項目 dropins 資料夾(選用)
      +- server_name server.output.dir 伺服器輸出目錄。利用 ${server.output.dir} 來說明伺服器產生的構件(日誌檔和工作區)。
         +- logs/   伺服器日誌檔,其中包括 FFDC 日誌(伺服器第一次執行之後,目錄就會存在)
            +- console.log   基本伺服器狀態和作業訊息
            +- trace_timestamp.log   含時間戳記的追蹤訊息,詳細層次取決於現行追蹤配置
            +- ffdc/   「首次失敗資料擷取 (FFDC)」輸出目錄
               +- ffdc_timestamp/   「首次失敗資料擷取 (FFDC)」輸出,通常包括與要求的作業失敗之相關診斷資料的選擇性記憶體傾出
         +- workarea/   伺服器作業時所建立的檔案(伺服器第一次執行之後,目錄就會存在)
[8.5.5.6 或更新版本]   +- clients/   共用用戶端目錄
      +- client_name   用戶端配置目錄。
         +- bootstrap.properties   用戶端引導內容(選用)
         +- client.jvm.options   用戶端 JVM 選項,會取代 wlp/etc/client.jvm.options 中的值(選用)
         +- client.xml   用戶端配置重疊(必要)
         +- apps/   應用程式的用戶端配置
         +- logs/   伺服器日誌檔,包括 FFDC 日誌(用戶端第一次執行之後,目錄就會存在)
            +- trace_timestamp.log   含時間戳記的追蹤訊息,詳細層次取決於現行追蹤配置
            +- ffdc/   「首次失敗資料擷取 (FFDC)」輸出目錄
               +- ffdc_timestamp/   「首次失敗資料擷取 (FFDC)」輸出,通常包括與要求的作業失敗之相關診斷資料的選擇性記憶體傾出
         +- workarea/   用戶端運作時所建立的檔案(用戶端第一次執行之後,目錄就會存在)

如果有各目錄的相關內容,在配置伺服器時,您可以利用這些內容來指定檔案位置。 如需範例,請參閱將應用程式部署到 Liberty 設定檔

提示: 如果要確保配置具有可攜性,請使用最明確的適用內容,不要依賴資源之間的關係。 比方說,在某些配置中,安裝位置 ${wlp.install.dir} 可能不是自訂實例 ${wlp.user.dir} 的母項。

程式化存取位置內容

位置內容可以利用 server.xml 檔中的 jndiEntry 配置元素,以您選擇的名稱來連結到 JNDI 名稱空間中,例如:

<jndiEntry jndiName="serverName" value="${wlp.server.name}"/>

在伺服器(應用程式、共用程式庫或特性)中執行的任何程式碼都可以通過 JNDI 查閱來存取這些項目:

Object serverName = new InitialContext().lookup("serverName");

如需如何在配置中使用 JNDI 項目的相關資訊,請參閱從伺服器配置檔使用常數的 JNDI 連結

特性程式碼也可以利用核心提供的系統程式設計介面 (SPI) 來解析這些內容的值,例如:

ServiceReference <WsLocationAdmin>locationAdminRef = bundleContext.getServiceReference(WsLocationAdmin.class);
WsLocationAdmin locationAdmin = bundleContext.getService(locationAdminRef);
String serverName = locationAdmin.resolveString("${wlp.server.name}");

指示主題類型的圖示 參照主題

資訊中心條款 | 意見


「時間戳記」圖示 前次更新: 2015 年 6 月 22 日
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=rwlp_dirs
檔名:rwlp_dirs.html