Service Registry 3 2005Q4 管理指南

第 1 章配置和設定 Service Registry

本章說明如何在安裝 Service Registry 之後對其進行配置，以及如何執行其他管理作業。

本章包含下列小節：

配置 Service Registry

「Sun Java Enterprise System 2005Q4 Installation Guide for UNIX」說明如何使用 Registry 的預設特性設定來執行 Service Registry 的安裝後配置。若要使用自訂特性設定，請在執行配置之前編輯檔案 ServiceRegistry-base/install/install.properties。

在 Solaris 作業環境中，ServiceRegistry-base 位置為 /opt/SUNWsoar；在 Linux 系統上，位置為 /opt/sun/SUNWsoar。

備註 –

在配置 Service Registry 之前，必須首先安裝和配置 Sun Java System Application Server (「Application Server」)。Service Registry 的配置程序會將 Registry 安裝至 Application Server 網域中。

建議您將 Application Server 安裝在其預設位置。如果您已將其安裝在非預設位置，請在配置 Service Registry 之前依照配置 Service Registry 以進行非預設 Application Server 安裝中的說明進行操作。

install.properties 檔案包含一組可修改的特性設定。在表 1–1 中列出的特性供安裝程序使用。每個特性名稱都具有前綴 registry.install. (以句點結尾)。這些特性大多數都會為 Application Server 網域 (為 Registry 所建立) 設定非預設連接埠。

表 1–1 Service Registry 安裝特性


屬性名稱	說明	預設特性值
`DomainName`	Application Server 網域名稱	`registry`
`ServerInstancePort`	Application Server HTTP 連接埠	`6060`
`ServerInstanceSecurePort`	Application Server HTTPS 連接埠	`6443`
`ServerJMSPort`	Application Server 訊息佇列連接埠	`6484`
`ServerIIOPPort`	Application Server IIOP 連接埠	`6485`
`ServerIIOPSecurePort`	Application Server IIOP 安全連接埠	`6486`
`ServerIIOPMutualAuthPort`	Application Server IIOP 相互認證連接埠	`6487`
`AdministrationJMXPort`	Application Server JMX 連接埠	`6488`
`AdministrationPort`	Application Server Administrative Server 連接埠	`6489`
`AdministratorUserID`	用於存取 Application Server Administrative Server 的使用者名稱	`admin`
`AdministratorPassword`	用於存取 Application Server Administrative Server 的密碼	`12345678`
`ApplicationServerKeystorePassword`	用於存取 Application Server 金鑰庫的密碼	`12345678`
`RegistryServerKeystorePassword`	用於存取 Service Registry 金鑰庫的密碼	`12345678`

在安裝之後，使用自訂特性配置 Service Registry

開始之前

若要配置 Registry，您必須作為 root 使用者登入或成為超級使用者。

步驟

變更至 ServiceRegistry-base/install 目錄。

編輯檔案 install.properties 中的可修改特性。

為安全起見，建議您不要透過編輯此檔案來變更密碼值，而要在指令行中指定這些值。

編輯檔案之後，執行以下指令 (全部位於同一行)︰

在 Solaris 上：/usr/sfw/bin/ant -f build-install.xml install

在 Linux 上：/opt/sun/bin/ant --noconfig -f build-install.xml install

ant 指令需要設定 JAVA_HOME 環境變數。通常，將此變數設定為以下值︰

/usr/jdk/entsys-j2se

若要在指令行中指定變更的密碼，請為指令指定以下選項 (全部位於同一行)︰

/usr/sfw/bin/ant -f build-install.xml
-Dregistry.install.RegistryServerKeystorePassword=passwd1
-Dregistry.install.AdministratorPassword=passwd2
-Dregistry.install.ApplicationServerKeystorePassword=passwd3 install

Registry 配置程序在 RegistryDomain-base/domains/${registry.install.DomainName} 中建立 Application Server 網域。預設網域名稱為 registry。然後，配置程序會啟動網域，部署 Registry，並使網域處於執行狀態。

Registry 配置程序會將 Registry 資料庫和伺服器金鑰庫安裝在目錄 RegistryDomain-base/3.0 中。將 Registry 解除安裝時不會移除此目錄，以便保留資料庫以用於將來的發行版本。管理員可以控制何時移除此目錄和是否移除此目錄。

