上一頁      目錄      索引      下一頁
Sun Java System Message Queue 3 2005Q1 管理指南

第 2 章
管理快速入門

本快速入門的重點放在基本管理工作，亦即使用圖形化介面的管理主控台來管理 Message Queue 代理程式與物件儲存。您只要遵循本章中的指示，將可學習如何執行以下作業：

啟動代理程式。
連線至代理程式，並且使用管理主控台來管理代理程式。
在代理程式上建立實體目標。
建立物件儲存並使用管理主控台連線至此物件儲存。
將目標物件新增到物件儲存中，並檢視其特性。

快速入門旨在設定當您執行簡單 JMS 相容應用程式 HelloWorldMessageJNDI 時所需的實體目標和受管理物件。此應用程式在範例應用程式目錄 (Solaris 和 Windows 平台的 demo 或 Linux 的 examples；請參閱附錄 A「Message Queue 資料的作業系統特定位置」) 的 helloworld 子目錄中。您將在本快速入門的最後部分，執行此應用程式。

提供本快速入門主要是為了指導您使用管理主控台執行基本的管理工作。這不能取代您閱讀和參照文件。

有些 Message Queue 管理工作不能靠管理主控台來完成。類似下列的工作，必須使用指令行公用程式來執行：

配置某些實體目標特性
建立代理程式叢集
管理使用者資料庫

如需如何完成這些工作的詳細資訊，請參閱第 6 章「管理實體目標」、第 9 章「使用代理程式叢集」和第 7 章「管理安全性」。

---

準備工作

在您開始之前，請務必先安裝 Message Queue 產品。如需更多資訊，請參閱 Message Queue Installation Guide。請注意，本章主要以 Windows 為主，並針對 UNIX® 使用者加入備註。

在本章中，選擇 [Item1] > [Item2] > [Item3] 表示您應下拉名為 Item1 的功能表，從此功能表中選擇 Item2，然後從 Item2 提供的選取中選擇 Item3。

---

啟動管理主控台

若要啟動管理主控台，請執行以下方法之一：

在 Windows 上，請選擇 [開始] > [程式集] > [Sun Microsystems] > [Sun Java System Message Queue 3.6] > [管理]。
在 Solaris 上，請輸入下列指令：

/usr/bin/imqadmin

在 Linux 上，請輸入下列指令：

/opt/sun/mq/bin/imqadmin

可能需要等待幾秒鐘之後才會顯示主控台視窗。

花費幾秒鐘查看主控台視窗。

主控台視窗特徵為，頂部有一個功能表列，緊挨功能表列下面為工具列，視窗左側為瀏覽窗格，右側為結果窗格 (此時正顯示識別 Sun Java System Message Queue 產品的圖形)，視窗底部為狀態窗格。

本章未提供完整的資訊，因此讓我們首先找到取得管理主控台說明資訊的方法。

取得說明

在功能表列的最右端可以找到 [說明] 功能表。

若要顯示管理主控台說明資訊

下拉 [說明] 功能表並選擇 [簡介]。畫面上將會顯示說明視窗。





請注意說明資訊的組織方式。左側的瀏覽窗格顯示目錄表；右側的結果窗格顯示您在瀏覽窗格選取的任何項目的內容。

查看 [說明] 視窗的結果窗格。它顯示管理主控台的框架視區，可識別每個主控台窗格的使用。

查看 [說明] 視窗的瀏覽窗格。它以三個區域管理主題：簡介、物件儲存管理和代理程式管理。每個區域均包含檔案與資料夾。每個資料夾為包含多個標籤的對話方塊提供說明；每個檔案為單個對話方塊或標籤提供說明。

您的第一項主控台管理工作 (新增代理程式) 將是建立可透過主控台管理的代理程式的參照。但是開始之前，請先檢查線上說明以獲得資訊。

在 [說明] 視窗的目錄窗格中，按一下 [新增代理程式] 項目。

