AWS Mainframe Modernization Service (マネージドランタイム環境エクスペリエンス) は、新規のお客様に公開されなくなりました。 AWS Mainframe Modernization Service (マネージドランタイム環境エクスペリエンス) と同様の機能については、 AWS Mainframe Modernization Service (セルフマネージドエクスペリエンス) をご覧ください。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、[AWS 「 Mainframe Modernization の可用性の変更](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)」を参照してください。 翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # チュートリアル: WorkSpaces アプリケーションで Enterprise Analyzer をセットアップする このチュートリアルでは、1 つ以上のメインフレームアプリケーションを分析するために 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 Mainframe Modernization が顧客 と共有している WorkSpaces Applications Windows イメージに基づいています。セットアップは、「」で説明されているように、WorkSpaces アプリケーションフリートとスタックの作成にも基づいています[チュートリアル: Rocket Enterprise Analyzer と Rocket Enterprise Developer で使用する WorkSpaces アプリケーションをセットアップする](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 アプリケーションを設定することを前提としています。詳細については、「[チュートリアル: Rocket Enterprise Analyzer と Rocket Enterprise Developer で使用する WorkSpaces アプリケーションをセットアップする](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` 内のライブラリ + Enterprise Developer 向けの BankDemo ソースコードとプロジェクト定義: `m2-bankdemo-template.zip`。 + メインフレーム用の MFA インストールパッケージ: `mfa.zip`。詳細については、「*Micro Focus Enterprise Developer* ドキュメント」の「[Mainframe Access Overview](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` (またはその他の適切な名前) という名前の空のスキーマをデータベースに作成します。権限のあるユーザーがこのスキーマの項目を作成、挿入、更新、削除できるようにする認証情報を定義します。データベース名、サーバーエンドポイント URL、TCP ポートは Amazon RDS コンソールまたはアカウント管理者から取得できます。 + へのプログラムによるアクセスが設定されていることを確認します AWS アカウント。詳細については、「*Amazon Web Services 全般のリファレンス*」の「[プログラム的なアクセス](https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys)」を参照してください。 ## ステップ 1: セットアップ 1. WorkSpaces アプリケーションからのウェルカム E メールメッセージで受信した URL を使用して WorkSpaces アプリケーションとのセッションを開始します。 1. E メールをユーザー ID として使用し、永久パスワードを定義します。 1. Enterprise Analyzer スタックを選択します。 1. WorkSpaces アプリケーションメニューページで、**デスクトップ**を選択して、フリートがストリーミングしている Windows デスクトップにアクセスします。 ## ステップ 2: Windows 用の Amazon S3 ベースの仮想フォルダを作成する **注記** AWS Mainframe Modernization プレビュー中に Rclone を既に使用している場合は、 にある新しいバージョン`m2-rclone.cmd`に更新する必要があります`C:\Users\Public`。 1. `C:\Users\Public` で提供されている `m2-rclone.conf` ファイルと `m2-rclone.cmd` ファイルを、ファイルエクスプローラーを使用してホームフォルダ `C:\Users\PhotonUser\My Files\Home Folder` にコピーします。 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. Windows コマンドプロンプトを開き、必要に応じて cd コマンドで `C:\Users\PhotonUser\My Files\Home Folder` に変更し、`m2-rclone.cmd` を実行します。このコマンドスクリプトは連続ループを実行し、Amazon S3 バケットとキーを 10 秒ごとにローカルフォルダに同期します。タイムアウトは、必要に応じて調整できます。Windows ファイルエクスプローラーの Amazon S3 バケットにあるアプリケーションのソースコードが表示されます。 作業中のセットに新しいファイルを追加したり、既存のファイルを更新したりするには、ファイルを Amazon S3 バケットにアップロードします。そうすれば、`m2-rclone.cmd` で定義した次のイテレーションでディレクトリに同期されます。同様に、ファイルを削除する場合は Amazon S3 バケットから削除します。次の同期オペレーションでは、ローカルディレクトリから削除されます。 ## ステップ 3: Amazon RDS インスタンス用の ODBC ソースを作成する 1. EA\_Admin ツールを開始するには、ブラウザウィンドウの左上隅にあるアプリケーションセレクタメニューに移動し、**[MF EA\_Admin]** を選択します。 1. **[管理]** メニューから、**[ODBC データソース]** を選択し、**[ユーザー DSN]** タブから **[追加]** を選択します。 1. [新しいデータソースを作成] ダイアログボックスで、**[PostgreSQL Unicode]** ドライバーを選択し、**[終了]** を選択します。 1. **[PostgreSQL Unicode ODBC ドライバー (psqlODBC) のセットアップ]** ダイアログボックスで、目的のデータソース名を定義し、書き留めておきます。以前に作成した RDS インスタンスの値を使用して、次のパラメータを入力します。 **説明** このデータベース接続をすばやく識別するのに役立つ説明 (オプション)。 **データベース** 以前に作成した Amazon RDS データベース。 **サーバー** Amazon RDS エンドポイント。 **ポート** Amazon RDS ポート。 **ユーザー名** Amazon RDS インスタンスで定義されているとおり。 **[パスワード]** Amazon RDS インスタンスで定義されているとおり。 1. **[テスト]** を選択して Amazon RDS への接続が成功したことを確認し、**[保存]** を選択して新しいユーザー DSN を保存します。 1. 適切なワークスペースが作成されたことを確認するメッセージが表示されるまで待ってから、**[OK]** を選択して ODBC データソースを終了し、EA\_Admin ツールを閉じます。 1. アプリケーションセレクタメニューに再度移動し、[Enterprise Analyzer] を選択してツールを開始します。**[新規作成]** を選択します。 1. ワークスペース設定ウィンドウで、ワークスペース名を入力し、その場所を定義します。ワークスペースは、この設定で作業する場合は Amazon S3 ベースのディスクにすることも、必要に応じてホームフォルダにすることもできます。 1. **[他のデータベースを選択]** を選択して、Amazon RDS インスタンスに接続します。 1. オプションから **[Postgre]** アイコンを選択し、**[OK]** を選択します。 1. Windows 設定の **[オプション - 接続パラメータの定義]** に、作成したデータソースの名前を入力します。データベース名、スキーマ名、ユーザー名、パスワードも入力します。[**OK**] を選択してください。 1. Enterprise Analyzer が結果を保存するために必要なテーブル、インデックスなどをすべて作成するまでお待ちください。このステップには数分かかる場合があります。Enterprise Analyzer は、データベースとワークスペースが使用できる状態になったことを確認します。 1. アプリケーションセレクタメニューに再度移動し、[Enterprise Analyzer] を選択してツールを開始します。 1. Enterprise Analyzer のスタートアップウィンドウが、新しく選択したワークスペースの場所に表示されます。[**OK**] を選択してください。 1. 左ペインのリポジトリに移動し、リポジトリ名を選択し、**[ファイル/フォルダをワークスペースに追加]** を選択します。アプリケーションコードが保存されているフォルダを選択して、ワークスペースに追加します。必要であれば、以前の BankDemo サンプルコードを使用できます。Enterprise Analyzer からこれらのファイルの検証を求めるメッセージが表示されたら、**[検証]** を選択して最初の Enterprise Analyzer 検証レポートを開始します。アプリケーションのサイズによっては、完了するまで数分かかる場合があります。 1. ワークスペースを展開すると、ワークスペースに追加したファイルとフォルダが表示されます。オブジェクトタイプと循環的複雑度レポートは、**[チャートビューアー]** ペインの上部にも表示されます。 これで、必要なすべてのタスクに Enterprise Analyzer を使用できるようになりました。 ## 以降のセッション 1. WorkSpaces アプリケーションからのウェルカム E メールメッセージで受信した URL を使用して WorkSpaces アプリケーションとのセッションを開始します。 1. E メールと永久パスワードを使用してログインします。 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? ``` この問題を解決するには、**[OK]** を選択してメッセージをクリアし、次の手順を実行します。 1. WorkSpaces Applications で、ツールバーの**アプリケーション起動**アイコンを選択し、**EA\_Admin** を選択して Enterprise Analyzer 管理ツールを起動します。 ![Rocket Enterprise Developer 管理ツールが選択された WorkSpaces アプリケーション起動セレクタメニュー。](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/aas-launch-selector.png) 1. **[管理]** メニューから **[ワークスペースパスを更新...]** を選択します。 ![更新 Workspace パスを選択して、Rocket Enterprise Analyzer 管理ツールのメニューを管理します。](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ea_admin-administer-refresh.png) 1. **[ワークスペースを選択]** で、目的のワークスペースを選択し、**[OK]** を選択します。 ![プロジェクトを選択した Rocket Enterprise Analyzer 管理ツールのワークスペースの選択ダイアログボックス。](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ea_admin-select-workspace.png) 1. **[OK]** を選択してエラーメッセージを確認します。 ![Enterprise Analyzer エラーメッセージ。[OK] が選択されているワークスペースディレクトリにはアクセスできません。](http://docs.aws.amazon.com/ja_jp/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/ja_jp/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/ja_jp/m2/latest/userguide/images/ea_admin-close.png) 1. WorkSpaces Applications で、ツールバーの**アプリケーション起動**アイコンを選択し、**EA** を選択して Micro Focus Enterprise Analyzer を起動します。 ![WorkSpaces アプリケーションは、EA が選択された状態でアプリケーションを起動します。](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/aas-launch-ea.png) 1. ステップ 3～5 を繰り返します。 これで、Micro Focus Enterprise Analyzer が既存のワークスペースで開かれるはずです。 ## リソースをクリーンアップする このチュートリアル用に作成したリソースが不要になった場合は、追加料金の発生を避けるため、それらを削除してください。以下のステップを実行します。 + **[EA\_Admin]** ツールを使用してワークスペースを削除します。 + このチュートリアル用に作成した S3 バケットを削除します。詳細については、「*Amazon S3 ユーザーガイド*」の「[バケットの削除](https://docs.aws.amazon.com/AmazonS3/latest/userguide/delete-bucket.html)」を参照してください。 + このチュートリアル用に作成したデータベースを削除します。詳細については、「[DB インスタンスの削除](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html#CHAP_GettingStarted.Deleting.PostgreSQL)」を参照してください。