Edit
Attach
P
rintable
r17 - 2016-05-03 - 23:37:31 - Main.tomp
You are here:
TWiki
>
Deployment Web
>
DeploymentInstallingUpgradingAndMigrating
>
IBMQuickDeployer
>
IBMQuickDeployerSetupAndRun
>
IBMQuickDeployerComponentVersionSetup
<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 <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 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=/opt/ibm-ucd/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/> ---++ Component script version setup (old - review ref only) 1. Copy the supplied component version compressed files onto the UCD server in folder */media/component-source*. (so the hard coded import script works, better script coming soon) * 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. Copy the supplied *versionUnzip.sh* script onto the UCD server in folder */media/component-source*. (better script coming soon) 1. SSH to the UCD server and switch to the */media/component-source* folder. Assign execute permission to the *versionUnzip.sh* script and run the script. <br/><br/> <verbatim> cd /media/component-source chmod 755 versionUnzip.sh ./versionUnzip.sh </verbatim> <br/>The folder should look like the image below after the script is run, (although the dates may be different and the compressed filenames are in the format name_60x_yyyymmdd-hhmm_artifacts.zip). <br/><br/><img src="%ATTACHURLPATH%/unzip01b.png" alt="extracted files"><br/><br/> 1. Copy the supplied *versionImport.sh* script onto the UCD server in folder *{agent install dir}/agent/opt/udclient*. 1. Switch to the *{agent install dir}/agent/opt/udclient* folder. Assign execute permission to the *versionImport.sh* and *udclient* scripts. The script expects 3 arguments, the UCD admin user name, the UCD admin password and the URL and port of the target UCD server. The script also expects the source files to be in folder */media/component-source*. Run the script <br/><br/>The output will look similar to the image below for a 6.1.1.6 UCD server: <br/> <verbatim> cd {agent install dir}/agent/opt/udclient chmod 755 versionImport.sh chmod 755 udclient ./versionImport.sh adminuser adminpassword ucdurl:port Application { "id": "9cd00ba4-16f7-424c-96f8-701d5ba522ce", "name": "6.0.0.0", "type": "FULL", "created": 1443178546234, "active": true, "archived": false, "sizeOnDisk": 0, "properties": [{ "id": "5efcdfc2-cae8-49af-8049-44b513d38378", "name": "versionHash", "value": "", "secure": false }], "propSheets": [{ "id": "fa58d5b4-fcee-4bd3-856e-58fd88d9be74", "path": "components\/e96ee3b8-2b96-4194-92b3-110c7f82b42e\/versions\/9cd00ba4-16f7-424c-96f8-701d5ba522ce\/propSheetGroup\/propSheets\/fa58d5b4-fcee-4bd3-856e-58fd88d9be74", "version": 1, "versionCount": 1, "commit": 0, "versioned": true, "propSheetDef": { "id": "b6a30dab-82a7-40bd-9145-bb9554454174", "path": "components\/e96ee3b8-2b96-4194-92b3-110c7f82b42e\/versionPropSheetDef", "version": 1, "versionCount": 1, "commit": 11, "resolveHttpValuesUrl": "property\/propSheetDef\/components%26e96ee3b8-2b96-4194-92b3-110c7f82b42e%26versionPropSheetDef.-1\/resolveHttpValues", "versioned": true }, "properties": [{ "id": "5efcdfc2-cae8-49af-8049-44b513d38378", "name": "versionHash", "value": "", "secure": false, "inherited": false }] }], "totalSize": 0, "totalCount": 0 } ApplicationServer { "id": "bea2371e-37ee-48e8-a626-d94608fb8cf4", "name": "6.0.0.0", "type": "FULL", "created": 1443178551417, "active": true, "archived": false, "sizeOnDisk": 0, "properties": [{ "id": "59a18ea2-037e-4476-a506-7363c1353359", "name": "versionHash", "value": "", "secure": false }], "propSheets": [{ "id": "7013a5bd-05e5-4170-bc97-7617522b1b30", "path": "components\/bb5f100c-d088-4e46-a8c9-6c43276c17dd\/versions\/bea2371e-37ee-48e8-a626-d94608fb8cf4\/propSheetGroup\/propSheets\/7013a5bd-05e5-4170-bc97-7617522b1b30", "version": 1, "versionCount": 1, "commit": 0, "versioned": true, "propSheetDef": { "id": "28bb0dd4-4169-4a95-ae4d-c00fa3a759a8", "path": "components\/bb5f100c-d088-4e46-a8c9-6c43276c17dd\/versionPropSheetDef", "version": 1, "versionCount": 1, "commit": 11, "resolveHttpValuesUrl": "property\/propSheetDef\/components%26bb5f100c-d088-4e46-a8c9-6c43276c17dd%26versionPropSheetDef.-1\/resolveHttpValues", "versioned": true }, "properties": [{ "id": "59a18ea2-037e-4476-a506-7363c1353359", "name": "versionHash", "value": "", "secure": false, "inherited": false }] }], "totalSize": 0, "totalCount": 0 } Database { "id": "1b51b770-db49-4d76-b6a6-a6783118eb80", "name": "6.0.0.0", "type": "FULL", "created": 1443178556278, "active": true, "archived": false, "sizeOnDisk": 0, "properties": [{ "id": "0c8ec719-e020-4ec3-90cc-54a09f704975", "name": "versionHash", "value": "", "secure": false }], "propSheets": [{ "id": "b6ad12db-18ca-49eb-837d-6c4c916fe789", "path": "components\/ecef9a81-cc1b-4bf0-b147-ad395c35246e\/versions\/1b51b770-db49-4d76-b6a6-a6783118eb80\/propSheetGroup\/propSheets\/b6ad12db-18ca-49eb-837d-6c4c916fe789", "version": 1, "versionCount": 1, "commit": 0, "versioned": true, "propSheetDef": { "id": "dc58e025-4829-42f5-bc9c-7206b88a6538", "path": "components\/ecef9a81-cc1b-4bf0-b147-ad395c35246e\/versionPropSheetDef", "version": 1, "versionCount": 1, "commit": 11, "resolveHttpValuesUrl": "property\/propSheetDef\/components%26ecef9a81-cc1b-4bf0-b147-ad395c35246e%26versionPropSheetDef.-1\/resolveHttpValues", "versioned": true }, "properties": [{ "id": "0c8ec719-e020-4ec3-90cc-54a09f704975", "name": "versionHash", "value": "", "secure": false, "inherited": false }] }], "totalSize": 0, "totalCount": 0 } InstallationManager { "id": "1f2934c0-30f3-4c74-8eca-6008790f1e19", "name": "6.0.0.0", "type": "FULL", "created": 1443178560778, "active": true, "archived": false, "sizeOnDisk": 0, "properties": [{ "id": "9a80e7ed-7436-4170-82e0-432cca667466", "name": "versionHash", "value": "", "secure": false }], "propSheets": [{ "id": "9e3b7fb5-9c20-459b-bd62-7c4543ee3bc5", "path": "components\/8e1b9b6c-8f83-4eb8-9999-7ca4ff6c7dd9\/versions\/1f2934c0-30f3-4c74-8eca-6008790f1e19\/propSheetGroup\/propSheets\/9e3b7fb5-9c20-459b-bd62-7c4543ee3bc5", "version": 1, "versionCount": 1, "commit": 0, "versioned": true, "propSheetDef": { "id": "f3607885-5a7f-41e5-84bf-d1757bddb666", "path": "components\/8e1b9b6c-8f83-4eb8-9999-7ca4ff6c7dd9\/versionPropSheetDef", "version": 1, "versionCount": 1, "commit": 11, "resolveHttpValuesUrl": "property\/propSheetDef\/components%268e1b9b6c-8f83-4eb8-9999-7ca4ff6c7dd9%26versionPropSheetDef.-1\/resolveHttpValues", "versioned": true }, "properties": [{ "id": "9a80e7ed-7436-4170-82e0-432cca667466", "name": "versionHash", "value": "", "secure": false, "inherited": false }] }], "totalSize": 0, "totalCount": 0 } SystemPre-Requisite { "id": "0c1ab668-0932-4f69-9bc5-2e2fe71ff4b5", "name": "6.0.0.0", "type": "FULL", "created": 1443178565166, "active": true, "archived": false, "sizeOnDisk": 0, "properties": [{ "id": "167277c8-e061-4a9c-a6a5-1f08f6fca76d", "name": "versionHash", "value": "", "secure": false }], "propSheets": [{ "id": "33979708-7110-45ad-a071-fc42e53117ac", "path": "components\/7788e308-64ab-469b-96a2-f72a67a022b2\/versions\/0c1ab668-0932-4f69-9bc5-2e2fe71ff4b5\/propSheetGroup\/propSheets\/33979708-7110-45ad-a071-fc42e53117ac", "version": 1, "versionCount": 1, "commit": 0, "versioned": true, "propSheetDef": { "id": "80c328be-bb26-4c2d-b751-87d9f7c5f2d8", "path": "components\/7788e308-64ab-469b-96a2-f72a67a022b2\/versionPropSheetDef", "version": 1, "versionCount": 1, "commit": 11, "resolveHttpValuesUrl": "property\/propSheetDef\/components%267788e308-64ab-469b-96a2-f72a67a022b2%26versionPropSheetDef.-1\/resolveHttpValues", "versioned": true }, "properties": [{ "id": "167277c8-e061-4a9c-a6a5-1f08f6fca76d", "name": "versionHash", "value": "", "secure": false, "inherited": false }] }], "totalSize": 0, "totalCount": 0 } </verbatim> <b> ==== end of old bit ==== </b> %INCLUDE{"IBMQuickDeployerInsertMiscellaneous"}% <sticky></div></sticky>
Edit
|
Attach
|
P
rintable
|
V
iew topic
|
Backlinks:
We
b
,
A
l
l Webs
|
H
istory
:
r20
<
r19
<
r18
<
r17
<
r16
|
More topic actions...
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
.