Thursday, 15 January 2015

IBM Operational Decision Manager 8.6 - Templates and Response Files

So this is another update to my previous notes re IBM ODM 8.6: -





I learned a few more things this week.

In no particular order: -

ODM 8.6 needs to be installed AFTER one has previously installed IBM Installation Manager, WebSphere Application Server etc.

In other words, one has to have this: -

/opt/IBM/InstallationManager/eclipse/tools/imcl listInstalledPackages

com.ibm.cic.agent_1.8.1000.20141126_2002
com.ibm.websphere.ND.v85_8.5.5004.20141119_1746


( other versions are permissible, providing that ODM supports them )

before one can install ODM.

If WAS is not installed, bad things (TM) occur, specifically this exception: -

ERROR: The following errors were generated while installing.
  CRIMA1209E ERROR: Validation failed for property user.wodm_was_home.
    ERROR: The selected location does not exist, or is not a directory.

    Explanation: The selected location does not exist, or is not a directory.

    User Action: 


which confused me totally because I did have the property user.wodm_was_home set in my response file ( see below ).

Here's the snippets of the response file that I used to install WAS: -

...
<repository location='/tmp/Repo/WAS85/Base/Product/'/>
<repository location='/tmp/Repo/WAS85/Base/Fixes/'/>

...
<profile id='IBM WebSphere Application Server V8.5' installLocation='/opt/IBM/WebSphere/AppServer'>
<data key='eclipseLocation' value='/opt/IBM/WebSphere/AppServer'/>
<data key='user.import.profile' value='false'/>
<data key='cic.selector.os' value='linux'/>
<data key='cic.selector.arch' value='x86'/>
<data key='cic.selector.ws' value='gtk'/>
<data key='cic.selector.nl' value='en'/>
</profile>

...
<install modify='false'>
<offering id='com.ibm.websphere.ND.v85' version='8.5.5004.20141119_1746' profile='IBM WebSphere Application Server V8.5' features='core.feature,ejbdeploy,thinclient,embeddablecontainer,com.ibm.sdk.6_64bit' installFixes='none'/>
</install>
...

and here's the corresponding snippets of the response file that I used to install ODM Decision Center: -

...
    <repository location='/tmp/Repo/ODM86/Product/DC'/>
...
  <profile id='Operational Decision Manager V8.6' installLocation='/opt/IBM/ODM86'>
    <data key='eclipseLocation' value='/opt/IBM/ODM86'/>
    <data key='user.import.profile' value='false'/>
    <data key='cic.selector.os' value='linux'/>
    <data key='cic.selector.arch' value='x86_64'/>
    <data key='cic.selector.ws' value='gtk'/>
    <data key='user.lic.dsr' value='full'/>
    <data key='user.prod.dsr' value='false'/>
    <data key='user.lic.dc' value='full'/>
    <data key='user.wodm_was_home' value='/opt/IBM/WebSphere/AppServer'/>
    <data key='user.wodm_admin_password' value='passw0rd'/>
    <data key='user.wodm_admin_username' value='wasadmin'/>
    <data key='user.confirm_password' value='passw0rd'/>
    <data key='cic.selector.nl' value='en'/>
  </profile>
  <install modify='false'>
    <!-- Decision Center 8.6.0.0 -->
    <offering profile='Operational Decision Manager V8.6' id='com.ibm.websphere.odm.dc.v86' version='8.6.0.20140507_2334' features='jdk,base,Decision Center,Rule Solutions for Office,com.ibm.wdc.rules.samples.feature,Documentation' installFixes='none'/>
  </install>
...

Installing Decision Center does NOT install the required WAS profile templates

Post-installation, there's NOTHING in: -

/opt/IBM/WebSphere/AppServer/profileTemplates/

pertaining to ODM, which makes it difficult to create a Deployment Manager profile for a Decision Center environment, which uses the following template: -

templatePath=/opt/IBM/WebSphere/AppServer/profileTemplates/rules/management/dc/

In other words, the manageprofiles.sh command will fail.

Installing Decision Server DOES install the required templates - for DS itself :-)

This is the snippet from the response file that I used to install ODM Decision Server: -

...
    <repository location='/tmp/Repo/ODM86/Product/DC'/>
    <repository location='/tmp/Repo/ODM86/Product/DecisionServerRules'/>

