

AWS Le service de modernisation du mainframe (expérience de l'environnement d'exécution géré) n'est plus ouvert aux nouveaux clients. Pour des fonctionnalités similaires au service de modernisation AWS du mainframe (expérience de l'environnement d'exécution géré), explorez le service de modernisation AWS du mainframe (expérience autogérée). Les clients existants peuvent continuer à utiliser le service normalement. Pour plus d'informations, consultez la section [Modification de la disponibilité de la modernisation du AWS mainframe](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html).

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Tutoriel : Configuration d'Enterprise Analyzer sur les applications WorkSpaces
<a name="set-up-ea"></a>

Ce didacticiel explique comment configurer Rocket Enterprise Analyzer (anciennement Micro Focus Enterprise Analyzer) pour analyser une ou plusieurs applications mainframe. L'outil Enterprise Analyzer fournit plusieurs rapports basés sur son analyse du code source de l'application et des définitions du système.

Cette configuration est conçue pour favoriser la collaboration au sein des équipes. L'installation utilise un compartiment Amazon S3 pour partager le code source avec des disques virtuels. Pour ce faire, vous devez utiliser [Rclone](https://rclone.org/)) sur l'ordinateur Windows. Avec une instance Amazon RDS commune exécutant [PostgreSQL](https://www.postgresql.org/), tous les membres de l'équipe peuvent accéder à tous les rapports demandés.

Les membres de l'équipe peuvent également monter le disque virtuel sauvegardé par Amazon S3 sur leurs machines personnelles et mettre à jour le compartiment source depuis leur poste de travail. Ils peuvent potentiellement utiliser des scripts ou toute autre forme d'automatisation sur leurs machines s'ils sont connectés à d'autres systèmes internes sur site.

La configuration est basée sur les images Windows WorkSpaces des applications que AWS Mainframe Modernization partage avec le client. La configuration repose également sur la création de flottes et de piles d' WorkSpaces applications, comme décrit dans. [Tutoriel : Configuration d' WorkSpaces applications à utiliser avec Rocket Enterprise Analyzer et Rocket Enterprise Developer](set-up-appstream-mf.md)

