下載資料收集器

若要開始使用，請從 Transformation Advisor 使用者介面完成下列步驟：

1. 建立工作區。
2. 在新的工作區頁面上，按一下 資料收集器 按鈕並遵循指示進行下載。

安裝資料收集器

若要安裝資料收集器，請使用應用程式擁有者的使用者認證來登入應用程式伺服器，然後完成下列步驟：

1. 將下載的檔案複製到應用程式系統中具有讀/寫/執行存取權的目錄內。
2. 發出適用於您作業系統的指令，來解壓縮下載的檔案：

Linux: tar xvfz transformationadvisor-Linux_<WORKSPACE_NAME>.tgz

AIX: gunzip -c transformationadvisor-AIX_<WORKSPACE_NAME>.tgz | tar xf -

Solaris: tar xvfz transformationadvisor-Solaris_<WORKSPACE_NAME>.tgz

z/OS: gunzip -c transformationadvisor-zOS_<WORKSPACE_NAME>.tgz | tar xf -

Windows: unzip transformationadvisor-Windows_<WORKSPACE_NAME>.zip

3. 移至資料收集器目錄：

cd transformationadvisor*

需要的資源

 System         | Memory (GB) | CPU (cores) | Disk space (GB)
 ---------------| ----------- | ----------- | ---------------
 Data Collector | 2           | 2           | 0.5

執行資料收集器

當您第一次執行資料收集器時，會顯示授權。 接受條款以繼續執行。

警告：不應在正式作業伺服器上執行資料收集器。

若要同時分析應用程式及其配置，請執行適用於您網域的指令：

IBM WebSphere: ./bin/transformationadvisor -w <WEBSPHERE_HOME_DIR> -p <PROFILE_NAME> [ --ignore-missing-binary --ignore-missing-shared-library --applications --applications-file --skip-applications --skip-applications-file --no-upload] ([] denotes optional arguments)

Oracle WebLogic: ./bin/transformationadvisor --web-logic-config-file <Path to the WebLogic domain config.xml file> [--applications --applications-file --skip-applications --skip-applications-file --no-upload] ([] denotes optional arguments)

JBoss: ./bin/transformationadvisor --jboss-config-dir <Path to the JBoss server configuration directory> [--applications --applications-file --skip-applications --skip-applications-file --no-upload] ([] denotes optional arguments)

Apache Tomcat: ./bin/transformationadvisor --tomcat-home-dir <TOMCAT_HOME_DIR> --tomcat-config-dir <TOMCAT_CONFIG_DIR> [--applications --applications-file --skip-applications --skip-applications-file --no-upload] ([] denotes optional arguments)

若要檢視可用於資料收集器的指令行選項，請使用 --help 選項。

檢視資料

視應用程式的數目、大小和複雜性而定，資料收集器可能需要一些時間來執行及上傳結果。 在此程序期間，您可以檢查您的指令行，以追蹤其進度。

如果您的系統與新集合之間有連線，資料收集器會自動將結果上傳至 Transformation Advisor。 提供了包含數個報告的詳細分析，以協助您瞭解問題，以及可能需要變更程式碼的位置。

如果沒有連線，資料收集器會傳回包含應用程式資料的 .zip 檔案。 您需要使用「工作區」頁面上的 上傳資料 按鈕來手動上傳 zip 檔。

Transformation Advisor 資料收集器及 Java

資料收集器需要 1.7+ 版才能執行。 在第一個實例中，資料收集器將尋找 WebSphere 使用的 Java 相容版本 (如果這是 WebSphere 集合)。 If it cannot find the WebSphere Java version, or if the WebSphere version is not compatible (i.e. < 1.7), or this is not a WebSphere collection, then the data collector will attempt to use the Java specified in the -–java-home data collector argument. 如果未提供 –java-home argument ，則會使用以 JAVA_HOME 環境變數指定的 Java。 如果這些選項都無法找到相容的 Java 版本，則資料收集器將使用與資料收集器一起包裝的 Java。

取代資料收集器中的 Java 版本

在某些情況下，您想要在其中執行資料收集器的系統上可能未預先存在相容的 Java 版本，且與資料收集器一起包裝的 Java 也與正在執行它的系統不相容。 例如，包含 Java for AMD64 架構的 Solaris 資料收集器可能會發生這種情況。 如果您的 Solaris 是在 SPARC 上執行，則包裝的 Java 將無法運作。 在這些情況下，您可以使用適當的 Java 版本來建置您自己的資料收集器版本。

請採取下列步驟：