在 Solaris 作業環境中，RegistryDomain-base 位置為 /var/opt/SUNWsoar，在 Linux 系統上，位置為 /var/opt/sun/SUNWsoar。

檢查 ant install 指令的輸出是否有錯誤。

如果沒有錯誤，您可以立即開始使用 Web 主控台或 Admin Tool。

允許使用 Administration Tool

若要執行僅有管理員角色才能執行的 Admin Tool 作業，您需要將一個 JAR 檔案增加至 Admin Tool 清單類別路徑，以修正一個錯誤。

步驟

確定您仍位於 ServiceRegistry-base/install 目錄中。

將檔案 soapprocessor.jar 從部署的 Registry 複製到 Registry lib 目錄。執行以下指令 (全部位於同一行)：
cp RegistryDomain-base/domains/registry/applications/j2ee-modules/soar/WEB-INF /lib/soapprocessor.jar ../lib

如下所述執行 admin.jar.manifest.fix 安裝目標：

在 Solaris 上：/usr/sfw/bin/ant -f build-install.xml admin.jar.manifest.fix

在 Linux 上：/opt/sun/bin/ant --noconfig -f build-install.xml admin.jar.manifest.fix

管理 Service Registry 的 Application Server 網域

依預設，Service Registry 的配置程序會建立名為 registry 的 Application Server 網域，Service Registry Web 應用程式將被部署至該網域。此網域位於 RegistryDomain-base/domains/registry 目錄中。

此位置與 Application Server 網域的預設位置不同，預設位置為 /var/opt/SUNWappserver/domains (Solaris) 或 /var/opt/sun/appserver/domains (Linux)。

若要管理 registry 網域，您可以使用 Application Server Administration Console (「Admin Console」)。您可以使用 Admin Console 啟動和停止網域、檢視伺服器記錄以及執行其他管理作業。請參閱使用 Application Server Admin Console，以取得詳細資訊。

您也可以直接檢查伺服器記錄。記錄位於檔案 RegistryDomain-base/domains/registry/logs/server.log 中。

您也可以使用 asadmin 指令管理 registry 網域。由於網域未在預設位置，所以當您使用提供 --domaindir 選項的 asadmin 指令時，必須指定該選項。

registry 網域的密碼檔案為 ServiceRegistry-base/pw.txt。管理 registry 網域時，將此密碼檔案指定為 asadmin 指令的 --passwordfile 選項的引數。

registry 網域使用一組非預設連接埠，以免導致與預設 Application Server 網域 domain1 發生衝突。表 1–2 列出並說明了這些連接埠。如需更多資訊，請參閱「Sun Java System Application Server Enterprise Edition 8.1 2005Q2 Administration Guide」中的「Ports in the Application Server」。

表 1–2 Service Registry 網域預設連接埠


連接埠值	說明
6060	HTTP 連接埠
6443	經由 SSL 的 HTTPS
6484	訊息佇列連接埠
6485	IIOP 連接埠
6486	IIOP SSL 連接埠
6487	IIOP 相互認證連接埠
6488	JMX 連接埠
6489	Application Server 網域管理連接埠

使用 Application Server Admin Console

步驟

在 Web 瀏覽器中，移至 URL https://hostname:6489/。

hostname 是執行 Application Server 和 Service Registry 的系統。

接受提供的憑證。

螢幕上顯示登入頁面

在登入頁面上，在 [使用者名稱] 欄位中鍵入 admin。

在 [密碼] 欄位中鍵入 Application Server 管理員密碼。使用您在配置 Registry 時為 AdministratorPassword 特性指定的值。預設為 12345678。

按一下 [登入]。

另請參閱

如需有關使用 Admin Console 的詳細資訊，請參閱 Admin Console 的線上說明或「Sun Java System Application Server Enterprise Edition 8.1 2005Q2 Administration Guide」。

若要變更 Service Registry 的記錄層級，請依照「Sun Java System Application Server Enterprise Edition 8.1 2005Q2 Administration Guide」中的「To configure log levels」的說明進行操作。要在 [附加特性] 區域指定的特性為 org.apache.commons.logging.simplelog.log.org.freebxml.omar。

停止並重新啟動 Registry 的 Application Server 網域

