EditAttachPrintable
r17 - 2016-05-03 - 23:37:31 - Main.tompYou are here: TWiki >  Deployment Web > DeploymentInstallingUpgradingAndMigrating > IBMQuickDeployer > IBMQuickDeployerSetupAndRun > IBMQuickDeployerComponentVersionSetup

IBM Quick Deployer component version setup updated.png

Authors: ThomasPiccoli, KennethThomson, JenniferLiu, KenTessier, ClareCarty
Build basis: CLM 6.0, CLM 6.0.x, CE 6.0.x

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
  2. 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
  3. Assign execute permission to the {agent install dir}/agent/opt/udclient/udclient script
  4. Assign execute permission to the versionUnzip.sh script
  5. ensure JAVA_HOME is set. If not export JAVA_HOME={location of your jre} (e.g. /usr/lib/jvm/jre)
  6. ensure UCDCLIEXE is set. If not export UCDCLIEXE={location of your udclient exe} (e.g. /opt/ibm-ucd/agent/opt/udclient/udclient)
  7. Execute the versionUnzip.sh script
    The script expects 3 arguments as key=value pairs:
    • BASEFOLDER =base folder for expanding the scripts into (e.g. /media/QD)
    • APPLICATIONVERSION =ApplicationVersion (e.g. 602)
    • COMPONENTVERSION =ComponentVersion (e.g. 6.0.2.0)
      - 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.
      - 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)

          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
         
  8. Ensure you are in the folder where you expanded the IBM Quick Deployer installation package eg /media/QD
  9. Ensure the following files are present
    • componentVersionImport.sh
    • versionImport.sh
  10. Assign execute permission to the componentVersionImport.sh and versionImport.sh scripts
  11. Execute the versionImport.sh script
    The script expects 6 arguments as key=value pairs:
    • USERNAME =UCDAdminUserName
    • USERPASSWORD =UCDAdminUserPassword
    • UCDSERVER =UCDURL (e.g. https://UCDHostName:8443)
    • BASEFOLDER =base folder containing the expanded scripts to import (e.g. /media/QD)
    • APPLICATIONVERSION =ApplicationVersion (e.g. 602)
    • COMPONENTVERSION =ComponentVersion (e.g. 6.0.2.0)
      - 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.

          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
         

  12. 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

      confirm version



      confirm content

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
  2. Copy the supplied versionUnzip.sh script onto the UCD server in folder /media/component-source. (better script coming soon)
  3. 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.

        cd /media/component-source
    
        chmod 755 versionUnzip.sh
    
        ./versionUnzip.sh
       

    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).

    extracted files

  4. Copy the supplied versionImport.sh script onto the UCD server in folder {agent install dir}/agent/opt/udclient.
  5. 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

    The output will look similar to the image below for a 6.1.1.6 UCD server:
        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
    }
    
       

== end of old bit ==

Miscellaneous

Notes:

  • Throughout the IBM Quick Deployer wiki the screen captures are for reference only.
    In some cases if the functionality they display has not changed in the latest release they will be from a previous release

Related topics:

External links:

Additional contributors: MichelleCrane, NathanBak, ChristianLopez

Edit | Attach | Printable | Raw View | Backlinks: Web, All Webs | History: r20 < r19 < r18 < r17 < r16 | More topic actions...
 
This site is powered by the TWiki collaboration platformCopyright © by the 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.
Ideas, requests, problems regarding the Deployment wiki? Create a new task in the RTC Deployment wiki project