...
  <profile id='Operational Decision Manager V8.6' installLocation='/opt/IBM/ODM86'>
    <data key='eclipseLocation' value='/opt/IBM/ODM86'/>
    <data key='user.import.profile' value='false'/>
    <data key='cic.selector.os' value='linux'/>
    <data key='cic.selector.arch' value='x86_64'/>
    <data key='cic.selector.ws' value='gtk'/>
    <data key='user.lic.dsr' value='full'/>
    <data key='user.prod.dsr' value='false'/>
    <data key='user.lic.dc' value='full'/>
    <data key='user.wodm_was_home' value='/opt/IBM/WebSphere/AppServer'/>
    <data key='user.wodm_admin_password' value='passw0rd'/>
    <data key='user.wodm_admin_username' value='wasadmin'/>
    <data key='user.confirm_password' value='passw0rd'/>
    <data key='cic.selector.nl' value='en'/>
  </profile>
  <install modify='false'>
    <offering profile='Operational Decision Manager V8.6' id='com.ibm.websphere.odm.ds.rules.v86' version='8.6.0.20140507_2359' features='com.ibm.wds.jdk.feature,base,com.ibm.wds.rules.studio.feature,com.ibm.wds.rules.res.feature,com.ibm.wds.rules.samples.feature,com.ibm.wds.updatesites.feature,com.ibm.wds.doc.feature' installFixes='none'/>
  </install>

...

IBM do package the templates for BOTH DC and DS as part of the ODM download

As evidenced here: -

Decision Server Rules for Linux 32/64 bits (IM Repository) V8.6 Multilingual Multiplatforms (Optional) CIZ97ML
Decision Server Events for Linux 32/64 bits (IM Repository) V8.6 Multilingual Multiplatforms (Optional)  CIZ98ML
Decision Center for Linux 32/64 bits (IM Repository) V8.6 Multilingual Multiplatform (Optional) CIZ99ML


One can create a single response file to install DC, DS *AND* the required WAS profile templates

As per the following excerpt: -

...
    <repository location='/tmp/Repo/ODM86/Product/DC'/>
    <repository location='/tmp/Repo/ODM86/Product/DecisionServerRules'/>
    <repository location='/tmp/Repo/ODM86/Product/ProfileTemplateDC'/>
    <repository location='/tmp/Repo/ODM86/Product/ProfileTemplateRules'/>

...
  <profile id='Operational Decision Manager V8.6' installLocation='/opt/IBM/ODM86'>
    <data key='eclipseLocation' value='/opt/IBM/ODM86'/>
    <data key='user.import.profile' value='false'/>
    <data key='cic.selector.os' value='linux'/>
    <data key='cic.selector.arch' value='x86_64'/>
    <data key='cic.selector.ws' value='gtk'/>
    <data key='user.lic.dsr' value='full'/>
    <data key='user.prod.dsr' value='false'/>
    <data key='user.lic.dc' value='full'/>
    <data key='user.wodm_was_home' value='/opt/IBM/WebSphere/AppServer'/>
    <data key='user.wodm_admin_password' value='passw0rd'/>
    <data key='user.wodm_admin_username' value='wasadmin'/>
    <data key='user.confirm_password' value='passw0rd'/>
    <data key='cic.selector.nl' value='en'/>
  </profile>
  <install modify='false'>
    <!-- Decision Center 8.6.0.0 -->
    <offering profile='Operational Decision Manager V8.6' id='com.ibm.websphere.odm.dc.v86' version='8.6.0.20140507_2334' features='jdk,base,Decision Center,Rule Solutions for Office,com.ibm.wdc.rules.samples.feature,Documentation' installFixes='none'/>
    <!-- Decision Center profile templates for WebSphere Application Server   8.6.0.0 -->
    <offering profile='Operational Decision Manager V8.6' id='com.ibm.websphere.odm.pt.dc.v86' version='8.6.0.20140508_0103' features='main.feature' installFixes='none'/>
    <!-- Decision Server Rules 8.6.0.0 -->
    <offering profile='Operational Decision Manager V8.6' id='com.ibm.websphere.odm.ds.rules.v86' version='8.6.0.20140507_2359' features='com.ibm.wds.jdk.feature,base,com.ibm.wds.rules.studio.feature,com.ibm.wds.rules.res.feature,com.ibm.wds.rules.samples.feature,com.ibm.wds.updatesites.feature,com.ibm.wds.doc.feature' installFixes='none'/>
    <!-- Rules profile templates for WebSphere Application Server  8.6.0.0 -->
    <offering profile='Operational Decision Manager V8.6' id='com.ibm.websphere.odm.pt.rules.v86' version='8.6.0.20140508_0104' features='main.feature' installFixes='none'/>
  </install>