Registry 的配置程序會啟動部署 Registry 的 Application Server 網域。執行某些管理作業後，您需要停止並重新啟動該網域。此類作業包括允許存取外部網站和建立管理員。

如果需要重新啟動網域，Admin Console 會通知您。您可以使用 Admin Console 來執行此作業。如果您使用的是 asadmin 指令，則可以使用 Ant 作業停止並啟動該網域。

步驟

變更至 Service Registry 安裝目錄。

cd ServiceRegistry-base/install

執行以下指令 (全部位於同一行)：

Solaris： /usr/sfw/bin/ant -f build-install.xml appserver.domain.bounce

Linux：/opt/sun/bin/ant --noconfig -f build-install.xml appserver.domain.bounce

此目標會停止網域，然後再將其重新啟動。

build-install.xml 檔案也包含分別用於停止和啟動 Registry 網域的 Ant 目標。若要停止網域，請使用 Ant 目標 appserver.domain.stop。若要啟動網域，請使用 Ant 目標 appserver.domain.start。

將根憑證增加到 Registry 網域的信任憑證

此作業可延伸 Application Server registry 網域中信任的憑證清單。

僅當您使用的是協力廠商憑證，且協力廠商的根認證機構 (CA) 憑證不在 Application Server 信任存放區中，才執行此作業。如果您僅使用 Registry 發行的憑證，請勿執行此作業。

步驟

下載您希望支援的任意根憑證。提供根憑證的網站包括︰

如有必要，使用 unzip 指令從下載的歸檔擷取 .cer 檔案。

備註 –
某些檔案具有後綴 .der。

將 .cer 檔案複製到目錄 ServiceRegistry-base/install/cacerts 中。

變更至目錄 ServiceRegistry-base/install 。

執行以下指令 (全部位於同一行)：

Solaris：/usr/sfw/bin/ant -f build-install.xml install.cacerts

Linux：/opt/sun/bin/ant --noconfig -f build-install.xml install.cacerts

此指令會將在目錄 ServiceRegistry-base/install/cacerts 中找到的任何憑證安裝至 Application Server 網域信任存放區。

您可以使用 list.cacerts 目標，以確定已正確安裝憑證。

依照停止並重新啟動 Registry 的 Application Server 網域中的說明進行操作。

配置 Service Registry 以進行非預設 Application Server 安裝

在 Solaris 作業環境中，安裝 Application Server 的預設位置為 /opt/SUNWappserver/appserver；在 Linux 系統上，預設位置為 /opt/sun/appserver。如果您已將 Application Server 安裝在其他位置上，則在配置 Service Registry 之前，必須先編輯檔案 install.properties。

編輯 `install.properties` 檔案

步驟

在 ServiceRegistry-base/install 目錄中，在文字編輯器中開啟檔案 install.properties。

尋找特性 appserver.root.dir 加入註釋的定義。

