翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
チュートリアル: AppStream 2.0 で Enterprise Analyzer をセットアップする
このチュートリアルでは、Micro Focus Enterprise Analyzer をセットアップして 1 つ以上のメインフレームアプリケーションを分析する方法について説明します。Enterprise Analyzer ツールは、アプリケーションのソースコードとシステム定義の分析に基づいて複数のレポートを提供します。
この設定は、チームのコラボレーションを促進するように設計されています。インストールでは Amazon S3 バケットを使用して、仮想ディスクとソースコードを共有します。これを行うには、Windows マシンの Rclone
チームメンバーは、Amazon S3 でバックアップされた仮想ディスクを自分のパーソナルマシンにマウントし、ワークステーションからソースバケットを更新することもできます。他のオンプレミスの内部システムに接続していれば、自分のマシンでスクリプトやその他の自動化手段を使用できる可能性があります。
セットアップは、 AWS Mainframe Modernization が顧客 と共有している AppStream 2.0 Windows イメージに基づいています。セットアップは、「」で説明されている AppStream 2.0 フリートとスタックの作成にも基づいていますチュートリアル: Micro Focus Enterprise Analyzer と Micro Focus Enterprise Developer で使用する AppStream 2.0 をセットアップする。
重要
このチュートリアルのステップでは、ダウンロード可能な AWS CloudFormation テンプレート cfn-m AppStream 2-.yml を使用して 2.0 をセットアップすることを前提としています。 appstream-fleet-ea-ed
このチュートリアルのステップを実行するには、Enterprise Analyzer フリートとスタックを設定済みで、それらが実行中である必要があります。
Enterprise Analyzer の機能と成果物の詳細については、Micro Focus ウェブサイトの「Enterprise Analyzer Documentation
イメージのコンテンツ
Enterprise Analyzer アプリケーション自体に加えて、イメージには次のツールとライブラリが含まれています。
サードパーティー製ツール
C:\Users\Public
内のライブラリ
-
BankDemo Enterprise Developer のソースコードとプロジェクト定義:
m2-bankdemo-template.zip
。 -
MFA メインフレームの インストールパッケージ:
mfa.zip
。詳細については、「Micro Focus Enterprise Developer ドキュメント」の「Mainframe Access Overview」を参照してください。 -
Rclone のコマンドファイルおよび設定ファイル (使用方法はチュートリアルに記載されています):
m2-rclone.cmd
とm2-rclone.conf
。
トピック
前提条件
-
分析する顧客アプリケーションのソースコードとシステム定義を S3 バケットにアップロードします。システム定義にはCICSCSD、、DB2オブジェクト定義などが含まれます。バケット内には、アプリケーションのアーティファクトをどのように整理するかに合わせたフォルダ構造を作成できます。例えば、 BankDemo サンプルを解凍すると、次の構造になります。
demo |--> jcl |--> RDEF |--> transaction |--> xa
-
Postgre を実行する Amazon RDSインスタンスを作成して起動しますSQL。このインスタンスには、Enterprise Analyzer によって生成されたデータと結果が保存されます。このインスタンスは、アプリケーションチームのすべてのメンバーと共有できます。また、
m2_ea
(またはその他の適切な名前) という名前の空のスキーマをデータベースに作成します。権限のあるユーザーがこのスキーマの項目を作成、挿入、更新、削除できるようにする認証情報を定義します。データベース名、サーバーエンドポイント 、およびTCPポートはURL、Amazon RDSコンソールまたはアカウント管理者から取得できます。 -
へのプログラムによるアクセスが設定されていることを確認します AWS アカウント。詳細については、「Amazon Web Services 全般のリファレンス」の「プログラム的なアクセス」を参照してください。
ステップ 1: セットアップ
-
AppStream 2.0 からウェルカム E メールメッセージでURL受信した を使用して、 AppStream 2.0 でセッションを開始します。
-
E メールをユーザー ID として使用し、永久パスワードを定義します。
-
Enterprise Analyzer スタックを選択します。
-
AppStream 2.0 メニューページで、デスクトップ を選択して、フリートがストリーミングしている Windows デスクトップにアクセスします。
ステップ 2: Windows 用の Amazon S3 ベースの仮想フォルダを作成する
注記
AWS Mainframe Modernization のプレビュー中に Rclone を既に使用している場合は、 にある新しいバージョンm2-rclone.cmd
に更新する必要がありますC:\Users\Public
。
-
C:\Users\Public
で提供されているm2-rclone.conf
ファイルとm2-rclone.cmd
ファイルを、ファイルエクスプローラーを使用してホームフォルダC:\Users\PhotonUser\My Files\Home Folder
にコピーします。 -
アクセス 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
-
m2-rclone.cmd
で、以下の変更を加えます。-
your-s3-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
と指定します。この同期されたディレクトリは、 AppStream 2.0 がセッションの開始と終了時に適切にバックアップおよび復元するために、ホームフォルダのサブディレクトリである必要があります。
:loop timeout /T 10 "C:\Program Files\rclone\rclone.exe" sync m2-s3:
your-s3-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 -
-
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ソースを作成する
-
EA_Admin ツールを開始するには、ブラウザウィンドウの左上隅にあるアプリケーションセレクタメニューに移動し、[MF EA_Admin] を選択します。
-
管理メニューからデータソース を選択しODBC、ユーザーDSNタブから追加 を選択します。
-
「新しいデータソースの作成」ダイアログボックスで、PostgreSQL Unicode ドライバーを選択し、「 の終了」を選択します。
-
PostgreSQL Unicode ODBCドライバー (psqlODBC) セットアップダイアログボックスで、必要なデータソース名を定義してメモします。以前に作成したRDSインスタンスの値を使用して、次のパラメータを入力します。
- 説明
-
このデータベース接続をすばやく識別するのに役立つ説明 (オプション)。
- データベース
-
以前に作成した Amazon RDS データベース。
- [サーバー]
-
Amazon RDSエンドポイント。
- [ポート]
-
Amazon RDS ポート。
- ユーザー名
-
Amazon RDSインスタンスで定義されているとおり。
- パスワード
-
Amazon RDSインスタンスで定義されているとおり。
-
テスト を選択して Amazon への接続RDSが成功したことを検証し、保存 を選択して新しいユーザー を保存しますDSN。
-
適切なワークスペースの作成を確認するメッセージが表示されるまで待ってから、OK を選択してODBCデータソースで終了し、EA_Admin ツールを閉じます。
-
アプリケーションセレクタメニューに再度移動し、[Enterprise Analyzer] を選択してツールを開始します。[新規作成] を選択します。
-
ワークスペース設定ウィンドウで、ワークスペース名を入力し、その場所を定義します。ワークスペースは、この設定で作業する場合は Amazon S3 ベースのディスクにすることも、必要に応じてホームフォルダにすることもできます。
-
Amazon RDSインスタンスに接続するには、「他のデータベースを選択」を選択します。
-
オプションから [Postgre] アイコンを選択し、[OK] を選択します。
-
Windows 設定の [オプション - 接続パラメータの定義] に、作成したデータソースの名前を入力します。データベース名、スキーマ名、ユーザー名、パスワードも入力します。[OK] を選択します。
-
Enterprise Analyzer が結果を保存するために必要なテーブル、インデックスなどをすべて作成するまでお待ちください。このステップには数分かかる場合があります。Enterprise Analyzer は、データベースとワークスペースが使用できる状態になったことを確認します。
-
アプリケーションセレクタメニューに再度移動し、[Enterprise Analyzer] を選択してツールを開始します。
-
Enterprise Analyzer のスタートアップウィンドウが、新しく選択したワークスペースの場所に表示されます。[OK] を選択します。
-
左ペインのリポジトリに移動し、リポジトリ名を選択し、[ファイル/フォルダをワークスペースに追加] を選択します。アプリケーションコードが保存されているフォルダを選択して、ワークスペースに追加します。必要に応じて、前の BankDemoサンプルコードを使用できます。Enterprise Analyzer からこれらのファイルの検証を求めるメッセージが表示されたら、[検証] を選択して最初の Enterprise Analyzer 検証レポートを開始します。アプリケーションのサイズによっては、完了するまで数分かかる場合があります。
-
ワークスペースを展開すると、ワークスペースに追加したファイルとフォルダが表示されます。オブジェクトタイプと循環的複雑度レポートは、[チャートビューアー] ペインの上部にも表示されます。
これで、必要なすべてのタスクに Enterprise Analyzer を使用できるようになりました。
以降のセッション
-
AppStream 2.0 からウェルカム E メールメッセージでURL受信した を使用して、 AppStream 2.0 でセッションを開始します。
-
E メールと永久パスワードを使用してログインします。
-
Enterprise Analyzer スタックを選択します。
-
このオプションを使用してワークスペースファイルを共有する場合は、
Rclone
を起動して Amazon S3 バックアップディスクに接続します。 -
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] を選択してメッセージをクリアし、次の手順を実行します。
-
AppStream 2.0 で、ツールバーのアプリケーション起動アイコンを選択し、EA_Admin を選択して Micro Focus Enterprise Analyzer 管理ツールを起動します。
-
[管理] メニューから [ワークスペースパスを更新...] を選択します。
-
[ワークスペースを選択] で、目的のワークスペースを選択し、[OK] を選択します。
-
[OK] を選択してエラーメッセージを確認します。
-
[ワークスペースディレクトリのネットワークパス] に、ワークスペースへの正しいパス (例:
D:\PhotonUser\My Files\Home Folder\EA\MyWorkspace3
) を入力します。 -
Micro Focus Enterprise Analyzer 管理ツールを閉じます。
-
AppStream 2.0 で、ツールバーのアプリケーション起動アイコンを選択し、EA を選択して Micro Focus Enterprise Analyzer を起動します。
-
ステップ 3~5 を繰り返します。
これで、Micro Focus Enterprise Analyzer が既存のワークスペースで開かれるはずです。
リソースをクリーンアップする
このチュートリアル用に作成したリソースが不要になった場合は、追加料金の発生を避けるため、それらを削除してください。以下のステップを実行します。
-
[EA_Admin] ツールを使用してワークスペースを削除します。
-
このチュートリアル用に作成した S3 バケットを削除します。詳細については、「Amazon S3 ユーザーガイド」の「バケットの削除」を参照してください。
-
このチュートリアル用に作成したデータベースを削除します。詳細については、「DB インスタンスの削除」を参照してください。