(r2) IBMQuickDeployerUpdatingComponentArtifactsOld < Deployment

Engineering Lifecycle Management Wiki - Deployment
Community information and contribution guidelines
~~EditAttach~~Printable
TWiki > Deployment Web > DeploymentInstallingUpgradingAndMigrating > IBMQuickDeployer > IBMQuickDeployerSetupAndRun > IBMQuickDeployerUpdatingComponentArtifactsOld
Revision 2 - 2016-12-16 - 18:10:40 - Main.kenneth
<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 Updating Component Artifacts
<img src="https://jazz.net/wiki/pub/Deployment/WebPreferences/uc.png" alt="uc.png" width="50" height="50" align="right"> 
%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 START-->
You might want to change the behavior of the IBM Quick Deployer by making changes to scripts in IBM !UrbanCode Deploy components. To modify the script artifacts used by an !UrbanCode Deploy component, you must have access to the full set of artifacts.
<br>This wiki explains how to use scripts supplied in the Quick Deployer package to do this task.
<br>To update an !UrbanCode Deploy Component's artifacts, perform the following tasks: 
   * Export the current version of the !UrbanCode Deploy Component (see section [[IBMQuickDeployerUpdatingComponentArtifacts#Download_UrbanCode_Deploy_comp][Download UCD Component artifacts]]).
   * Expand the artifact.zip and replace or modify the files as appropriate (see section [[IBMQuickDeployerUpdatingComponentArtifacts#Expand_and_update_the_artifacts][Expand and update the artifacts]]).
   * Import a new version of the !UrbanCode Deploy component (see section [[IBMQuickDeployerUpdatingComponentArtifacts#Upload_new_UrbanCode_Deploy_Comp][Upload new UCD Component version]]).
<br/>

---++ Download !UrbanCode Deploy component artifacts
   1. Expand the IBM Quick Deployer installation package into a temporary folder (e.g. /media/QD).
   1. Ensure that the following file is present:
      * componentVersionDownload.sh
   1. Assign execute permission to the *{agent install dir}/agent/opt/udclient/udclient* script. 
   1. Assign execute permission to the *componentVersionDownload.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 *componentVersionDownload.sh* script.
   <br/> The script expects five arguments:
      * *USERNAME* =<i>UCDAdminUserName</i> 
      * *USERPASSWORD* =<i>UCDAdminUserPassword</i> 
      * *UCDSERVER* =<i>UCDURL (e.g. !https://UCDHostName:8443)</i>
      * *COMPONENTNAME* =<i>the name of the component that will be downloaded (e.g. Rational_QD_Application_602)</i>
      * *COMPONENTVERSION* =<i>the version of the component that will be downloaded (e.g. 6.0.2.0)</i>
    <br/><br/>
    <verbatim>
    cd /media/QD
    chmod 755 {agent install dir}/agent/opt/udclient/udclient
    chmod 755 componentVersionDownload.sh
    export JAVA_HOME={location of your jre}
    export UCDCLIEXE={agent install dir}/agent/opt/udclient/udclient

    sh componentVersionDownload.sh USERNAME=adminuser USERPASSWORD=adminpassword UCDSERVER=https://UCDHostName:8443 COMPONENTNAME=Rational_QD_Application_602 COMPONENTVERSION=6.0.2.0 | tee console_versionDownload.log
    >> deleted console text <<
    SUCCESS [componentVersionDownload.sh]: successfully downloaded scripts from !UrbanCode Deploy
    </verbatim>
   1. Check that file *COMPONENTNAME_COMPONENTVERSION_artifacts.zip* has been downloaded (e.g. Rational_QD_Application_602_6.0.2.0_artifacts.zip).
    <br/><br/>

---++ Expand and update the artifacts
   1. Confirm that the artifacts.zip file was downloaded (e.g. Rational_QD_Application_602_6.0.2.0_artifacts.zip).
   1. Expand the artifact.zip file to a temporary folder (e.g. /media/QD/tempDownload).
   1. Update any existing files as required:
   <br> Add any new files.
   <br> Delete any obsolete files.
   <br/><br/>

---++ Upload new !UrbanCode Deploy Component version
   1. Expand the IBM Quick Deployer installation package into a temporary folder (e.g. /media/QD).
   1. Ensure that the following file is present:
      * componentVersionImport.sh
   1. Assign execute permission to the *{agent install dir}/agent/opt/udclient/udclient* script. 
   1. Assign execute permission to the *componentVersionImport.sh* script. 
   1. <font color=red><b>Ensure that 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 that 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 *componentVersionImport.sh* script.
   <br/> The script expects six arguments:
      * *USERNAME* =<i>UCDAdminUserName</i> 
      * *USERPASSWORD* =<i>UCDAdminUserPassword</i> 
      * *UCDSERVER* =<i>UCDURL (e.g. !https://UCDHostName:8443)</i>
      * *COMPONENTNAME* =<i>the name of the component that will be updated (e.g. Rational_QD_Application_602)</i>
      * *COMPONENTVERSION* =<i>the new version of the component that will be  updated (e.g. 6.0.2.1)</i>
      * *BASEFOLDER* =<i>the base folder containing the updated artifact scripts (e.g. /media/QD/tempDownload)</i>
    <br/><br/>
    <verbatim>
    cd /media/QD
    chmod 755 {agent install dir}/agent/opt/udclient/udclient
    chmod 755 componentVersionImport.sh
    export JAVA_HOME={location of your jre}
    export UCDCLIEXE={agent install dir}/agent/opt/udclient/udclient

    sh componentVersionImport.sh USERNAME=adminuser USERPASSWORD=adminpassword UCDSERVER=https://UCDHostName:8443 COMPONENTNAME=Rational_QD_Application_602 COMPONENTVERSION=6.0.2.1 BASEFOLDER=/media/QD/tempDownload | tee console_versionImport.log
    >> deleted console text <<
    SUCCESS [componentVersionImport.sh]: new component version including scripts added to !UrbanCode Deploy
    </verbatim>
    <br/>

---++Confirm that the update happened
   1. Open the component version after the script is executed successfully. You should see that the newer version is added to the component.
   <br/><br/><img src="%ATTACHURLPATH%/comp-version-list.png" alt="version list picture to capture / steal"><br/><br/>
   1. Click the *Compare* button to see the differences between the two versions.
   <br/><br/><img src="%ATTACHURLPATH%/comp-version-comp.png" alt="version compare picture to capture / steal"><br/><br/>

---++Update fixed component versions
NOTE: If you previously fixed the *Rational_QD_x* component version that is used by the *Install Applications* application process, update it to this new version. To do so, see [[IBMQuickDeployerSetFixedComponentVersions][Set fixed component versions]].


<!-- THE END -->
%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.