E
dit
A
ttach
P
rintable
r5 - 2017-07-31 - 20:18:49 - Main.ktessier
You are here:
TWiki
>
Deployment Web
>
DeploymentInstallingUpgradingAndMigrating
>
IBMQuickDeployerOld
>
IBMQuickDeployerSetupAndRunOld
>
IBMQuickDeployerUpdatingComponentArtifactsOld
<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/updated.png" alt="updated.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 [[IBMQuickDeployerUpdatingComponentArtifactsOld#Download_UrbanCode_Deploy_comp][Download UCD Component artifacts]]). * Expand the artifact.zip and replace or modify the files as appropriate (see section [[IBMQuickDeployerUpdatingComponentArtifactsOld#Expand_and_update_the_artifacts][Expand and update the artifacts]]). * Import a new version of the !UrbanCode Deploy component (see section [[IBMQuickDeployerUpdatingComponentArtifactsOld#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. In the !UrbanCode Deploy server, click *Components*; click the component that contains the change; then click *Versions*. You should see that the new version has been added to the component. <br/><br/><img src="%ATTACHURLPATH%/component-versions.png" alt="two versions of component"><br/><br/> 1. In the *Actions* column for the new version, click *Compare*. In the *Version* field, select the version to which you want to compare the new version, then click *Submit*. The list of files that contain differences is listed. <br/><br/><img src="%ATTACHURLPATH%/component-versions-compare1.png" alt="file differences"><br/><br/> 1. To see the differences within a specific file, click *Compare* <br/><br/><img src="%ATTACHURLPATH%/component-versions-compare2.png" alt="differences between two versions of a file"><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>
E
dit
|
A
ttach
|
P
rintable
|
V
iew topic
|
Backlinks:
We
b
,
A
l
l Webs
|
H
istory
: r5
<
r4
<
r3
<
r2
<
r1
|
M
ore topic actions
Deployment.IBMQuickDeployerUpdatingComponentArtifactsOld moved from Deployment.IBMQuickDeployerUpdatingComponentArtifacts on 2017-07-31 - 20:18 by Main.ktessier
-
Deployment
Deployment web
Planning and design
Installing and upgrading
Migrating and evolving
Integrating
Administering
Monitoring
Troubleshooting
Community information and contribution guidelines
Create new topic
Topic list
Search
Advanced search
Notify
RSS
Atom
Changes
Statistics
Web preferences
NOTE: Please use the Sandbox web for testing
Status icon key:
To do
Under construction
New
Updated
Constant change
None - stable page
Smaller versions of status icons for inline text:
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
.