請注意結果窗格已經變更。它此時包含介紹新增代理程式涵義的文字，還包含描述 [新增代理程式] 對話方塊中每個欄位之使用的文字。欄位名稱以粗體文字顯示。

閱讀此說明文字。
關閉 [說明] 視窗。

---

啟動代理程式

您無法使用管理主控台啟動代理程式。請使用下列其中一種方法：

在 Windows 上，請選擇 [開始] > [程式集] > [Sun Microsystems] > [Sun Java System Message Queue 3.6] > [訊息代理程式]。
在 Solaris 上，請輸入下列指令：

/usr/bin/imqbrokerd

在 Linux 上，請輸入下列指令：

/opt/sun/mq/bin/imqbrokerd

如果您使用 Windows [開始] 功能表，會出現指令視窗。指令出現下列回應時，表示代理程式已經備妥，顯示如下行：

Loading persistent data...
Broker “imqbroker@stan:7676 ready.

返回至管理主控台視窗。此時，您可以將代理程式新增至主控台並連線至此代理程式。

在向管理主控台中的代理程式新增參照之前，您不必啟動此代理程式，但是您必須啟動代理程式之後才可以與其連線。

---

新增代理程式

新增代理程式可建立管理主控台中代理程式的參照。新增代理程式之後，您可以連線至此代理程式。

若要將代理程式新增至管理主控台

在瀏覽窗格中的 [代理程式] 上按一下滑鼠右鍵，然後選擇 [新增代理程式]。
在 [代理程式標籤] 欄位中輸入 MyBroker。

這可提供識別管理主控台中代理程式的標籤。





請注意對話方塊中指定的預設主機名稱 (localhost) 和主要連接埠 (7676)。稍後當您配置連線工廠 (用戶端將用來設定與此代理程式的連線) 時，您必須指定這些值。

保留 [密碼] 欄位為空白。如果您在連線時指定密碼將更安全。

按一下 [確定] 以新增此代理程式。

查看瀏覽窗格。您剛新增的代理程式應已在 [代理程式] 下列出。代理程式圖示上的紅色 X 表示此代理程式目前尚未連線至主控台。





在 [MyBroker] 上按一下滑鼠右鍵，然後從快顯功能表中選擇 [特性]。

畫面上將會顯示代理程式特性對話方塊。您可以使用此對話方塊更新您在新增此代理程式時指定的任何特性。

按一下 [取消] 以關閉此對話方塊。

---

連線至代理程式

若要連線至代理程式

在 MyBroker 上按一下滑鼠右鍵，然後選擇 [連線至代理程式]。

出現對話方塊，要求您輸入使用者名稱和密碼。





依預設，管理主控台可以用使用者 admin，密碼 admin 連線至代理程式。在本例，使用預設值。在實際情況中，您應儘快建立安全的使用者名稱和密碼。請參閱認證使用者，以獲得更多資訊。

在 [密碼] 欄位中輸入 admin。

指定使用者名稱 admin 並提供正確的密碼可讓您連線至代理程式，並擁有管理權限。

按一下 [確定] 以連線至此代理程式。

連線至此代理程式之後，您可以從 [動作] 功能表中選擇以獲得有關代理程式的資訊、暫停並繼續代理程式、關閉並重新啟動代理程式以及與代理程式中斷連線。

檢視連線服務

透過代理程式提供的連線服務和它支援的實體目標可以識別此代理程式。

若要檢視可用的連線服務

在瀏覽窗格中選取 [服務]。

可用的服務會在結果窗格中列出。對於每種服務，均會提供其名稱、連接埠號與狀態。





按一下結果窗格中的 jms 服務選取此服務。
下拉 [動作] 功能表並注意反白顯示的項目。

您便可以暫停 jms 服務或檢視與更新其特性。

從 [動作] 功能表中選擇 [特性]。

請注意，透過使用 [服務特性] 對話方塊，您可以為服務指定靜態連接埠號，還可以變更配置給此服務的最小和最大執行緒數量。





