AWS Mainframe Modernization Service （受管執行期環境體驗）不再開放給新客戶使用。對於與 AWS Mainframe Modernization Service （受管執行期環境體驗）類似的功能，探索 AWS Mainframe Modernization Service （自我管理體驗）。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱[AWS 大型主機現代化可用性變更](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)。本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 使用 Rocket Software （先前為 Micro Focus) 來複寫應用程式本指南涵蓋使用 AWS Mainframe Modernization 解決方案進行大型主機應用程式重建的end-to-end程序 AWS。它描述了所有任務，包括有關在 Amazon EC2 上設定和操作 AWS 大型主機現代化執行期的資訊，從初始設定和分析到建置、測試和部署您的現代化應用程式 AWS。它還涵蓋進階主題，例如使用傳統資料結構、使用範本和預先定義的專案，以及設定串流工作階段的自動化。 **Topics** + [ # 設定 Rocket Software （先前為 Micro Focus) （在 Amazon EC2 上） ](mf-runtime-setup.md) + [ # 設定 Automation for Rocket Enterprise Analyzer （先前稱為 Micro Focus) 和 Rocket Enterprise 開發人員串流工作階段 ](set-up-automation-m2.md) + [ # 在 Rocket Enterprise Developer （先前為 Micro Focus Enterprise Developer) 中將資料集檢視為資料表和資料欄 ](view-datasets-tables-m2.md) + [ # 在企業開發人員中使用 Rocket Software （先前稱為 Micro Focus) 資料檔案工具編輯資料集 ](edit-datasets-m2.md) + [ # 火箭軟體教學課程（先前為 Micro Focus) ](tutorials-mf.md) + [ # AWS Mainframe Modernization 中的可用批次公用程式 ](utilities-m2.md) # 設定 Rocket Software （先前為 Micro Focus) （在 Amazon EC2 上） AWS Mainframe Modernization 提供數個 Amazon Machine Image (AMIs)，其中包含 Rocket Software （先前稱為 Micro Focus) 授權產品。這些 AMIs 可讓您快速佈建 Amazon Elastic Compute Cloud (Amazon EC2) 執行個體，以支援您控制和管理的 Rocket Software 環境。本主題提供存取和啟動這些 AMIs 所需的步驟。使用這些 AMIs完全是選用的，不需要完成本使用者指南中的教學課程。 **Topics** + [ # 設定 Rocket Software （先前為 Micro Focus) （在 Amazon EC2 上）的先決條件 ](mf-runtime-setup-prereq.md) + [ # 建立 Amazon S3 的 Amazon VPC 端點 ](mf-runtime-setup-vpc.md) + [ # 請求帳戶的允許清單更新 ](mf-runtime-setup-allowlist.md) + [ # 建立 AWS Identity and Access Management 角色 ](mf-runtime-setup-iam-role.md) + [ # 授予 License Manager 所需的許可 ](mf-runtime-setup-lic.md) + [ # 訂閱 Amazon Machine Image ](mf-runtime-setup-ami.md) + [ # 啟動 AWS Mainframe Modernization Rocket Software （先前稱為 Micro Focus) 執行個體 ](mf-runtime-setup-mf-instance.md) + [ # 沒有網際網路存取的子網路或 VPC ](mf-runtime-setup-no-access.md) # 設定 Rocket Software （先前為 Micro Focus) （在 Amazon EC2 上）的先決條件當您設定 Rocket Software （在 Amazon EC2 上）時，請確定您符合下列先決條件。 + 管理員存取要建立 Amazon EC2 執行個體的帳戶。 + 識別要建立 Amazon EC2 執行個體 AWS 區域的，並確認 AWS Mainframe Modernization 服務是否可用。請參閱[AWS 依區域的服務](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/)。請務必選擇提供服務的區域。 + 識別要建立 Amazon EC2 執行個體的 Amazon Virtual Private Cloud (Amazon VPC)。 Amazon EC2 # 建立 Amazon S3 的 Amazon VPC 端點在本節中，您會建立 Amazon S3 要使用的 Amazon VPC 端點。設定此端點有助於您稍後設定 VPC 的網際網路存取。 1. 在中導覽至 Amazon VPC AWS 管理主控台。 1. 在導覽窗格中選擇**端點**。 1. 選擇**建立端點**。 ![\[建立端點作用中的 VPC 端點。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-create-s3-endpoint_1.jpg) 1. 輸入有意義的名稱標籤，例如「Micro-Focus-License-S3」。 1. 選擇 **AWS 服務**做為服務類別。 ![\[輸入範例名稱標籤的端點設定。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-create-s3-endpoint_2.png) 1. 在**服務**下搜尋 Amazon S3 Gateway 服務：**com.amazonaws.【region】.s3**。 `us-west-1` 為此：`com.amazonaws.us-west-1.s3`。 1. 選擇**閘道**服務。 ![\[已選取具有 Amazon S3 Gateway 服務的服務。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-create-s3-endpoint_3.png) 1. 針對 VPC，選擇您將使用的 VPC。 ![\[輸入 VPC 的 VPC。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-create-s3-endpoint_4.png) 1. 選擇 VPC 的所有路由表。 ![\[選取所有路由表的路由表。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-create-s3-endpoint_5.png) 1. 在**政策**下選擇**完整存取**。 ![\[選取完整存取的政策。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-create-s3-endpoint_6.png) **注意** 如果您決定建立自訂政策，請確定其可存取 Amazon S3 儲存貯體 `s3://aws-supernova-marketplace--prod`。 1. 選擇**建立端點**。 # 請求帳戶的允許清單更新與您的 AWS 代表合作，將您的帳戶列入 AWS Mainframe Modernization AMIs的允許清單。請提供下列資訊： + AWS 帳戶 ID。 + 建立 Amazon VPC 端點 AWS 區域的。 + 在中建立的 Amazon VPC Amazon S3 端點 ID[建立 Amazon S3 的 Amazon VPC 端點](mf-runtime-setup-vpc.md)。這是 **com.amazonaws.【region】.s3 Gateway** `vpce-xxxxxxxxxxxxxxxxx` 端點的 ID。 + 所有 Rocket Software Enterprise Suite AMI Amazon EC2 執行個體所需的授權數量。每個 CPU 核心需要一個授權（大多數 Amazon EC2 執行個體每 2 vCPUs)。如需詳細資訊，請參閱[最佳化 CPU 選項](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-optimize-cpu.html#cpu-options-compute-optimized)。未來可以調整請求的號碼 AWS。 **注意** 請聯絡您的 AWS 代表或將代表您開啟允許清單請求的支援票證 AWS 支援的人員。您無法直接請求，請求可能需要幾天才能完成。 # 建立 AWS Identity and Access Management 角色建立 AWS Identity and Access Management 政策和角色以供 AWS Mainframe Modernization Amazon EC2 執行個體使用。透過 IAM 主控台建立角色會建立相同名稱的相關聯執行個體描述檔。將此執行個體描述檔指派給 Amazon EC2 執行個體允許指派 Rocket 軟體授權。如需執行個體描述檔的詳細資訊，請參閱[使用 IAM 角色將許可授予在 Amazon EC2 執行個體上執行的應用程式](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-ec2.html)。 ## 建立 IAM 政策首先建立 IAM 政策，然後連接到角色。 1. 導覽至 AWS Identity and Access Management 中的 AWS 管理主控台。 1. 選擇**政策**，然後選擇**建立政策**。 ![\[未套用篩選條件的政策頁面。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-create-iam-policy_1.png) 1. 選擇 **JSON** 標籤。 ![\[沒有內容的 JSON 標籤\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-create-iam-policy_2.png) 1. 將下列 JSON `us-west-1`取代為定義 Amazon S3 端點 AWS 區域的，然後將 JSON 複製並貼到政策編輯器中。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "S3WriteObject", "Effect": "Allow", "Action": [ "s3:PutObject" ], "Resource": [ "arn:aws:s3:::aws-supernova-marketplace-us-west-1-prod/*" ] }, { "Sid": "OtherRequiredActions", "Effect": "Allow", "Action": [ "sts:GetCallerIdentity", "ec2:DescribeInstances", "license-manager:ListReceivedLicenses" ], "Resource": [ "*" ] } ] } ``` ------ **注意** Sid 下的動作`OtherRequiredActions`不支援資源層級許可，且必須在資源元素`*`中指定。 ![\[已輸入政策並反白顯示 us-west-1 的 JSON 標籤。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-create-iam-policy_3.png) 1. 選擇下**一步：標籤**。 ![\[未輸入資料的標籤。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-create-iam-policy_4.png) 1. 選擇性地輸入任何標籤，然後選擇**下一步：檢閱**。 1. 輸入政策的名稱，例如「Micro-Focus-Licensing-policy」。選擇性地輸入描述，例如「包含此政策的角色必須連接到每個 AWS Mainframe Modernization Amazon EC2 執行個體。」 ![\[檢閱已輸入名稱和描述的政策。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-create-iam-policy_5.png) 1. 選擇**建立政策**。 ## 建立 IAM 角色建立 IAM 政策後，您可以建立 IAM 角色並將其連接至政策。 1. 在中導覽至 IAM AWS 管理主控台。 1. 選擇**角色**，然後選擇**建立角色**。 ![\[未套用篩選條件的角色。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-create-iam-role_1.png) 1. 將**信任的實體類型**保留為**AWS 服務**，然後選擇 **EC2** 常用案例。 ![\[選取 AWS 服務並選取 EC2 的受信任實體\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-create-iam-role_2.png) 1. 選擇**下一步**。 1. 在篩選條件中輸入「微」，然後按 Enter 鍵套用篩選條件。 1. 選擇剛建立的政策，例如「Micro-Focus-Licensing-policy」。 1. 選擇**下一步**。 ![\[在選取 Micro Focus 政策的情況下新增許可。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-create-iam-role_3.png) 1. 輸入角色名稱，例如「Micro-Focus-Licensing-role」。 1. 以您自己的其中一個取代描述，例如「允許使用此角色的 Amazon EC2 執行個體取得 Micro Focus 授權」。 ![\[輸入名稱和描述的角色詳細資訊。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-create-iam-role_4.png) 1. 在**步驟 1：選取信任的實體**檢閱 JSON 並確認其具有下列值： ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "sts:AssumeRole" ], "Principal": { "Service": [ "ec2.amazonaws.com" ] } } ] } ``` ------ **注意** 效果、動作和委託人的順序並不重要。 1. 確認**步驟 2：新增許可**顯示您的授權政策。 ![\[步驟 2：新增已選取授權政策的許可。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-create-iam-role_6.png) 1. 選擇建**立角色**。在允許清單請求完成後，請繼續執行下列步驟。 # 授予 License Manager 所需的許可您需要授予許可， AWS License Manager 才能設定 Rocket Software 執行期引擎（在 Amazon EC2 上）。 1. 導覽至 AWS License Manager 中的 AWS 管理主控台。 ![\[AWS License Manager 首頁。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-license-manager_1.png) 1. 選擇**開始使用 AWS License Manager**。 1. 如果您看到下列快顯視窗，請檢視詳細資訊，然後選擇核取方塊，然後按**授予許可**。 ![\[IAM 許可一次性設定\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-license-manager_2.png) # 訂閱 Amazon Machine Image 訂閱 AWS Marketplace 產品後，您可以從產品的 AMI 啟動執行個體。您也可以在設定 Rocket Software （先前稱為 Micro Focus) 執行期引擎（在 Amazon EC2 上）時管理訂閱AMIs。 1. 導覽至中的 AWS Marketplace 訂閱 AWS 管理主控台。 1. 選擇 **Manage subscriptions (管理訂閱)**。 ![\[AWS Marketplace 首頁。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-ami-subscription_1.png) 1. 將下列其中一個連結複製並貼到瀏覽器地址列。 **注意** 僅選擇您已獲授權使用之其中一個產品的連結。遵循 [請求帳戶的允許清單更新](mf-runtime-setup-allowlist.md)頁面以使用這些連結，確保您的帳戶已列入允許清單。 + 企業伺服器：https：//[https://aws.amazon.com/marketplace/pp/prodview-g5emev63l7blc](https://aws.amazon.com/marketplace/pp/prodview-g5emev63l7blc) + 適用於 Windows 的企業伺服器：https：//[https://aws.amazon.com/marketplace/pp/prodview-lwybsiyikbhc2](https://aws.amazon.com/marketplace/pp/prodview-lwybsiyikbhc2) + 企業開發人員：https：//[https://aws.amazon.com/marketplace/pp/prodview-77qmpr42yzxwk](https://aws.amazon.com/marketplace/pp/prodview-77qmpr42yzxwk) + 使用 Visual Studio 2022 的企業開發人員：https：//[https://aws.amazon.com/marketplace/pp/prodview-m4l3lqiszo6cm](https://aws.amazon.com/marketplace/pp/prodview-m4l3lqiszo6cm) + Enterprise Analyzer：https：//[https://aws.amazon.com/marketplace/pp/prodview-tttheylcmcihm](https://aws.amazon.com/marketplace/pp/prodview-tttheylcmcihm) + 適用於 Windows 的企業建置工具：https：//[https://aws.amazon.com/marketplace/pp/prodview-2rw35bbt6uozi](https://aws.amazon.com/marketplace/pp/prodview-2rw35bbt6uozi) + 企業儲存程序：https：//[https://aws.amazon.com/marketplace/pp/prodview-zoeyqnsdsj6ha](https://aws.amazon.com/marketplace/pp/prodview-zoeyqnsdsj6ha) + SQL Server 2019 的企業儲存程序：https：//[https://aws.amazon.com/marketplace/pp/prodview-ynfklquwubnz4](https://aws.amazon.com/marketplace/pp/prodview-ynfklquwubnz4) 1. 選擇 **Continue to Subscribe (繼續以訂閱)**。 ![\[中的 Enterprise Server 產品 AWS Marketplace。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-ami-subscription_2.png) 1. 如果條款與條件是可接受的，請選擇**接受條款**。 ![\[訂閱條款及條件。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-ami-subscription_3.png) 1. 訂閱可能需要幾分鐘的時間來處理。 ![\[訂閱擱置訊息。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-ami-subscription_4.png) 1. 顯示感謝訊息後，請複製並貼上步驟 3 的下一個連結，以繼續新增訂閱。 ![\[訂閱感謝訊息。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-ami-subscription_5.png) 1. 當**管理訂閱**顯示所有訂閱AMIs 時停止。 **注意** 面板偏好設定（齒輪圖示）設定為將檢視顯示為資料表。 ![\[使用訂閱的 AMIs 清單管理訂閱。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-ami-subscription_6.png) # 啟動 AWS Mainframe Modernization Rocket Software （先前稱為 Micro Focus) 執行個體建立端點、IAM 政策、IAM 角色和訂閱 AMIs 之後，您就可以在中啟動 AWS Mainframe Modernization Rocket Software (Micro Focus) 執行個體 AWS 管理主控台。 1. 導覽至中的 AWS Marketplace 訂閱 AWS 管理主控台。 1. 找到要啟動的 AMI，然後選擇**啟動新執行個體**。 ![\[使用 Enterprise Server 和 Enterprise Analyzer 準備啟動來管理訂閱。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-launch-instance_1.png) 1. 在啟動新的執行個體對話方塊中，確保已選取允許清單區域。 1. 按下**繼續以透過 EC2 啟動**。 **注意** 下列範例顯示企業開發人員 AMI 的啟動，但所有 AWS Mainframe Modernization AMIs的程序都相同。 ![\[啟動新的執行個體。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-launch-instance_2.png) 1. 輸入伺服器的名稱。 1. 選擇執行個體類型。選取的執行個體類型應取決於專案效能和成本需求。以下是建議的起點： + 對於 Enterprise Analyzer，r6i.xlarge + 對於企業開發人員，r6i.large + 對於 Enterprise Server 的獨立執行個體，r6i.xlarge + 對於具有橫向擴展的 Rocket 軟體效能可用性叢集 (PAC)，r6i.large **注意** 螢幕擷取畫面的應用程式和作業系統映像區段已摺疊。 ![\[啟動輸入名稱和執行個體類型的執行個體。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-launch-instance_3.png) 1. 選擇或建立（並儲存）金鑰對（未顯示）。如需 Linux 執行個體金鑰對的詳細資訊，請參閱 [Amazon EC2 金鑰對和 Linux 執行個體](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html)。如需 Windows 執行個體金鑰對的詳細資訊，請參閱 [Amazon EC2 金鑰對和 Windows 執行個體](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ec2-key-pairs.html)。 1. 編輯網路設定，**然後選擇允許清單 VPC **和適當的子網路。 1. **選擇或建立安全群組**。如果這是 Enterprise Server EC2 執行個體，通常允許連接埠 86 和 10086 的 TCP 流量管理 Rocket 軟體組態。 1. 選擇性地設定 Amazon EC2 執行個體的儲存體。 1. 重要 - 展開進階詳細資訊，並在 IAM 執行個體描述檔下選擇先前建立的授權角色，例如「Micro-Focus-Licensing-role」。 **注意** 如果遺漏此步驟，則在建立執行個體之後，您可以從 EC2 執行個體的動作功能表的安全性選項修改 IAM 角色。 ![\[輸入 IAM 執行個體描述檔的進階詳細資訊。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-launch-instance_4.png) 1. 檢閱摘要並推送**啟動執行個體**。 ![\[選取選項的摘要。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-launch-instance_5.png) 1. 如果選擇無效的虛擬伺服器類型，執行個體啟動將會失敗。如果發生這種情況，請選擇**編輯執行個體組態**並變更執行個體類型。 ![\[啟動執行個體進度訊息。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-launch-instance_6.png) 1. 一旦顯示「成功」訊息，請選擇**連線至執行個體**以取得連線詳細資訊。 ![\[執行個體啟動成功訊息。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-launch-instance_7.png) 1. 或者，在中導覽至 **EC2** AWS 管理主控台。 1. 選擇**執行個體**以查看新執行個體的狀態。 ![\[狀態的執行個體清單。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-launch-instance_8.png) # 沒有網際網路存取的子網路或 VPC 如果子網路或 VPC 沒有傳出網際網路存取，請進行這些額外的變更。授權管理員需要存取下列 AWS 服務： + com.amazonaws.*region*.s3 + com.amazonaws.*region*.ec2 + com.amazonaws.*region*.license-manager + com.amazonaws.*region*.sts 先前步驟將 com.amazonaws.*region*.s3 服務定義為閘道端點。此端點需要路由表項目，才能用於沒有網際網路存取的任何子網路。額外的三個服務將定義為介面端點。 **Topics** + [ ## 新增 Amazon S3 端點的路由表項目 ](#mf-runtime-setup-no-access-route-table) + [ ## 定義所需的安全群組 ](#mf-runtime-setup-no-access-security-group) + [ ## 建立服務端點 ](#mf-runtime-setup-no-access-endpoints) ## 新增 Amazon S3 端點的路由表項目 1. 在中導覽至 **VPC** AWS 管理主控台，然後選擇**子網路**。 1. 選擇將要建立 Amazon EC2 執行個體的子網路，然後選擇路由表索引標籤。 1. 請注意 Route 資料表 ID 的幾個結尾數字。例如，下圖中的 6b39。 ![\[路由表詳細資訊。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-no-internet_1.png) 1. 從導覽窗格中選擇**端點**。 1. 選擇先前建立的端點，然後從端點的**路由表索引標籤或從動作下拉式清單中管理**路由表。 1. 使用先前識別的數字選擇路由表，然後按修改路由表。 ![\[已選取路由表。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-no-internet_2.png) ## 定義所需的安全群組 Amazon EC2 AWS STS和 License Manager 服務會透過連接埠 443 透過 HTTPS 通訊。此通訊是雙向的，需要傳入和傳出規則，以允許執行個體與服務通訊。 1. 在中導覽至 Amazon VPC AWS 管理主控台。 1. 在導覽列中尋找**安全群組**，然後選擇**建立安全群組**。 1. 輸入安全群組名稱和描述，例如「傳入/傳出 HTTPS」。 1. 按下 VPC 選擇區域中的 X 以**移除預設 VPC**，然後選擇包含 S3 端點的 VPC。 1. 新增傳入規則，**允許來自任何地方的連接埠 443 上的 TCP 流量**。 **注意** 透過限制來源，可以進一步限制傳入（和傳出規則）。如需詳細資訊，請參閱《*Amazon VPC 使用者指南*》中的[使用安全群組控制 AWS 資源的流量](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-security-groups.html)。 ![\[輸入傳入規則的基本詳細資訊。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-no-internet_3.png) 1. 按下**建立安全群組**。 ## 建立服務端點重複此程序三次 – 每個服務一次。 1. 在中導覽至 Amazon VPC AWS 管理主控台，然後選擇**端點**。 1. 按下**建立端點**。 1. 輸入名稱，例如「Micro-Focus-License-EC2」、「Micro-Focus-License-STS」或「Micro-Focus-License-Manager」。 1. 選擇 **AWS Services** 服務類別。 ![\[選取 AWS 服務的端點設定。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-no-internet_4.png) 1. 在服務下搜尋相符的界面服務，這是下列其中一項： + 「com.amazonaws.*region*.ec2」 + 「com.amazonaws.*region*.sts」 + 「com.amazonaws.*region*.license-manager」例如： + 「com.amazonaws.us-west-1.ec2」 + 「com.amazonaws.us-west-1.sts」 + 「com.amazonaws.us-west-1.license-manager」 1. 選擇相符的界面服務。 **com.amazonaws.*region*.ec2**： ![\[已選取 Amazon EC2 介面服務的服務。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-no-internet_5.png) **com.amazonaws.*region*.sts：** ![\[已選取 AWS STS 界面服務的服務。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-no-internet_6.png) **com.amazonaws.*region*.license-manager：** ![\[已選取 License Manager 介面服務的服務。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-no-internet_7.png) 1. 針對 VPC，選擇執行個體的 VPC。 ![\[已選取執行個體 VPC 的 VPC。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-no-internet_8.png) 1. 選擇 VPC 的**可用區域**和**子網路**。 ![\[具有所選 VPC 可用區域和子網路的子網路。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-no-internet_9.png) 1. 選擇先前建立的安全群組。 ![\[選取安全群組的安全群組。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-no-internet_10.png) 1. 在政策下選擇**完整存取**。 ![\[選取完整存取的政策。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/mf-no-internet_11.png) 1. 選擇**建立端點**。 1. 針對剩餘的界面重複此程序。 # 設定 Automation for Rocket Enterprise Analyzer （先前稱為 Micro Focus) 和 Rocket Enterprise 開發人員串流工作階段您可以在工作階段開始和結束時自動執行指令碼，以允許客戶內容特定的自動化。如需此 WorkSpaces 應用程式功能的詳細資訊，請參閱《*Amazon WorkSpaces 應用程式管理指南*》中的[使用工作階段指令碼來管理 AppStream 2.0 使用者的串流體驗](https://docs.aws.amazon.com/appstream2/latest/developerguide/use-session-scripts.html)。此功能需要您至少擁有以下版本的 Enterprise Analyzer 和 Enterprise Developer 映像： + `m2-enterprise-analyzer-v8.0.4.R1` + `m2-enterprise-developer-v8.0.4.R1` **Topics** + [ ## 在工作階段開始時設定自動化 ](#set-up-automation-m2.start) + [ ## 在工作階段結束時設定自動化 ](#set-up-automation-m2.end) ## 在工作階段開始時設定自動化如果您想要在使用者連線至 WorkSpaces 應用程式時執行自動化指令碼，請建立指令碼並將其命名為 `m2-user-setup.cmd`。將指令碼存放在使用者的 WorkSpaces 應用程式主資料夾中。 AWS 大型主機現代化提供的 WorkSpaces 應用程式映像會在該位置尋找具有該名稱的指令碼，並在存在時執行該指令碼。 **注意** 指令碼持續時間不能超過 WorkSpaces 應用程式設定的限制，目前為 60 秒。如需詳細資訊，請參閱《*Amazon WorkSpaces 應用程式管理指南*》中的[在串流工作階段開始之前執行指令碼](https://docs.aws.amazon.com/appstream2/latest/developerguide/use-session-scripts.html#run-scripts-before-streaming-sessions-begin)。 ## 在工作階段結束時設定自動化如果您想要在使用者中斷與 WorkSpaces 應用程式的連線時執行自動化指令碼，請建立指令碼並將其命名為 `m2-user-teardown.cmd`。將指令碼存放在使用者的 WorkSpaces 應用程式主資料夾中。 AWS 大型主機現代化提供的 WorkSpaces 應用程式映像會在該位置尋找具有該名稱的指令碼，並在存在時執行該指令碼。 **注意** 指令碼持續時間不能超過 WorkSpaces 應用程式設定的限制，目前為 60 秒。如需詳細資訊，請參閱《*Amazon WorkSpaces 應用程式管理指南*》中的[在串流工作階段結束後執行指令碼](https://docs.aws.amazon.com/appstream2/latest/developerguide/use-session-scripts.html#run-scripts-after-streaming-sessions-end)。 # 在 Rocket Enterprise Developer （先前為 Micro Focus Enterprise Developer) 中將資料集檢視為資料表和資料欄您可以使用 Rocket Software （先前稱為 Micro Focus) 執行時間，存取部署在 AWS Mainframe Modernization 中的大型主機資料集。您可以從 Rocket Enterprise Developer 執行個體將遷移的資料集檢視為資料表和資料欄。以這種方式檢視資料集可讓您： + 在遷移的資料檔案上執行`SQL SELECT`操作。 + 在遷移大型主機應用程式外公開資料，而不變更應用程式。 + 輕鬆篩選資料並儲存為 CSV 或其他檔案格式。 **注意** 步驟 1 和 2 是一次性活動。針對每個資料集重複步驟 3 和 4，以建立資料庫檢視。 **Topics** + [ ## 先決條件 ](#view-datasets-tables-m2.prereq) + [ ## 步驟 1：設定與 Rocket Software 資料存放區的 ODBC 連線 (Amazon RDS 資料庫） ](#view-datasets-tables-m2.odbc) + [ ## 步驟 2：建立 MFDBFH.cfg 檔案 ](#view-datasets-tables-m2.config) + [ ## 步驟 3：為您的複製手冊配置建立結構 (STR) 檔案 ](#view-datasets-tables-m2.str) + [ ## 步驟 4：使用結構 (STR) 檔案建立資料庫檢視 ](#view-datasets-tables-m2.dbview) + [ ## 步驟 5：將 Rocket Software （先前稱為 Micro Focus) 資料集檢視為資料表和資料欄 ](#view-datasets-tables-m2.cols) ## 先決條件 + 您必須能夠透過 WorkSpaces 應用程式存取 Rocket Enterprise Developer Desktop。 + 您必須使用 Rocket Software 執行期引擎，在 AWS Mainframe Modernization 下部署和執行應用程式。 + 您正在 Aurora PostgreSQL 相容版本中存放應用程式資料。 ## 步驟 1：設定與 Rocket Software 資料存放區的 ODBC 連線 (Amazon RDS 資料庫）在此步驟中，您會設定資料庫的 ODBC 連線，其中包含要檢視為資料表和資料欄的資料。這是一次性步驟。 1. 使用 WorkSpaces 應用程式串流 URL 登入 Rocket Enterprise Developer Desktop。 1. 開啟 **ODBC 資料來源管理員**，選擇**使用者 DSN**，然後選擇**新增**。 1. 在**建立新資料來源**中，選擇 **PostgreSQL ANSI**，然後選擇**完成**。 1. 透過`PG.POSTGRES`提供必要的資料庫資訊來建立的資料來源，如下所示： ``` Data Source : PG.POSTGRES Database : postgres Server : rds_endpoint.rds.amazonaws.com Port : 5432 User Name : user_name Password : user_password ``` ![\[在企業開發人員中設定 Postgres ODBC 連線。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/view-data-tables-odbc.png) 1. 選擇**測試**，以確保連線正常運作。`Connection successful` 如果測試成功，您應該會看到訊息。如果測試不成功，請檢閱下列資訊。 + [Amazon RDS 的故障診斷](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Troubleshooting.html) + [如何解決連線至 Amazon RDS 資料庫執行個體時的問題？](https://repost.aws/knowledge-center/rds-cannot-connect) 1. 儲存資料來源。 1. 建立的資料來源`PG.VSAM`、測試連線並儲存資料來源。提供下列資料庫資訊： ``` Data Source : PG.VSAM Database : MicroFocus$SEE$Files$VSAM Server : rds_endpoint.rds.amazonaws.com Port : 5432 User Name : user_name Password : user_password ``` ![\[在企業開發人員中設定 PG.VSAM ODBC 資料來源。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/view-data-tables-pg-vsam.png) ## 步驟 2：建立 MFDBFH.cfg 檔案在此步驟中，您會建立描述 Micro Focus 資料存放區的組態檔案。這是一次性的組態步驟。 1. 在主資料夾中，例如，在中`D:\PhotonUser\My Files\Home Folder\MFED\cfg\MFDBFH.cfg`，使用下列內容建立 MFDBFH.cfg 檔案。 ``` ``` 1. 執行下列命令來查詢 Micro Focus 資料存放區，以驗證 MFDBFH 組態： ``` *##* *## Test the connection by running the following commands* *##* set MFDBFH_CONFIG="D:\PhotonUser\My Files\Home Folder\MFED\cfg\MFDBFH.cfg" dbfhdeploy list sql://ESPACDatabase/VSAM?folder=/DATA ``` ## 步驟 3：為您的複製手冊配置建立結構 (STR) 檔案在此步驟中，您會為複製手冊配置建立結構檔案，以便稍後使用它從資料集建立資料庫檢視。 1. 編譯與您的複製手冊相關聯的程式。如果沒有程式正在使用複製手冊，請使用複製手冊的 COPY 陳述式來建立和編譯簡單的程式，如下所示。 ``` IDENTIFICATION DIVISION. PROGRAM-ID. TESTPGM1. ENVIRONMENT DIVISION. CONFIGURATION SECTION. DATA DIVISION. WORKING-STORAGE SECTION. COPY CVTRA05Y. PROCEDURE DIVISION. GOBACK. ``` 1. 成功編譯後，在程式上按一下滑鼠右鍵，然後選擇**建立記錄配置檔案**。這會使用編譯期間產生的 .idy 檔案來開啟 Micro Focus 資料檔案工具。 ![\[企業開發人員中建立記錄配置檔案命令的位置。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/view-data-tables-idy-file.png) 1. 在記錄結構上按一下滑鼠右鍵，然後根據配置選擇**建立預設配置** （單一結構）或**建立條件式配置** （多重結構）。如需詳細資訊，請參閱 Micro Focus 文件中的[建立結構檔案和配置](https://www.microfocus.com/documentation/enterprise-developer/ed60/ES-WIN/GUID-6EDDA4C3-F09E-4CEC-9CF8-281D9D7453C3.html)。 ![\[Micro Focus 資料檔案工具中配置命令的位置。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/view-data-tables-mf-data-file-tools.png) 1. 建立配置後，從功能表中選擇**檔案**，然後選擇**另存新檔**。瀏覽並儲存主資料夾下的檔案，其檔案名稱與複製手冊相同。您可以選擇建立名為的資料夾，`str`並將所有結構檔案儲存在該處。 ![\[在企業開發人員中儲存 str 檔案。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/view-data-tables-save-str.png) ## 步驟 4：使用結構 (STR) 檔案建立資料庫檢視在此步驟中，您會使用先前建立的結構檔案來建立資料集的資料庫檢視。 + 使用 `dbfhview`命令為已在 Micro Focus 資料存放區中的資料集建立資料庫檢視，如下列範例所示。 ``` ## ## The below command creates database view for VSAM file AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS ## using the STR file CVTRA05Y.str ## dbfhview -create -struct:"D:\PhotonUser\My Files\Home Folder\MFED\str\CVTRA05Y.str" -name:V_AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS.DAT -file:sql://ESPACDatabase/VSAM/AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS.DAT?folder=/DATA ## ## Output: ## Micro Focus Database File Handler - View Generation Tool Version 8.0.00 Copyright (C) 1984-2022 Micro Focus. All rights reserved. VGN0017I Using structure definition 'TRAN-RECORD-DEFAULT' VGN0022I View 'V_AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS.DAT' installed in datastore 'sql://espacdatabase/VSAM' VGN0002I The operation completed successfully ``` ## 步驟 5：將 Rocket Software （先前稱為 Micro Focus) 資料集檢視為資料表和資料欄在此步驟中，使用連線至資料庫`pgAdmin`，以便您可以執行查詢以檢視資料表和資料欄等資料集。 + `MicroFocus$SEE$Files$VSAM` 使用 pgAdmin 連線到資料庫，並查詢您在步驟 4 中建立的資料庫檢視。 ``` SELECT * FROM public."V_AWS.M2.CARDDEMO.TRANSACT.VSAM.KSDS.DAT"; ``` ![\[遷移的資料集顯示 pgAdmin 中的資料表和資料欄。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/view-data-tables-new-view-pgadmin.png) # 在企業開發人員中使用 Rocket Software （先前稱為 Micro Focus) 資料檔案工具編輯資料集您可以使用 Rocket Software 執行時間來檢視和編輯 AWS 大型主機現代化中任何已遷移資料集的資料集。  本文件中的步驟將引導您使用資料檔案工具存取資料集。  這可讓您視需要檢視和編輯遷移的資料集。  **Topics** + [ ## 先決條件 ](#edit-datasets-m2.prereq) + [ ## 啟動 Rocket Software （先前為 Micro Focus) 資料檔案工具 ](#edit-datasets-m2-launch) + [ ## 編輯存放在 MFDBFH 資料庫中的 VSAM 資料集 ](#edit-datasets-m2-vsam) + [ ## 編輯存放在 MFDBFH 資料庫中的非 VSAM 資料集 ](#edit-datasets-m2-nonvsam) + [ ## 編輯存放在檔案系統中的 VSAM 和非 VSAM 資料集 (EFS/FSx) ](#edit-datasets-m2-open) ## 先決條件開始之前，您必須使用資料集部署應用程式  使用 Rocket 軟體引擎在 AWS Mainframe Modernization 服務下匯入。若要繼續編輯資料集，您必須完成步驟 1、步驟 2、  和（選用） [在 Rocket Enterprise Developer （先前為 Micro Focus Enterprise Developer) 中將資料集檢視為資料表和資料欄](view-datasets-tables-m2.md)頁面的步驟 3  設定 ODBC 連線和 Micro Focus 資料存放區（即 `MFDBFH`)。 **重要** 本指南假設您使用 Amazon Aurora Postgres 做為 Micro Focus 資料存放區 (`MFDBFH`)  來存放您的應用程式資料。 ## 啟動 Rocket Software （先前為 Micro Focus) 資料檔案工具完成先決條件後，您可以透過設定 `MFDBFH_CONFIG`環境變數來存取存放在資料庫 () 中的資料集，以啟動 Micro Focus 資料檔案工具`MFDBFH`。若要這樣做， 1. 登入 Micro Focus Enterprise Developer 桌面，然後從**開始功能表**啟動**企業開發人員命令提示字元 (64 位元）**。 1. 使用`MFDBCH.cfg`檔案的完整路徑設定`MFDBFH_CONFIG`環境變數。 ``` set MFDBFH_CONFIG="C:\MicroFocus\config\MFDBFH.cfg" ``` 1. 使用下列命令，從企業開發人員命令列啟動 Micro Focus 資料檔案工具。 ``` mfdatatools2 ``` ![\[企業開發人員命令提示字元。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/edit-mfdbfh-launch.png) 這會在單獨的視窗中開啟 Micro Focus 資料檔案工具。 ## 編輯存放在 MFDBFH 資料庫中的 VSAM 資料集啟動 Micro Focus 資料檔案工具後，您可以開啟存放在 Micro Focus 資料存放區的 VSAM 資料集。若要這樣做， 1. 從 Micro Focus Data File Tools 視窗中**的檔案選單**中，選擇 **Data Explorer**。 1. 在 Data Explorer 區段中，選擇**設定** （齒輪圖示）以設定新的連線。這會開啟**資料來源設定**視窗。 ![\[Micro Focus Data File Tools 視窗與 Data Explorer 區段。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/edit-mfdbfh-data-source.png) 1. 在資料來源設定視窗中，選擇 **MFDBFH** 索引標籤，然後輸入下列值： + 伺服器： `ESPACDatabase` + 資料存放區： `VSAM` 選擇**套用**以儲存組態。 ![\[Micro Focus Data File Tools 使用 MFDBFH 索引標籤視窗資料來源設定。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/edit-mfdbfh-data-source-settings.png) Data Explorer 現在會顯示存放在中的所有資料集`MFDBFH`。 ![\[Micro Focus Data File Tools 視窗，內含顯示所有資料集的 Data Explorer 區段。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/edit-mfdbfh-datasets.png) 1. 展開相對路徑`DATA`，按兩下您要開啟的 VSAM 資料集。 1. 在**開啟資料檔案**視窗中，選擇**開啟共用**或**開啟獨佔**以開啟資料集。 ![\[Micro Focus Data File Tools 視窗與 Data Explorer 區段開啟資料檔案區段以開啟資料集。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/edit-mfdbfh-data-set.png) 您現在可以檢視或編輯開啟的資料集。 ## 編輯存放在 MFDBFH 資料庫中的非 VSAM 資料集如果您想要編輯非 VSAM 資料集，您可以開啟存放在 Micro Focus 資料存放區中的非 VSAM 資料集。若要這樣做， 1. 從企業開發人員命令提示字元 (64 位元）執行 `dbfhdeploy data extract`命令，將非 VSAM 資料集下載到您的本機檔案系統。 **注意** 執行此命令之前，請確定您已使用`MFDBFH.cfg`檔案的完整路徑設定`MFDBFH_CONFIG`環境變數。 ``` dbfhdeploy data extract sql://ESPACDatabase/VSAM/AWS.M2.CARDDEMO.TRANSACT.BKUP.G0001V00.DAT?folder=/DATA C:\MicroFocus\data\AWS.M2.CARDDEMO.TRANSACT.BKUP.G0001V00.DAT ``` 1. 從**開始功能表**啟動 Micro Focus 資料檔案工具。 1. 從 Micro Focus 資料檔案工具的檔案選單中，選擇**開啟**，然後選擇**資料檔案**。 1. 在開啟資料檔案視窗中，瀏覽本機檔案系統中下載的資料集。視需要編輯**檔案詳細資訊**。然後選擇**開啟共用**或**開啟獨佔**以開啟資料集。 ![\[開啟資料檔案視窗，並選取本機標籤來瀏覽資料集。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/edit-mfdbfh-browse.png) 您現在可以檢視或編輯開啟的資料集。編輯或更新的資料集可以使用 [匯入 AWS Mainframe Modernization 應用程式的資料集](applications-m2-dataset.md)中的步驟或使用 [dbfhdeploy Command Line Utility ](https://www.microfocus.com/documentation/enterprise-developer/ed90/ED-Eclipse/GUID-2A16851F-E475-42C9-B024-37567006B86D.html)匯入回 Micro Focus 資料存放區。 ## 編輯存放在檔案系統中的 VSAM 和非 VSAM 資料集 (EFS/FSx) 您也可以開啟存放在檔案系統中的資料集。若要這樣做， 1. 在 Enterprise Developer EC2 執行個體的中掛載EFS/FSx檔案系統。 1. 使用 Micro Focus 資料檔案工具瀏覽，並從檔案系統開啟資料集。 # 火箭軟體教學課程（先前為 Micro Focus) 本節中的教學課程可協助您開始為 AWS Mainframe Modernization 服務在 Rocket Software 執行期引擎中設定各種任務。這些教學課程用於設定範例應用程式、搭配 Rocket Enterprise Developer 使用範本，以及設定 Enterprise Analyzer。 **Topics** + [ # 教學課程：為 BankDemo 範例應用程式設定 Rocket Software （先前稱為 Micro Focus) 組建 ](tutorial-build-mf.md) + [ # 教學課程：設定 WorkSpaces 應用程式以搭配 Rocket Enterprise Analyzer 和 Rocket Enterprise Developer 使用 ](set-up-appstream-mf.md) + [ # 教學課程：搭配 Rocket Enterprise Developer （先前為 Micro Focus Enterprise Developer) 使用範本 ](tutorial-templates-ed.md) + [ # 教學課程：在 WorkSpaces 應用程式上設定 Enterprise Analyzer ](set-up-ea.md) + [ # 教學課程：在 WorkSpaces 應用程式上設定 Rocket Enterprise Developer ](set-up-ed.md) # 教學課程：為 BankDemo 範例應用程式設定 Rocket Software （先前稱為 Micro Focus) 組建 AWS Mainframe Modernization 可讓您為遷移的應用程式設定建置和持續整合/持續交付 (CI/CD) 管道。這些建置和管道會使用 AWS CodeBuild AWS CodeCommit和 AWS CodePipeline 來提供這些功能。CodeBuild 是全受管建置服務，可編譯您的原始程式碼、執行單元測試，並產生準備好部署的成品。CodeCommit 是一種版本控制服務，可讓您在 AWS 雲端中私下存放和管理 Git 回應。CodePipeline 是一種持續交付服務，可讓您模型化、視覺化和自動化發行軟體所需的步驟。本教學課程示範如何使用從 Amazon S3 AWS CodeBuild 編譯 BankDemo 範例應用程式原始碼，然後將編譯後的程式碼匯出回 Amazon S3。 AWS CodeBuild 是一種全受管持續整合服務，可編譯原始程式碼、執行測試，並產生準備好部署的軟體套件。使用 CodeBuild，您可以使用預先封裝的建置環境，也可以使用您自己的建置工具建立自訂建置環境。此示範案例使用第二個選項。它包含使用預先封裝 Docker 映像的 CodeBuild 建置環境。 **重要** 在開始大型主機現代化專案之前，建議您先了解[AWS 大型主機的 Migration Acceleration Program (MAP)](https://aws.amazon.com/migration-acceleration-program/mainframe/)，或聯絡[AWS 大型主機專家](mailto: mainframe@amazon.com)，以了解現代化大型主機應用程式所需的步驟。 **Topics** + [ ## 先決條件 ](#tutorial-build-mf-prerequisites) + [ ## 步驟 1：與 AWS 帳戶共用建置資產 ](#tutorial-build-mf-assets) + [ ## 步驟 2：建立 Amazon S3 儲存貯體 ](#tutorial-build-mf-s3) + [ ## 步驟 3：建立建置規格檔案 ](#tutorial-build-mf-spec) + [ ## 步驟 4：上傳來源檔案 ](#tutorial-build-mf-upload) + [ ## 步驟 5：建立 IAM 政策 ](#tutorial-build-mf-IAM-policy) + [ ## 步驟 6：建立 IAM 角色 ](#tutorial-build-mf-IAM-role) + [ ## 步驟 7：將 IAM 政策連接至 IAM 角色 ](#tutorial-build-mf-attach) + [ ## 步驟 8：建立 CodeBuild 專案 ](#tutorial-build-mf-create-project) + [ ## 步驟 9：啟動建置 ](#tutorial-build-mf-start) + [ ## 步驟 10：下載輸出成品 ](#tutorial-build-mf-download-output) + [ ## 清除資源 ](#tutorial-build-mf-clean) ## 先決條件開始本教學課程之前，請先完成下列先決條件。 + 下載 [BankDemo 範例應用程式](https://d3lkpej5ajcpac.cloudfront.net/demo/mf/BANKDEMO-build.zip)，並將其解壓縮至資料夾。來源資料夾包含 COBOL 程式、Copybook 和定義。它也包含 JCL 資料夾以供參考，但您不需要建置 JCL。資料夾也包含建置所需的中繼檔案。 + 在 AWS 大型主機現代化主控台中，選擇**工具** 。在**分析、開發和建置資產**中，選擇**與我的 AWS 帳戶共用資產**。 ## 步驟 1：與 AWS 帳戶共用建置資產在此步驟中，您會確保與 AWS 帳戶共用建置資產，尤其是在使用資產的區域中。 1. 在 https：//[https://console.aws.amazon.com/m2/](https://us-west-2.console.aws.amazon.com/m2/home?region=us-west-2#/) 開啟 AWS 大型主機現代化主控台。 1. 在左側導覽中，選擇**工具**。 1. 在**分析、開發和建置資產**中，選擇**與我的 AWS 帳戶共用資產**。 **重要** 您需要在每個要進行建置的 AWS 區域中執行此步驟一次。 ## 步驟 2：建立 Amazon S3 儲存貯體在此步驟中，您會建立兩個 Amazon S3 儲存貯體。第一個是用來保存原始程式碼的輸入儲存貯體，另一個是用來保存建置輸出的輸出儲存貯體。如需詳細資訊，請參閱《[Amazon S3 使用者指南》中的建立、設定和使用 Amazon S3 儲存貯](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html)體。 *Amazon S3 * 1. 若要建立輸入儲存貯體，請登入 Amazon S3 主控台，然後選擇**建立儲存貯**體。 1. 在**一般組態**中，提供儲存貯體的名稱，並指定您要建立儲存貯體 AWS 區域的。範例名稱為 `codebuild-regionId-accountId-input-bucket`，其中 `regionId`是儲存貯體 AWS 區域的，而 `accountId`是您的 AWS 帳戶 ID。 **注意** 如果您要在與美國東部（維吉尼亞北部） AWS 區域不同的中建立儲存貯體，請指定 `LocationConstraint` 參數。如需詳細資訊，請參閱《*Amazon Simple Storage Service API 參考*》中的[建立儲存貯](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html)體。 1. 保留所有其他設定，然後選擇**建立儲存貯**體。 1. 重複步驟 1-3 來建立輸出儲存貯體。範例名稱為 `codebuild-regionId-accountId-output-bucket`，其中 `regionId`是儲存貯體 AWS 區域的，而 `accountId`是您的 AWS 帳戶 ID。無論您為這些儲存貯體選擇的名稱為何，請務必在本教學課程中使用這些儲存貯體。 ## 步驟 3：建立建置規格檔案在此步驟中，您會建立建置規格檔案。此檔案提供 YAML 格式的建置命令和相關設定，讓 CodeBuild 執行建置。如需詳細資訊，請參閱*AWS CodeBuild 《使用者指南*》中的[為 CodeBuild 建置規格參考](https://docs.aws.amazon.com/codebuild/latest/userguide/build-spec-ref.html)。 1. 在您解壓縮為先決條件`buildspec.yml`的目錄中建立名為的檔案。 1. 將下列內容新增至檔案並儲存。此檔案不需要變更。 ``` version: 0.2 env: exported-variables: - CODEBUILD_BUILD_ID - CODEBUILD_BUILD_ARN phases: install: runtime-versions: python: 3.7 pre_build: commands: - echo Installing source dependencies... - ls -lR $CODEBUILD_SRC_DIR/source build: commands: - echo Build started on `date` - /start-build.sh -Dbasedir=$CODEBUILD_SRC_DIR/source -Dloaddir=$CODEBUILD_SRC_DIR/target post_build: commands: - ls -lR $CODEBUILD_SRC_DIR/target - echo Build completed on `date` artifacts: files: - $CODEBUILD_SRC_DIR/target/** ``` 此處的 `CODEBUILD_BUILD_ID`、`$CODEBUILD_SRC_DIR/source`、 `CODEBUILD_BUILD_ARN`和 `$CODEBUILD_SRC_DIR/target`是 CodeBuild 中可用的環境變數。如需詳細資訊，請參閱[建置環境中的環境變數](https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-env-vars.html)。此時，您的目錄看起來應該會像這樣。 ``` (root directory name) |-- build.xml |-- buildspec.yml |-- LICENSE.txt |-- source |... etc. ``` 1. 將資料夾的內容壓縮至名為的檔案`BankDemo.zip`。在本教學課程中，您無法壓縮資料夾。反之，請將資料夾的內容壓縮至檔案 `BankDemo.zip`。 ## 步驟 4：上傳來源檔案在此步驟中，您將 BankDemo 範例應用程式的原始碼上傳至您的 Amazon S3 輸入儲存貯體。 1. 登入 Amazon S3 主控台，然後在左側導覽窗格中選擇**儲存貯**體。然後選擇您先前建立的輸入儲存貯體。 1. 在**物件**下，選擇**上傳**。 1. 在**檔案和資料夾**區段中，選擇**新增檔案**。 1. 導覽至並選擇您的 `BankDemo.zip` 檔案。 1. 選擇**上傳**。 ## 步驟 5：建立 IAM 政策在此步驟中，您會建立兩個 [IAM 政策](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html)。一項政策授予 AWS Mainframe Modernization 存取和使用包含 Rocket Software 組建工具的 Docker 映像的許可。此政策不會為客戶自訂。其他政策授予 AWS Mainframe Modernization 與輸入和輸出儲存貯體以及 CodeBuild 產生的 [Amazon CloudWatch logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/WhatIsCloudWatchLogs.html)互動的許可。若要了解如何建立 IAM 政策，請參閱《[IAM 使用者指南》中的編輯 IAM 政策](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html)。 ** **建立存取 Docker 映像的政策** 1. 在 IAM 主控台中，複製下列政策文件並將其貼到政策編輯器中。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "ecr:GetAuthorizationToken" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "ecr:BatchCheckLayerAvailability", "ecr:GetDownloadUrlForLayer", "ecr:BatchGetImage" ], "Resource": "arn:aws:ecr:*:673918848628:repository/m2-enterprise-build-tools" }, { "Effect": "Allow", "Action": [ "s3:PutObject" ], "Resource": "arn:aws:s3:::aws-m2-repo-*--prod" } ] } ``` ------ 1. 提供政策的名稱，例如 `m2CodeBuildPolicy`。 **建立允許 AWS Mainframe Modernization 與儲存貯體和日誌互動的政策** 1. 在 IAM 主控台中，複製下列政策文件並將其貼到政策編輯器中。請務必`regionId`將 AWS 區域和更新`accountId`為 AWS 帳戶。 1. 提供政策的名稱，例如 `BankdemoCodeBuildRolePolicy`。 ## 步驟 6：建立 IAM 角色在此步驟中，您會建立新的 [IAM 角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)，在您將先前建立的 IAM 政策與此新 IAM 角色建立關聯之後，允許 CodeBuild 與您 AWS 資源互動。如需有關建立服務角色的資訊，請參閱《*IAM 使用者指南*》中的[建立角色以委派許可給 AWS 服務](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html)。 1. 登入 IAM 主控台，然後在左側導覽窗格中選擇**角色**。 1. 選擇建**立角色**。 1. 在**信任的實體類型**下，選擇 **AWS 服務**。 1. 在**其他 AWS 服務的使用案例**下，選擇 **CodeBuild**，然後再次選擇 **CodeBuild**。 1. 選擇**下一步**。 1. 在 **Add permissions** (新增許可) 頁面上，選擇 **Next** (下一步)。您稍後會將政策指派給角色。 1. 在**角色詳細資訊**下，提供角色的名稱，例如 `BankdemoCodeBuildServiceRole`。 1. 在**選取信任的實體**下，確認政策文件如下所示： ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "codebuild.amazonaws.com" }, "Action": "sts:AssumeRole" } ] } ``` ------ 1. 選擇建**立角色**。 ## 步驟 7：將 IAM 政策連接至 IAM 角色在此步驟中，您將先前建立的兩個 IAM 政策連接到 IAM `BankdemoCodeBuildServiceRole` 角色。 1. 登入 IAM 主控台，然後在左側導覽窗格中選擇**角色**。 1. 在**角色**中，選擇您先前建立的角色，例如 `BankdemoCodeBuildServiceRole`。 1. 在**許可政策**中，選擇**新增許可**，然後選擇**連接政策**。 1. **在其他許可政策**中，選擇您先前建立的政策，例如 `m2CodeBuildPolicy`和 `BankdemoCodeBuildRolePolicy`。 1. 選擇**連接政策**。 ## 步驟 8：建立 CodeBuild 專案在此步驟中，您會建立 CodeBuild 專案。 1. 登入 CodeBuild 主控台，然後選擇**建立建置專案**。 1. 在**專案組態**區段中，提供專案的名稱，例如 `codebuild-bankdemo-project`。 1. 在**來源**區段中，針對**來源提供者**選擇 **Amazon S3**，然後選擇您先前建立的輸入儲存貯體，例如 `codebuild-regionId-accountId-input-bucket`。 1. 在 **S3 物件金鑰或 S3 資料夾**欄位中，輸入您上傳到 S3 儲存貯體的 zip 檔案名稱。在此情況下，檔案名稱為 `bankdemo.zip`。 1. 在**環境**區段中，選擇**自訂映像**。 1. 在**環境類型**欄位中，選擇 **Linux**。 1. 在**映像登錄**檔下，選擇**其他登錄檔**。 1. 在**外部登錄 URL** 欄位中， + 對於 Rocket 軟體 v9：輸入 `673918848628.dkr.ecr.us-west-1.amazonaws.com/m2-enterprise-build-tools:9.0.7.R1`。如果您使用不同的 AWS 區域搭配 Rocket Software v9，您也可以指定 ` 673918848628.dkr.ecr..amazonaws.com/m2-enterprise-build-tools:9.0.7.R1`，其中是可使用 AWS 大型主機現代化服務 AWS 的區域（例如 `eu-west-3`)。 + 對於 Rocket 軟體 v8：輸入 `673918848628.dkr.ecr.us-west-2.amazonaws.com/m2-enterprise-build-tools:8.0.9.R1` + 對於 Rocket 軟體 v7：輸入 `673918848628.dkr.ecr.us-west-2.amazonaws.com/m2-enterprise-build-tools:7.0.R10` 1. 在**服務角色**下，選擇**現有服務角色**，然後在**角色 ARN** 欄位中，選擇您先前建立的服務角色；例如，`BankdemoCodeBuildServiceRole`。 1. 在 **Buildspec** 區段中，選擇**使用 buildspec 檔案**。 1. 在**成品**區段的**類型**下，選擇 **Amazon S3**，然後選擇輸出儲存貯體，例如 `codebuild-regionId-accountId-output-bucket`。 1. 在**名稱**欄位中，輸入您要包含建置輸出成品之儲存貯體中的資料夾名稱，例如 `bankdemo-output.zip`。 1. 在**成品封裝**下，選擇 **Zip**。 1. 選擇 **Create build project (建立建置專案)**。 ## 步驟 9：啟動建置在此步驟中，您會啟動建置。 1. 登入 CodeBuild 主控台。 1. 在左側導覽窗格中，選擇**建置專案**。 1. 選擇您先前建立的建置專案，例如 `codebuild-bankdemo-project`。 1. 選擇 **Start build (開始組建)**。此命令會啟動建置。組建會以非同步方式執行。命令的輸出是包含屬性 ID 的 JSON。此屬性 idis 是您剛啟動之組建的 CodeBuild 組建 ID 參考。您可以在 CodeBuild 主控台中檢視組建的狀態。您也可以在主控台中查看有關建置執行的詳細日誌。如需詳細資訊，請參閱*AWS CodeBuild 《使用者指南*》中的[檢視詳細的建置資訊](https://docs.aws.amazon.com/codebuild/latest/userguide/getting-started-build-log-console.html)。當目前階段為 COMPLETED 時，表示您的建置已成功完成，而且您的編譯成品已在 Amazon S3 上就緒。 ## 步驟 10：下載輸出成品在此步驟中，您會從 Amazon S3 下載輸出成品。Rocket 軟體建置工具可以建立數種不同的可執行檔類型。在本教學課程中，它會產生共用物件。 1. 登入 Amazon S3 主控台。 1. 在**儲存貯體** role="bold"> 區段中，選擇輸出儲存貯體的名稱，例如 `codebuild-regionId-accountId-output-bucket`。 1. 選擇**下載** role="bold">。 1. 解壓縮所下載的檔案。導覽至目標資料夾以查看建置成品。這些包括 `.so` Linux 共用物件。 ## 清除資源如果您不再需要為本教學課程建立的資源，請將其刪除以避免額外費用。若要這樣做，請完成下列步驟： + 刪除您為此教學課程建立的 S3 儲存貯體。如需詳細資訊，請參閱《*Amazon Simple Storage Service 使用者指南*》中的[刪除儲存貯](https://docs.aws.amazon.com/AmazonS3/latest/userguide/delete-bucket.html)體。 + 刪除您為此教學課程建立的 IAM 政策。如需詳細資訊，請參閱《[IAM 使用者指南》中的刪除 IAM 政策](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-delete.html)。 ** + 刪除您為此教學課程建立的 IAM 角色。如需詳細資訊，請參閱 *IAM 使用者指南*中的[刪除角色或執行個體描述檔](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_delete.html)。 + 刪除您為此教學課程建立的 CodeBuild 專案。如需詳細資訊，請參閱*AWS CodeBuild 《使用者指南*》中的在 [ CodeBuild 中刪除組建專案](https://docs.aws.amazon.com/codebuild/latest/userguide/delete-project.html)。 # 教學課程：設定 WorkSpaces 應用程式以搭配 Rocket Enterprise Analyzer 和 Rocket Enterprise Developer 使用 AWS Mainframe Modernization 透過 Amazon WorkSpaces 應用程式提供數種工具。WorkSpaces 應用程式是一種全受管、安全的應用程式串流服務，可讓您將桌面應用程式串流給使用者，而無需重寫應用程式。WorkSpaces 應用程式可讓使用者立即存取所需的應用程式，並在自己選擇的裝置上提供回應靈敏、流暢的使用者體驗。使用 WorkSpaces 應用程式託管執行期引擎特定工具，可讓客戶應用程式團隊直接從 Web 瀏覽器使用工具，並與存放在 Amazon S3 儲存貯體或 CodeCommit 儲存庫中的應用程式檔案互動。如需有關 WorkSpaces 應用程式中瀏覽器支援的資訊，請參閱《*Amazon WorkSpaces 應用程式管理指南*》中的[系統需求和功能支援（網頁瀏覽器）](https://docs.aws.amazon.com/appstream2/latest/developerguide/requirements-and-features-web-browser-admin.html)。如果您在使用 WorkSpaces 應用程式時遇到問題，請參閱《*Amazon WorkSpaces 應用程式管理指南*》中的[對 AppStream 2.0 使用者問題進行故障診斷](https://docs.aws.amazon.com/appstream2/latest/developerguide/troubleshooting-user-issues.html)。本文件適用於客戶營運團隊的成員。它說明如何設定 Amazon WorkSpaces 應用程式機群和堆疊來託管與 AWS Mainframe Modernization 搭配使用的 Rocket Enterprise Analyzer 和 Rocket Enterprise Developer 工具。Rocket Enterprise Analyzer 通常在評估階段使用，Rocket Enterprise Developer 通常在 AWS 大型主機現代化方法的遷移和現代化階段使用。如果您打算同時使用 Enterprise Analyzer 和 Enterprise Developer，您必須為每個工具建立單獨的機群和堆疊。每個工具都需要自己的機群和堆疊，因為其授權條款不同。 **重要** 本教學課程中的步驟是以可下載的 CloudFormation 範本 [cfn-m2-appstream-fleet-ea-ed.yml](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml) 為基礎。 **Topics** + [ ## 先決條件 ](#tutorial-aas-prerequisites) + [ ## 步驟 1：取得 WorkSpaces 應用程式映像 ](#tutorial-aas-step1) + [ ## 步驟 2：使用 CloudFormation 範本建立堆疊 ](#tutorial-aas-step2) + [ ## 步驟 3：在 WorkSpaces 應用程式中建立使用者 ](#tutorial-aas-step3) + [ ## 步驟 4：登入 WorkSpaces 應用程式 ](#tutorial-aas-step4) + [ ## 步驟 5：驗證 Amazon S3 中的儲存貯體（選用） ](#tutorial-aas-step5) + [ ## 後續步驟 ](#tutorial-aas-next-steps) + [ ## 清除資源 ](#tutorial-aas-cleanup) ## 先決條件 + 下載範本：[cfn-m2-appstream-fleet-ea-ed.yml](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml)。 + 取得預設 VPC 和安全群組的 ID。如需預設 VPC 的詳細資訊，請參閱《Amazon [ VPCs》中的預設](https://docs.aws.amazon.com/vpc/latest/userguide/default-vpc.html) VPC。 **如需預設安全群組的詳細資訊，請參閱《*Amazon EC2 使用者指南*》中的[預設和自訂安全群組](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/default-custom-security-groups.html)。 + 請確定您有下列許可： + 在 WorkSpaces 應用程式中建立堆疊、機群和使用者。 + CloudFormation 使用範本在中建立堆疊。 + 建立儲存貯體並將檔案上傳至 Amazon S3 中的儲存貯體。 + 從 IAM 下載登入資料 (`access_key_id` 和 `secret_access_key`)。 ## 步驟 1：取得 WorkSpaces 應用程式映像在此步驟中，您會與 AWS 帳戶共用 Enterprise Analyzer 和 Enterprise Developer 的 WorkSpaces 應用程式映像。 1. 在 https：//[https://console.aws.amazon.com/m2/](https://us-west-2.console.aws.amazon.com/m2/home?region=us-west-2#/) 開啟 AWS 大型主機現代化主控台。 1. 在左側導覽中，選擇**工具**。 1. 在**分析、開發和建置資產**中，選擇**與我的 AWS 帳戶共用資產**。 ## 步驟 2：使用 CloudFormation 範本建立堆疊在此步驟中，您會使用下載的 CloudFormation 範本來建立 WorkSpaces 應用程式堆疊和機群，以執行 Rocket Enterprise Analyzer。您可以稍後重複此步驟，為執行 Rocket Enterprise Developer 建立另一個 WorkSpaces 應用程式堆疊和機群，因為每個工具都需要自己的機群和 WorkSpaces 應用程式中的堆疊。如需 CloudFormation 堆疊的詳細資訊，請參閱*AWS CloudFormation 《使用者指南*》中的[使用堆疊](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacks.html)。 **注意** AWS Mainframe Modernization 會針對使用 Enterprise Analyzer 和 Enterprise Developer 的標準 WorkSpaces 應用程式定價增加額外費用。如需詳細資訊，請參閱[AWS 大型主機現代化定價](https://aws.amazon.com/mainframe-modernization/pricing/)。 1. 如有必要，請下載 [cfn-m2-appstream-fleet-ea-ed.yml 範本。](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml) 1. 開啟 CloudFormation 主控台，然後選擇使用新資源**建立堆疊** 和（標準）。 **** 1. 在**先決條件 - 準備範本**中，選擇**範本已就緒**。 1. 在**指定範本**中，選擇**上傳範本檔案**。 1. 在**上傳範本檔案中**，選擇**選擇檔案**並上傳 [cfn-m2-appstream-fleet-ea-ed.yml 範本。](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml) 1. 選擇**下一步**。 ![\[使用選取的 cfn-m2-appstream-fleet-ea-ed.yml 範本 CloudFormation 建立堆疊頁面。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/cfn-create-stack.png) 1. 在**指定堆疊詳細資訊**上，輸入下列資訊： + 在**堆疊名稱**中，輸入您選擇的名稱。例如 **m2-ea**。 + 在 **AppStreamApplication** 中，選擇 **ea**。 + 在 **AppStreamFleetSecurityGroup** 中，選擇預設 VPC 的預設安全群組。 + 在 **AppStreamFleetVpcSubnet** 中，選擇預設 VPC 內的子網路。 + 在 **AppStreamImageName** 中，選擇以開頭的影像`m2-enterprise-analyzer`。此映像包含 Rocket Enterprise Analyzer 工具目前支援的版本。 + 接受其他欄位的預設值，然後選擇**下一步**。 ![\[已填入 Enterprise Analyzer 選項的 CloudFormation 指定堆疊詳細資訊頁面。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/cfn-specify-stack-details.png) 1. 接受所有預設值，然後再次選擇**下一步**。 1. **檢閱**時，請確定所有參數都是您想要的。 1. 捲動至底部，選擇**我確認 AWS CloudFormation 可能會使用自訂名稱建立 IAM 資源**，然後選擇**建立堆疊**。堆疊和機群需要 20 到 30 分鐘才能建立。您可以選擇**重新整理**，在 CloudFormation 事件發生時查看事件。 ## 步驟 3：在 WorkSpaces 應用程式中建立使用者當您等待 CloudFormation 完成建立堆疊時，您可以在 WorkSpaces 應用程式中建立一或多個使用者。這些使用者是將在 WorkSpaces 應用程式中使用 Enterprise Analyzer 的使用者。您需要為每個使用者指定電子郵件地址，並確保每個使用者有足夠的許可在 Amazon S3 中建立儲存貯體、將檔案上傳至儲存貯體，以及連結到儲存貯體以映射其內容。 1. 開啟 WorkSpaces 應用程式主控台。 1. 在左側導覽中，選擇**使用者集區**。 1. 選擇 **Create user** (建立使用者)。 1. 提供電子郵件地址，讓使用者可以收到使用 WorkSpaces 應用程式的電子郵件邀請、名字和姓氏，然後選擇**建立使用者**。 1. 如有必要，請重複此動作以建立更多使用者。每個使用者的電子郵件地址必須是唯一的。如需建立 WorkSpaces 應用程式使用者的詳細資訊，請參閱《Amazon [WorkSpaces 應用程式管理指南》中的 WorkSpaces 應用程式使用者集](https://docs.aws.amazon.com/appstream2/latest/developerguide/user-pool.html)區。 *Amazon WorkSpaces * CloudFormation 完成建立堆疊後，您可以將您建立的使用者指派給堆疊，如下所示： 1. 開啟 WorkSpaces 應用程式主控台。 1. 選擇使用者名稱。 1. 選擇**動作**，然後選擇**指派堆疊**。 1. 在**指派堆疊**中，選擇開頭為的堆疊`m2-appstream-stack-ea`。 1. 選擇 **Assign stack (指派堆疊)**。 ![\[WorkSpaces 應用程式指派堆疊頁面顯示要指派的使用者和 Enterprise Analyzer 堆疊。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/aas-assign-stack.png) 將使用者指派給堆疊會導致 WorkSpaces 應用程式根據您提供的地址傳送電子郵件給使用者。此電子郵件包含 WorkSpaces 應用程式登入頁面的連結。 ## 步驟 4：登入 WorkSpaces 應用程式在此步驟中，您會使用 WorkSpaces 應用程式傳送給您在中建立之使用者的電子郵件中的連結登入 WorkSpaces 應用程式[步驟 3：在 WorkSpaces 應用程式中建立使用者](#tutorial-aas-step3)。 1. 使用 WorkSpaces 應用程式傳送的電子郵件中提供的連結登入 WorkSpaces 應用程式。 1. 如果出現提示，請變更您的密碼。您看到的 WorkSpaces 應用程式畫面類似如下： ![\[顯示桌面圖示的範例 WorkSpaces 應用程式登入畫面。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/aas-login-screen.png) 1. 選擇**桌面**。 1. 在任務列上，選擇**搜尋**並輸入 **D:** 以導覽至主資料夾。 **注意** 如果您略過此步驟，當您嘗試存取主資料夾`Device not ready`時，可能會發生錯誤。在任何時候，如果您無法登入 WorkSpaces 應用程式，您可以使用下列步驟重新啟動 WorkSpaces 應用程式機群並嘗試再次登入。 1. 開啟 WorkSpaces 應用程式主控台。 1. 在左側導覽中，選擇**機群**。 1. 選擇您嘗試使用的機群。 1. 選擇**動作**，然後選擇**停止**。 1. 等待機群停止。 1. 選擇**動作**，然後選擇**開始**。此程序可能需要約 10 分鐘的時間。 ## 步驟 5：驗證 Amazon S3 中的儲存貯體（選用）您用來建立堆疊的 CloudFormation 範本完成的任務之一是在 Amazon S3 中建立兩個儲存貯體，這是跨工作工作階段儲存和還原使用者資料和應用程式設定的必要項目。這些儲存貯體如下所示： + 名稱開頭為 `appstream2-`。此儲存貯體會將資料映射至 WorkSpaces 應用程式 () 中的主資料夾`D:\PhotonUser\My Files\Home Folder`。 **注意** 主資料夾對於指定的電子郵件地址是唯一的，並且會在指定 AWS 帳戶中的所有機群和堆疊之間共用。Home Folder 的名稱是使用者電子郵件地址的 SHA256 雜湊，並根據該雜湊儲存在路徑上。 + 名稱開頭為 `appstream-app-settings-`。此儲存貯體包含 WorkSpaces 應用程式的使用者工作階段資訊，並包含瀏覽器我的最愛、IDE 和應用程式連線設定檔，以及 UI 自訂等設定。如需詳細資訊，請參閱*《Amazon WorkSpaces 應用程式管理指南*》中的[應用程式設定持久性的運作方式](https://docs.aws.amazon.com/appstream2/latest/developerguide/how-it-works-app-settings-persistence.html)。若要驗證儲存貯體是否已建立，請依照下列步驟執行： 1. 開啟 Amazon S3 主控台。 1. 在左側導覽中，選擇**儲存貯體**。 1. 在**依名稱尋找儲存貯**體中，輸入 **appstream**來篩選清單。如果您看到儲存貯體，則不需要進一步的動作。請注意，儲存貯體存在。如果您沒有看到儲存貯體，則表示 CloudFormation 範本未完成執行，或發生錯誤。前往 CloudFormation 主控台並檢閱堆疊建立訊息。 ## 後續步驟現在已設定 WorkSpaces 應用程式基礎設施，您可以設定並開始使用 Enterprise Analyzer。如需詳細資訊，請參閱[教學課程：在 WorkSpaces 應用程式上設定 Enterprise Analyzer](set-up-ea.md)。您也可以設定企業開發人員。如需詳細資訊，請參閱[教學課程：在 WorkSpaces 應用程式上設定 Rocket Enterprise Developer](set-up-ed.md)。 ## 清除資源清除建立的堆疊和機群的程序如[建立 WorkSpaces 應用程式機群和堆疊](https://docs.aws.amazon.com/appstream2/latest/developerguide/set-up-stacks-fleets.html)中所述。刪除 WorkSpaces 應用程式物件後，帳戶管理員也可以視需要清除應用程式設定和主資料夾的 Amazon S3 儲存貯體。 **注意** 指定使用者的主資料夾在所有機群中都是唯一的，因此如果同一帳戶中有其他 WorkSpaces 應用程式堆疊處於作用中狀態，您可能需要保留它。最後，WorkSpaces 應用程式目前不允許您使用主控台刪除使用者。反之，您必須搭配 CLI 使用服務 API。如需詳細資訊，請參閱《Amazon WorkSpaces 應用程式管理指南》中的[使用者集](https://docs.aws.amazon.com/appstream2/latest/developerguide/user-pool-admin.html)區管理。 *Amazon WorkSpaces * # 教學課程：搭配 Rocket Enterprise Developer （先前為 Micro Focus Enterprise Developer) 使用範本本教學課程說明如何搭配 Rocket Enterprise Developer 使用範本和預先定義的專案。它涵蓋三個使用案例。所有使用案例都會使用 BankDemo 範例中提供的範本程式碼。若要下載範例，請選擇 [https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip](https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip) 。 **重要** 如果您使用適用於 Windows 的 Enterprise Developer 版本，編譯器產生的二進位檔只能在 Enterprise Developer 隨附的 Enterprise Server 上執行。您無法在以 Linux 為基礎的 AWS Mainframe Modernization 執行時間下執行它們。 **Topics** + [ ## 使用案例 1 - 使用包含來源元件的 COBOL 專案範本 ](#tutorial-templates-ed-step1) + [ ## 使用案例 2 - 使用不含來源元件的 COBOL 專案範本 ](#tutorial-templates-ed-step2) + [ ## 使用案例 3 - 使用連結至來源資料夾的預先定義 COBOL 專案 ](#tutorial-templates-ed-step3) + [ ## 使用區域定義 JSON 範本 ](#tutorial-templates-ed-step4) ## 使用案例 1 - 使用包含來源元件的 COBOL 專案範本此使用案例需要您將來源元件複製到範本目錄結構，作為示範預先設定步驟的一部分。在中，[https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip](https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip)這已從原始`AWSTemplates.zip`交付變更，以避免有兩個來源複本。 1. 啟動企業開發人員並指定選擇的工作區。 ![\[選取工作區的 Eclipse 啟動器。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-uc1-step1.png) 1. 在 **Application Explorer** 檢視中，從**企業開發專案**樹狀檢視項目中，從內容功能表中**選擇範本中的新專案**。 ![\[企業開發專案樹狀檢視內容選單。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-uc1-step2.png) 1. 輸入範本參數，如下所示。 **注意** 範本路徑會參照 ZIP 的擷取位置。 ![\[輸入範本參數方塊，其中包含填入的路徑和專案名稱。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-uc1-step3.png) 1. 選擇確定將根據提供的範本建立本機開發 Eclipse 專案，其中包含完整的來源和執行環境結構。 ![\[顯示其結構的本機開發 Eclipse 專案。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-uc1-step4.png) `System` 結構包含完整的資源定義檔案，其中包含 BANKDEMO 的必要項目、新增項目的必要目錄，以及對應的 ASCII 資料檔案。由於來源範本結構包含所有來源項目，因此這些檔案會複製到本機專案，因此會自動建置在企業開發人員中。 ## 使用案例 2 - 使用不含來源元件的 COBOL 專案範本步驟 1 到 3 與相同[使用案例 1 - 使用包含來源元件的 COBOL 專案範本](#tutorial-templates-ed-step1)。此使用案例中的`System`結構也包含完整的資源定義檔案，其中包含 BankDemo 所需的項目、新增項目的必要目錄，以及對應的 ASCII 資料檔案。不過，範本來源結構不包含任何元件。您必須從您使用的任何來源儲存庫將這些項目匯入專案。 1. 選擇專案名稱。從相關內容功能表中，選擇**匯入**。 ![\[選取匯入的專案內容選單。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-uc2-step4.png) 1. 在產生的對話方塊中，於**一般**區段下，選擇**檔案系統**，然後選擇下一步。 ![\[已選取檔案系統的匯入方塊。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-uc2-step5.png) 1. 瀏覽檔案系統以指向儲存庫資料夾，填入**從目錄**欄位。選擇您要匯入的所有資料夾，例如 `sources`。`Into folder` 欄位將預先填入。選擇**完成**。 ![\[展開 BankDemo 目錄的檔案系統方塊。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-uc2-step6.png) 在來源範本結構包含所有來源項目之後，它們會自動建置在企業開發人員中。 ## 使用案例 3 - 使用連結至來源資料夾的預先定義 COBOL 專案 1. 啟動企業開發人員並指定選擇的工作區。 ![\[選取工作區的 Eclipse 啟動器。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-uc3-step1.png) 1. 從 **File (檔案)** 功能表中，選擇 **Import (匯入)**。 ![\[已選取匯入的檔案功能表。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-uc3-step2.png) 1. 從產生的對話方塊中，在**一般**下，**從資料夾或封存中選擇專案**，然後選擇**下一步**。 ![\[選取從資料夾或封存匯入專案的方塊。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-uc3-step3.png) 1. 填入**匯入來源**、選擇**目錄**並瀏覽檔案系統，以選取預先定義的專案資料夾。中包含的專案具有相同儲存庫中來源資料夾的連結。 ![\[從檔案系統或封存方塊匯入專案，並輸入匯入來源的路徑。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-uc3-step4.png) 選擇**完成**。由於專案是由來源資料夾的連結填入，因此會自動建置程式碼。 ## 使用區域定義 JSON 範本 1. 切換到 Server Explorer 檢視。從相關內容功能表中，選擇**開啟管理頁面**，這會啟動預設瀏覽器。 ![\[已選取開啟管理頁面的伺服器瀏覽器內容選單。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-json-admin-page.png) 1. 從產生的 Enterprise Server Common Web Administration (ESCWA) 畫面中，選擇**匯入** 。 ![\[已選取匯入的企業伺服器通用 Web 管理畫面。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-json-import.png) 1. 選擇 **JSON** 匯入類型，然後選擇**下一步**。 ![\[選取 JSON 的選擇匯入類型方塊。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-json-import-type.png) 1. 上傳提供的`BANKDEMO.JSON`檔案。 ![\[選擇要上傳且已選取 BANKDEMO 檔案的檔案方塊。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-json-upload.png) 選取後，選擇**下一步**。 ![\[具有來自未選取端點之透明連接埠的選取區域方塊。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-json-next.png) 在**選取區域**面板上，確保未選取**從端點清除連接埠**選項，然後繼續透過面板選擇**下一步**，直到顯示**執行匯入**面板。然後從左側導覽窗格中選擇**匯入**。最後按一下**完成**。接著會將 BANKDEMO 區域新增至伺服器清單。 ![\[新增了 BankDemo 的區域和伺服器清單。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-json-server-list.png) 1. 導覽至 BANKDEMO 區域**的一般屬性**。 1. 捲動至**組態**區段。 1. ESP 環境變數需要設定為與先前步驟中建立的 Eclipse 專案相關的`System`資料夾。這應該是 `workspacefolder/projectname/System`。 ![\[顯示 ESP 變數的組態區段。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-json-ESP.png) 1. 按一下 **Apply (套用)**。區域現在已完全設定為搭配 Eclipse COBOL 專案執行。 1. 最後，回到企業開發人員，將匯入的區域與專案建立關聯。 ![\[選取與專案相關聯的專案內容選單。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-json-associate.png) 企業開發人員環境現在已準備就緒，可使用完整的 BankDemo 工作版本。您可以針對區域編輯、編譯和偵錯程式碼。 **重要** 如果您使用適用於 Windows 的 Enterprise Developer 版本，編譯器產生的二進位檔只能在 Enterprise Developer 隨附的 Enterprise Server 上執行。您無法在以 Linux 為基礎的 AWS Mainframe Modernization 執行時間下執行它們。 # 教學課程：在 WorkSpaces 應用程式上設定 Enterprise Analyzer 本教學課程說明如何設定 Rocket Enterprise Analyzer （先前稱為 Micro Focus Enterprise Analyzer) 來分析一或多個大型主機應用程式。Enterprise Analyzer 工具會根據其對應用程式原始碼和系統定義的分析，提供數個報告。此設定旨在促進團隊協作。安裝使用 Amazon S3 儲存貯體與虛擬磁碟共用原始程式碼。這樣做會在 Windows 機器上使用 [Rclone](https://rclone.org/))。使用執行 [PostgreSQL](https://www.postgresql.org/) 的常見 Amazon RDS 執行個體，團隊的任何成員都可以存取所有請求的報告。團隊成員也可以在其個人機器上掛載虛擬 Amazon S3 支援的磁碟。並從工作站更新來源儲存貯體。如果連接到其他內部部署系統，他們可以在機器上使用指令碼或任何其他形式的自動化。設定是以 AWS 大型主機現代化與客戶共用的 WorkSpaces 應用程式 Windows 映像為基礎。設定也以 WorkSpaces 應用程式機群和堆疊的建立為基礎，如中所述[教學課程：設定 WorkSpaces 應用程式以搭配 Rocket Enterprise Analyzer 和 Rocket Enterprise Developer 使用](set-up-appstream-mf.md)。 **重要** 本教學課程中的步驟假設您使用可 CloudFormation 下載的範本 [cfn-m2-appstream-fleet-ea-ed.yml](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml) 設定 WorkSpaces 應用程式。如需詳細資訊，請參閱[教學課程：設定 WorkSpaces 應用程式以搭配 Rocket Enterprise Analyzer 和 Rocket Enterprise Developer 使用](set-up-appstream-mf.md)。若要執行本教學課程中的步驟，您必須已設定 Enterprise Analyzer 機群和堆疊，而且必須正在執行。如需 Enterprise Analyzer 功能和交付項目的完整說明，請參閱 Rocket Software （先前稱為 Micro Focus) 網站上的 [Enterprise Analyzer 文件](https://www.microfocus.com/documentation/enterprise-analyzer/)。 ## 影像內容除了 Enterprise Analyzer 應用程式本身之外，映像還包含下列工具和程式庫。第三方工具 + [Python](https://www.python.org/) + [Rclone](https://rclone.org/) + [pgAdmin](https://www.pgadmin.org/) + [git-scm](https://git-scm.com/) + [PostgreSQL ODBC 驅動程式](https://odbc.postgresql.org/) 中的程式庫 `C:\Users\Public` + 企業開發人員的 BankDemo 原始程式碼和專案定義：`m2-bankdemo-template.zip`。 + 大型主機的 MFA 安裝套件：`mfa.zip`。如需詳細資訊，請參閱 *Micro Focus Enterprise Developer *文件中的[大型主機存取概觀](https://www.microfocus.com/documentation/enterprise-developer/30pu12/ED-VS2012/BKMMMMINTRS001.html)。 + Rclone 的命令和組態檔案（教學課程中的指示）： `m2-rclone.cmd`和 `m2-rclone.conf`。 **Topics** + [ ## 影像內容 ](#set-up-ea-image-contents) + [ ## 先決條件 ](#tutorial-ea-prerequisites) + [ ## 步驟 1：設定 ](#tutorial-ea-step1) + [ ## 步驟 2：在 Windows 上建立以 Amazon S3 為基礎的虛擬資料夾 ](#tutorial-ea-step2) + [ ## 步驟 3：建立 Amazon RDS 執行個體的 ODBC 來源 ](#tutorial-ea-step3) + [ ## 後續工作階段 ](#tutorial-ea-step4) + [ ## 工作區連線故障診斷 ](#tutorial-ea-step5) + [ ## 清除資源 ](#tutorial-ea-clean) ## 先決條件 + 將您要分析的客戶應用程式的原始程式碼和系統定義上傳至 S3 儲存貯體。系統定義包括 CICS CSD、DB2 物件定義等。您可以在儲存貯體中建立資料夾結構，以決定您想要如何組織應用程式成品。例如，當您解壓縮 BankDemo 範例時，其具有下列結構： ``` demo |--> jcl |--> RDEF |--> transaction |--> xa ``` + 建立並啟動執行 PostgreSQL 的 Amazon RDS 執行個體。此執行個體將存放 Enterprise Analyzer 產生的資料和結果。您可以與應用程式團隊的所有成員共用此執行個體。此外，在資料庫中建立名為 `m2_ea`（或任何其他適當名稱）的空白結構描述。定義授權使用者的登入資料，允許他們建立、插入、更新和刪除此結構描述中的項目。您可以從 Amazon RDS 主控台或帳戶管理員取得資料庫名稱、其伺服器端點 URL 和 TCP 連接埠。 + 請確定您已設定的程式設計存取權 AWS 帳戶。如需詳細資訊，請參閱中的[程式設計存取](https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys)*Amazon Web Services 一般參考。* ## 步驟 1：設定 1. 使用您在 WorkSpaces 應用程式歡迎電子郵件訊息中收到的 URL 啟動 WorkSpaces 應用程式的工作階段。 1. 使用您的電子郵件做為您的使用者 ID，並定義您的永久密碼。 1. 選取 Enterprise Analyzer 堆疊。 1. 在 WorkSpaces 應用程式選單頁面上，選擇**桌面**以連接機群正在串流的 Windows 桌面。 ## 步驟 2：在 Windows 上建立以 Amazon S3 為基礎的虛擬資料夾 **注意** 如果您已在 AWS Mainframe Modernization 預覽期間使用 Rclone，則必須更新`m2-rclone.cmd`至位於的較新版本`C:\Users\Public`。 1. `C:\Users\PhotonUser\My Files\Home Folder` 使用 `m2-rclone.cmd` File Explorer 將中提供的 `m2-rclone.conf`和檔案`C:\Users\Public`複製到主資料夾。 1. 使用 AWS 存取金鑰和對應的秘密以及 `m2-rclone.conf` 更新組態參數 AWS 區域。 ``` [m2-s3] type = s3 provider = AWS access_key_id = YOUR-ACCESS-KEY secret_access_key = YOUR-SECRET-KEY region = YOUR-REGION acl = private server_side_encryption = AES256 ``` 1. 在 `m2-rclone.cmd` 中，進行下列變更： + `amzn-s3-demo-bucket` 變更為 Amazon S3 儲存貯體名稱。例如 `m2-s3-mybucket`。 + `your-s3-folder-key` 變更為 Amazon S3 儲存貯體金鑰。例如 `myProject`。 + `your-local-folder-path` 變更為您要從包含它們的 Amazon S3 儲存貯體同步應用程式檔案的目錄路徑。例如 `D:\PhotonUser\My Files\Home Folder\m2-new`。此同步目錄必須是主資料夾的子目錄，WorkSpaces 應用程式才能在工作階段開始和結束時正確備份和還原。 ``` :loop timeout /T 10 "C:\Program Files\rclone\rclone.exe" sync m2-s3:amzn-s3-demo-bucket/your-s3-folder-key "D:\PhotonUser\My Files\Home Folder\your-local-folder-path" --config "D:\PhotonUser\My Files\Home Folder\m2-rclone.conf" goto :loop ``` 1. `C:\Users\PhotonUser\My Files\Home Folder` 視需要開啟 Windows 命令提示字元，cd 至並執行 `m2-rclone.cmd`。此命令指令碼會執行連續迴圈，將您的 Amazon S3 儲存貯體和金鑰每 10 秒同步至本機資料夾。您可以視需要調整逾時。您應該會在 Windows File Explorer 的 Amazon S3 儲存貯體中看到應用程式的原始碼。若要將新檔案新增至您正在處理的集，或更新現有的檔案，請將檔案上傳至 Amazon S3 儲存貯體，並在中定義的下一個反覆運算時同步至您的目錄`m2-rclone.cmd`。同樣地，如果您要刪除一些檔案，請從 Amazon S3 儲存貯體中刪除它們。下一個同步操作會從本機目錄刪除它們。 ## 步驟 3：建立 Amazon RDS 執行個體的 ODBC 來源 1. 若要啟動 EA\$1Admin 工具，請導覽至瀏覽器視窗左上角的應用程式選擇器選單，然後選擇 **MF EA\$1Admin**。 1. 從**管理員**功能表中，選擇 **ODBC 資料來源**，然後從**使用者 DSN** 索引標籤選擇**新增**。 1. 在建立新的資料來源對話方塊中，選擇 **PostgreSQL Unicode** 驅動程式，然後選擇**完成**。 1. 在 **PostgreSQL Unicode ODBC 驅動程式 (psqlODBC) 設定**對話方塊中，定義並記下您想要的資料來源名稱。使用您先前建立之 RDS 執行個體的值完成下列參數： **Description** 選用描述，協助您快速識別此資料庫連線。 **資料庫** 您先前建立的 Amazon RDS 資料庫。 **Server** Amazon RDS 端點。 **站點** Amazon RDS 連接埠。 **使用者名稱** 如 Amazon RDS 執行個體中所定義。 **密碼** 如 Amazon RDS 執行個體中所定義。 1. 選擇**測試**以驗證與 Amazon RDS 的連線是否成功，然後選擇**儲存**以儲存您的新使用者 DSN。 1. 等到您看到確認建立適當工作區的訊息，然後選擇**確定**完成 ODBC 資料來源，然後關閉 EA\$1Admin 工具。 1. 再次導覽至應用程式選擇器選單，然後選擇 Enterprise Analyzer 以啟動工具。選擇**建立新項目**。 1. 在工作區組態視窗中，輸入您的工作區名稱並定義其位置。如果您在此組態下工作，工作區可以是 Amazon S3 型磁碟，或者如果您願意，也可以是主資料夾。 1. 選擇**選擇其他資料庫**以連線至您的 Amazon RDS 執行個體。 1. 從選項中選擇 **Postgre** 圖示，然後選擇**確定**。 1. 針對**選項 – 定義連線參數**下的 Windows 設定，輸入您建立的資料來源名稱。同時輸入資料庫名稱、結構描述名稱、使用者名稱和密碼。選擇**確定**。 1. 等待 Enterprise Analyzer 建立所有資料表、索引等，以便儲存結果。此程序可能需要幾分鐘的時間。Enterprise Analyzer 會確認資料庫和工作區何時可供使用。 1. 再次導覽至應用程式選擇器選單，然後選擇 Enterprise Analyzer 以啟動工具。 1. Enterprise Analyzer 啟動視窗會顯示在新的所選工作區位置。選擇**確定**。 1. 導覽至左側窗格中的儲存庫，選取儲存庫名稱，然後選擇**將檔案/資料夾新增至工作區**。選取存放應用程式碼的資料夾，將其新增至工作區。您可以視需要使用先前的 BankDemo 範例程式碼。當 Enterprise Analyzer 提示您驗證這些檔案時，請選擇**驗證**以啟動初始 Enterprise Analyzer 驗證報告。視您的應用程式大小而定，可能需要幾分鐘的時間才能完成。 1. 展開您的工作區，以查看您已新增至工作區的檔案和資料夾。物件類型和循環複雜性報告也會顯示在**圖表檢視器**窗格的上象限中。您現在可以針對所有必要的任務使用 Enterprise Analyzer。 ## 後續工作階段 1. 使用您在 WorkSpaces 應用程式歡迎電子郵件訊息中收到的 URL 啟動 WorkSpaces 應用程式的工作階段。 1. 使用您的電子郵件和永久密碼登入。 1. 選取 Enterprise Analyzer 堆疊。 1. 如果您使用此選項來共用工作區檔案，請啟動 `Rclone` 以連線至 Amazon S3 後端磁碟。 1. 啟動 Enterprise Analyzer 來執行您的任務。 ## 工作區連線故障診斷當您嘗試重新連線至 Enterprise Analyzer 工作區時，您可能會看到如下錯誤： ``` Cannot access the workspace directory D:\PhotonUser\My Files\Home Folder\EA_BankDemo. The workspace has been created on a non-shared disk of the EC2AMAZ-E6LC33H computer. Would you like to correct the workspace directory location? ``` 若要解決此問題，請選擇**確定**以清除訊息，然後完成以下步驟。 1. 在 WorkSpaces 應用程式中，選擇工具列上的**啟動應用程式**圖示，然後選擇 **EA\$1Admin** 以啟動 Enterprise Analyzer 管理工具。 ![\[已選取 Rocket Enterprise Developer 管理工具的 WorkSpaces 應用程式啟動選擇器功能表。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/aas-launch-selector.png) 1. 從**管理員**功能表中，選擇**重新整理工作區路徑...**。 ![\[選取重新整理工作區路徑時，管理 Rocket Enterprise Analyzer 管理工具的功能表。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ea_admin-administer-refresh.png) 1. 在**選取工作區**下，選擇您想要的工作區，然後選擇**確定**。 ![\[選取專案時 Rocket Enterprise Analyzer 管理工具的選取工作區對話方塊。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ea_admin-select-workspace.png) 1. 選擇**確定**以確認錯誤訊息。 ![\[已選取 OK 的 Enterprise Analyzer 錯誤訊息「無法存取工作區目錄」。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ea_admin-select-workspace-error.png) 1. 在**工作區目錄網路路徑**下，輸入工作區的正確路徑，例如 `D:\PhotonUser\My Files\Home Folder\EA\MyWorkspace3`。 ![\[Enterprise Analyzer 對話方塊具有範例路徑的工作區目錄網路路徑。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ea_admin-workspace-directory-network-path.png) 1. 關閉 Micro Focus Enterprise Analyzer 管理工具。 ![\[已選取關閉按鈕的 Micro Focus Enterprise Analyzer 管理工具。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ea_admin-close.png) 1. 在 WorkSpaces 應用程式中，選擇工具列上的**啟動應用程式**圖示，然後選擇 **EA** 以啟動 Micro Focus Enterprise Analyzer。 ![\[已選取 EA 的 WorkSpaces 應用程式啟動應用程式圖示。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/aas-launch-ea.png) 1. 重複步驟 3 - 5。 Micro Focus Enterprise Analyzer 現在應使用現有的工作區開啟。 ## 清除資源如果您不再需要為本教學課程建立的資源，請將其刪除，以免產生進一步的費用。請完成下列步驟： + 使用 **EA\$1Admin** 工具刪除工作區。 + 刪除您為此教學課程建立的 S3 儲存貯體。如需詳細資訊，請參閱《Amazon S3 使用者指南》**中的[刪除儲存貯體](https://docs.aws.amazon.com/AmazonS3/latest/userguide/delete-bucket.html)。 + 刪除您為此教學課程建立的資料庫。如需詳細資訊，請參閱[刪除資料庫執行個體](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html#CHAP_GettingStarted.Deleting.PostgreSQL)。 # 教學課程：在 WorkSpaces 應用程式上設定 Rocket Enterprise Developer 本教學課程說明如何為一或多個大型主機應用程式設定 Rocket Enterprise Developer （先前稱為 Micro Focus Enterprise Developer)，以便使用企業開發人員功能進行維護、編譯和測試。此設定是根據 AWS 大型主機現代化與客戶共用的 WorkSpaces 應用程式 Windows 映像，以及建立 WorkSpaces 應用程式機群和堆疊，如中所述[教學課程：設定 WorkSpaces 應用程式以搭配 Rocket Enterprise Analyzer 和 Rocket Enterprise Developer 使用](set-up-appstream-mf.md)。 **重要** 本教學課程中的步驟假設您使用可 CloudFormation 下載的範本 [cfn-m2-appstream-fleet-ea-ed.yaml](https://d1vi4vxke6c2hu.cloudfront.net/tutorial/cfn-m2-appstream-fleet-ea-ed.yaml) 設定 WorkSpaces 應用程式。如需詳細資訊，請參閱[教學課程：設定 WorkSpaces 應用程式以搭配 Rocket Enterprise Analyzer 和 Rocket Enterprise Developer 使用](set-up-appstream-mf.md)。當企業開發人員機群和堆疊啟動並執行時，您必須執行此設定的步驟。如需 Enterprise Developer v7 功能和交付項目的完整說明，請參閱 Rocket Software （先前稱為 Micro Focus[) 網站上的up-to-date線上文件 (v7.0)。](https://www.microfocus.com/documentation/enterprise-developer/ed70/ED-Eclipse/GUID-8D6B7358-AC35-4DAF-A445-607D8D97EBB2.html) ## 影像內容除了企業開發人員本身之外，映像還包含 Rumba (TN3270 模擬器）。它還包含下列工具和程式庫。第三方工具 + [Python](https://www.python.org/) + [Rclone](https://rclone.org/) + [pgAdmin](https://www.pgadmin.org/) + [git-scm](https://git-scm.com/) + [PostgreSQL ODBC 驅動程式](https://odbc.postgresql.org/) 中的程式庫 `C:\Users\Public` + 企業開發人員的 BankDemo 原始程式碼和專案定義：`m2-bankdemo-template.zip`。 + 大型主機的 MFA 安裝套件：`mfa.zip`。如需詳細資訊，請參閱 *Micro Focus Enterprise Developer *文件中的[大型主機存取概觀](https://www.microfocus.com/documentation/enterprise-developer/30pu12/ED-VS2012/BKMMMMINTRS001.html)。 + Rclone 的命令和組態檔案（教學課程中的指示）： `m2-rclone.cmd`和 `m2-rclone.conf`。如果您需要存取尚未載入 CodeCommit 儲存庫的原始程式碼，但可在 Amazon S3 儲存貯體中使用，例如，若要執行原始程式碼的初始載入至 git，請依照中所述的程序建立虛擬 Windows 磁碟[教學課程：在 WorkSpaces 應用程式上設定 Enterprise Analyzer](set-up-ea.md)。 **Topics** + [ ## 影像內容 ](#set-up-ed-image-contents) + [ ## 先決條件 ](#tutorial-ed-prerequisites) + [ ## 步驟 1：由個別企業開發人員使用者設定 ](#tutorial-ed-step1) + [ ## 步驟 2：在 Windows 上建立 Amazon S3 型虛擬資料夾（選用） ](#tutorial-ed-step2) + [ ## 步驟 3：複製儲存庫 ](#tutorial-ed-step3) + [ ## 後續工作階段 ](#tutorial-ed-step4) + [ ## 清除資源 ](#tutorial-ed-clean) ## 先決條件 + 一或多個 CodeCommit 儲存庫，載入要維護的應用程式原始碼。儲存庫設定應符合上述CI/CD管道的要求，以透過結合這兩種工具來建立協同作用。 + 每個使用者都必須擁有 CodeCommit 儲存庫的登入資料，或帳戶管理員根據 [ AWS CodeCommit 身分驗證和存取控制](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control.html)中的資訊定義的儲存庫。這些登入資料的結構會在 [ AWS CodeCommit 的身分驗證和存取控制](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control.html)中檢閱，而 CodeCommit 的 IAM 授權完整參考位於 [CodeCommit 許可參考](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control-permissions-reference.html)中：管理員可以為具有每個儲存庫角色特定登入資料的不同角色定義不同的 IAM 政策，並將使用者的授權限制在指定儲存庫上必須完成的特定任務集。因此，對於 CodeCommit 儲存庫的每個維護者，帳戶管理員將產生主要使用者，並透過選取適當的 IAM 政策或 CodeCommit 存取政策，授予此使用者存取所需儲存庫或儲存庫的許可。 ## 步驟 1：由個別企業開發人員使用者設定 1. 取得您的 IAM 登入資料： 1. 連線至 AWS 主控台，網址為 https：//[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)。 1. 遵循《 *AWS CodeCommit 使用者指南*》中的[使用 Git 登入資料設定 HTTPS 使用者](https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-gc.html)的步驟 3 中所述的程序。 1. 複製 IAM 為您產生的 CodeCommit 特定登入憑證，方法是顯示、複製此資訊，然後將此資訊貼到本機電腦上的安全檔案中，或選擇**下載憑證**，將此資訊下載為 .CSV 檔案。您需要此資訊才能連線至 CodeCommit。 1. 根據歡迎電子郵件中收到的 URL，使用 WorkSpaces 應用程式啟動工作階段。使用您的電子郵件做為使用者名稱並建立您的密碼。 1. 選取您的企業開發人員堆疊。 1. 在選單頁面上，選擇**桌面**以連接機群串流的 Windows 桌面。 ## 步驟 2：在 Windows 上建立 Amazon S3 型虛擬資料夾（選用）如果需要 Rclone （請參閱上述），請在 Windows 上建立以 Amazon S3 為基礎的虛擬資料夾：（如果所有應用程式成品完全來自 CodeCommit 存取，則為選用）。 **注意** 如果您已在 AWS Mainframe Modernization 預覽期間使用 Rclone，則必須更新`m2-rclone.cmd`至位於的較新版本`C:\Users\Public`。 1. `C:\Users\PhotonUser\My Files\Home Folder` 使用 `m2-rclone.cmd` File Explorer 將中提供的 `m2-rclone.conf`和檔案`C:\Users\Public`複製到主資料夾。 1. 使用 AWS 存取金鑰和對應的秘密以及 `m2-rclone.conf` 更新組態參數 AWS 區域。 ``` [m2-s3] type = s3 provider = AWS access_key_id = YOUR-ACCESS-KEY secret_access_key = YOUR-SECRET-KEY region = YOUR-REGION acl = private server_side_encryption = AES256 ``` 1. 在 `m2-rclone.cmd` 中，進行下列變更： + `amzn-s3-demo-bucket` 變更為 Amazon S3 儲存貯體名稱。例如 `m2-s3-mybucket`。 + `your-s3-folder-key` 變更為 Amazon S3 儲存貯體金鑰。例如 `myProject`。 + `your-local-folder-path` 變更為您要從包含它們的 Amazon S3 儲存貯體同步應用程式檔案的目錄路徑。例如 `D:\PhotonUser\My Files\Home Folder\m2-new`。此同步目錄必須是主資料夾的子目錄，WorkSpaces 應用程式才能在工作階段開始和結束時正確備份和還原。 ``` :loop timeout /T 10 "C:\Program Files\rclone\rclone.exe" sync m2-s3:amzn-s3-demo-bucket/your-s3-folder-key "D:\PhotonUser\My Files\Home Folder\your-local-folder-path" --config "D:\PhotonUser\My Files\Home Folder\m2-rclone.conf" goto :loop ``` 1. `C:\Users\PhotonUser\My Files\Home Folder` 視需要開啟 Windows 命令提示字元，cd 至並執行 `m2-rclone.cmd`。此命令指令碼會執行連續迴圈，將您的 Amazon S3 儲存貯體和金鑰每 10 秒同步至本機資料夾。您可以視需要調整逾時。您應該會在 Windows File Explorer 的 Amazon S3 儲存貯體中看到應用程式的原始碼。若要將新檔案新增至您正在處理的集，或更新現有的檔案，請將檔案上傳至 Amazon S3 儲存貯體，並在中定義的下一個反覆運算時同步至您的目錄`m2-rclone.cmd`。同樣地，如果您要刪除一些檔案，請從 Amazon S3 儲存貯體中刪除它們。下一個同步操作會從本機目錄刪除它們。 ## 步驟 3：複製儲存庫 1. 導覽至瀏覽器視窗左上角的應用程式選擇器選單，然後選取企業開發人員。 1. 在主資料夾中選擇 `C:\Users\PhotonUser\My Files\Home Folder`（也稱為 `D: \PhotonUser\My Files\Home Folder`) 作為工作區的位置，以完成企業開發人員所需的工作區建立。 1. 在企業開發人員中，前往 Project Explorer 複製您的 CodeCommit 儲存庫，按一下滑鼠右鍵，然後選擇**匯入**、**匯入...**、**Git**、來自 **Git** **複製 URI** **的專案**。然後，輸入您的 CodeCommit 特定登入憑證，並完成 Eclipse 對話方塊以匯入程式碼。現在已在您的本機工作區複製中的 CodeCommit git 儲存庫。您的企業開發人員工作區現在已準備好在您的應用程式上開始維護工作。特別是，您可以使用與企業開發人員整合的 Enterprise Server (ES) 本機執行個體，以互動方式偵錯和執行您的應用程式，以在本機驗證您的變更。 **注意** 本機企業開發人員環境，包括本機企業伺服器執行個體，會在 Windows 下執行，而 AWS 大型主機現代化則在 Linux 下執行。建議您在將新應用程式遞交至 CodeCommit 後，以及在將新應用程式推展至生產環境之前，在 AWS Mainframe Modernization 提供的 Linux 環境中執行補充測試。 ## 後續工作階段當您選取 WorkSpaces 應用程式管理下的資料夾時，例如複製 CodeCommit 儲存庫的主資料夾，它將在工作階段之間透明地儲存和還原。下次您需要使用應用程式時，請完成下列步驟： 1. 根據歡迎電子郵件中收到的 URL，使用 WorkSpaces 應用程式啟動工作階段。 1. 使用您的電子郵件和永久密碼登入。 1. 選取企業開發人員堆疊。 1. 當此選項用於共用工作區檔案時，啟動 `Rclone` 以連線至（請參閱上述） Amazon S3 後端磁碟。 1. 啟動企業開發人員來執行您的工作。 ## 清除資源如果您不再需要為本教學課程建立的資源，請將其刪除，這樣就不會繼續收取這些資源的費用。請完成下列步驟： + 刪除您為此教學課程建立的 CodeCommit 儲存庫。如需詳細資訊，請參閱*AWS CodeCommit 《使用者指南*》中的[刪除 CodeCommit 儲存庫](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-delete-repository.html)。 + 刪除您為此教學課程建立的資料庫。如需詳細資訊，請參閱[刪除資料庫執行個體](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html#CHAP_GettingStarted.Deleting.PostgreSQL)。 # AWS Mainframe Modernization 中的可用批次公用程式大型主機應用程式通常會使用批次公用程式來執行特定功能，例如排序資料、使用 FTP 傳輸檔案、將資料載入資料庫，例如 DB2、從資料庫卸載資料等。當您將應用程式遷移至 AWS 大型主機現代化時，您需要功能上同等的替代公用程式，來執行與大型主機相同的任務。其中一些公用程式可能已作為 AWS Mainframe Modernization 執行期引擎的一部分提供，但我們提供下列替代公用程式： + M2SFTP - 使用 SFTP 通訊協定啟用安全的檔案傳輸。 + M2WAIT - 等待指定的時間量，然後繼續批次任務中的下一個步驟。 + TXT2PDF - 將文字檔案轉換為 PDF 格式。 + M2DFUTIL - 在與大型主機 ADRDSSU 公用程式提供的支援類似的資料集上提供備份、還原、刪除和複製函數。 + M2RUNCMD - 可讓您直接從 JCL 執行 Rocket Software （先前稱為 Micro Focus) 命令、指令碼和系統呼叫。我們根據客戶意見回饋開發這些批次公用程式，並設計它們以提供與大型主機公用程式相同的功能。目標是讓您盡可能順利地從大型主機轉換至 AWS 大型主機現代化。 **Topics** + [ ## 二進位位置 ](#location-utilities) + [ # M2SFTP 批次公用程式 ](m2sftp.md) + [ # M2WAIT 批次公用程式 ](m2wait.md) + [ # TXT2PDF 批次公用程式 ](txt2pdf.md) + [ # M2DFUTIL 批次公用程式 ](m2dfutil.md) + [ # M2RUNCMD 批次公用程式 ](m2runcmd.md) ## 二進位位置這些公用程式預先安裝在 Rocket Enterprise Developer (ED) 和 Rocket Software (ES) 產品上。您可以在下列位置找到 ED 和 ES 的所有變體： + Linux：`/opt/aws/m2/microfocus/utilities/64bit` + Windows (32 位元）： `C:\AWS\M2\MicroFocus\Utilities\32bit` + Windows (64 位元）： `C:\AWS\M2\MicroFocus\Utilities\64bit` # M2SFTP 批次公用程式 M2SFTP 是一種 JCL 公用程式程式，旨在使用安全檔案傳輸通訊協定 (SFTP) 在系統之間執行安全的檔案傳輸。此程式使用 Putty SFTP 用戶端 `psftp`來執行實際的檔案傳輸。此程式的運作方式類似於大型主機 FTP 公用程式，並使用使用者和密碼身分驗證。 **注意** 不支援公有金鑰身分驗證。若要將您的大型主機 FTP JCLs 轉換為使用 SFTP，請將 `PGM=FTP`變更為 `PGM=M2SFTP`。 **Topics** + [ ## 支援平台 ](#m2sftp-platforms) + [ ## 安裝相依項目 ](#m2sftp-dependencies) + [ ## 為 AWS 大型主機現代化受管設定 M2SFTP ](#m2sftp-configure-managed) + [ ## 在 Amazon EC22 上為大型主機現代化執行時間設定 M2SFTP （包括 WorkSpaces 應用程式） AWS ](#m2sftp-configure-customer-infra) + [ ## 範例 JCLs ](#m2sftp-jcl) + [ ## Putty SFTP (PSFTP) 用戶端命令參考 ](#m2sftp-cmd-ref) + [ ## 後續步驟 ](#m2sftp-next) ## 支援平台您可以在下列任何平台上使用 M2SFTP： + AWS Mainframe Modernization Rocket Software （先前稱為 Micro Focus) 受管 + Rocket 軟體執行期（在 Amazon EC2 上） + Rocket Software Enterprise Developer (ED) 和 Rocket Software Enterprise Server (ES) 產品的所有變體。 ## 安裝相依項目 **在 Windows 上安裝 Putty SFTP 用戶端** + 下載 [PuTTY SFTP](https://www.putty.org/) 用戶端並進行安裝。 **在 Linux 上安裝 Putty SFTP 用戶端：** + 執行下列命令來安裝 Putty SFTP 用戶端： ``` sudo yum -y install putty ``` ## 為 AWS 大型主機現代化受管設定 M2SFTP 如果您的遷移應用程式在 AWS Mainframe Modernization Managed 上執行，您將需要設定 M2SFTP，如下所示。 + 為 MFFTP 設定適當的 Rocket Enterprise Server 環境變數。以下是幾個範例： + `MFFTP_TEMP_DIR` + `MFFTP_SENDEOL` + `MFFTP_TIME` + `MFFTP_ABEND` 您可以設定任意數量或數量的這些變數。您可以使用 `ENVAR DD`陳述式在 JCL 中設定它們。如需這些變數的詳細資訊，請參閱 Micro Focus 文件中的 [MFFTP 控制變數](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-3F94BBC8-CB97-4642-A4A7-4235C0C079E2.html)。若要測試您的組態，請參閱 [範例 JCLs](#m2sftp-jcl)。 ## 在 Amazon EC22 上為大型主機現代化執行時間設定 M2SFTP （包括 WorkSpaces 應用程式） AWS 如果您遷移的應用程式在 Amazon EC2 上的 AWS Mainframe Modernization 執行時間上執行，請設定 M2SFTP，如下所示。 1. 變更 [Micro Focus JES 程式路徑](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-BC8A1796-9EDE-48EB-8363-31C9BDE7F96B.html)，以包含批次公用程式的二進位位置。如果您需要指定多個路徑，請使用冒號 (`:`) 來分隔 Linux 上的路徑和 Windows 上的分號 (`;`)。 + Linux：`/opt/aws/m2/microfocus/utilities/64bit` + Windows (32 位元）： `C:\AWS\M2\MicroFocus\Utilities\32bit` + Windows (64 位元）： `C:\AWS\M2\MicroFocus\Utilities\64bit` 1. 為 MFFTP 設定適當的 Rocket Enterprise Server 環境變數。以下是幾個範例： + `MFFTP_TEMP_DIR` + `MFFTP_SENDEOL` + `MFFTP_TIME` + ``MFFTP\$1ABEND 您可以設定任意數量或數量的這些變數。您可以使用 `ENVAR DD`陳述式在 JCL 中設定它們。如需這些變數的詳細資訊，請參閱 Micro Focus 文件中的 [MFFTP 控制變數](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-3F94BBC8-CB97-4642-A4A7-4235C0C079E2.html)。若要測試您的組態，請參閱 [範例 JCLs](#m2sftp-jcl)。 ## 範例 JCLs 若要測試安裝，您可以使用下列其中一個範例 JCL 檔案。 **M2SFTP1.jcl** 此 JCL 說明如何呼叫 M2SFTP 將檔案傳送至遠端 SFTP 伺服器。請注意 `ENVVAR DD`陳述式中設定的環境變數。 ``` //M2SFTP1 JOB 'M2SFTP1',CLASS=A,MSGCLASS=X,TIME=1440 //* //* Copyright Amazon.com, Inc. or its affiliates.* //* All Rights Reserved.* //* //*-------------------------------------------------------------------** //* Sample SFTP JCL step to send a file to SFTP server* //*-------------------------------------------------------------------** //* //STEP01 EXEC PGM=M2SFTP, // PARM='127.0.0.1 (EXIT=99 TIMEOUT 300' //* //SYSFTPD DD * RECFM FB LRECL 80 SBSENDEOL CRLF MBSENDEOL CRLF TRAILINGBLANKS FALSE /* //NETRC DD * machine 127.0.0.1 login sftpuser password sftppass /* //SYSPRINT DD SYSOUT=* //OUTPUT DD SYSOUT=* //STDOUT DD SYSOUT=* //INPUT DD * type a locsite notrailingblanks cd files put 'AWS.M2.TXT2PDF1.PDF' AWS.M2.TXT2PDF1.pdf put 'AWS.M2.CARDDEMO.CARDDATA.PS' AWS.M2.CARDDEMO.CARDDATA.PS1.txt quit /* //ENVVAR DD * MFFTP_VERBOSE_OUTPUT=ON MFFTP_KEEP=N /* //* // ``` **M2SFTP2.jcl** 此 JCL 說明如何呼叫 M2SFTP 從遠端 SFTP 伺服器接收檔案。請注意 `ENVVAR DD`陳述式中設定的環境變數。 ``` //M2SFTP2 JOB 'M2SFTP2',CLASS=A,MSGCLASS=X,TIME=1440 //* //* Copyright Amazon.com, Inc. or its affiliates.* //* All Rights Reserved.* //* //*-------------------------------------------------------------------** //* Sample SFTP JCL step to receive a file from SFTP server* //*-------------------------------------------------------------------** //* //STEP01 EXEC PGM=M2SFTP //* //SYSPRINT DD SYSOUT=* //OUTPUT DD SYSOUT=* //STDOUT DD SYSOUT=* //INPUT DD * open 127.0.0.1 sftpuser sftppass cd files locsite recfm=fb lrecl=150 get AWS.M2.CARDDEMO.CARDDATA.PS.txt + 'AWS.M2.CARDDEMO.CARDDATA.PS2' (replace quit /* //ENVVAR DD * MFFTP_VERBOSE_OUTPUT=ON MFFTP_KEEP=N /* //* // ``` **注意** 我們強烈建議將 FTP 登入資料儲存在 NETRC 檔案中，並限制只有授權使用者才能存取。 ## Putty SFTP (PSFTP) 用戶端命令參考 PSFTP 用戶端不支援所有 FTP 命令。下列清單顯示 PSFTP 支援的所有命令。 | 命令 | Description | | --- | --- | | \$1 | 執行本機命令 | | 再見 | 完成您的 SFTP 工作階段 | | cd | 變更您的遠端工作目錄 | | chmod | 變更檔案許可和模式 | | 關閉 | 完成您的 SFTP 工作階段，但不退出 PSFTP | | 德爾 | 刪除遠端伺服器上的檔案 | | dir | 列出遠端檔案 | | exit | 完成您的 SFTP 工作階段 | | get | 將檔案從伺服器下載到您的本機電腦 | | 說明 | 提供說明 | | lcd | 變更本機工作目錄 | | lpwd | 列印本機工作目錄 | | ls | 列出遠端檔案 | | mget | 一次下載多個檔案 | | mkdir | 在遠端伺服器上建立目錄 | | mput | 一次上傳多個檔案 | | mv | 移動或重新命名遠端伺服器上的檔案 (s) | | 開啟 | 連線至主機 | | put | 將檔案從本機電腦上傳至伺服器 | | pwd | 列印您的遠端工作目錄 | | 結束 | 完成您的 SFTP 工作階段 | | 重新取得 | 繼續下載檔案 | | ren | 移動或重新命名遠端伺服器上的檔案 (s) | | 評價 | 繼續上傳檔案 | | rm | 刪除遠端伺服器上的檔案 | | rmdir | 移除遠端伺服器上的目錄 | ## 後續步驟若要使用 SFTP 將檔案上傳和下載到 Amazon Simple Storage Service，您可以搭配使用 M2SFTP AWS Transfer Family，如下列部落格文章所述。 + [使用 AWS SFTP 邏輯目錄建置簡單的資料分佈服務](https://aws.amazon.com/blogs/storage/using-aws-sftp-logical-directories-to-build-a-simple-data-distribution-service/) + [AWS Transfer for SFTP 使用啟用密碼身分驗證 AWS Secrets Manager](https://aws.amazon.com/blogs/storage/enable-password-authentication-for-aws-transfer-for-sftp-using-aws-secrets-manager/) # M2WAIT 批次公用程式 M2WAIT 是一種大型主機公用程式程式，可讓您指定以秒、分鐘或小時為單位的持續時間，在 JCL 指令碼中引入等待期間。您可以傳遞您想要等待的時間做為輸入參數，直接從 JCL 呼叫 M2WAIT。在內部，M2WAIT 程式會呼叫 Rocket Software （先前為 Micro Focus) 提供的模組`C$SLEEP`，以等待指定的時間。 **注意** 您可以使用 Micro Focus 別名來取代您在 JCL 指令碼中擁有的內容。如需詳細資訊，請參閱 Micro Focus 文件中的 [JES 別名](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-D4206FF9-32C4-43E7-9413-5E7E96AA8092.html)。 **Topics** + [ ## 支援平台 ](#m2wait-platforms) + [ ## 為 AWS 大型主機現代化受管設定 M2WAIT ](#m2wait-configure-managed) + [ ## 在 Amazon EC22 上為大型主機現代化執行時間設定 M2WAIT （包括 WorkSpaces 應用程式） AWS ](#m2wait-configure-customer-infra) + [ ## 範例 JCL ](#m2wait-jcl) ## 支援平台您可以在下列任何平台上使用 M2WAIT： + AWS Mainframe Modernization Rocket Software （先前稱為 Micro Focus) 受管 + Rocket 軟體執行期（在 Amazon EC2 上） + Rocket Software Enterprise Developer (ED) 和 Rocket Software Enterprise Server (ES) 產品的所有變體。 ## 為 AWS 大型主機現代化受管設定 M2WAIT 如果您的遷移應用程式在 AWS Mainframe Modernization Managed 上執行，您將需要設定 M2WAIT，如下所示。 + 透過傳遞輸入參數，在您的 JCL 中使用程式 M2WAIT，如所示[範例 JCL](#m2wait-jcl)。 ## 在 Amazon EC22 上為大型主機現代化執行時間設定 M2WAIT （包括 WorkSpaces 應用程式） AWS 如果您遷移的應用程式在 Amazon EC2 上的 AWS Mainframe Modernization 執行時間上執行，請設定 M2WAIT，如下所示。 1. 變更 [Micro Focus JES 程式路徑](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-BC8A1796-9EDE-48EB-8363-31C9BDE7F96B.html)，以包含批次公用程式的二進位位置。如果您需要指定多個路徑，請使用冒號 (`:`) 來分隔 Linux 上的路徑和 Windows 上的分號 (`;`)。 + Linux：`/opt/aws/m2/microfocus/utilities/64bit` + Windows (32 位元）： `C:\AWS\M2\MicroFocus\Utilities\32bit` + Windows (64 位元）： `C:\AWS\M2\MicroFocus\Utilities\64bit` 1. 透過傳遞輸入參數，在您的 JCL 中使用程式 M2WAIT，如所示[範例 JCL](#m2wait-jcl)。 ## 範例 JCL 若要測試安裝，您可以使用 `M2WAIT1.jcl`程式。此範例 JCL 示範如何呼叫 M2WAIT 並傳遞數個不同的持續時間。 ``` //M2WAIT1 JOB 'M2WAIT',CLASS=A,MSGCLASS=X,TIME=1440 //* //* Copyright Amazon.com, Inc. or its affiliates.* //* All Rights Reserved.* //* //*-------------------------------------------------------------------** //* Wait for 12 Seconds* //*-------------------------------------------------------------------** //* //STEP01 EXEC PGM=M2WAIT,PARM='S012' //SYSOUT DD SYSOUT=* //* //*-------------------------------------------------------------------** //* Wait for 0 Seconds (defaulted to 10 Seconds)* //*-------------------------------------------------------------------** //* //STEP02 EXEC PGM=M2WAIT,PARM='S000' //SYSOUT DD SYSOUT=* //* //*-------------------------------------------------------------------** //* Wait for 1 Minute* //*-------------------------------------------------------------------** //* //STEP03 EXEC PGM=M2WAIT,PARM='M001' //SYSOUT DD SYSOUT=* //* // ``` # TXT2PDF 批次公用程式 TXT2PDF 是一種大型主機公用程式程式，通常用於將文字檔案轉換為 PDF 檔案。此公用程式針對 TXT2PDF (z/OS 免費軟體）使用相同的原始程式碼。我們已將其修改為在 AWS Mainframe Modernization Rocket Software （先前稱為 Micro Focus) 執行時間環境中執行。 **Topics** + [ ## 支援平台 ](#txt2pdf-platforms) + [ ## 為 AWS 大型主機現代化受管設定 TXT2PDF ](#txt2pdf-configure-managed) + [ ## 在 Amazon EC22 上為大型主機現代化執行時間設定 TXT2PDF （包括 WorkSpaces 應用程式） AWS ](#txt2pdf-configure-customer-infra) + [ ## 範例 JCL ](#txt2pdf-jcl) + [ ## 修改 ](#txt2pdf-mods) + [ ## 參考 ](#txt2pdf-ref) ## 支援平台您可以在下列任何平台上使用 TXT2PDF： + AWS Mainframe Modernization Rocket 軟體受管 + Rocket 軟體執行期（在 Amazon EC2 上） + Rocket Enterprise Developer (ED) 和 Rocket Enterprise Server (ES) 產品的所有變體。 ## 為 AWS 大型主機現代化受管設定 TXT2PDF 如果您遷移的應用程式在 AWS Mainframe Modernization Managed 上執行，請設定 TXT2PDF，如下所示。 + 建立名為的 REXX EXEC 程式庫`AWS.M2.REXX.EXEC`。下載這些 [REXX 模組](https://drm0z31ua8gi7.cloudfront.net/utilities/mf/TXT2PDF/rexx/TXT2PDF_rexx.zip)並將其複製到程式庫。 + `TXT2PDF.rex` - TXT2PDF z/OS 免費軟體（已修改） + `TXT2PDFD.rex` - TXT2PDF z/OS 免費軟體（未修改） + `TXT2PDFX.rex` - TXT2PDF z/OS 免費軟體（已修改） + `M2GETOS.rex` - 檢查作業系統類型 (Windows 或 Linux) 若要測試您的組態，請參閱 [範例 JCL](#txt2pdf-jcl)。 ## 在 Amazon EC22 上為大型主機現代化執行時間設定 TXT2PDF （包括 WorkSpaces 應用程式） AWS 如果您遷移的應用程式在 Amazon EC2 上的 AWS Mainframe Modernization 執行時間上執行，請設定 TXT2PDF，如下所示。 1. 將 Rocket Software 環境變數`MFREXX_CHARSET`設定為適當的值，例如 ASCII 資料的「`A`」。 **重要** 輸入錯誤的值可能會導致資料轉換問題（從 EBCDIC 到 ASCII)，導致產生的 PDF 無法讀取或無法操作。我們建議設定 `MFREXX_CHARSET`以符合 `MF_CHARSET`。 1. 變更 [Micro Focus JES 程式路徑](https://www.microfocus.com/documentation/enterprise-developer/ed80/ED-Eclipse/GUID-BC8A1796-9EDE-48EB-8363-31C9BDE7F96B.html)，以包含批次公用程式的二進位位置。如果您需要指定多個路徑，請使用冒號 (`:`) 來分隔 Linux 上的路徑和 Windows 上的分號 (`;`)。 + Linux：`/opt/aws/m2/microfocus/utilities/64bit` + Windows (32 位元）： `C:\AWS\M2\MicroFocus\Utilities\32bit` + Windows (64 位元）： `C:\AWS\M2\MicroFocus\Utilities\64bit` 1. 建立名為的 REXX EXEC 程式庫`AWS.M2.REXX.EXEC``。下載這些 [REXX 模組](https://drm0z31ua8gi7.cloudfront.net/utilities/mf/TXT2PDF/rexx/TXT2PDF_rexx.zip)並將其複製到程式庫。 + `TXT2PDF.rex` - TXT2PDF z/OS 免費軟體（已修改） + `TXT2PDFD.rex` - TXT2PDF z/OS 免費軟體（未修改） + `TXT2PDFX.rex` - TXT2PDF z/OS 免費軟體（已修改） + `M2GETOS.rex` - 檢查作業系統類型 (Windows 或 Linux) 若要測試您的組態，請參閱 [範例 JCL](#txt2pdf-jcl)。 ## 範例 JCL 若要測試安裝，您可以使用下列其中一個範例 JCL 檔案。 **TXT2PDF1.jcl** 此範例 JCL 檔案使用 DD 名稱進行 TXT2PDF 轉換。 ``` //TXT2PDF1 JOB 'TXT2PDF1',CLASS=A,MSGCLASS=X,TIME=1440 //* //* Copyright Amazon.com, Inc. or its affiliates.* //* All Rights Reserved.* //* //*-------------------------------------------------------------------** //* PRE DELETE* //*-------------------------------------------------------------------** //* //PREDEL EXEC PGM=IEFBR14 //* //DD01 DD DSN=AWS.M2.TXT2PDF1.PDF.VB, // DISP=(MOD,DELETE,DELETE) //* //DD02 DD DSN=AWS.M2.TXT2PDF1.PDF, // DISP=(MOD,DELETE,DELETE) //* //*-------------------------------------------------------------------** //* CALL TXT2PDF TO CONVERT FROM TEXT TO PDF (VB)* //*-------------------------------------------------------------------** //* //STEP01 EXEC PGM=IKJEFT1B //* //SYSEXEC DD DISP=SHR,DSN=AWS.M2.REXX.EXEC //* //INDD DD * 1THIS IS THE FIRST LINE ON THE PAGE 1 0THIS IS THE THIRD LINE ON THE PAGE 1 -THIS IS THE 6TH LINE ON THE PAGE 1 THIS IS THE 7TH LINE ON THE PAGE 1 +____________________________________ - OVERSTRIKE 7TH LINE 1THIS IS THE FIRST LINE ON THE PAGE 2 0THIS IS THE THIRD LINE ON THE PAGE 2 -THIS IS THE 6TH LINE ON THE PAGE 2 THIS IS THE 7TH LINE ON THE PAGE 2 +____________________________________ - OVERSTRIKE 7TH LINE /* //* //OUTDD DD DSN=AWS.M2.TXT2PDF1.PDF.VB, // DISP=(NEW,CATLG,DELETE), // DCB=(LRECL=256,DSORG=PS,RECFM=VB,BLKSIZE=0) //* //SYSTSPRT DD SYSOUT=* //SYSTSIN DD DDNAME=SYSIN //* //SYSIN DD * %TXT2PDF BROWSE Y IN DD:INDD + OUT DD:OUTDD + CC YES /* //* //*-------------------------------------------------------------------** //* CONVERT PDF (VB) TO PDF (LSEQ - BYTE STREAM)* //*-------------------------------------------------------------------** //* //STEP02 EXEC PGM=VB2LSEQ //* //INFILE DD DSN=AWS.M2.TXT2PDF1.PDF.VB,DISP=SHR //* //OUTFILE DD DSN=AWS.M2.TXT2PDF1.PDF, // DISP=(NEW,CATLG,DELETE), // DCB=(LRECL=256,DSORG=PS,RECFM=LSEQ,BLKSIZE=0) //* //SYSOUT DD SYSOUT=* //* // ``` **TXT2PDF2.jcl** 此範例 JCL 使用 DSN 名稱進行 TXT2PDF 轉換。 ``` //TXT2PDF2 JOB 'TXT2PDF2',CLASS=A,MSGCLASS=X,TIME=1440 //* //* Copyright Amazon.com, Inc. or its affiliates.* //* All Rights Reserved.* //* //*-------------------------------------------------------------------** //* PRE DELETE* //*-------------------------------------------------------------------** //* //PREDEL EXEC PGM=IEFBR14 //* //DD01 DD DSN=AWS.M2.TXT2PDF2.PDF.VB, // DISP=(MOD,DELETE,DELETE) //* //DD02 DD DSN=AWS.M2.TXT2PDF2.PDF, // DISP=(MOD,DELETE,DELETE) //* //*-------------------------------------------------------------------** //* CALL TXT2PDF TO CONVERT FROM TEXT TO PDF (VB)* //*-------------------------------------------------------------------** //* //STEP01 EXEC PGM=IKJEFT1B //* //SYSEXEC DD DISP=SHR,DSN=AWS.M2.REXX.EXEC //* //INDD DD * 1THIS IS THE FIRST LINE ON THE PAGE 1 0THIS IS THE THIRD LINE ON THE PAGE 1 -THIS IS THE 6TH LINE ON THE PAGE 1 THIS IS THE 7TH LINE ON THE PAGE 1 +____________________________________ - OVERSTRIKE 7TH LINE 1THIS IS THE FIRST LINE ON THE PAGE 2 0THIS IS THE THIRD LINE ON THE PAGE 2 -THIS IS THE 6TH LINE ON THE PAGE 2 THIS IS THE 7TH LINE ON THE PAGE 2 +____________________________________ - OVERSTRIKE 7TH LINE /* //* //SYSTSPRT DD SYSOUT=* //SYSTSIN DD DDNAME=SYSIN //* //SYSIN DD * %TXT2PDF BROWSE Y IN DD:INDD + OUT 'AWS.M2.TXT2PDF2.PDF.VB' + CC YES /* //* //*-------------------------------------------------------------------** //* CONVERT PDF (VB) TO PDF (LSEQ - BYTE STREAM)* //*-------------------------------------------------------------------** //* //STEP02 EXEC PGM=VB2LSEQ //* //INFILE DD DSN=AWS.M2.TXT2PDF2.PDF.VB,DISP=SHR //* //OUTFILE DD DSN=AWS.M2.TXT2PDF2.PDF, // DISP=(NEW,CATLG,DELETE), // DCB=(LRECL=256,DSORG=PS,RECFM=LSEQ,BLKSIZE=0) //* //SYSOUT DD SYSOUT=* //* // ``` ## 修改為了讓 TXT2PDF 程式在 AWS Mainframe Modernization Rocket Software 執行期環境上執行，我們進行了下列變更： + 變更原始程式碼，以確保與 Rocket Software REXX 執行時間相容 + 變更以確保程式可以在 Windows 和 Linux 作業系統上執行 + 修改以支援 EBCDIC 和 ASCII 執行時間 ## 參考 TXT2PDF 參考和原始程式碼： + [文字轉 PDF 轉換器](https://homerow.net/rexx/txt2pdf/) + [z/OS Freeware TCP/IP 和郵件工具](http://www.lbdsoftware.com/tcpip.html) + [TXT2PDF 使用者指南](http://www.lbdsoftware.com/TXT2PDF-User-Guide.pdf) # M2DFUTIL 批次公用程式 M2DFUTIL 是一種 JCL 公用程式，可在資料集上提供備份、還原、刪除和複製函數，類似於大型主機 ADRDSSU 公用程式提供的支援。此程式會從 ADRDSSU 保留許多 SYSIN 參數，可簡化遷移至此新公用程式的程序。 **Topics** + [ ## 支援平台 ](#m2dfutil-platforms) + [ ## 平台需求 ](#m2dfutil-platform) + [ ## 計劃的未來支援 ](#m2udfutil-future-support) + [ ## 資產位置 ](#mdfutil-assets) + [ ## 在 Amazon EC22 上設定 M2DFUTIL 或 AWS 大型主機現代化執行時間（包括 AppStream 2.0) ](#mdfutil-dependencies) + [ ## 一般語法 ](#mdfutil-syntax) + [ ## 範例 JCLs ](#mdfutil-sample-jcls) ## 支援平台您可以在下列任何平台上使用 M2DFUTIL： + Windows 上的 Rocket Software （先前稱為 Micro Focus) ES (64 位元和 32 位元） + Linux 上的 Rocket Software ES (64 位元） ## 平台需求 M2DFUTIL 取決於呼叫指令碼來執行規則表達式測試。在 Windows 上，您必須安裝 Windows Services for Linux (WSL)，此指令碼才能執行。 ## 計劃的未來支援目前無法從大型主機 ADRDSSU 公用程式取得，但在未來範圍內的功能包括： + M2 受管 + VSAM + 檔案名稱重新命名的 COPY 支援 + RESTORE 的重新命名支援 + 多個 INCLUDE 和 EXCLUDE + 用於由 DSORG、CREDT、EXPDT 子選取的 BY 子句 + 重試佇列失敗的 MWAIT 子句 + DUMP/RESTORE 的 S3 儲存支援 ## 資產位置此公用程式的載入模組會在 `M2DFUTIL.so` Linux 和 Windows `M2DFUTIL.dll` 上呼叫。您可以在下列位置找到此載入模組： + Linux：`/opt/aws/m2/microfocus/utilities/64bit` + Windows (32 位元）： `C:\AWS\M2\MicroFocus\Utilities\32bit` + Windows (64 位元）： `C:\AWS\M2\MicroFocus\Utilities\64bit` 用於規則表達式測試的指令碼稱為 `compare.sh`。您可以在下列位置找到此指令碼： + Linux：`/opt/aws/m2/microfocus/utilities/scripts` + Windows (32 位元）： `C:\AWS\M2\MicroFocus\Utilities\scripts` ## 在 Amazon EC22 上設定 M2DFUTIL 或 AWS 大型主機現代化執行時間（包括 AppStream 2.0) 使用下列項目設定您的 Enterprise Server 區域： + 在 **【ES-Environment】** 中新增下列變數 + `M2DFUTILS_BASE_LOC` - DUMP 輸出的預設位置 + `M2DFUTILS_SCRIPTPATH` - 記錄在資產位置中的`compare.sh`指令碼位置 **** + `M2DFUTILS_VERBOSE` - 【VERBOSE 或 NORMAL】。這會控制`SYSPRINT `輸出中的詳細資訊層級 + 確認載入模組路徑已新增至`JES\Configuration\JES Program Path`設定 + 確認公用程式目錄中的指令碼具有執行許可。您可以在 Linux 環境中使用 `chmod + x