Création d'un environnement Rational Automation Framework avec la console graphique.

1. Avant-propos
1.1. Présentation
1.2. Introduction
2. Environnement
2.1. Création de l'environnement
2.2. Création des variables d'environnement
3. Librairie
3.1. Création d'une librairie
3.2 - Création d'une étape "Step"
4. Projet
4.1. Création d'un projet
5. Construction
5.1. Création physique de votre environnement
5.1.1 Explication de la commande de la première ligne
5.1.2 Explication de la commande de la deuxième ligne
5.1.3 Explication des substitutions
5.1.4 Lancement de la création
6. Lancement de la création d'un DMGR
6.1. Création d'un DMGR avec notre environnement
6.2. Démarrage du DMGR sans RAF en ligne de commande
6.3. Arrêt du DMGR à partir de RAF à la console
7. Conclusion
7.1. Lien de la documentation IBM substitution
7.2 - Lien de la documentation IBM dmgr

1. Avant-propos


1.1 - Présentation.


+------------------------------+                                               +-----------------------------+ 
| Serveur RAFW                 |                                               | Serveur WebSphere 8.0.0.5   | 
| Hostname : saturn            |---(Création d'une action RAF et execution)--->| Hostname : arecibo          | 
| Os : Linux 2.6.32            |                                               | Os : Linux                  | 
|                              |                                               | DMGR : areciboNetwork       | 
|                              |                                               | NODE : areciboNode          | 
+------------------------------+                                               +-----------------------------+ 

1.2 - Introduction


Afin de se familiariser avec la console graphique de RAF, nous allons réaliser un projet permattant l'installation d'un WebSphere 8.0.0.5.

2. Environnement


Le mode preview permet de vérifier la mise en place de l'action.

2.1 - Création d'un environnement


Pour créer un environnement, vous devez sélèctionner dans le menu de gauche.
Rational Automation Framework
Puis cliquer sur :
Rational Automation Framework
Saisir votre nom d'environnement (ex: arecibo_environnement).
Rational Automation Framework

2.2. Création des variables d'environnements


Une fois l'environnement créée, nous allons rajouter les variables d'environnements nécessaire à notre projet.
Normalement la fenêtre suivante apparait.
Rational Automation Framework
Puis cliquer sur :
Rational Automation Framework
Puis saisisser les champs "name" et "value".
Rational Automation Framework
Cliquer sur le bouton sauvegarder.
Rational Automation Framework
Puis renouveller l'opération pour toutes les variables d'environnements dont vous aurez besoin dans votre projet.
Comme le montre la capture d'écran ci-dessous.
Rational Automation Framework

3. Librairies


3.1 - Création d'une librairie


Pour créer une librairie vous devez sélectionner dans le menu de gauche "Librairies", puis cliquer sur :
Rational Automation Framework
Puis renseigner tout les champs :
  • Class

  • Environment

  • Access

  • Name

  • Rational Automation Framework
    Puis cliquer sur "save".
    Rational Automation Framework
    Il faut à présent rajouter des étapes dans votre librairie.

    3.2 - Création d'une étape "Step"


    Les étapes correspondent au commande disponible sur RAF.
    Cliquer sur "Add Step".
    Rational Automation Framework
    Puis renseigner le champs "Name", ainsi que le champ "Command".
    Le champs "Command" contient des variables qui correspondent à celles que vous avez créées plus haut dans le chapitre "Environnement".
    Rational Automation Framework
    Renouvellé l'opération afin de créer les étapes les unes après les autres, comme suit :
    Rational Automation Framework


    4. Projet


    4.1 - Création d'un projet "Project"


    Le projet rassemble tout les éléments :
  • Un environement

  • Une ou des librairies

  • Regroupant une ou plusieurs étapes "Step"

  • Contenant une ou plusieurs lignes de commande

  • Dans le menu de gauche sélectionner "Project", puis à droite cliquer sur le bouton "Add Project".
    Rational Automation Framework
    Renseigner les champs comme si dessous.
    Rational Automation Framework
    Avant de sauvegarder votre projet pensez à allez dans l'onglet "Tags" permettant de donner des noms aux différents "Build".
    Rational Automation Framework

    5. Construction


    5.1 - Création physique de votre environnement


    Si le bouton "EnvGen" Rational Automation Framework ne fonctionne pas, il est tout à fait possible de créer votre environement physique sur le serveur avec une librairie de votre création.

    Nous allons expliquer toutes les lignes ci-dessous.
    Rational Automation Framework

    5.1.1 - Explication de la commande de la première ligne


    Cette ligne permet d'extraire juste un fichier d'un fichier zip contenant plusieurs fichiers.
    ${UNZIPCMD} ${PATH_TEMPLATE}${SLASH}${BF_PROJECTNAME_PHYS}.zip cells${SLASH}cell${SLASH}cell.properties ${UNZIP_CD_FLAG} ${RAFW_HOME}${SLASH}user${SLASH}environments${SLASH}${ENVIRONMENT}
    Voici ce que fait la commande, une fois les variables sourcées.
    unzip -o /root/Project_ARECIBO.zip cells/cell/cell.properties -d /opt/IBM/RAFServer/rafw/user/environments/arecibo_environnement
    root@saturn:~/ # unzip -o /root/Project_ARECIBO.zip cells/cell/cell.properties -d /opt/IBM/RAFServer/rafw/user/environments/arecibo_environnement
    Archive:  /root/Project_ARECIBO.zip
      inflating: /opt/IBM/RAFServer/rafw/user/environments/arecibo_environnement/cells/cell/cell.properties
    root@saturn:~/ #
    

    5.1.2 - Explication de la commande de la deuxième ligne


    Cette ligne permet de copier le fichier "templete" cell.properties dans notre environnement.
    ${COPYCMD} ${RAFW_HOME}${SLASH}user${SLASH}environments${SLASH}${ENVIRONMENT}${SLASH}cells${SLASH}cell${SLASH}cell.properties build-cell.properties
    Voici ce que fait la commande, une fois les variables sourcées.
    cp -p /opt/IBM/RAFServer/rafw/user/environments/arecibo_environnement/cells/cell/cell.properties build-cell.properties
    root@saturn:~/ # cp -p /opt/IBM/RAFServer/rafw/user/environments/arecibo_environnement/cells/cell/cell.properties build-cell.properties
    root@saturn:~/ #
    

    5.1.3 - Explication des substitutions


    Les lignes ci-dessous permettent de remplacer les marqueurs (ex : __HOSTNAME__) par les variables d'environnements.
    .rem ### debut des substitutions dans la template ARECIBO ###
    .strsub __HOSTNAME__ ${NODE1_HOST_NAME} build-cell.properties
    .strsub __WASUSER__ ${WAS_USERNAME} build-cell.properties
    .strsub __WASPASSWD__ ${WAS_PASSWORD} build-cell.properties
    .strsub __OSUSER__ ${OS_USER} build-cell.properties
    .strsub __OSPASSWD__ ${OS_PASSWORD} build-cell.properties
    .strsub __OSGROUP__ ${OS_GROUP} build-cell.properties
    .strsub __ENVIRONMENT__ "${ENVIRONMENT}" build-cell.properties
    .strsub __CELLNAME__ "${CELL_NAME}" build-cell.properties
    .strsub __DMGRNODE__ "${ND_NODE_NAME}" build-cell.properties
    .strsub __NODE__ "${NODE1_NODE_NAME}" build-cell.properties
    .strsub __RAFW_INSTALL_ROOT__ ${RAFW_HOME} build-cell.properties

    5.1.4 - Lancement de la création


    La ligne suivante est une ligne de commande RAF, qui permet la création d'un environnement à partir d'un fichier properties.
    ${RAFW_HOME}${SLASH}bin${SLASH}rafwEnvBuild${SCRIPT_EXT} -b build-cell.properties -genRAFWEnv
    /opt/IBM/RAFServer/rafw/bin/rafwEnvBuild.sh -b build-cell.properties -genRAFWEnv

    6. Lancement de la création DMGR


    6.1 - Création d'un DMGR avec notre environnement


    Afin de tester la création de notre environnement, nous allons créer en ligne de commande notre DMGR "hors console".
    /opt/IBM/RAFServer/rafw/bin/rafw.sh -env arecibo -cell areciboCell -node areciboNetwork -execute was_80_install_dmgr_profile
    
    root@saturn:/opt/IBM/RAFServer/rafw/user/environments# /opt/IBM/RAFServer/rafw/bin/rafw.sh -env arecibo -cell areciboCell -node areciboNetwork -execute was_80_install_dmgr_profile
    CRWFW0026I A new run with the following ID 00bG is starting at Oct 3, 2013 11:52:03 CEST
    Rational Automation Framework version 3.0.0.5 build 20121029-1616
    Including the following modules:
         WebSphere Liberty Profile version 8.5.0.0
         Midvision Extension Module version 1.0.0.1
    
    CRWFW0104I Using the values defined for the properties OS_USER and OS_PASSWORD for the user 'was8'
    defined in the file user/environments/arecibo/cells/areciboCell/configure.properties
    CRWFW0103I Using the following value for OS_GROUP 'web' defined in the file
     user/environments/arecibo/cells/areciboCell/configure.properties
    CRWFW0015I A network connection has been made to 'arecibo'
    CRWFW0013I A list of files that are already on the target system is being created.
    Buildfile: /apps/Rational/RAFW/user/environments/arecibo/cells/areciboCell/nodes/areciboNetwork/build.xml
    
    default:
      [rafwlog] CRWFW0001I If an error occurs, check '/apps/Rational/RAFW//logs/arecibo/cells/areciboCell/nodes/areciboNetwork/was_80_install_dmgr_profile.log'
      [rafwlog] CRWFW0014I Beginning action was_80_install_dmgr_profile on host arecibo
         [echo] Apache Ant version 1.7.0 compiled on December 13 2006
    
    only_execute:
    
    was_common_install_dmgr_profile_prereq_check:
    
    scope_init:
    
    prepare_shell:
    
    decode_password:
    
    was_init:
    
    was_common_install_dmgr_profile:
    
    only_execute:
    
    scope_init:
    
    prepare_shell:
    
    decode_password:
    
    was_init:
    
    was_common_install_create_profile:
         [echo] /apps/WebSphere/AppServer80/bin/manageprofiles.sh -create -profileName dmgr -profilePath '/apps/WebSphere/profiles80/dmgr' -templatePath '/apps/WebSphere/AppServer80/profileTemplates/dmgr'  -enableAdminSecurity false -adminUserName admwas -adminPassword password -cellName areciboCell -nodeName areciboNetwork -hostName arecibo
         [exec] CWMBU0002I: The deployment manager profile template has been deprecated and replaced by the management profile template with a deployment manager server.
         [exec] INSTCONFSUCCESS: Success: Profile dmgr now exists. Please consult /apps/WebSphere/profiles80/dmgr/logs/AboutThisProfile.txt for more information about this profile.
    
    post_install_verification:
    
    prepare_shell:
    
    change_directory_ownership:
    
    report_error_log:
         [copy] Copying 1 file to /apps/Rational/RAFW/logs/arecibo/cells/areciboCell/nodes/areciboNetwork
         [echo] For more information see this log file: /apps/Rational/RAFW//logs/arecibo/cells/areciboCell/nodes/areciboNetwork/dmgr_create.log
    
    prepare_shell:
    
    change_directory_ownership:
    
    update_soap_client_props:
    [propertyeditor] Reading properties from: /apps/WebSphere/profiles80/dmgr/properties/soap.client.props
    [propertyeditor] Updating: com.ibm.SOAP.requestTimeout with value: 6000
    [propertyeditor] Saving properties in: /apps/WebSphere/profiles80/dmgr/properties/soap.client.props
    
    was_80_install_dmgr_profile:
    
    prepare_shell:
    
    change_directory_ownership:
    
    prepare_shell:
    
    change_directory_ownership:
    
    prepare_shell:
    
    change_directory_ownership:
    [querychangedfiles] CRWFW6009I Computing list of files modified during action execution for scope arecibo/cells/areciboCell
    
    BUILD SUCCESSFUL
    Total time: 2 minutes 18 seconds
    CRWFW0059I The following file is being transferred from the target system to the framework server: logs/arecibo/cells/areciboCell/nodes/areciboNetwork/was_80_install_dmgr_profile.log
    CRWFW0059I The following file is being transferred from the target system to the framework server: logs/arecibo/cells/areciboCell/nodes/areciboNetwork/was_80_install_dmgr_profile.trace
    CRWFW0059I The following file is being transferred from the target system to the framework server: logs/arecibo/cells/areciboCell/nodes/areciboNetwork/dmgr_create.log
    CRWFW7070I Disconnected from 'arecibo'
    root@saturn:/opt/IBM/RAFServer/rafw/user/environments#
    
    

    6.2 - Démarrage du DMGR sans RAF en ligne de commande


    Pour tester tout les cas possible, nous démarrons le DMGR sur son serveur.
    /apps/WebSphere/profiles80/dmgr/bin/startManager.sh
    root@saturn:/apps/WebSphere/profiles80/dmgr/bin# ./startManager.sh
    ADMU0116I: Tool information is being logged in file
               /apps/WebSphere/profiles80/dmgr/logs/dmgr/startServer.log
    ADMU0128I: Starting tool with the dmgr profile
    ADMU3100I: Reading configuration for server: dmgr
    ADMU3200I: Server launched. Waiting for initialization status.
    ADMU3000I: Server dmgr open for e-business; process id is 30385
    root@saturn:/apps/WebSphere/profiles80/dmgr/bin# 
    
    Puis nous testons à la console.
    Nous voyons bien un DMGR sans NOEUD possible.
    Rational Automation Framework

    6.3 - Arrêt du DMGR à partir de RAF à la console


    Pour tester tout les cas possible, nous arrêtons le DMGR à partir de RAF à la console.
    Rational Automation Framework

    7. Conclusion


    7.1 - Lien de la documentation IBM substitution


    Url ibm pour les substitutions dans les commandes RAF.

    7.2 - Lien de la documentation IBM dmgr


    Url ibm pour la création d'un dmgr dans les commandes RAF.