按一下 [確定] 或 [取消] 以關閉 [特性] 對話方塊。
在結果窗格中選取 admin 服務。
下拉 [動作] 功能表。

請注意您無法暫停此服務 (暫停項目已停用)。admin 服務是管理員與代理程式的連結。如果暫停此服務，您將無法再存取代理程式。

選擇 [動作] > [特性] 以檢視 admin 服務的特性。
當您完成之後，按一下 [確定] 或 [取消]。

將實體目標新增至代理程式

依預設，代理程式啟用實體目標自動建立功能。自動建立功能可以讓代理程式動態建立實體目標。

在開發環境中，您不需明確建立實體目標來測試用戶端程式碼。

在生產設定中，建議您明確建立實體目標。這樣可讓您 (管理員) 充分地瞭解在代理程式上使用的實體目標。

現在您要將實體目標新增至代理程式。請注意您指定給此目標的名稱；稍後當您建立與此實體目標相對應的受管理物件時將需要此名稱。

若要將佇列目標新增至代理程式

在 MyBroker 的 [目標] 節點上按一下滑鼠右鍵，然後選擇 [新增代理程式目標]。

畫面上將會顯示以下對話方塊：





在 [目標名稱] 欄位中輸入 MyQueueDest。
如果尚未選取 [佇列] 單選按鈕，請選取此按鈕。
按一下 [確定] 以新增此實體目標。

此時此實體目標將會在結果窗格中出現。

管理實體目標

一旦您已在代理程式上新增實體目標，您便可以進行以下任何工作，如以下程序中所述：

檢視與更新實體目標的特性
清除實體目標的訊息
刪除實體目標

若要檢視實體目標的特性

選取 MyBroker 的 [目標] 節點。

結果面板中出現兩個實體目標，MyQueueDest 和 mq.sys.dmq。mq.sys.dmq 目標是系統建立的佇列，儲存代理程式的到期訊息和拒絕訊息。目前請暫時略過此停用的訊息佇列。

在結果窗格中選取 [MyQueueDest]。
選擇 [動作] > [特性]。

畫面上將會顯示以下對話方塊：





請注意，對話方塊會顯示目前有關佇列的狀態資訊，以及一些您可以變更的特性資訊。

按一下 [取消] 以關閉此對話方塊。

清除實體目標的訊息

在結果窗格中選取實體目標。
選擇 [動作] > [清除訊息]。

畫面上將會顯示確認對話方塊。

清除訊息可移除訊息並保留空白目標。

若要刪除目標

在結果窗格中選取實體目標。
選擇 [編輯] > [刪除]。

畫面上將會顯示確認對話方塊。

備註	請勿刪除 MyQueueDest 佇列目標。

刪除實體目標時會清除此目標上的訊息並移除此目標。

取得有關主題的資訊

代理程式主題目標的特性對話方塊包括一個列示長期訂閱資訊的附加標籤。此標籤在佇列為停用狀態。

您可以使用此對話方塊：

清除長期訂閱以及移除與長期訂閱相關聯的所有訊息
刪除長期訂閱、清除與長期訂閱相關聯的所有訊息以及移除長期訂閱

---

使用物件儲存

物件儲存可用來儲存 Message Queue 受管理物件。這些受管理物件封裝 Message Queue 特定的有關用戶端應用程式所用物件的實作與配置資訊。物件儲存可能是 LDAP 目錄伺服器或檔案系統儲存 (檔案系統中的目錄)。

受管理物件可以在用戶端程式碼中創設與配置。但是管理員最好還是在用戶端應用程式可以透過 JNDI 存取的物件儲存中，建立、配置並儲存這些物件。這樣可讓用戶端程式碼獨立於供應程式。

您無法使用管理主控台建立物件儲存。您必須提前進行此作業，如以下一節中所述。

新增物件儲存

新增物件儲存可在管理主控台中建立現有物件儲存的參照。即使您退出並重新啟動主控台，此參照仍可保留。