移除註釋字元 (#) 並使用 Application Server 的實際位置替代特性定義。

儲存並關閉 install.properties 檔案。

接下來的步驟

繼續依照配置 Service Registry中的說明進行操作。

配置 Service Registry 以進行非預設 Service Registry 安裝

在 Solaris 作業環境中，安裝 Service Registry 的預設位置為 /opt/SUNWsoar，在 Linux 系統中，預設位置為 /opt/sun/SUNWsoar。如果您已將 Service Registry 安裝在其他位置上，則在配置 Service Registry 之前，必須先編輯檔案 install.properties。

編輯 `install.properties` 檔案

步驟

在 ServiceRegistry-base/install 目錄中，在文字編輯器中開啟檔案 install.properties。

尋找特性 soar.sdk.home 和 soar.server.home 加入註釋的定義。

對於每個特性，移除註釋字元 (#) 並使用 Service Registry 的實際位置取代特性定義。

儲存並關閉 install.properties 檔案。

接下來的步驟

繼續依照配置 Service Registry中的說明進行操作。

允許存取外部網站

任何 Registry 物件均可具有 ExternalLink 物件，該物件可指定與該 Registry 物件關聯的 URL。為了讓使用者可以建立 ExternalLink 物件，Service Registry 必須可以驗證 URL，且此作業需要存取外部網站。如果 Registry 是在防火牆後部署的，您需要設定允許此存取的代理伺服器配置。

代理伺服器配置需要您將 Web 代理伺服器主機和連接埠指定為部署 Service Registry 之 Application Server 實例的 Java 虛擬機器 (JVM) 選項。

指定 Web 代理伺服器

步驟

依照使用 Application Server Admin Console中的說明登入至 Application Server Admin Console。

展開配置節點。

展開伺服器節點 server-config (Admin Config)。

按一下 [JVM 設定]。

按一下 [JVM 選項] 標籤。

按一下 [增加 JVM 選項]。

在文字欄位中，鍵入以下內容 (全部位於同一行)︰
-Dhttp.proxyHost=hostname.domainname -Dhttp.proxyPort=8080
連接埠值通常為 8080。如果在您的位置為其他連接埠，請指定正確的值。

按一下 [儲存]。

依照停止並重新啟動 Registry 的 Application Server 網域中的說明進行操作。

建立管理員

Service Registry Administration Tool 中的一些作業僅可由註冊為管理員的使用者執行。此外，可能會需要管理員實作對其他使用者提交的物件進行生命週期變更 (例如，批准)。

管理員還可以變更預設存取控制策略 (ACP)。然而，目前編寫 ACP 是手動程序，需要有關 OASIS 可延伸存取控制標記語言 (XACML) 的知識。如需詳細資訊，請參閱 ebXML RIM 3.0 的第 9 章「Access Control Information Model」，尤其是 9.7.6 小節至 9.7.8 小節中的範例。請參閱在閱讀本書之前，以獲得有關如何尋找 ebXML RIM 3.0 規格的資訊。

建立管理員

若要將自己註冊為管理員，請執行以下步驟。

步驟

依照「Service Registry 3 2005Q4 使用者指南」中的「建立使用者帳號」的說明，執行使用者註冊。

請記住您下載的憑證的路徑名稱。憑證檔案的預設名稱為 generated-key.p12。

取得 User 物件的唯一識別碼，如下所示︰
1. 將物件類型設定為 [User]，使用 Web 主控台執行基本查詢。
2. 按一下詳細資訊連結以檢視 Registry 為您建立的 User 物件。
3. 記下 [唯一識別碼] 欄位值。

將憑證複製到您主目錄中的以下位置 (依需要建立目錄)：
```
$HOME/soar/3.0/jaxr-ebxml/security
```

變更至目錄 RegistryDomain-base/domains/registry/applications/j2ee-modules /soar/WEB-INF/classes。

在文字編輯器中開啟檔案 omar.properties。

尋找特性 omar.security.authorization.registryAdministrators 的定義。

透過增加豎線 (|) 並在其後增加於步驟 2 中記下的邏輯識別碼字串來編輯特性定義。

特性定義必須全部位於同一行，且不得包含空格。完成後，它會類似於以下顯示 (全部位於同一行)︰
```
omar.security.authorization.registryAdministrators=
urn:freebxml:registry:predefinedusers:registryoperator|
urn:uuid:77f5c196-79de-4286-8483-8d80def3583b
```

儲存並關閉 omar.properties 檔案。

依照停止並重新啟動 Registry 的 Application Server 網域中的說明進行操作。

接下來的步驟

若要建立附加管理員，您不必編輯 omar.properties 檔案。如果您為管理員，可以使用 Admin Tool 或 Web 主控台增加使用者，並且可以使用 Web 主控台將使用者分類為管理員。

配置 Web 主控台

作為管理員，可以透過編輯配置檔案來自訂 Web 主控台顯示的某些方面。本節說明以下作業︰

如需有關使用 Web 主控台的資訊，請參閱「Service Registry 3 2005Q4 使用者指南」。

增加預先定義的查詢

Service Registry 包含一些預先定義的查詢，這些查詢顯示在 [Web 主控台搜尋] 表單的 [選取預先定義的查詢] 下拉式清單中。作為管理員，您可以在 Registry 安裝的特定下拉式清單中增加新查詢。

增加預先定義的查詢

步驟

使用 Web 主控台將 AdhocQuery 物件發佈至 Registry。

為查詢指定的名稱和說明將顯示在預先定義查詢的下拉式清單中。在查詢的 SQL 敘述中，透過將其括在單引號中為使用者提供的資料指定預留位置，如下所示︰
```
select * from registryobject where id = ''$lid''
```

記下 AdhocQuery 物件和 SQL 敘述中任何預留位置的唯一識別碼。

變更至路徑 RegistryDomain-base/3.0/jaxr-ebxml。

在文字編輯器中開啟檔案 registry-browser-config.xml。

使用以下格式將項目增加至 registry-browser-config.xml 檔案。為 SQL 敘述中的每個預留位置指定 Parameter 元素。
```
<Query>
  <AdhocQueryRef id="unique_identifier"/>
  <Parameter parameterName="$placeholder_name" datatype="string">
    <rim:Name>
      <rim:LocalizedString xml:lang="en" charset="UTF-8" 
        value="parameter_name_in_en_locale"/>
      <rim:LocalizedString xml:lang="fr" charset="UTF-8" 
        value="parameter_name_in_fr_locale"/>
    </rim:Name>
    <rim:Description>
      <rim:LocalizedString xml:lang="en" charset="UTF-8" 
        value="parameter_description_in_en_locale"/>
      <rim:LocalizedString xml:lang="fr" charset="UTF-8" 
        value="parameter_description_in_fr_locale"/>
    </rim:Description>
  </Parameter>
  ...
</Query>
```
unique_identifier 是 AdhocQuery 物件的唯一識別碼。

每個參數的 parameterName 屬性值必須來自查詢的 SQL 敘述中的預留位置。

datatype 屬性可以具有以下任一值︰
- string︰參數在 [搜尋] 表單中顯示為文字欄位。
- taxonomyElement︰參數在 [搜尋] 表單中顯示為下拉式清單。如果您指定 taxonomyElement 資料類型，名稱和說明元素必須後接 SlotList 元素，如下所示︰
```
<rim:SlotList>
  <rim:Slot name="domain">
    <rim:ValueList>
      <rim:Value>
      classification_scheme_or_concept_id
      </rim:Value>
    </rim:ValueList>
  </rim:Slot>
</rim:SlotList>
```
  classification_scheme_or_concept_id 是類別方案或概念 (其概念或子概念必須顯示在下拉式清單中) 的唯一識別碼。如果類別方案尚未存在於 Registry 中，則您必須發佈類別方案。
  
  槽名稱必須為 "domain"。
- boolean︰參數在 [搜尋] 表單中顯示為核取方塊。
如果 datatype 為 string 或 boolean，則還可以將 defaultValue 屬性增加到 Parameter 元素來指定在 [搜尋] 表單中顯示預設值。

為每個參數名稱指定本土化字串值，為支援的語言環境指定說明。目前語言環境中的 parameter_name 在 [搜尋] 表單中顯示為參數的標籤。

將 registry-browser-config.xml 檔案中的現有項目用作參照。

儲存並關閉 registry-browser-config.xml 檔案。

依照停止並重新啟動 Registry 的 Application Server 網域中的說明進行操作。

變更預設查詢

在 [選取預先定義的查詢] 下拉式清單中顯示為預設選項的查詢為 [基本查詢]，允許使用者依名稱、說明和類別搜尋 Registry 物件。

作為管理員，您可以將此預設變更為適合您的安裝的查詢。例如，您可能要將此預設查詢變更為您增加到 Registry 的新預先定義查詢 (如增加預先定義的查詢中所述)。若要執行此變更，請編輯配置檔案中的特性。

變更預設查詢

步驟

變更至目錄 RegistryDomain-base/domains/registry/applications/j2ee-modules /soar/WEB-INF/classes。

在文字編輯器中開啟檔案 jaxr-ebxml.properties。

尋找特性 jaxr-ebxml.thin.defaultQueryPanel 的定義。依預設，此特性被註釋為︰
```
#jaxr-ebxml.thin.defaultQueryPanel=
```

移除註釋字元 (#)。

透過指定要作為預設的查詢之邏輯識別碼來設定特性的值，如以下範例所示︰
```
jaxr-ebxml.thin.defaultQueryPanel=urn:oasis:names:tc:ebxml-regrep:query:MyQuery
```

儲存並關閉 jaxr-ebxml.properties 檔案。

依照停止並重新啟動 Registry 的 Application Server 網域中的說明進行操作。

隱藏類別方案

類別方案的樹狀結構顯示於 Web 主控台的以下區域中︰

[搜尋] 表單區域 ([基本查詢] 被選取時)
[探索] 功能表區域
[類別方案/概念選擇器] 視窗 (當您需要為某些類別的 Registry 物件選擇概念時)

作為管理員，如果您不希望 Service Registry 使用者使用類別方案，則可以從視圖中隱藏類別方案。若要隱藏類別方案，請定義配置檔案中的特性。

隱藏類別方案

步驟

變更至路徑 RegistryDomain-base/domains/registry/applications/j2ee-modules /soar/WEB-INF/classes。

在文字編輯器中開啟檔案jaxr-ebxml.properties。

透過使用以下語法設定特性 jaxr-ebxml.registryBrowser.ConceptsTreeModel.hiddenSchemesList。所有特性定義均必須全部位於同一行，且不得含有空格。
```
jaxr-ebxml.registryBrowser.ConceptsTreeModel.hiddenSchemesList=
class_scheme_id1|class_scheme_id2|...
```
指定每個要隱藏的類別方案的邏輯識別碼。如果您指定多個識別碼，請使用豎線 (|) 分隔識別碼，如以下範例所示︰
```
jaxr-ebxml.registryBrowser.ConceptsTreeModel.hiddenSchemesList=
urn:oasis:names:tc:ebxml-regrep:classificationScheme:StatusType|
urn:oasis:names:tc:ebxml-regrep:profile:ws:classificationScheme:BindingType
```

儲存並關閉 jaxr-ebxml.properties 檔案。

依照停止並重新啟動 Registry 的 Application Server 網域中的說明進行操作。

配置搜尋結果顯示

依預設，Web 主控台每次為每個查詢顯示 10 個搜尋結果。如果搜尋傳回的結果多於 10 個，則使用者可以顯示結果的其他頁面。作為管理員，您可以修改每一頁面顯示的搜尋結果數量。

依預設，Web 主控台在搜尋結果區域中顯示特定欄。對於每個物件，會顯示物件類型、名稱、說明、版本和版本註釋。對於某些物件類型，配置了非預設顯示。例如，對於 ServiceBinding 物件，顯示包含終點，而不包含版本資訊。作為管理員，您可以增加配置資訊以為您選擇的物件類別顯示非預設資料。

若要執行以下任一作業，請編輯配置檔案。

配置搜尋結果顯示中的列數

步驟

變更至目錄 RegistryDomain-base/domains/registry/applications/j2ee-modules /soar/WEB-INF/classes。

在文字編輯器中開啟檔案jaxr-ebxml.properties。

尋找特性 omar.client.thinbrowser.numSearchResults 的定義︰
```
omar.client.thinbrowser.numSearchResults=10
```

將值 10 變更為您所需的值。

儲存並關閉 jaxr-ebxml.properties 檔案。

依照停止並重新啟動 Registry 的 Application Server 網域中的說明進行操作。

配置搜尋結果區域中的欄

步驟

變更至目錄 RegistryDomain-base/3.0/jaxr-ebxml。

在文字編輯器中開啟檔案 registry-browser-config.xml。

使用以下格式，將項目增加到 registry-browser-config.xml 檔案。

此範例配置 Service 物件的非預設顯示。

<ObjectTypeConfig 
    className="org.freebxml.omar.client.xml.registry.infomodel.ServiceImpl" 
    id="urn:oasis:names:tc:ebxml-regrep:ObjectType:RegistryObject:Service">
  <SearchResultsConfig>
    <SearchResultsColumn columnClass="java.lang.Object" 
      columnHeader="Object Type" columnWidth="25" editable="false" 
      method="getObjectType"/>
    <SearchResultsColumn columnClass="java.lang.Object" 
      columnHeader="Name" columnWidth="25" editable="true" method="getName"/>
    <SearchResultsColumn columnClass="java.lang.Object" 
      columnHeader="Description" columnWidth="30" editable="true" 
      method="getDescription"/>
    <SearchResultsColumn columnClass="java.lang.Object" 
      columnHeader="Status" columnWidth="15" method="getStatusAsString"/>
    <SearchResultsColumn columnClass="java.lang.Object" 
      columnHeader="Version" columnWidth="5" method="getVersionName"/>
  </SearchResultsConfig>
</ObjectTypeConfig>

registry-browser-config.xml 提供了 ObjectTypeConfig 元素的語法。依範例使用檔案中已經存在的元素。這些元素可配置 Registry 物件的預設顯示，以及 ExternalLink、ExtrinsicObject 和 ServiceBinding 物件的非預設顯示。

對於大部分，您可以從 ebXML Registry Information Model Version 3.0 規格 (請參閱在閱讀本書之前以取得詳細資訊) 推論方法名稱。getStatusAsString 方法可以在 RegistryObjectImpl 實作類別中找到。(但此 Service Registry 發行版本不包含 API 文件。)

儲存並關閉 registry-browser-config.xml 檔案。

依照停止並重新啟動 Registry 的 Application Server 網域中的說明進行操作。

若要驗證重新配置，請使用 Web 主控台的 [搜尋] 或 [探索] 功能表來顯示已為其變更欄的物件。

重新安裝 Service Registry

如果您需要將 Service Registry 解除安裝後再重新安裝，請在重新安裝之前執行以下作業︰

如果 Registry 資料庫中含有您要保留的資料，請依照備份及復原資料庫中的說明備份資料庫。
停止 Registry 的 Application Server 網域，然後刪除該網域。如果不刪除網域，則重新安裝之 Registry 的安裝後配置將失敗。

如果需要重新安裝 Service Registry 資料庫 (例如資料庫已毀損)，請依照將 Service Registry 資料庫解除安裝中的說明進行操作。您無需在重新安裝資料庫之前將其解除安裝。

停止並刪除 Registry Application Server 網域

步驟

變更至目錄 ServiceRegistry-base/install 。

執行以下指令 (全部位於同一行)：

Solaris：/usr/sfw/bin/ant -f build-install.xml appserver.domain.stop

Linux：/opt/sun/bin/ant --noconfig -f build-install.xml appserver.domain.stop

執行以下指令 (全部位於同一行)：

Solaris：/usr/sfw/bin/ant -f build-install.xml appserver.domain.delete

Linux：/opt/sun/bin/ant --noconfig -f build-install.xml appserver.domain.delete

將 Service Registry 資料庫解除安裝

步驟

變更至目錄 ServiceRegistry-base/install 。

執行以下指令 (全部位於同一行)：

Solaris：/usr/sfw/bin/ant -f build-install.xml install.db

Linux：/opt/sun/bin/ant --noconfig -f build-install.xml install.db

備份及復原資料庫

Registry 使用 Apache Derby 資料庫。依預設，資料庫位於目錄 RegistryDomain-base/3.0/data/registry/soar/ 中。

若要瞭解如何備份及復原資料庫，請查閱 Apache Derby 文件。

尋找 Apache Derby 文件

步驟

在 Web 瀏覽器中，移至 Apache Derby 網站。

按一下 [Manuals] 標籤。

按一下 [10.0 Manuals]。

尋找「Server & Admin Guide」。

尋找有關備份及復原資料庫的小節。

第 1 章 配置和設定 Service Registry

配置 Service Registry

在安裝之後，使用自訂特性配置 Service Registry

開始之前

步驟

允許使用 Administration Tool

步驟

管理 Service Registry 的 Application Server 網域

使用 Application Server Admin Console

步驟

另請參閱

停止並重新啟動 Registry 的 Application Server 網域

步驟

將根憑證增加到 Registry 網域的信任憑證

步驟

配置 Service Registry 以進行非預設 Application Server 安裝

編輯 install.properties 檔案

步驟

接下來的步驟

配置 Service Registry 以進行非預設 Service Registry 安裝

編輯 install.properties 檔案

步驟

接下來的步驟

允許存取外部網站

指定 Web 代理伺服器

步驟

建立管理員

建立管理員

步驟

接下來的步驟

配置 Web 主控台

增加預先定義的查詢

增加預先定義的查詢

步驟

變更預設查詢

變更預設查詢

步驟

隱藏類別方案

隱藏類別方案

步驟

配置搜尋結果顯示

配置搜尋結果顯示中的列數

步驟

配置搜尋結果區域中的欄

步驟

重新安裝 Service Registry

停止並刪除 Registry Application Server 網域

步驟

將 Service Registry 資料庫解除安裝

步驟

備份及復原資料庫

尋找 Apache Derby 文件

步驟

第 1 章配置和設定 Service Registry

編輯 `install.properties` 檔案

編輯 `install.properties` 檔案