• 透過 Transformation Advisor 使用者介面下載該資料收集器的版本
• 解壓縮壓縮資料收集器
• 在解壓縮的資料收集器中找到 "jre" 資料夾，並將它取代為所需 Java 版本中的 jre
• 選用: 解壓縮的資料收集器中有一個稱為 uploadEndpoint.json 的檔案。 這包含 Transformation Advisor 伺服器的位置，以及上傳至特定工作區的唯一索引鍵。 您可以移除 uploadEndpoint.json 檔案。 這表示資料收集器將無法自動將集合上傳至 Transformation Advisor，而是會產生 zip ，您可以使用 Transformation Advisor 使用者介面手動上傳。 移除 uploadEndpoint.json 的優點是可讓您建立可在環境之間隨時複製的自訂資料收集器。 實際上，它會中斷資料收集器與 Transformation Advisor中特定工作區之間的鏈結。
• 壓縮資料收集器

現在可以將壓縮資料收集器複製到您想要執行收集的任何環境。

從 SunOS 和 Solaris 架構移轉

Transformation Advisor 提供 SunOS/Solaris 環境的資料收集器。 它已在 SunOS 5.10 5.11 (Solaris 10、11) 上測試過，但可能適用於舊版本。 為 SunOS/Solaris 提供的資料收集器會包裝 JRE ，以在 SunOS/Solaris on AMD64 架構上使用。 如果您想要在 SunOS/Solaris SPARC 架構上執行資料收集器，則您需要在執行資料收集器的系統上提供相容版本的 Java。

已知問題：

• 在 SunOS/Solaris 上執行資料收集器之前，請檢查環境上的 Bash 版本。 If the version is < 4.x, please upgrade to 4.x to ensure correct functioning of the data collector.

從舊版 WebSphere 移轉

Transformation Advisor 資料收集器支援從 WebSphere v6.1+進行收集。 對於從 6.1之前的版本進行 WebSphere 移轉，您需要手動尋找系統上部署的所有應用程式二進位檔，並將它們放入某個單一位置。 然後，您可以使用 "-o" 選項來執行資料收集器，以指向該位置並對應用程式執行分析。 當您使用 -o 選項執行資料收集器時，它會要求您選擇來源 WebSphere 及 Java 版本。 如果未顯示確切版本，請選取最接近實際版本的值，以取得最精確的結果。 在此狀況下，分析可能無法捕捉所有問題，將不會標示 WebSphere 及 Java 版本舊於受支援規則的問題。

從支援的應用程式伺服器移轉

Transformation Advisor 支援從下列應用程式伺服器收集:

• WebSphere
• Red Hat JBoss
• Weblogic
• Tomcat。

從不支援的應用程式伺服器移轉

如果您想要對不受支援的應用程式伺服器 (例如 Glassfish) 中的應用程式執行分析，您可以執行下列動作:

• 從系統手動收集應用程式二進位檔，並放在目錄中。
• 執行資料收集器，並使用 "-c" 選項將它指向應用程式位置。 這會執行一組基本 Java 規則，外加一些 Tomcat 特定規則。 Tomcat 特定規則不一定適用於您正在分析的應用程式伺服器，需要進一步調查。 在未來版本的資料收集器中，將有僅執行一般適用 Java 規則的選項。 需要進一步調查的 Tomcat 規則如下:

Set the sharing scope on resource references
Spring applications might fail to run from a non-expanded WAR file
Stub classes must be included when using remote Enterprise JavaBeans (EJB) 2.x
The getRealPath method previously returned null for files that do not exist
The OSGI remote bundle repository service API is unavailable
The OSGI Remote Service Admin API is unavailable
Transaction propagation is not supported for Enterprise JavaBeans (EJB) remote interfaces
Use correct case for tag attribute names
Use Java EE deployment descriptors and WebSphere bindings to define resource link references
Use Java EE deployment descriptors and WebSphere bindings to define resource references
Use Java EE deployment descriptors to define context lifecycle listeners
Use Java EE deployment descriptors to define context parameters
Use Java EE deployment descriptors to define environment references
Use Java EE deployment descriptors to define missing security roles
Validate the result of concatenation with getRealPath("")
Validate the result of concatenation with getRealPath("/")
Web Services Notification (WS-Notification) is unavailable

自訂用來產生報告檔的掃描選項

/conf 目錄下的 customCmd.properties 檔案用來配置掃描選項，這些掃描選項用來在掃描應用程式期間產生報告檔案。 使用者可以編輯此檔案來自訂掃描選項。

定義您自己的規則

自 Transformation Advisor v2.5 發行以來，您可以定義自己的自訂分析規則，以偵測應用程式移轉特有的實務範例。 可以輕鬆建立使用者定義的規則，如 這裡的詳細說明。 結果將以與現成可用的預先撰寫規則相同的方式顯示在 Transformation Advisor 使用者介面中。

資料收集器指令行工具選項

app1.ear,app2.ear
app3.ear

app1.ear,app2.ear
app3.ear