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)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 Amazon EC2 上設定大型主機執行期的 AWS 轉換
<a name="ba-runtime-deploy-ec2"></a>

本主題說明如何在 Amazon EC2 上使用適用於大型主機執行期的 AWS Transform 來設定和部署 PlanetsDemo 範例應用程式。

**Topics**
+ [先決條件](#ba-runtime-deploy-prereq)
+ [設定](#ba-runtime-deploy-setup)
+ [測試部署的應用程式](#ba-runtime-deploy-test)

## 先決條件
<a name="ba-runtime-deploy-prereq"></a>

開始之前，請務必完成下列先決條件。
+  AWS CLI 請依照設定 [AWS CLI 中的步驟來設定 ](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html)。
+ 完成 [AWS 大型主機執行期先決條件的轉換](ba-runtime-setup-prereq.md)和 [大型主機執行期的加入 AWS 轉換](ba-runtime-setup-onboard.md)。
+ 使用其中一個支援的執行個體類型建立 Amazon EC2 執行個體。如需詳細資訊，請參閱 [Amazon EC2 Linux 執行個體入門](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EC2_GetStarted.html)。
+ 請確定您可以成功連線至 Amazon EC2 執行個體，例如使用 SSM。
**注意**  
在本指南中，Tomcat 安裝路徑假設為 `/m2-anywhere/tomcat-gapwalk/velocity`。遵循下列指示時，請務必使用此路徑，或將下列指示調整為您選擇的路徑。
+ 將大型主機執行期 （在 Amazon EC2 上） 的 AWS 轉換直接下載並解壓縮至速度目錄 `/m2-anywhere/tomcat-gapwalk/velocity`(Tomcat 安裝資料夾）。如需如何擷取大型主機執行期成品 AWS 轉換的指示，包括儲存、存取和內容的相關資訊，請參閱 [AWS 大型主機執行期成品的轉換](ba-runtime-artifacts.md)。
+ 下載 [PlanetsDemo 應用程式封存](https://d3lkpej5ajcpac.cloudfront.net/demo/bluage/PlanetsDemo-v1.zip)。
+ 解壓縮封存檔，並將應用程式上傳到您選擇的 Amazon S3 儲存貯體。
+ 為 JICS 建立 Amazon Aurora PostgreSQL 資料庫。大型主機執行期的 AWS 轉換會在第一次啟動期間自動執行`PlanetsDemo-v1/jics/sql/initJics.sql`指令碼。如需有關如何建立 Amazon Aurora PostgreSQL 資料庫的資訊，請參閱[建立並連線至 Aurora PostgreSQL 資料庫叢集](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_GettingStartedAurora.CreatingConnecting.AuroraPostgreSQL.html#CHAP_GettingStarted.AuroraPostgreSQL.CreateDBCluster)。

## 設定
<a name="ba-runtime-deploy-setup"></a>

若要設定 PlanetsDemo 範例應用程式，請完成下列步驟。

1. 連線至 Amazon EC2 執行個體，並前往 Apache Tomcat 安裝`conf`資料夾下的 資料夾。開啟 `catalina.properties` 檔案進行編輯，並以下列行取代開頭`common.loader`為 的行。

   ```
   common.loader="${catalina.base}/lib","${catalina.base}/lib/*.jar","${catalina.home}/lib","${catalina.home}/lib/*.jar","${catalina.home}/shared","${catalina.home}/shared/*.jar","${catalina.home}/extra","${catalina.home}/extra/*.jar"
   ```

1. 導覽至 `/m2-anywhere/tomcat-gapwalk/velocity/webapps` 資料夾。

1. 使用下列命令，從 Amazon S3 儲存貯體複製`PlanetsDemo-v1/webapps/`資料夾提供的 PlanetsDemo 二進位檔。

   ```
   aws s3 cp s3://path-to-demo-app-webapps/ . --recursive
   ```
**注意**  
針對您先前解壓縮 PlanetsDemo 封存的儲存貯體，`path-to-demo-app-webapps`以正確的 Amazon S3 URI 取代 。

1. 將`PlanetsDemo-v1/config/`資料夾的內容複製到 `/m2-anywhere/tomcat-gapwalk/velocity/config/`。

1. 在 `/m2-anywhere/tomcat-gapwalk/velocity/config/application-main.yml` 檔案的下列程式碼片段中提供您在先決條件中建立之資料庫的連線資訊。如需詳細資訊，請參閱[建立並連線至 Aurora PostgreSQL 資料庫叢集](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_GettingStartedAurora.CreatingConnecting.AuroraPostgreSQL.html#CHAP_GettingStarted.AuroraPostgreSQL.CreateDBCluster)。

   ```
   datasource:
      jicsDs:
        driver-class-name :  
        url: 
        username: 
        password: 
        type :
   ```

1. 啟動 Apache Tomcat 伺服器並驗證日誌。

   ```
   /m2-anywhere/tomcat-gapwalk/velocity/startup.sh
   
   tail -f /m2-anywhere/tomcat-gapwalk/velocity/logs/catalina.log
   ```

   如果您找到以 C 開頭的錯誤代碼，後面接著 CXXXX 等數字，請注意錯誤訊息。例如，錯誤碼 C5102 是表示基礎設施組態不正確的常見錯誤。

## 測試部署的應用程式
<a name="ba-runtime-deploy-test"></a>

如需如何測試 PlanetsDemo 應用程式的範例，請參閱 [測試 PlanetsDemo 應用程式](ba-runtime-test-planetsdemo.md)。