...

I've not yet worked out what one gets for DS, over and above the default DS installation, but c'est la vie.

So in the full installation of BOTH DS and DS plus the profile templates, this is what I get: -

/opt/IBM/InstallationManager/eclipse/tools/imcl listInstalledPackages

com.ibm.cic.agent_1.8.1000.20141126_2002
com.ibm.websphere.ND.v85_8.5.5004.20141119_1746
com.ibm.websphere.odm.dc.v86_8.6.0.20140507_2334
com.ibm.websphere.odm.ds.rules.v86_8.6.0.20140507_2359
com.ibm.websphere.odm.pt.dc.v86_8.6.0.20140508_0103
com.ibm.websphere.odm.pt.rules.v86_8.6.0.20140508_0104

and, in terms of templates, I now have templates for BOTH: -

ls -al /opt/IBM/WebSphere/AppServer/profileTemplates/rules/management

total 16
drwxr-xr-x. 4 wasadmin wasadmins 4096 Jan 15 14:14 .
drwxr-xr-x. 8 wasadmin wasadmins 4096 Jan 15 14:14 ..
drwxr-xr-x. 4 wasadmin wasadmins 4096 Jan 15 14:14 dc
drwxr-xr-x. 4 wasadmin wasadmins 4096 Jan 15 13:13 ds

Finally, for the record, here's what I had to start with, including WAS 8.5.5.4: -

/opt/IBM/InstallationManager/eclipse/tools/imcl listAvailablePackages -repositories /tmp/Repo/WAS85/Base/Product/,/tmp/Repo/WAS85/Base/Fixes/,/tmp/Repo/ODM86/Product/DC,/tmp/Repo/ODM86/Product/DecisionServerRules,/tmp/Repo/ODM86/Product/ProfileTemplateRules,/tmp/Repo/ODM86/Product/ProfileTemplateDC

com.ibm.websphere.ND.v85_8.5.0.20120501_1108
com.ibm.websphere.BASE.v85_8.5.5004.20141119_1746
com.ibm.websphere.BASETRIAL.v85_8.5.5004.20141119_1746
com.ibm.websphere.DEVELOPERS.v85_8.5.5004.20141119_1746
com.ibm.websphere.DEVELOPERSILAN.v85_8.5.5004.20141119_1746
com.ibm.websphere.EXPRESS.v85_8.5.5004.20141119_1746
com.ibm.websphere.EXPRESSTRIAL.v85_8.5.5004.20141119_1746
com.ibm.websphere.ND.v85_8.5.5004.20141119_1746
com.ibm.websphere.NDDMZ.v85_8.5.5004.20141119_1746
com.ibm.websphere.NDDMZTRIAL.v85_8.5.5004.20141119_1746
com.ibm.websphere.NDTRIAL.v85_8.5.5004.20141119_1746
com.ibm.websphere.odm.dc.v86_8.6.0.20140507_2334
com.ibm.websphere.odm.ds.rules.v86_8.6.0.20140507_2359
com.ibm.websphere.odm.pt.rules.v86_8.6.0.20140508_0104
com.ibm.websphere.odm.pt.dc.v86_8.6.0.20140508_0103


with the details: -

/opt/IBM/InstallationManager/eclipse/tools/imcl listAvailablePackages -repositories /tmp/Repo/WAS85/Base/Product/,/tmp/Repo/WAS85/Base/Fixes/,/tmp/Repo/ODM86/Product/DC,/tmp/Repo/ODM86/Product/DecisionServerRules,/tmp/Repo/ODM86/Product/ProfileTemplateRules,/tmp/Repo/ODM86/Product/ProfileTemplateDC -features