**Important**  
Les étapes de ce didacticiel supposent que vous configurez WorkSpaces des applications avec le CloudFormation modèle téléchargeable [cfn-m2- appstream-fleet-ea-ed](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml) .yml. Pour de plus amples informations, veuillez consulter [Tutoriel : Configuration d' WorkSpaces applications à utiliser avec Rocket Enterprise Analyzer et Rocket Enterprise Developer](set-up-appstream-mf.md).  
Pour effectuer les étapes de ce didacticiel, vous devez avoir configuré votre parc et votre stack Enterprise Analyzer et ils doivent être en cours d'exécution.

Pour une description complète des fonctionnalités et des livrables d'Enterprise Analyzer, consultez la [documentation d'Enterprise Analyzer](https://www.microfocus.com/documentation/enterprise-analyzer/) sur le site Web de Rocket Software (anciennement Micro Focus).

## Contenu de l'image
<a name="set-up-ea-image-contents"></a>

Outre l'application Enterprise Analyzer elle-même, l'image contient les outils et bibliothèques suivants.

Outils tiers
+ [Python](https://www.python.org/)
+ [Recloner](https://rclone.org/)
+ [pgAdmin](https://www.pgadmin.org/)
+ [git-scm](https://git-scm.com/)
+ [pilote ODBC pour PostgreSQL](https://odbc.postgresql.org/)

Bibliothèques de `C:\Users\Public`
+ BankDemo code source et définition du projet pour Enterprise Developer :`m2-bankdemo-template.zip`.
+ Package d'installation MFA pour le mainframe :. `mfa.zip` Pour plus d'informations, consultez la section [Présentation de l'accès au mainframe](https://www.microfocus.com/documentation/enterprise-developer/30pu12/ED-VS2012/BKMMMMINTRS001.html) dans la documentation *Micro Focus Enterprise Developer*.
+ Fichiers de commande et de configuration pour Rclone (instructions pour leur utilisation dans les didacticiels) : `m2-rclone.cmd` et`m2-rclone.conf`.

**Topics**
+ [Contenu de l'image](#set-up-ea-image-contents)
+ [Conditions préalables](#tutorial-ea-prerequisites)
+ [Étape 1 : configuration](#tutorial-ea-step1)
+ [Étape 2 : créer le dossier virtuel basé sur Amazon S3 sous Windows](#tutorial-ea-step2)
+ [Étape 3 : créer une source ODBC pour l'instance Amazon RDS](#tutorial-ea-step3)
+ [Sessions suivantes](#tutorial-ea-step4)
+ [Résolution des problèmes de connexion aux espaces](#tutorial-ea-step5)
+ [nettoyer des ressources ;](#tutorial-ea-clean)

## Conditions préalables
<a name="tutorial-ea-prerequisites"></a>
+ Téléchargez le code source et les définitions du système pour l'application client que vous souhaitez analyser dans un compartiment S3. Les définitions du système incluent CICS CSD, les définitions d' DB2 objets, etc. Vous pouvez créer une structure de dossiers dans le compartiment adaptée à la manière dont vous souhaitez organiser les artefacts de l'application. Par exemple, lorsque vous décompressez l' BankDemo échantillon, sa structure est la suivante :

  ```
  demo
       |--> jcl
       |--> RDEF
       |--> transaction
       |--> xa
  ```
+ Créez et démarrez une instance Amazon RDS exécutant PostgreSQL. Cette instance stockera les données et les résultats produits par Enterprise Analyzer. Vous pouvez partager cette instance avec tous les membres de l'équipe chargée de l'application. Créez également un schéma vide appelé `m2_ea` (ou tout autre nom approprié) dans la base de données. Définissez les informations d'identification pour les utilisateurs autorisés qui leur permettent de créer, d'insérer, de mettre à jour et de supprimer des éléments dans ce schéma. Vous pouvez obtenir le nom de la base de données, l'URL du point de terminaison du serveur et le port TCP depuis la console Amazon RDS ou auprès de l'administrateur du compte.
+ Assurez-vous d'avoir configuré l'accès programmatique à votre Compte AWS. *Pour plus d'informations, consultez la section [Accès par programmation](https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys) dans le Référence générale d'Amazon Web Services.*

## Étape 1 : configuration
<a name="tutorial-ea-step1"></a>

1. Démarrez une session avec WorkSpaces Applications à l'aide de l'URL que vous avez reçue dans le message électronique de bienvenue envoyé par WorkSpaces Applications.

1. Utilisez votre adresse e-mail comme nom d'utilisateur et définissez votre mot de passe permanent.

1. Sélectionnez la pile Enterprise Analyzer.

1. Sur la page du menu WorkSpaces Applications, choisissez **Bureau** pour accéder au bureau Windows que le parc diffuse.

## Étape 2 : créer le dossier virtuel basé sur Amazon S3 sous Windows
<a name="tutorial-ea-step2"></a>

**Note**  
Si vous avez déjà utilisé Rclone lors de la version préliminaire de AWS Mainframe Modernization, vous devez effectuer la mise à jour `m2-rclone.cmd` vers la version la plus récente située dans. `C:\Users\Public`

1. Copiez les `m2-rclone.cmd` fichiers `m2-rclone.conf` et fournis dans votre dossier `C:\Users\Public` de base à `C:\Users\PhotonUser\My Files\Home Folder` l'aide de l'explorateur de fichiers.

1. Mettez à jour les paramètres de `m2-rclone.conf` configuration avec votre clé AWS d'accès et le secret correspondant, ainsi que votre Région 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. Dans `m2-rclone.cmd`, effectuez les modifications suivantes :
   + `amzn-s3-demo-bucket`Changez le nom de votre compartiment Amazon S3. Par exemple, `m2-s3-mybucket`.
   + Passez `your-s3-folder-key` à la clé de votre compartiment Amazon S3. Par exemple, `myProject`.
   + Accédez `your-local-folder-path` au chemin du répertoire dans lequel vous souhaitez que les fichiers d'application soient synchronisés à partir du compartiment Amazon S3 qui les contient. Par exemple, `D:\PhotonUser\My Files\Home Folder\m2-new`. Ce répertoire synchronisé doit être un sous-répertoire du dossier de base pour que les WorkSpaces applications puissent le sauvegarder et le restaurer correctement au début et à la fin de la session.

   ```
   :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. Ouvrez une invite de commande Windows, envoyez-la `C:\Users\PhotonUser\My Files\Home Folder` si nécessaire et lancez-la`m2-rclone.cmd`. Ce script de commande exécute une boucle continue, synchronisant votre compartiment et votre clé Amazon S3 avec le dossier local toutes les 10 secondes. Vous pouvez ajuster le délai d'attente selon vos besoins. Vous devriez voir le code source de l'application situé dans le compartiment Amazon S3 de l'Explorateur de fichiers Windows.

Pour ajouter de nouveaux fichiers à l'ensemble sur lequel vous travaillez ou pour mettre à jour les fichiers existants, chargez les fichiers dans le compartiment Amazon S3 et ils seront synchronisés avec votre répertoire lors de la prochaine itération définie dans. `m2-rclone.cmd` De même, si vous souhaitez supprimer certains fichiers, supprimez-les du compartiment Amazon S3. La prochaine opération de synchronisation les supprimera de votre répertoire local.

## Étape 3 : créer une source ODBC pour l'instance Amazon RDS
<a name="tutorial-ea-step3"></a>

1. **Pour démarrer l'outil EA\_Admin, accédez au menu de sélection d'applications dans le coin supérieur gauche de la fenêtre du navigateur et choisissez MF EA\_Admin.**

1. Dans le menu **Administrer**, choisissez **Sources de données ODBC**, puis choisissez **Ajouter** dans l'onglet **DSN utilisateur**.

1. **Dans la boîte de dialogue Créer une nouvelle source de données, choisissez le pilote Unicode **PostgreSQL**, puis cliquez sur Terminer.**

1. Dans la boîte de dialogue de configuration du **pilote ODBC Unicode PostgreSQL (PSQLodBC**), définissez et notez le nom de la source de données que vous souhaitez. Complétez les paramètres suivants avec les valeurs de l'instance RDS que vous avez créée précédemment :  
**Description**  
Description facultative pour vous aider à identifier rapidement cette connexion à la base de données.  
**Base de données**  
La base de données Amazon RDS que vous avez créée précédemment.  
**Serveur**  
Le point de terminaison Amazon RDS.  
** Port**  
Le port Amazon RDS.  
**Nom d’utilisateur**  
Tel que défini dans l'instance Amazon RDS.  
**Mot de passe**  
Tel que défini dans l'instance Amazon RDS.

1. Choisissez **Test** pour vérifier que la connexion à Amazon RDS est réussie, puis sélectionnez **Enregistrer pour enregistrer** votre nouveau DSN utilisateur.

1. Attendez de voir le message confirmant la création de l'espace de travail approprié, puis cliquez **sur OK** pour terminer avec les sources de données ODBC et fermer l'outil EA\_Admin.

1. Accédez à nouveau au menu de sélection d'applications, puis choisissez Enterprise Analyzer pour démarrer l'outil. Choisissez **Créer un nouveau**. 

1. Dans la fenêtre de configuration de l'espace de travail, entrez le nom de votre espace de travail et définissez son emplacement. L'espace de travail peut être le disque basé sur Amazon S3 si vous travaillez sous cette configuration, ou votre dossier personnel si vous préférez.

1. **Choisissez Choose Other Database** pour vous connecter à votre instance Amazon RDS.

1. Choisissez l'icône **Postgre** parmi les options, puis cliquez **sur OK.**

1. Pour les paramètres Windows, sous **Options — Définir les paramètres de connexion**, entrez le nom de la source de données que vous avez créée. Entrez également le nom de la base de données, le nom du schéma, le nom d'utilisateur et le mot de passe. Choisissez **OK**.

1. Attendez qu'Enterprise Analyzer crée toutes les tables, tous les index, etc. dont il a besoin pour stocker les résultats. Ce processus peut prendre quelques minutes. Enterprise Analyzer confirme le moment où la base de données et l'espace de travail sont prêts à être utilisés.

1. Accédez à nouveau au menu de sélection d'applications et choisissez Enterprise Analyzer pour démarrer l'outil.

1. La fenêtre de démarrage d'Enterprise Analyzer apparaît dans le nouvel emplacement d'espace de travail sélectionné. Choisissez **OK**.

1. Accédez à votre référentiel dans le volet de gauche, sélectionnez le nom du référentiel, puis choisissez **Ajouter des fichiers/dossiers à votre espace de travail**. Sélectionnez le dossier dans lequel le code de votre application est stocké pour l'ajouter à l'espace de travail. Vous pouvez utiliser l' BankDemoexemple de code précédent si vous le souhaitez. Lorsque Enterprise Analyzer vous invite à vérifier ces fichiers, choisissez **Verify** pour démarrer le rapport de vérification initial d'Enterprise Analyzer. Le traitement peut prendre quelques minutes, en fonction de la taille de votre demande.

1. Développez votre espace de travail pour afficher les fichiers et dossiers que vous y avez ajoutés. Les types d'objets et les rapports de complexité cyclomatique sont également visibles dans le quadrant supérieur du volet **Chart** Viewer.

Vous pouvez désormais utiliser Enterprise Analyzer pour toutes les tâches nécessaires.

## Sessions suivantes
<a name="tutorial-ea-step4"></a>

1. Démarrez une session avec WorkSpaces Applications à l'aide de l'URL que vous avez reçue dans le message électronique de bienvenue envoyé par WorkSpaces Applications.

1. Connectez-vous à l'aide de votre e-mail et de votre mot de passe permanent.

1. Sélectionnez la pile Enterprise Analyzer.

1. Lancez `Rclone` pour vous connecter au disque sauvegardé par Amazon S3 si vous utilisez cette option pour partager les fichiers de l'espace de travail.

1. Lancez Enterprise Analyzer pour effectuer vos tâches.

## Résolution des problèmes de connexion aux espaces
<a name="tutorial-ea-step5"></a>

Lorsque vous essayez de vous reconnecter à votre espace de travail Enterprise Analyzer, le message d'erreur suivant peut s'afficher :

```
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?
```

Pour résoudre ce problème, cliquez **sur OK** pour effacer le message, puis effectuez les étapes suivantes.

1. Dans WorkSpaces Applications, cliquez sur l'icône **Lancer l'application** dans la barre d'outils, puis choisissez **EA\_Admin** pour démarrer l'outil d'administration d'Enterprise Analyzer.  
![Le menu de sélection WorkSpaces des applications lance avec l'outil d'administration Rocket Enterprise Developer sélectionné.](http://docs.aws.amazon.com/fr_fr/m2/latest/userguide/images/aas-launch-selector.png)

1. Dans le menu **Administrer**, choisissez **Actualiser le chemin de l'espace de travail...** .  
![Menu d'administration de l'outil d'administration Rocket Enterprise Analyzer avec Refresh Workspace Path sélectionné.](http://docs.aws.amazon.com/fr_fr/m2/latest/userguide/images/ea_admin-administer-refresh.png)

1. Sous **Sélectionner un espace de travail**, choisissez l'espace de travail de votre choix, puis **cliquez sur OK**.  
![La boîte de dialogue Sélectionner l'espace de travail de l'outil d'administration Rocket Enterprise Analyzer avec un projet sélectionné.](http://docs.aws.amazon.com/fr_fr/m2/latest/userguide/images/ea_admin-select-workspace.png)

1. Cliquez **sur OK** pour confirmer le message d'erreur.  
![Le message d'erreur « Impossible d'accéder au répertoire de l'espace de travail » d'Enterprise Analyzer avec OK est sélectionné.](http://docs.aws.amazon.com/fr_fr/m2/latest/userguide/images/ea_admin-select-workspace-error.png)

1. Sous **Chemin réseau du répertoire de l'espace** de travail, entrez le chemin d'accès correct à votre espace de travail, par exemple,`D:\PhotonUser\My Files\Home Folder\EA\MyWorkspace3`.  
![Le chemin réseau du répertoire Workspace de la boîte de dialogue Enterprise Analyzer avec un exemple de chemin.](http://docs.aws.amazon.com/fr_fr/m2/latest/userguide/images/ea_admin-workspace-directory-network-path.png)

1. Fermez l'outil d'administration de Micro Focus Enterprise Analyzer.  
![L'outil d'administration de Micro Focus Enterprise Analyzer avec le bouton Fermer sélectionné.](http://docs.aws.amazon.com/fr_fr/m2/latest/userguide/images/ea_admin-close.png)

1. Dans WorkSpaces Applications, cliquez sur l'icône **Lancer l'application** dans la barre d'outils, puis choisissez **EA** pour démarrer Micro Focus Enterprise Analyzer.  
![L'icône WorkSpaces Applications lance l'application avec EA sélectionnée.](http://docs.aws.amazon.com/fr_fr/m2/latest/userguide/images/aas-launch-ea.png)

1. Répétez les étapes 3 à 5.

Micro Focus Enterprise Analyzer devrait maintenant s'ouvrir avec l'espace de travail existant.

## nettoyer des ressources ;
<a name="tutorial-ea-clean"></a>

Si vous n'avez plus besoin des ressources que vous avez créées pour ce didacticiel, supprimez-les afin de ne pas avoir à payer de frais supplémentaires. Procédez comme suit :
+ Utilisez l'outil **EA\_Admin** pour supprimer l'espace de travail.
+ Supprimez les compartiments S3 que vous avez créés pour ce didacticiel. Pour plus d’informations, consultez [Suppression d’un compartiment](https://docs.aws.amazon.com/AmazonS3/latest/userguide/delete-bucket.html) dans le *Guide de l’utilisateur Amazon S3*.
+ Supprimez la base de données que vous avez créée pour ce didacticiel. Pour plus d'informations, consultez [Suppression d'une instance de base de données](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html#CHAP_GettingStarted.Deleting.PostgreSQL).