新增檔案系統物件儲存

如果您的 C 磁碟機上還沒有名為 Temp 的資料夾，請現在建立一個。

本章中所用範例應用程式假設物件儲存為 C 磁碟機上名為 Temp 的資料夾。一般來說，檔案系統物件儲存可以為任何磁碟機上的任何目錄。

非 Windows：您可以使用 /tmp 目錄，此目錄應已存在。

在 [物件儲存] 上按一下滑鼠右鍵，然後選擇 [新增物件儲存]。

畫面上將會顯示以下對話方塊：





在名為 [ObjectStoreLabel] 的欄位中輸入 MyObjectStore。

此項僅可為管理主控台中的物件儲存顯示提供標籤。

在以下步驟中，您必須輸入 JNDI 名稱/值對。JMS 相容應用程式將使用這些名稱/值對來查找受管理物件。

從 [名稱] 下拉式清單中選取 java.naming.factory.initial。

此特性可讓您指定要使用何種 JNDI 服務供應程式。例如，檔案系統服務供應程式或 LDAP 服務供應程式。

在 [值] 欄位中輸入以下內容

com.sun.jndi.fscontext.RefFSContextFactory

這表示您將使用檔案系統儲存。(對於 LDAP 儲存，您將指定 com.sun.jndi.ldap.LdapCtxFactory。)

在生產環境中，您可能要使用 LDAP 目錄伺服器作為物件儲存。如需有關設定伺服器以及進行 JNDI 查找的資訊，請參閱 LDAP 伺服器物件儲存。

按一下 [新增] 按鈕。

請注意此時特性摘要窗格中列出的特性及其值。

從 [名稱] 下拉式清單中選取 java.naming.provider.url。

此特性可讓您指定物件儲存的確切位置。對於檔案系統類型的物件儲存，此項將為現有目錄的名稱。

在 [值] 欄位中輸入以下內容

file:///C:/Temp

