IBMQuickDeployerComponentVersionSetup < Deployment

Engineering Lifecycle Management Wiki - Deployment

Community information and contribution guidelines

TWiki > Deployment Web > DeploymentInstallingUpgradingAndMigrating > IBMQuickDeployerOld > IBMQuickDeployerSetupAndRunOld > IBMQuickDeployerComponentVersionSetup

Revision 20 - 2017-07-31 - 19:23:20 - Main.ktessier

<div id="header-title" style="padding: 10px 15px; border-width:1px; border-style:solid; border-color:#FFD28C; background-image: url(<nop>https://jazz.net/wiki/pub/Deployment/WebPreferences/TLASE.jpg); background-size: cover; font-size:120%">
---+!! IBM Quick Deployer component version setup  
%DKGRAY%
%INCLUDE{"IBMQuickDeployerInsertAuthorBuildBasis"}%
%ENDCOLOR%</div></sticky>

<!-- Page contents top of page on right hand side in box -->
<sticky><div style="float:right; border-width:1px; border-style:solid; border-color:#DFDFDF; background-color:#F6F6F6; margin:0 0 15px 15px; padding: 0 15px 0 15px;">
%TOC{title="Page contents"}%
</div></sticky>

<sticky><div style="margin:15px;"></sticky>

The scripts used by Quick Deployer are delivered as a single compressed file for each component. This topic explains how to extract the scripts from the compressed file and import them into UCD as a new UCD Component version.

---++ Component script version setup

   1. On the UCD server expand the IBM Quick Deployer installation package into a temporary folder eg */media/QD*
   1. Ensure the following files are present
      * versionUnzip.sh
      * Rational_QD_Application_60x_yyyymmdd-hhmm_artifacts.zip
      * Rational_QD_ApplicationServer_60x_yyyymmdd-hhmm_artifacts.zip
      * Rational_QD_Database_60x_yyyymmdd-hhmm_artifacts.zip
      * Rational_QD_InstallationManager_60x_yyyymmdd-hhmm_artifacts.zip
      * Rational_QD_SystemPre-Requisite_60x_yyyymmdd-hhmm_artifacts.zip
   1. Assign execute permission to the *{agent install dir}/agent/opt/udclient/udclient* script      
   1. Assign execute permission to the *versionUnzip.sh* script
   1. <font color=red><b>ensure JAVA_HOME is set.</b></font> If not export JAVA_HOME={<i>location of your jre</i>} (e.g. /usr/lib/jvm/jre)
   1. <font color=red><b>ensure UCDCLIEXE is set.</b></font> If not export UCDCLIEXE={<i>location of your udclient exe</i>} (e.g. /opt/ibm-ucd/agent/opt/udclient/udclient)
   1. Execute the *versionUnzip.sh* script
      <br/> The script expects 3 arguments as key=value pairs:
      * *BASEFOLDER* =<i>base folder for expanding the scripts into (e.g. /media/QD)</i>
      * *APPLICATIONVERSION* =<i>ApplicationVersion (e.g. 602)</i>
      * *COMPONENTVERSION* =<i>ComponentVersion (e.g. 6.0.2.0)</i>
      <br>- as lots of information is written to the screen it is recommended that when executing the script the output should be *piped through the tee program* for post processing.
      <br> - when execution completes the individual application artifacts will be found in */BASEFOLDER/APPLICATIONVERSION/COMPONENTVERSION/{application}* (e.g. /media/QD/602/6.0.2.0/Application)
   <br/><br/>
   <verbatim>
    cd /media/QD
    chmod 755 {agent install dir}/agent/opt/udclient/udclient
    chmod 755 versionUnzip.sh
    export JAVA_HOME={location of your jre}
    export UCDCLIEXE={agent install dir}/agent/opt/udclient/udclient
    
    sh versionUnzip.sh BASEFOLDER=/media/QD APPLICATIONVERSION=602 COMPONENTVERSION=6.0.2.0 | tee console_versionUnzip.log
    >> deleted console text <<
    SUCCESS [versionUnzip.sh]: Quick Deployer scripts successfully unzipped   

    ls /media/QD/602/6.0.2.0
    Application  ApplicationServer  Database  InstallationManager  SystemPre-Requisite
   </verbatim>
   1. Ensure you are in the folder where you expanded the IBM Quick Deployer installation package eg */media/QD*
   1. Ensure the following files are present
      * componentVersionImport.sh
      * versionImport.sh
   1. Assign execute permission to the *componentVersionImport.sh* and *versionImport.sh* scripts
   1. Execute the *versionImport.sh* script
      <br/> The script expects 6 arguments as key=value pairs:      
      * *USERNAME* =<i>UCDAdminUserName</i> 
      * *USERPASSWORD* =<i>UCDAdminUserPassword</i> 
      * *UCDSERVER* =<i>UCDURL (e.g. !https://UCDHostName:8443)</i> 
      * *BASEFOLDER* =<i>base folder containing the expanded scripts to import (e.g. /media/QD)</i>
      * *APPLICATIONVERSION* =<i>ApplicationVersion (e.g. 602)</i>
      * *COMPONENTVERSION* =<i>ComponentVersion (e.g. 6.0.2.0)</i>
      <br>- as lots of information is written to the screen it is recommended that when executing the script the output should be *piped through the tee program* for post processing.
   <br/><br/>
   <verbatim>
    cd /media/QD
    chmod 755 componentVersionImport.sh
    chmod 755 versionImport.sh

    sh versionImport.sh USERNAME=adminuser USERPASSWORD=adminpassword UCDSERVER=ucdurl:port BASEFOLDER=/media/QD APPLICATIONVERSION=602 COMPONENTVERSION=6.0.2.0 | tee console_versionImport.log
    >> deleted console text <<
    SUCCESS [versionImport.sh]: Quick Deployer scripts imported into UCD
   </verbatim>
   <br/>
   1. Confirm for each of the components listed that they have the correct version [e.g. 6.0.x.0] and file content.
      * Rational_QD_Application_60x
      * Rational_QD_ApplicationServer_60x
      * Rational_QD_Database_60x
      * Rational_QD_InstallationManager_60x
      * Rational_QD_SystemPre-Requisite_60x
   <br/><br/><img src="%ATTACHURLPATH%/CVS_1.png" alt="confirm version"><br/><br/>
   <br/><br/><img src="%ATTACHURLPATH%/CVS_2.png" alt="confirm content"><br/><br/>


%INCLUDE{"IBMQuickDeployerInsertMiscellaneous"}%

<sticky></div></sticky>

Copyright © by IBM and non-IBM contributing authors. All material on this collaboration platform is the property of the contributing authors.
Contributions are governed by our Terms of Use. Please read the following disclaimer.
Dashboards and work items are no longer publicly available, so some links may be invalid. We now provide similar information through other means. Learn more here.