表 14–1 列出與連線服務相關的代理程式特性。
表 14–1 代理程式連線特性| 特性 | 類型 | 預設 | 說明 | 
|---|---|---|---|
| 字串 | jms,admin | ||
| 字串 | 所有可用的 IP 位址 | 所有連線服務的預設主機名稱或 IP 位址 | |
| 字串 | 無 | 連接埠對映器的主機名稱或 IP 位址 如果指定,會置換 imq.hostname | |
| 整數 | 7676 | 連接埠對映器的連接埠號 備註 – 如果在同一台主機上執行多個代理程式實例,那麼每一個實例都必須指定唯一的連接埠對映器連接埠。 | |
| imq.serviceName .protocolType.hostname [僅限 jms、ssljms、admin 與 ssladmin 服務;請參閱附錄 CHTTP/HTTPS 支援 以取得更多有關配置 httpjms 與 httpsjms 服務的資訊] | 字串 | 無 | 連線服務的主機名稱或 IP 位址 如果指定,會置換所指定連線服務的 imq.hostname | 
| 整數 | 0 | 連線服務的連接埠號 0 值指定連接埠對映器應動態配置連接埠號。 | |
| 整數 | 50 | 作業系統儲存區中的最大擱置連接埠對映器請求數 | |
| 字串 | dedicated | 用於執行緒池管理的執行緒模型: dedicated:每個連線都有兩個專屬執行緒,一個用於內送訊息,另一個用於外寄訊息 shared:連線在傳送或接收訊息時會由共用執行緒進行處理 | |
| 專屬模型會限制所能支援的連線數目,但可以提供較高的效能;共用模型可增加連線數目,但因為需要額外的經常性耗用時間進行執行緒管理,所以效能較低。 | |||
| 整數 | jms:10 ssljms:10 httpjms:10 httpsjms:10 admin:4 ssladmin:4 | 連線服務的執行緒池中所維護的最小執行緒數 當可用的執行緒數超過此臨界值時,將會在執行緒閒置時將其關閉,直到達到臨界值下限為止。 如其所示,預設值因連線服務而異。 | |
| 整數 | jms:1000 ssljms:500 httpjms:500 httpsjms:500 admin:10 ssladmin:10 | 執行緒數目,一旦超過此數目,系統便不會將新的執行緒增加至執行緒池,供已命名的連線服務使用 此數目必須大於 0,並且必須大於 imq.serviceName.min_threads 的值。 如其所示,預設值因連線服務而異。 | |
| 整數 | Solaris:512 Linux:512 Windows:64 | 由分散執行緒監視的最大連線數目 系統配置了足夠的分散執行緒以監視所有連線。此特性的值愈小,將執行緒指定給使用中連線的速度愈快。-1 值表示不限制每個執行緒的連線數目。 如其所示,預設值因作業系統平台而異。 | |
| 整數 | 120 | 測試用戶端與代理程式之間連線的時間間隔 (以秒為單位) 0 或 -1 值可停用定期的連線測試。 | 
表 14–2 列出與路由服務相關的代理程式特性。可配置以自動建立目標的特性列於表 14–3 中。
表 14–2 代理程式路由特性表 14–3 自動建立的目標之代理程式特性
Message QueueTM 支援永久性資料存放區的檔案式與 JDBC 型模型。代理程式特性 imq.persist.store (表 14–4) 可指定要使用哪種模型。以下各節描述兩種模型的代理程式配置特性。
表 14–4 全域代理程式永久性特性| 特性 | 類型 | 預設 | 說明 | 
|---|---|---|---|
| 字串 | file | 永久性資料存放區的模型: file:檔案式永久性 jdbc:JDBC 型永久性 | 
表 14–5 列出與檔案式永久性相關的代理程式特性。
表 14–5 檔案式永久性的代理程式特性
表 14–6 列出與 JDBC 型永久性相關的代理程式特性。所示範例為 DataMirror Mobile Solutions, Inc. 資料庫產品的 PointBase® 系列。
表 14–6 JDBC 型永久性的代理程式特性
表 14–7 列出與安全性服務相關的代理程式特性。
表 14–7 代理程式安全性特性| 特性 | 類型 | 預設 | 說明 | 
|---|---|---|---|
| 布林值 | true | 如果為 true,系統將會檢查存取控制特性檔案,以驗證認證的使用者已取得授權使用連線服務或執行與特定目標相關的特定作業。 | |
| imq.serviceName.accesscontrol.enabled | 布林值 | 無 | 要使用連線服務的存取控制? 如果指定,會置換指定之連線服務的 imq.accesscontrol.enabled。 如果為 true,系統將會檢查存取控制特性檔案,以驗證認證的使用者已取得授權使用連線服務或執行與特定目標相關的特定作業。 | 
| 字串 | accesscontrol.properties | 存取控制特性檔的名稱 檔案名稱可指定與存取控制目錄相關的路徑 (請參閱附錄 AMessage QueueTM 資料的特定平台位置)。 | |
| 字串 | 無 | 連線服務的存取控制特性檔名稱 如果指定,會置換指定之連線服務的 imq.accesscontrol.file.filename。 檔案名稱可指定與存取控制目錄相關的路徑 (請參閱附錄 AMessage QueueTM 資料的特定平台位置)。 | |
| 字串 | digest | basic:Base64 digest:MD5 | |
| 字串 | 無 | basic:Base64 digest:MD5 如果指定,會置換指定之連線服務的 imq.authentication.type。 | |
| 字串 | file | Base64 認證的使用者儲存庫類型: file:檔案式 ldap:LDAP | |
| 整數 | 180 | 等待用戶端回應認證請求的時間間隔 (以秒為單位) | |
| 布林值 | false | 要從密碼檔案取得密碼? | |
| 字串 | 前往包含密碼檔的路徑 | ||
| 字串 | passfile | ||
| 字串 | 無 | 管理使用者的密碼 指令公用程式 (imqcmd) 可使用此密碼,在執行指令之前認證該使用者。 | |
| 字串 | 無 | LDAP 伺服器的主機名稱與連接埠號 值的格式為 hostName: port 其中 hostName 是執行 LDAP 伺服器的主機之完全合格 DNS 名稱,而 port 是該伺服器使用的連接埠號。 | |
| 若要指定容錯移轉伺服器的清單,請使用下列語法: host1: port1 ldap://host2 : port2 ldap://host3 :port3 … | |||
| 清單中的項目以空格分開。請注意,每個容錯移轉伺服器位址都會以 ldap:// 開頭。即使您使用 SSL 並且將特性 imq.user_repository.ldap.ssl.enabled 設定為 true,也請使用此格式。您不需要在位址中指定 ldaps。 | |||
| 字串 | 無 | 可供連結到 LDAP 使用者儲存庫的辨別名稱 如果 LDAP 伺服器允許匿名搜尋,則不需要。 | |
| 字串 | 無 | 可供連結到 LDAP 使用者儲存庫的密碼 如果 LDAP 伺服器允許匿名搜尋,則不需要。 | |
| 敬請期待 | 敬請期待 | 敬請期待 | |
| 字串 | 無 | LDAP 使用者項目的目錄基底 | |
| 字串 | 無 | LDAP 使用者名稱的提供者專用屬性識別碼 | |
| 字串 | 無 | (選擇性) LDAP 使用者搜尋的 JNDI 篩選器 | |
| 布林值 | false | 啟用 LDAP 群組搜尋? 備註 – Message Queue 不支援巢式群組。 | |
| 字串 | 無 | LDAP 群組項目的目錄基底 | |
| 字串 | 無 | LDAP 群組名稱的提供者專用屬性識別碼 | |
| 字串 | 無 | LDAP 群組中使用者名稱的提供者專用屬性識別碼 | |
| 字串 | 無 | (選擇性) LDAP 群組搜尋的 JNDI 篩選器 | |
| 整數 | 280 | LDAP 搜尋的時間限制 (以秒為單位) | |
| 布林值 | false | 要使用 SSL 與 LDAP 伺服器進行通訊? | |
| 字串 | 前往包含金鑰庫檔案的路徑 | ||
| 字串 | keystore | 金鑰庫檔的名稱 | |
| 字串 | 無 | 金鑰庫檔的密碼 | |
| 布林值 | false | 要啟動代理程式記錄檔的稽核記錄功能? | 
表 14–8 列出與監視服務相關的代理程式特性。
表 14–8 代理程式監視特性
表 14–9 列出與代理程式叢集相關的配置特性。
表 14–9 叢集配置的代理程式特性| 特性 | 類型 | 預設 | 說明 | 
|---|---|---|---|
| 字串 | 無 | 代理程式位址的清單 此清單由以逗號分隔的一個或多個位址組成。每個位址都可指出叢集中某個代理程式的主機名稱與連接埠對映器之連接埠號,使用的格式為 hostName: portNumber。 範例: host1:3000,host2:8000,ctrlhost | |
| 字串 | 無 | 如果指定,會置換 cluster 連線服務的 imq.hostname (請參閱表 14–1)。 | |
| 整數 | 0 | 0 值指定連接埠對映器應動態配置連接埠號。 | |
| 字串 | tcp | 為了在代理程式之間以安全方式傳送加密的訊息,請將此特性設定為 ssl。 | |
| 字串 | 無 | 範例: http://webserver/imq/cluster.properties (適用於 Web 伺服器上的檔案) file:/net/mfsserver/imq/cluster.properties (適用於共用磁碟機上的檔案) | |
| 字串 | 無 | 叢集主代理程式的主機名稱和連接埠號 (如果存在) 值的格式為 hostName: portNumber,其中 hostName 是主代理程式的主機名稱, portNumber 是其連接埠對映器的連接埠號。 範例: ctrlhost:7676 | 
按字母順序排列的代理程式特性清單是按字母順序排列的代理程式配置特性清單,可與本章中的相關表格交叉參照。
表 14–10 按字母順序排列的代理程式特性清單| 特性 | 表格 | 
|---|---|
| imq.persist.store | |