(在 Solaris 和 Linux 上為 file:///tmp )

按一下 [新增] 按鈕。

請注意此時特性摘要窗格中列出的特性及其值。如果您要使用 LDAP 伺服器，您可能還必須指定認證資訊；而檔案系統儲存則無需此項。

按一下 [確定] 以新增此物件儲存。
如果尚未在瀏覽窗格中選取節點 [MyObjectStore]，請現在選取它。

管理主控台此時顯示如下：





此物件儲存已在瀏覽窗格中列出，其內容、目標以及連線工廠已在結果窗格中列出。我們尚未將任何受管理物件新增至此物件儲存，這可在結果窗格的 [計數] 欄中顯示。

瀏覽窗格中的物件儲存圖示上畫有紅色的 X。這表示此物件儲存已中斷連線。在使用物件儲存之前，您必須先連線至物件儲存。

檢查物件儲存特性

當中斷管理主控台與物件儲存的連線時，您可以檢查與變更此物件儲存的某些特性。

若要顯示物件儲存的特性

在瀏覽窗格中的 [MyObjectStore] 上按一下滑鼠右鍵。
從快顯功能表中選擇 [特性]。

畫面上將會顯示對話方塊，此對話方塊顯示您新增此物件儲存時指定的所有特性。您可以變更這些特性中的任何一項，然後按一下 [確定] 以更新舊的資訊。

按一下 [確定] 或 [取消] 以關閉此對話方塊。

連線至物件儲存

您必須連線至物件儲存之後才可以將物件新增至此儲存。

若要連線至物件儲存

在瀏覽窗格中的 [MyObjectStore] 上按一下滑鼠右鍵。
從快顯功能表中選擇 [連線至物件儲存]。

請注意物件儲存的圖示已不再有叉號。此時您可以將物件、連線工廠和目標新增至此物件儲存。

新增連線工廠受管理物件

您可以使用管理主控台建立和配置連線工廠。用戶端程式碼使用連線工廠連線至代理程式。透過配置連線工廠，您可以控制連線工廠通常建立的連線運作方式。

如需有關配置連線工廠的資訊，請參閱線上說明與 Message Queue Developer’sGuide for Java Clients 。

備註	管理主控台僅列出與顯示 Message Queue 受管理物件。如果物件儲存包含的非 Message Queue 物件與您想新增的受管理物件具有相同的查找名稱，那麼當您嘗試新增作業時會出現錯誤。

若要將連線工廠新增至物件儲存

如果尚未連線，請連線至 MyObjectStore (請參閱連線至物件儲存)。
在 [連線工廠] 節點上按一下滑鼠右鍵，然後選擇 [新增連線工廠物件]。

畫面上將會顯示 [新增連線工廠物件] 對話方塊。





在 [查找名稱] 欄位中輸入名稱「MyQueueConnectionFactory」。

此名稱為用戶端程式碼查找連線工廠時使用的名稱，如 HelloWorldMessageJNDI.java 的以下行中所示：

qcf=(javax.jms.QueueConnectionFactory)
    ctx.lookup("MyQueueConnectionFactory")

從下拉式清單中選取 [QueueConnectionFactory]，以指定連線工廠的類型。
按一下 [連線處理] 標籤。
您通常可以在 [訊息伺服器位址清單] 欄位輸入用戶端連線之代理程式的位址。此欄位的範例如下所示：

mq://localhost:7676/jms

依預設，您不需輸入任何值，因為將連線工廠配置為在連接埠 7676 上的本地主機執行以連線至代理程式，此配置為本快速入門所預期的範例。

按一下此對話方塊的所有標籤，以查閱您可以為連線工廠配置的資訊種類。使用 [新增連線工廠物件] 對話方塊右下角的 [說明] 按鈕，以獲得有關個別標籤的資訊。此時請勿變更任何預設值。
按一下 [確定] 以建立此佇列連線工廠。
查看結果窗格：已列出新建立的連線工廠的查找名稱與類型。

---

新增目標物件

目標受管理物件與代理程式上的實體目標相關聯，它們指向那些目標。目標受管理物件可以讓用戶端查找並找到實體目標，並不需要提供者的特定目標名稱與配置。

當用戶端傳送訊息時，它會查找或創設目標受管理物件，並以 JMS API 的 send() 方法參照此物件。然後，代理程式負責將訊息傳送至與受管理物件相關聯的實體目標，如下所示：

如果您已建立與此受管理物件相關聯的實體目標，則代理程式會將訊息傳送至此實體目標。
如果您尚未建立實體目標且已啟用實體目標的自動建立功能，則代理程式自身會建立實體目標並將訊息傳送至此目標。
如果您尚未建立實體目標且已停用實體目標的自動建立功能，則代理程式無法建立實體目標，亦無法傳送訊息。

在本快速入門的下一部分，您將要新增與您先前新增的實體目標相對應的受管理物件。

若要將目標新增至物件儲存

在瀏覽窗格的中的 [目標] 節點 (於 [MyObjectStore] 節點下) 上按一下滑鼠右鍵。
選擇 [新增目標物件]。

管理主控台會顯示 [新增目標物件] 對話方塊，您可用來指定有關此物件的資訊。





在 [查找名稱] 欄位中輸入 MyQueue。

使用此查找名稱可以找到正在使用 JNDI 查找呼叫的物件。在範例應用程式中，此呼叫如下：

queue=(javax.jms.Queue)ctx.lookup(“MyQueue”);

為 [目標類型] 選擇 [佇列] 單選按鈕。
在 [目標名稱] 欄位中輸入 MyQueueDest。

此名稱為您在代理程式上新增實體目標時指定的名稱 (請參閱將實體目標新增至代理程式)。

按一下 [確定]。
在瀏覽窗格中選取 [目標]，並注意有關剛新增的佇列目標受管理物件的資訊在結果窗格中的顯示方式。

---

檢視受管理物件特性

若要檢視或更新受管理物件的特性，您需要在瀏覽窗格中選取 [目標] 或 [連線工廠]，在結果窗格中選取特定的物件然後選擇 [動作] > [特性]。

若要檢視或更新目標物件的特性

選取瀏覽窗格中 [MyObjectStore] 的 [目標] 節點。
在結果窗格中選取 [MyQueue]。
選擇 [動作] > [特性] 以檢視 [目標物件特性] 對話方塊。

請注意您僅可以變更目標名稱與描述的值。若要變更查找名稱，您必須刪除此物件，然後新增具有所需查找名稱之新的佇列受管理物件。

按一下 [取消] 以關閉此對話方塊。

---

更新主控台資訊

無論您使用物件儲存區還是代理程式，均可以透過選擇 [檢視] > [重新顯示] 來更新任何元素或元素群組的可視顯示。

---

執行範例應用程式

範例應用程式 HelloWorldMessageJNDI，可供您搭配快速入門使用。此範例應用程式使用您建立的實體目標和受管理物件：

佇列實體目標的名稱是 MyQueueDest
佇列連線工廠受管理物件和佇列受管理物件的 JNDI 查找名稱分別是 MyQueueConnectionFactory 和 MyQueue

此程式碼建立簡單的佇列傳送者和接收者，並傳送和接收「Hello World」訊息。

若要執行 HelloWorldMessageJNDI 應用程式

使包含 HelloWorldmessageJNDI 應用程式的目錄成為目前目錄；例如：

cd IMQ_HOME\demo\helloworld\helloworldmessagejndi (Windows)

cd /usr/demo/imq/helloworld/helloworldmessagejndi (Solaris)

cd /opt/sun/mq/examples/helloworld/helloworldmessagejndi (Linux)

您應會發現 HelloWorldMessageJNDI.class 檔案已存在 (如果您要變更此應用程式，就必須使用 Message Queue Developer’s Guide for C Clients 快速入門指導中的用於編譯用戶端應用程式的指令重新編譯它)。設定 CLASSPATH 變數，以納入目前包含檔案 HelloWorldMessageJNDI.class 的目錄與 Message Queue 產品的 JAR 檔案，JAR 檔案如下所示：jms.jar、imq.jar 和 fscontext.jar。請參閱 Message Queue Developer’s Guide for Java Clients，以獲得設定 CLASSPATH 的說明。

JNDI jar 檔案 (jndi.jar) 隨附於 JDK 1.4。如果您在使用 JDK，您則不需新增 jndi.jar 至您的 CLASSPATH 設定。如果您是使用較早版本的 JDK，您則必須將 jndi.jar 納入您的 CLASSPATH。請參閱 Message Queue Developer’s Guide forJava Clients ，以取得其他資訊。

執行此應用程式前，請開啟來源檔案 HelloWorldMessageJNDI.java，接著閱讀來源。它很簡短但已充分進行說明，並且有關您建立的受管理物件和目標的使用方法亦相當清楚。
請執行以下其中一個指令，以執行 HelloWorldMessageJNDI 應用程式：

在 Windows 上為 java HelloWorldMessageJNDI

在 Solaris 和 Linux 上為 % java HelloWorldMessageJNDI file:///tmp

如果此應用程式執行成功，您應看到以下輸出：

java HelloWorldMessageJNDI 正在使用 file:///C:/Temp for Context.PROVIDER_URL     正以查找名稱查找佇列連線工廠物件：MyQueueConnectionFactory 找到佇列連線工廠物件。 正以查找名稱查找佇列物件：MyQueue 找到佇列物件。     正在建立與代理程式的連線。 已建立與代理程式的連線。   正在發佈訊息至佇列：MyQueueDest 已接受以下訊息：Hello World

上一頁      目錄      索引      下一頁

---

文件號碼 819-2220。   Copyright 2005 Sun Microsystems, Inc. 版權所有。