Share:|

Problem Statement:

AtriumCore 8.1 to 8.1 SP1 upgrade fails if the base stack has AR 8.1 Patch 1 or Patch 2 applied along with the Atrium Core Hot-fix as described in “Applying the Data Management hotfix” section of the ITSM Patch documentation "Patch2 for version 8.1.00: 8.1.00.001(and002)". This blog explains pre-upgrade steps to avoid the failure during AtriumCore 8.1 SP1 upgrade installation.

 

The Data Management hotfix adds two Fields on PCT:LoadProdModelVersion namely CompanyID (ID: 536870914) and CompanyInstanceID (ID: 536870913). In AtriumCore 8.1 SP1, upgrade installer corrects Field IDs of these fields to 420000166 and 420000179 respectively.

 

While upgrading from AtriumCore 8.1, in an environment where Data Management hotfix is applied, the 8.1 SP1 upgrade installation fails with following errors which you will see in the AtriumCore installation logs.

 

(Feb 25 2014 03:29:06.939 AM -0800),SEVERE,com.bmc.install.product.atriumfoundation.dsl.DSLRuleEngineInstallerExecutorTask,
  THROWABLE EVENT {Description=[Failed to execute Rule Engine 2],Detail=[[ERROR][Tue Feb 25 03:26:39.936] ImportFileNode- ARImport() for "pct_deplapp.def" returned non-zero return code 2
[ERROR][Tue Feb 25 03:26:39.936] ImportFileNode- 314 Field does not exist on current form PCT:ProductVersionJoin : <420000165>
[ERROR][Tue Feb 25 03:26:39.936] ImportFileNode- 392 Field/VUI name must be unique for the form -- there is already a field or VUI using this name CompanyID
[WARNING][Tue Feb 25 03:26:39.937] ImportFileNode- 55 The following item was not imported PCT:Product Cost LookUp
[WARNING][Tue Feb 25 03:26:39.937] ImportFileNode- 55 The following item was not imported PCT:ProductVersionPatchKey
[WARNING][Tue Feb 25 03:26:39.937] ImportFileNode- 55 The following item was not imported PCT:ProductVersionPatchJoin
[WARNING][Tue Feb 25 03:26:39.937] ImportFileNode- 55 The following item was not imported PCT:ProductAliasModVerLookUp
[WARNING][Tue Feb 25 03:26:39.937] ImportFileNode- 55 The following item was not imported PCT:Product M-V Uti Com LookUp
[WARNING][Tue Feb 25 03:26:39.937] ImportFileNode- 55 The following item was not imported PCT:ProductVersionJoin
[WARNING][Tue Feb 25 03:26:39.937] ImportFileNode- 55 The following item was not imported PCT:ProductAliasCPYAssocLookUp
[WARNING][Tue Feb 25 03:26:39.966] ImportFileNode- 55 The following item was not imported PCT:VersionStatusFlagsJoin








The installation fails due to the Field IDs clashing in AtriumCore 8.1 SP1. You can use following simple steps to avoid 8.1 SP1 upgrade failure.


In case you do not have Data Management Hot-fix then you may ignore these steps. You can directly proceed with 8.1 SP1 upgrade.


Solution:


From your ARSystem install directory, run the archgid to change the Field ID of following fields.


Form: PCT:LoadProdModelVersion field ID: 536870914 to 420000166

Form: PCT:LoadProdModelVersion field ID: 536870913 to 420000179

 

"archgid" program lets you change the internal ID of a form, field, VUI, or group within the AR System. 


The following is a sample command which you can use to change the field IDs. You will need to replace input values of –u, -p and –x.


archgid -c 2 -i 420000166 -s "PCT:LoadProdModelVersion" -f 536870914 -u "Demo" -p "" -x "cmdbqa.labs.bmc.com"
archgid -c 2 -i 420000179 -s "PCT:LoadProdModelVersion" -f 536870913 -u "Demo" -p "" -x "cmdbqa.labs.bmc.com"


-u    The name of an Admin user

-p    Password for the user specified

-a    Authentication string for the user specified.  For Windows where the NT domain is needed for login, this is the domain name.  Generally, this option is not needed.  If this value is omitted from the ommand line, a backup prompt is issued only if the user name is also prompted for.

-x    Name of the server the Field/Form is on

-t   TCP port, that the Server is used for communication.  This setting is not needed if the server is registered with port-mapper.  If this value is omitted from the command line, a backup prompt is issued only if the server name is also prompted for.


What if I have already run Atrium Core 8.1 SP1 and installation failed due to above reason?


In case you have already run installer of 8.1 SP1 and have encountered the installation failure with the same error mentioned above in log file snippet, then along with above steps you will need following extra clean-up steps to be carried out.


1) When installer fails for some reason, it creates an entry in SHARE:Application_Properties form with Property Name = “state” and Property value = “failed”. Search for such entry and delete it from SHARE:Application_Properties form.

 

2) Edit the AtriumCoreInstalledConfig.xml  from AtriumCore Install directory and remove the failed feature(s) from the FAILED section:


<name>FAILED_INSTALL_FEATURES</name>

Change <value>feature*</value>  to <value></value>


Delete the copies of this file from the %TEMP% folders. This is the same location where atriumcore_install_log.txt would be found.

You can re-run the AtriumCore 8.1 SP1 installer once you have successfully completed above clean-up steps.