com.ibm.websphere.ND.v85_8.5.0.20120501_1108 : core.feature,ejbdeploy,thinclient,embeddablecontainer,samples,liberty,com.ibm.sdk.6_32bit,com.ibm.sdk.6_64bit
com.ibm.websphere.BASE.v85_8.5.5004.20141119_1746 : core.feature,ejbdeploy,thinclient,embeddablecontainer,samples,com.ibm.sdk.6_32bit,com.ibm.sdk.6_64bit
com.ibm.websphere.BASETRIAL.v85_8.5.5004.20141119_1746 : core.feature,ejbdeploy,thinclient,embeddablecontainer,samples,com.ibm.sdk.6_32bit,com.ibm.sdk.6_64bit
com.ibm.websphere.DEVELOPERS.v85_8.5.5004.20141119_1746 : core.feature,ejbdeploy,thinclient,embeddablecontainer,samples,com.ibm.sdk.6_32bit,com.ibm.sdk.6_64bit
com.ibm.websphere.DEVELOPERSILAN.v85_8.5.5004.20141119_1746 : core.feature,ejbdeploy,thinclient,embeddablecontainer,samples,com.ibm.sdk.6_32bit,com.ibm.sdk.6_64bit
com.ibm.websphere.EXPRESS.v85_8.5.5004.20141119_1746 : core.feature,ejbdeploy,thinclient,embeddablecontainer,samples,com.ibm.sdk.6_32bit,com.ibm.sdk.6_64bit
com.ibm.websphere.EXPRESSTRIAL.v85_8.5.5004.20141119_1746 : core.feature,ejbdeploy,thinclient,embeddablecontainer,samples,com.ibm.sdk.6_32bit,com.ibm.sdk.6_64bit
com.ibm.websphere.ND.v85_8.5.5004.20141119_1746 : core.feature,ejbdeploy,thinclient,embeddablecontainer,samples,com.ibm.sdk.6_32bit,com.ibm.sdk.6_64bit
com.ibm.websphere.NDDMZ.v85_8.5.5004.20141119_1746 : core.feature,thinclient,com.ibm.jre.6_32bit,com.ibm.jre.6_64bit
com.ibm.websphere.NDDMZTRIAL.v85_8.5.5004.20141119_1746 : core.feature,thinclient,com.ibm.jre.6_32bit,com.ibm.jre.6_64bit
com.ibm.websphere.NDTRIAL.v85_8.5.5004.20141119_1746 : core.feature,ejbdeploy,thinclient,embeddablecontainer,samples,com.ibm.sdk.6_32bit,com.ibm.sdk.6_64bit
com.ibm.websphere.odm.dc.v86_8.6.0.20140507_2334 : Decision Center,com.ibm.wbdm.dts.tomcat.feature,com.ibm.wbdm.dts.jboss.feature,com.ibm.wbdm.dts.weblogic.feature,Rule Solutions for Office,com.ibm.wdc.rules.samples.feature,Documentation,jdk,base
com.ibm.websphere.odm.ds.rules.v86_8.6.0.20140507_2359 : com.ibm.wds.jdk.feature,com.ibm.wds.rules.studio.feature,com.ibm.wds.rules.scorecard.feature,com.ibm.wds.rules.res.feature,com.ibm.wds.rules.res.tomcat.feature,com.ibm.wds.rules.res.jboss.feature,com.ibm.wds.rules.res.weblogic.feature,com.ibm.wds.rules.samples.feature,com.ibm.wds.updatesites.feature,com.ibm.wds.doc.feature,base
com.ibm.websphere.odm.pt.rules.v86_8.6.0.20140508_0104 : main.feature
com.ibm.websphere.odm.pt.dc.v86_8.6.0.20140508_0103 : main.feature

and this is with what I ended up: -

/opt/IBM/InstallationManager/eclipse/tools/imcl listInstalledPackages

com.ibm.cic.agent_1.8.1000.20141126_2002
com.ibm.websphere.ND.v85_8.5.5004.20141119_1746
com.ibm.websphere.odm.dc.v86_8.6.0.20140507_2334
com.ibm.websphere.odm.ds.rules.v86_8.6.0.20140507_2359
com.ibm.websphere.odm.pt.dc.v86_8.6.0.20140508_0103
com.ibm.websphere.odm.pt.rules.v86_8.6.0.20140508_0104

3 comments:

Michael Prendergast said...

dave,
I'd point out there are patches for ODM 8.6 out --
and it's much easier to install them as part of the base install -- patches = all (I think) and just add the repos , than add them later...

FYI I'm in the middle of doing this for an IIB run time where I want the DS console and the DC -- and I'm being told that 8.5.1 is the version of the IIB embedded one...
Keep up the good work, you are saving me heaps of time :-)
Mike -- I promise not to laugh, as you make my mistakes for me

Dave Hay said...

Morning Michael, thanks for your feedback, which is well made.

You're quite right, there are always going to be iFixes and fix packs for WAS, IHS, Plugin, IODM etc.

However, the point remains - one needs to install WAS before IODM, and the WAS templates do need to be considered.

Cheers, Dave

Michael Prendergast said...

your point is well made.
And even more importantly the fact that you have to install both the code and the profiles.. which sort of makes sense once you realise there are profiles for more than just wWAS, available.
It's not explicitly pointed out any where in the docs however, that I could find.
So your explicit documentation is much appreciated, as always