MDM XU ReleaseNotes
MDM XU ReleaseNotes
1 of 22
Note: ** indicates issues that were in earlier releases that have been resolved in the Siperian Hub XU Patch B
release.
Oracle RAC
The rollup also includes:
Transactional multi-merge
All hot fixes from the previous releases have been rolled into this patch. Please review the resolved issues in XU Rollup Patch B and
the issues from earlier releases that are resolved in Siperian Hub XU Rollup Patch B (indicated with **).Please contact Siperian
Support for additional information about the new features in this rollup.
Important: New hot fixes for XU will be built only on top of XU Rollup Patch B.
General steps to upgrade to XU Patch B from XU Patch A (or an earlier patched version) are:
Upgrade the MRM Server using mrm server install command: hub_install.exe
Upgrade the MRM Cleanse using mrm cleanse-match install command: hub_cleanse_install.exe
Upgrade the Master using the command: sip_ant updatemasterdatabase
Upgrade the ORS using the command: sip_ant updateorsdatabase
If you use Platon AddressDoctor for address cleansing, you need to upgrade to AddressDoctor build 4.1.11.384 and update
your AddressDoctor data files to December 2007 or later. Please review the Install Guide for detailed instructions about how
2 of 22
Please note that there is no change to the Master database in this patch since XU Rollup Patch A.
Several issues reported by Customers on Oracle 10.2.0.1 and Oracle 10.2.0.2 were resolved by upgrading to Oracle 10.2.0.3.
For Oracle versions, our recommendation is to use Oracle 10.2.0.3. You should use JDBC driver 10.2.0.3 with Oracle
10.2.0.3 for all app servers, except IBM WebSphere.
Note: The Oracle JDBC driver 10.2.0.3 is incompatible with IBM WebSphere JRE 1.4.2 on Windows. You need to use the
Oracle JDBC driver 10.2.0.2 instead when using an Oracle 10.2.0.3 database with WebSphere.
If your ORS is not upgraded to XU Rollup Patch B, you will get the following warnings when you run MET validation against the ORS
and the schema will also fail to load in the console.
2
Warning SIP-PV-10108 System column 'GLOBAL_NOLOGGING_IND' in table 'C_REPAR_DB_RELEASE' is not found.
3
Warning SIP-PV-10108 System column 'GLOBAL_NOLOGGING_IND' in table 'C_REPOS_DB_RELEASE' is not found.
The javadocs in this XU Rollup Patch B are not up to date. Please contact Siperian Support to get the latest resource kit
software for the updated javadocs.
Back to top
17802: Invalid lookups are not rejected when "allow null foreign key" option enabled. This fix changes the following behavior
Old behavior: If you have Allow Null Fkey enabled:
- The valid values will be processed as per the lookup
- The NULL values will be processed as NULLs
- The invalid values will be processed as NULLs. We do not reject/provide warning for invalid lookup values
New behavior: If you have Allow Null Fkey enabled:
- The valid values will be processed as per the lookup
- The NULL values will be processed as NULLs
- The invalid values will be rejected
See Configuring Operational Record Stores in the Siperian Hub Administrators Guide for more information about the
lookup functionality.
Merge
17749: Consolidation_ind can be reset to 4 on child when merging parent regardless of whether the child is consolidated or
not if Requeue_On_Parent_merge_ind is set to 2 via the backend. Below is an example of a SQL script to update the
Requeue_On_Parent_merge_ind:
UPDATE C_REPOS_TABLE SET REQUEUE_ON_PARENT_MERGE_IND = 2 WHERE TABLE_NAME = '<BO_NAME>';
Old behavior: Supports the following two scenarios:
requeue_on_parent_merge_ind set to 0: does not queue any related children on parent merge.
requeue_on_parent_merge_ind set to 1: queues the related children if consolidation_ind is set to 2 only when parent records
are merged.
New behavior: Supports an additional scenario:
requeue_on_parent_merge_ind set to 2: queues the related children even if consolidation_ind is set to 1 or 2 when parent
records are merged.
See About Matching and Consolidating Data in the Siperian Hub Administrators Guide for more information about the
consolidation functionality.
This is a change in design to the Immutable Rowid Object, the description for the Immutable Rowid Object section has not been
updated in the Administrators Guide. The description should now say:
Immutable Rowid Object: Allows you to designate a source system as an immutable source, which means that records from that
source will beaccepted as unique and, once a record from that source has been fully consolidated, it will not be changedeven in
the event of a merge. Immutable sources are also distinct systems. All records are stored in the Siperian Hub as master records. For
all source records from an immutable source system, the consolidation indicator for Load and PUT is always 1 (consolidated record).
If REQUEUE_ON_PARENT_MERGE_IND is set to 2 on the child via the backend, the consolidation indicator will be set to 4
for the child record in the event of merging parent.
Note: When the requeue_on_parent_merge_ind is set to 2, it is not visible in the console. It is shown as unchecked.
SIF API
17583: PUT SIF API call should handle special characters automatically within the SIF call so that caller doesnt have to do it
explicitly.
This is a change in behavior.
Old behavior:
- Special characters have to be escaped
Special characters include \ ~
These characters had to escaped in the old behavior like this: \\ \ \~
New behavior:
- Special characters dont need to be escaped before making the API call. However, if you have custom code that
escaped special characters in the past, you would need to update your custom code to factor in the new behavior.
See the Siperian Hub SIF Guide for more information about the SIF functionality.
17728: Put SIF API needs to process null values like the CleansePut API, for example when no value is specified for a field, it should
be set to null. This is a change in behavior.
Old behavior:
Put fails when no value is specified to INT, NUMBER or DATE column. For example,
<q0:field>
<q0:stringValue/>
<q0:name>CONSUMER_ID</q0:name>
</q0:field>
<q0:field>
<q0:name>INT_COL</q0:name>
3 of 22
4 of 22
</q0:field>
<q0:field>
<q0:name>NUMBER_COL</q0:name>
</q0:field>
<q0:field>
<q0:name>DATE_COL</q0:name>
</q0:field>
New behavior: PUT goes through with NULL value in INT, NUMBER or DATE column.
Please note:
bigIntegerValue, bigDecimalValue, etc. are strongly typed elements. The format used below to set null values in those
elements is not valid.
The format used below is NOT valid:
<q0:field>
<q0:bigIntegerValue/>
<q0:name>INT_COL</q0:name>
</q0:field>
<q0:field>
<q0:bigDecimalValue/>
<q0:name>NUMBER_COL</q0:name>
</q0:field>
The format below is the valid way to insert null values for INT, NUMBER, etc.
<q0:field>
<q0:name>INT_COL</q0:name>
</q0:field>
<q0:field>
<q0:name>NUMBER_COL</q0:name>
</q0:field>
See the Siperian Hub SIF Guide for more information about the SIF API functionality.
17857: PUT/CLEANSE_PUT fails to insert a new record with default value in non-nullable varchar column.
17887: PUT/CLEANSE_PUT fails with default value in non-nullable date column.
17641 tokenize SIF API call fails to close the SSA connections properly.
17914: Compatibility issues to make SIF API request through .Net. since .Net has a different way of interpreting optional parameters
and null values.
Schema manager:
17561: Nullable value does not get set on the PRL if landing table is updated resulting in SIP-PV-10210 errors
17568: synch up staging column sequence number when the column sequence number changed in BO
17570: C_REPOS_CL_COL_PARAM not cleaned up when landing cols are dropped resulting in SIP-MV-11932 errors
17743: trust_ind not set on the staging properly if trust is disabled in the base object resulting in SIP-MV-10306 errors
Proxy User
17772: Auto link job fails when Proxy User is enabled
17748: Proxy_Role is missing for BO, VCT and CTL tables when running automerge with automerge_ctas is set to 1 (default is -1).
Performance
16937: Allow Transactional Multi-merge - multi-merge must treat the entire set of records to be merged as one batch.
16936: Performance Issues with PUT inside of Merge service. PUT performance has been optimized to reduce the latency of some
of the XREF updates.
16492: Further optimize the multi-merge performance by removing the unnecessary analyzing and parallel execution on temp tables.
Fixed the bad execution plan of the long running update on hfkm table.
HM
17271: Indirect search query constructed incorrectly in the SearchHMQuery call
17424: Changing Entity Direction in HM configuration causes Java Null Pointer Exception.
Environment Staging:
17553: The Environment Staging script (11_migration_repos_seq_keycount.sql) was not setting Oracle sequence numbers correctly
and caused constraint violation errors during data load (Load/Put).
17591: Sequence on GBID columns do not get created on the target schema
17482: Environment staging scripts do not create the STRP tables as IOT tables
5 of 22
18019: The Environment staging script 09_check_repository_vs_physical.sql ignores UTF8 settings when generating ALTER
statements for modified columns.
MET
17250, 17036: Fix SIP-MV-10218 Validation warnings that are reported incorrectly against the RMT, VOK and VPC columns on the
VCT, VXR and related History tables. Similarly, fix SIP-MV-10218 validation warnings that are reported incorrectly against the
Shadow key columns (S_*) on the XREF tables.
17432: Metadata Manager displays incorrect warning messages indicating that columns are not used.
17731: Update the SQL consistency check for Packages to address erroneous SIP-PV-10703 errors
17712: Remove duplicate shadow column check to address erroneous SIP-MV-10201 errors
Resource Kit:
17779: Updated the Deployment panel to clearly state that the user cannot use our deployment process if they choose not to deploy
the resource kit sample apps.
Others:
17610: Inconsistency - STRICT_IND is nullable in the hub metadata but not nullable in the database
17970: The datasource connection from WebSphere may give a connection failure error on the Oracle RAC. This is not a Siperian
issue; you will need to use the actual node name for the SID instead of the Oracle RAC instance name in the datasource connection
properties.
Back to top
like the User Guide, Admin Guide, and SIF Guide still say Siperian Hub XU on the version page.
The Group 1 Enterprise Server cleanse engine chapters in the UNIX and Windows Install Guides have been updated with
Group 1 CDQ 5 information.
17541: Javadocs are not up to date. Please get the latest resource kit software from Support for the updated javadocs.
Stage:
17770: Staging job fails when landing table has not nullable columns (varchar) with default value
Load:
17569: Load by rowid object rejects rows not found in XREF and HMRG table but doesn't populate %_REJ table if the landing table
is truncated.
17829: Endless loop in LOAD_MASTER standard_abort exception handler
Workaround: Run the metadata validation tool and manually recreate any missing constraints to avoid the error condition that leads
to this endless loop. Contact Siperian Support if you need more information or assistance.
18048: Records with null or invalid foreign keys will not get rejected if the relationship is based on unique keys and the lookup is
based on the primary Key of the XREF table. Users will only get a NO ACTION in such cases. These records will also not be inserted
into the Base Object.
Match:
17660: External Match result do not appear in Batch Group Logs Viewer
17548: The ruleset filter may cause an error to be thrown if there are records set to consolidation_ind=3 at the time of Match Job
execution.
Workaround: Reset the Base Object records to 4 and re-execute the Match Job.
6 of 22
17620: The Link Style MFD/PK_Match job may return a warning if you execute these jobs after running clean_table.
17663: The Link Style match job does not use the BVTB table.
Merge:
17890: _TMST temp tables are left behind after automerge process and automerge_ctas_ratio=1.
Workaround: manually drop these temp tables
17912: Temp tables are left behind after multi-merge call.
Workaround: This is by design; the caller should manually drop the temp tables.
Unmerge:
16154: Unmerge will not cascade to child records properly if the Child is loaded after parent merged. This is because the Child
HFKM table does not contain the metadata that links the Child records to the original Parent record. (Known issue from XU Patch A)
Merge Manager:
17814: "Accept All Records without a Match" affects records that aren't queued for merge.
API:
17684: API SearchQuery issue - need to pad parameter values for ROWID_OBJECT columns
HM:
17795: Load fails if HM relationship object columns are called rowid_bo1, bo2
Workaround: drop and recreate the relationship object, for example don't use rowid_bo1, rowid_bo2 as column names when
re-creating the relationship object.
17490: HM does not use security on Profiles
With the introduction of SAM in XU, there are no changes to the security functionality in any of the Data Steward tools (Data
Manager, Merge Manager, Hierarchy Manager). These tools generally don't use the APIs where security is enforced. They
make limited use of the security assignments:
- Data/Merge Manager - list of packages is limited by security roles. Ability to Merge is not constrained by security. Put is
the only API used - security is enforced there.
- Hierarchy Manager - list of profiles is limited by security roles. A user has access to a profile that he has any privileges on.
17499: New sandbox validation fails if "Validate Data" is checked
17384: The console does not stop the user from dropping columns from HM packages through the Package Manager. This may
cause issues during validation and in the HM UI later. In general, modifications to HM packages (for example dropping required
columns from the package) can result in the HM Package and also the HM unusable.
17515: NPE calling updateRelationship with invalid Hierarchy as part of record tag
MET Validation
17437: The metadata validation tool may report data length inconsistencies on system tables when run against a UTF8 database.
These warnings can be safely ignored.
17889: The MET tool does not report conditions that do not have outputs in the cleanse function UI. This will only happen if you
mapped the condition previously and then deleted the output from the condition in the cleanse functions UI.
The out put from MET will indicate a Fatal error in this case. Please contact Siperian Support if you get a Fatal error when validating
your ORS.
1
Fatal Error
SIP-PV-10000 Unable to load Siperian metadata.
Others:
17798: The ORS group name may disappear from the Security Workbench if the ORS group and user share the same name.
Workaround: Avoid using the same name for the User and the ORS Group.
17910: The Mapping UI/cleanse functions UI can fail to load if you have a mapping that has conditions without any outputs. This will
only happen if you mapped the condition previously and then deleted the output from the condition in the cleanse functions UI.
Workaround: drop and recreate this condition.
17797: Typo in creating a proxy user in Windows Hub installation guide.
17947: The Resource Kit is supported only on Windows. Please review the Resource Kit User Guide for more information about the
supported platforms.
Back to top
7 of 22
(and GA).
** Platon
17353: The AddressDoctor (Platon) December-2007 dataset is not supported in this Rollup Patch. You would need to use the
September Data files from Address Doctor with Platon Build 334.
** Hierarchy Manager
**17134: Cannot drop HM entity type object table because of constraints to HM node.
Workaround: Do not use the Remove option in the impact analysis screen to drop HM objects. Instead revert the HM objects to
regular base objects and then use the drop option from the Schema Manager.
MET Validation
17254: The MET Validation tool reports the SIP-MV-11903 warning incorrectly if you have HM Foreign Key Objects (for e.g.
SIP-MV-11903 HM package 'PCK_PROD_READ' does not contain all records from the underlying table)
17253: The MET Validation tool reports the SIP-MV-11931 warning incorrectly if you have HM Foreign Key packages (for e.g.
SIP-MV-11931 Required column 'REL_START_DATE' is not found in the package 'PCK_PROD_WRITE' of profile 'Default'
relationship type 'Manufactures')
** 17250, 17036: SIP-MV-10218 Validation warnings are reported incorrectly against the RMT, VOK and VPC columns on the VCT ,
VXR and related History tables even if trust is setup for the columns.
Similarly, SIP-MV-10218 validation warnings are reported incorrectly against the Shadow key columns (S_*) on the XREF tables
17265: The Validation tool does not report incorrect ROWID_PARENT values in History tables (SIP-MV-10219 )
17350: Metadata tool does not report views/packages that are invalid
17327: The Metadata tool does not report missing defaults on RAW/OPL/PRL
Merge
** 16937: Multi-merge must treat the entire set of records to be merged as one batch.
17125: History Viewer - Merge History Panel does not display the correct time.
Migration
16918, 17082: XU migration might take longer to process an update SQL in "2007050902_ldc_upd_tree_unmerge_struct_data.sql".
Oracle:
17398: The Oracle JDBC driver 10.2.0.3 is incompatible with IBM WebSphere JRE 1.4.2 on Windows. You need to use Oracle JDBC
driver 10.2.0.2 instead when using an Oracle 10.2.0.3 database with WebSphere. For more information, see: http://www.ibm.com
/developerworks/forums/dw_thread.jsp?forum=367&thread=172043&message=13980613&cat=10&
q=IBM+JDK+CERTIFICATON%3A+THIN+DRV+TEST+GOT+BAD+CONNECTIONS#13980613
** Performance
16936: Performance Issues with PUT inside of Merge service.
SIF API
12786: incorrect API privilege settings, clearAssignedUnmergedRecords API has READ privilege but it should have WRITE and the
unmerge API has WRITE but it should have MERGE
17120: describeSiperianObject API does not support BATCH_GROUP type.
17123: validateMetadata API does not return message in the response to indicate if the request is successful.
17087: The registerUsers API call does not set the default database for the new user, which causes a null pointer exception when
trying to login as that user.
17039: The SIF APIs fail if you provide the IP address in the hostname.
Workaround: Create an alias in the hosts files on Windows client and Solaris server.
16873: Records set as ON_HOLD by setRecordState API call cannot be seen from On Hold screen in Merge Manager.
17097: describeSiperianObject API for MATCH_RULE_SET and MATCH_COLUMN can be executed without privilege.
17110: describeSiperianObject API for HM-SANDBOX can be executed without privilege.
17121: HM APIs do not use the configurable column names.
17177: SearchMatchRequest API fails with error SIP-14105: Unexpected error processing request if a package is defined on an
XREF table instead of BO.
Workaround: Change the packages to be based on BO instead of XREF.
17184: SIF API cleanse call only works with EXECUTE privilege on BO mapping.
17215: getLookupValue API fails if Package UID & BO columns have only READ privileges.
17214: acceptUnmatchedRecordsAsUnique API can be executed with only BO UPDATE privilege.
17203: getUnmergedRecordCount API can be executed with only BO READ privilege.
17269: getBatchGroupStatus API returns incorrect runStatus when batchGroup fails.
17271: search query constructed incorrectly by the SearchHMQuery API. The API does not substitute ROWID_OBJECTs and code
columns correctly based on the Base Object settings.
Unmerge
8 of 22
16154: Unmerge will not cascade to child records properly if the Child is loaded after parent merged. This is because the Child
HFKM table does not contain the metadata that links the Child records to the original Parent record.
11981: Concurrent Unmerge on the same rowid_object is not supported.
15761: The Rowid_Object returned by Unmerge is not correct if you unmerge a subtree from the Data Manager. The stored
procedure returns the rowid_object correctly; the issue is in the GUI.
Other
16182: Custom buttons allow you to define buttons/functions that can be associated with any or all of Data, Merge, and Hierarchy
Managers. However, the code that fetches the functions for a specific tool always gets only the functions that are targeted for Data
Manager.
**16540: You might run into .Net (Visual Basic) compatibility issues when using Visual Basic applications.
17052: Integrity constraint violation when add/update privileges in Role if only Mappings is set to SECURE when in the SECURE
RESOURCE UI.
16739: NullPointerException from View that is built on top of C_REPOS_AUDIT in Query Manager.
17105: ORA-06502: PL/SQL: numeric or value error: associative array shape is not consistent with session parameters in the debug
log. This is an Oracle issue that has been fixed in Oracle 10.2.0.4. as stated in metalink Doc ID: Note:467688.1
16384: Old raw records might not be removed as expected when the retention period is reduced to certain days.
16307: The console currently allows Anti-match (not equal match) and null matches non-null as coexisting options. This is an invalid
combination.
**17363: Help Text on the Patch install screens refers to upgrading to XU GA instead of the XU Rollup Patch A. (The patch installer
for XU Patch B has been updated.)
Back to top
9 of 22
16904: Foreign Key constraint might get dropped from the base object after initial data load if CTAS is on.
16911: Refresh in Batch Viewer causes a NullPointerException if the batch operation is still in progress.
16942: The base object physical table may sometimes disappear when running match job if local / remote cleanse-match servers are
set off-line/on-line.
16974: MRM creates Message Queue connection without any credentials.
This is resolved in XU Rollup Patch A. To use this capability, you would need to add the following properties in
<SIP_HOME>\hub\server\resources\cmxserver.properties:
[jms connection factory jndi].qcf.username=[username]
[jms connection factory jndi].qcf.password=[encrypted password]
AND/OR
[jms connection factory jndi].ctx.username=[username]
[jms connection factory jndi].ctx.password=[encrypted password]
Note:
1. Password must be encrypted using blowfish
2. To encrypt a password, open cmd and cd C:\siperian\hub\server\lib\:
java -cp siperian-common.jar com.siperian.common.security.Blowfish password
16978: Manual merge is slow when a large amount of data needs to be updated in _HMXR table.
17011: The Prerequisites for Running the Migration scripts section in the environment staging doc has been updated to include
information about the C_REPOS_ERROR_MSG table.
17033: Unique constraint violations might happen when creating mappings after deletes of base object/staging tables.
17196: ExecuteBatchGroup Stored Procedure does not accept batchGroupID. The get_batchgroup_status, execute_batchgroup and
reset_batchgroup stored procs have been updated to accept batchgroupUID now.
17219: NullPointerException when non-admin user with read-execute privileges adds/updates entities in HM.
17226: Error reverting HM BO when trust is enabled.
17299: Out of Memory errors when executing cleanse against WebSphere. This may happen because the 9i Oracle helper class is
used in the data source by default.
Workaround: WebSphere customers should make sure that the right helper class is being used in the datasource. For example, if
you are executing against a 10g database, use the 10g oracle helper class in the datasource.
17331: add SHOW_VERSION to cmxdb package
17338: special characters cause issues in cleanse put call
Back to top
Master Reference Manager (MRM) The foundation and core product that consolidates multiple customer profiles to
better identify customers uniquely across all channels, thereby increasing the accuracy and reliability of customer reference
data to all systems.
Optionally, you can separately license either or both of the following products:
Hierarchy Manager (HM) Delivers reliable and consolidated customer relationship views that enable organizations to
navigate, analyze, and manage relationships across multiple hierarchies from disparate sources
Activity Manager (AM) Evaluates data events, synchronizes master data, and delivers unified views of reference and
activity data from disparate sources
These release notes cover the following topics:
Whats New
Before Installing
Troubleshooting Tips
Known Issues
Back to top
Whats New
For Siperian MRM
Metadata Validation
Workflow Integration
10 of 22
Cleanse Adaptors
Match, Link, and Merge Enhancements
Performance and Scalability
Hierarchy Management
Batch Groups
Schema Viewer
Installer Enhancements
New Environments
Sample Schema
Full support for Oracle RAC 10gR2
For Siperian HM
Creation of Entity and Relationship Base Objects within the HM Configuration Tool
AM Rules API
Siperian Hub enhancements that affect all products
Before Installing
Installation requires that you acquire a license file from Siperian, so that the application will work properly. If you do not have the file,
you can continue with the install, but the application will not function until the information is provided. Contact Siperian support for
more information.
Note: Emulated environments such as VMware or Citrix are not supported under any configuration.
Hub Store
Hub Store requires the following hardware and software:
Hardware
Recommended
Processor (Intel)
2 CPUs @ 2.0 GHz Pentium 4 or equivalent *
Memory
2 Gigabytes
Hard Disk Space
Based on customer data
CD ROM
Yes
* The recommended minimum number of CPUs and minimum memory values are dependent on your data.
One of the following operating systems
Windows
HP-UX 11
Solaris 9
Solaris 10
Linux
AIX
Software
Supported versions
2003, XP sp2
11.11.0509. Only for WebSphere 6, you must apply the linker patch PHSS_33035.
5.9 Generic_118558-19 sub4u sparc
5.10 Generic_ 118833-03
SUSE 9 SP3, Red Hat Enterprise Linux AS
v4.3 (2.6.9-34.0.1.ELsmp)
5.3 (with the IBM JDK v 1.4.2)
Patch 5300-03
Supported versions
11 of 22
Oracle
9i (9.2.0.8), 10.2.0.3 - with database server and network client and SQL*Plus
(same release). For Oracle 9i, 10.2.0.x use the 10.2.0.2 driver. Several issues reported
by Customers on Oracle 10.2.0.1 and Oracle 10.2.0.2 were resolved by upgrading to
Oracle 10.2.0.3. You should use JDBC driver 10.2.0.3 with Oracle 10.2.0.3 for all
appservers, except IBM WebSphere.
Note: Oracle JDBC driver 10.2.0.3 is incompatible with IBM WebSphere JRE 1.4.2 on
Windows. You need to use Oracle JDBC driver 10.2.0.2 instead when using an Oracle
10.2.0.3 database with WebSphere.
Hub Server
Hub Server requires the following hardware and software:
Hardware
Recommended
Processor
2 CPU @ 2.0 GHz Pentium 4 or equivalent *
Memory
2 Gigabytes *
Hard Disk Space
300 MB
CD ROM
Yes
* The recommended minimum number of CPUs and minimum memory values are dependent on your data.
One of the following operating systems
Windows
HP-UX 11
Solaris 9
Solaris 10
Linux
AIX
Software
JDK
Supported versions
2003, XP sp2
11.11.0509. Only for WebSphere 6, you must apply the linker patch PHSS_33035.
5.9 Generic_118558-19 sub4u SPARC
5.10 Generic_118833-03
SUSE 9 SP3, Red Hat Enterprise Linux AS 32 or 64-bit
v4.3 (2.6.9-34.0.1.ELsmp)
5.3 (with the IBM JDK v 1.4.2)
Patch 5300-03
Supported versions
4.0.3 SP1
NOTE: JBoss is not supported on AIX platforms.
8.1.6 (Enterprise Edition required), 9.2
5.1.1.6, 6.1.0.3 (These are the only versions that are supported. Please
contact Siperian Support for more information.)
Supported
1.4.2_13 or 1.5
Supported versions
2003, XP sp2
11.11.0509. Only for WebSphere 6, you must apply the linker patch PHSS_33035.
5.9 Generic_118558-19 sub4u SPARC
5.10 Generic_118833-03
SUSE 9 SP3, Red Hat Enterprise Linux AS 32 or 64-bit
12 of 22
AIX
JDK
v4.3 (2.6.9-34.0.1.ELsmp)
5.3 (with the IBM JDK v 1.4.2 and Oracle 9205)
Patch 5300-03
Supported versions
4.0.3 SP1
NOTE: JBoss is not supported on AIX platforms.
8.1.6 (Enterprise Edition required), 9.2
5.1.1.6, 6.1.0.3
Supported versions
9i (9.2.0.8), 10.2.0.3 - with database server and network client and SQL*Plus
(same release). For Oracle 9i, 10.2.0.x use the 10.2.0.2 driver.
Note: Oracle JDBC driver 10.2.0.3 is incompatible with IBM WebSphere JRE 1.4.2 on
Windows. You need to use Oracle JDBC driver 10.2.0.2 instead when using an Oracle
10.2.0.3 database with WebSphere.
1.4.2_13 or 1.5
The Oracle client must be installed on every machine on which you wish to use Hub Cleanse Match. This Oracle client requires
Oracle Java utilities, so you must install these utilities on each machine on which you have Hub Cleanse Match as well. The Oracle
Client and Oracle Java utilities are part of your Oracle distribution.
You must also install SQL*Loader on each machine on which you use Hub Cleanse Match Server. SQL*Loader is part of your Oracle
distribution. On UNIX systems, the user that starts the application server for the system that hosts the Cleanse Match Server must
have Oracle in the path and Oracle home, base and SID defined in the environment variables.
Note: For large datasets, JVM 1.5 is recommended as it has superior memory management features.
Using the Platon Cleanse Engine
Important: Configure Platon to use CERTIFY mode, and not CORRECT_ONLY or CORRECT_CERTIFY.
To learn more, see your Platon documentation.
Hub Console
Hardware
Processor (Intel)
Memory
Hard Disk Space
CD ROM
Software
Windows
Sun JDK with Java WebStart
Recommended
1 CPU @ 2.0 GHz Pentium 4 or equivalent
1 Gigabyte
500MB
No
Supported
2003, XP sp2
1.4.2_13 and 1.5
(WebSphere 5.1.1.6 requires IBM JDK 1.4.2 for Client and
Server; WebSphere 6.1.0.3 requires IBM JDK 1.5 for Server,
JDK 1.4.2 or 1.5 for Client)
Back to top
Troubleshooting Tips
Admin Console
Use the following two properties in cmxserver.properties to configure initial heap size and maximum heap size for Java
Web Start with JBOSS.
jnlp.initial-heap-size=128m
jnlp.max-heap-size=192m
13 of 22
If you execute an auto match and merge job, it completes successfully with 1 job shown in the status. However, if you
stop and restart the application server and return to the batch viewer, you see a second job with a warning a few
seconds later. The second job is Siperian Hubs way of ensuring that either the base object is empty or there are no
more records to match.
Batch/Tuning
ANALYZE_BATCH_JOB_THRESHOLD:
This value is defined in the C_REPOS_TABLE, the default is 10000. If the number of records exceeds this threshold,
the load process will do the analysis.
PARALLEL_BATCH_JOB_THRESHOLD:
This value is defined in C_REPOS_TABLE, the default is 1000. The load process enables the parallel degree option if
the volume is greater than this threshold.
CASE_INDICATOR:
Case_indicator is a field on C_REPOS_TABLE. The field only applies to entries that correspond to Packages and is
used for Case insensitive searches in GetList and SearchQuery APIs. See API section below for more details.
Cleansing
When you refresh your external cleanse, Siperian Hub doesn't take the values from cmxcleanse.properties. So if you
change something in the properties file and refresh, the change you made is not reflected in the product. To fix this, run
postinstallsetup.
Do not use DeliveryAddressLines and Building input fields in the same mapping. DeliveryAddressLines are for "semistructured" data and would include the Building data.
Database Configuration
Creation of data sources on JBoss 4.0.3 SP1 takes a long time. This JBoss problem was introduced in the 3.2.4
release of JBoss
An exception may appear in the log files when registering the data sources on JBoss. This is caused by the
deficiencies in the deployment architecture on JBoss and results from the server trying to deploy twice. The system is
dealing with this situation gracefully.
The versions of MRM and your ORS must always match. A mismatch, such as an XU version of MRM with an XT
version ORS will cause exceptions.
Documentation
The Sample Tutorial Guide, mentioned in the various guides, is not included in this release.
Hierarchy Manager
When converting a base object to a relationship base object, HM does not use the existing column names, nor does
the interface give an option to select columns. For the relationship base object, HM creates the default column names.
HM has specific requirements for column names. This means that mappings may have to be reconfigured.
Install
When the cleanse server is not installed on the same application server as Hub, the datasources must be manually
created on the Cleanse server to take advantage of connection pooling and improved performance
By default, HP-UX does not enable SHLIB_PATH lookups for its executables and shared libraries. If shared libraries
are not found, even though you have them in your SHLIB_PATH environment variable, enable SHLIB_PATH. To
enable SHLIB_PATH for HPUX you must flip the bit that tells it to use the SHLIB_PATH by doing the following:
chatr +s enable filename
where filename is the name of the executable or shared library
Prior to installing Siperian Hub, install Oracle with all Java options selected.
Cleanse path will fail to load, if it exceeds 256 character or libraries.
Uninstallation of the Hub Server for WebSphere and JBoss users: When performing an uninstallation or reinstallation
of the Hub Server, check for the siperian-mrm-xs.ear ,siperian-mrm-362-was.ear, siperian-mrm-361-was.ear, or the
siperian-mrm-360-was.ear file and delete it if it was not deleted from the WebSphere repository or JBoss deployment
folder. You can do this through the WebSphere administration console. Also, check the subfolders of the installedApp
directory for the physical .ear file and delete it if it exists. When re-installing, if the application is installed in WebSphere
or if the physical .ear file exists, the Hub Server installer will not set up and deploy the new .ear file in the WebSphere
application server. You must then manually install and deploy the application. See the Install Guide for more
information.
When starting the WebSphere application server on an HP-UX system, you may see a java.lang.OutOfMemoryError
while deploying or starting up the application server after installation. To fix this, edit MaxPermSize in the
systemlaunch.properties file. This file is in the wasjmx.jar in the WebSphere lib directory. Set the MaxPermSize for
14 of 22
permanent generation space for the JVM to 128 Mbytes. The default value is 64 Mbytes and this may be insufficient for
your system.
If you are planning to run both the Hub Server and the Hub Cleanse within the same JBoss application server, you
need to follow the instructions in the installation guide to modify the JBoss default classloader.
JRockit JVM is not supported. Use Suns JDK when installing Siperian Hub on WebLogic.
If you install the supporting software (application servers, database, cleanse engines) with the default port settings,
you might find port conflicts on the following ports:
o
1099 (Trillium/JBoss)
o
8080 (Oracle Webservices/JBoss).
To fix this, you must change the conflicting ports.
To change the Trillium port:
1.
Change the Trillium port in the tril7v6\rmi\ports.txt file. Using port number 1069 works without conflicts.
2.
Run TrilServer.bat
To change the JBoss port:
1.
Change the JBoss port in the C:\jboss-4.0.3sp1\server\default\deploy\jbossweb-tomcatxx.sar\server.xml
Change the port from 8080 to 8888 as follows:
<!-- A HTTP/1.1 Connector on port 8080 -->
<Connector port="8888" address="${jboss.bind.address}"
maxThreads="150" maxHttpHeaderSize="8192"
minSpareThreads="25" maxSpareThreads="75"
enableLookups="false" redirectPort="8443" acceptCount="100"
connectionTimeout="20000" disableUploadTimeout="true"/>
2.
If you find this problem after you have done the installation, you must also change the port number in the mrm
server properties file. For instructions on how to do this, see the Troubleshooting section of the Siperian Hub
Installation Guide for your platform.
3.
Run postinstallseup.
Installing Siperian Hub on WebSphere and JBoss on the same machine causes a communication exception. To
address this, in your JRE/lib folder, the IBM Pluggable application client installs a file named "orb.properties". This file is
required for communication with the IBM WebSphere Application Server. However, it causes an exception when
communicating with other application servers, such as JBoss. The workaround is to delete or rename the
"orb.properties" file. This allows communication with JBoss. This file must be restored if communication with
WebSphere Application Server is required.
Hub Console fails when connecting to different WebSphere application servers. To address this, in the WebSphere
administration console, change the host property under Servers>ApplicationServers>your_server_name>End
Points>BOOTSTRAP_ADDRESS to the fully qualified domain name of your application server (E.g.:
server1.siperian.com). Save and restart the application server.
There is a known Oracle issue when executing setup_ors script on 9.2.0.6 on Solaris. When running loadjava, you may
get a JNI panic error. To address this, use the thin option in the setup/setup_ors script. For example: loadjava -thin
-user scott/tiger@myserver:1526:DEMO4536 pass.jar
The installer fails to add path environment variable if it exceeds 256 characters.
When you enter the unlock code for Platon in the install UI, an incorrect unlock code is saved into properties after
installation. If your unlock code has the $ or / characters, it might not get interpreted correctly by the UI.
To address this, after you complete the install process, edit the cmxcleanse.properties file so it correctly reflects your
unlock code.
JBoss
JBoss fails to start if the cmx_system user is named anything other then the default. This only applies to the JBoss
application server. If this happens, change the siperian-mrm-ds.xml file manually.
INTER_SYSTEM_TIME_DELTA_SEC:
If records in the landing table contain future times, even just a few seconds into the future, the stage process would set
that LAST_UPDATE_DATE in the staging table to 1/1/3000. And during the load process these records would not be
inserted or update base object tables.
The INTER_SYSTEM_TIME_DELTA_SEC can be used in such cases where there are discrepancies between the
Appserver machine and the database machine. This column is available on the C_REPOS_DB_RELEASE table. The
delta value specified in this column is in seconds and is used to calculate the last update date (LUD).
15 of 22
This setting only applies to the Stage process. The load does not use this setting.
Load Process
The threshold for parallel degree for loading is configurable. In the C_REPOS_TABLE, there is a column whose
value you can set to configure parallel degree for loading:
PARALLEL_BATCH_JOB_THRESHOLD the default value is 10000.
Logging
If you are using UNIX, debugging is turned on, and cmx_debug.log exceeds the UNIX file size limits, debug prints will
not appear in the log once you hit the 2G limit on UNIX.
Workaround: Move or delete cmx_debug.log.
Summary logging has been moved to the INFO level, so this information is available when logging is not set to the
DEBUG level.
Segment match values are case-sensitive. When using segment match on fuzzy and exact base objects, the values
the user sets are case-sensitive when executing the match process. This is different from the behavior in XS.
Property to enable large rowid_objects during Match:
Match
Message Queues
Support for direct IBM WebSphere queues has been discontinued in Siperian Hub XT. If you have already configured
IBM WebSphere queue in a previous Siperian Hub release, using IBM WebSphere, you must drop and create the
queue again with IBM WebSphere MQ through their JMS interfaces. To configure the queue with MRM see Using
Message Queues in the Siperian Hub Administrators Guide.
Migration
When you are migrating from one environment to another, if you do not have sufficient privileges, you may see the
following error on staging:
Current status: Couldn't start procedure execution: SIP-24200: Error: start_cleanse failed with ret_code:-20904,
errmsg:java.security.AccessControlException: the Permission (java.net.SocketPermission host resolve) has not been
granted to YOUR_ORS. The PL/SQL to grant this is dbms_java.grant_permission( 'YOUR_ORS',
'SYS:java.net.SocketPermission', 'host', 'resolve' ) [http://host:8088/cleanse/] Runtime Exception cmxcl.start_cleanse
You can avoid this by either giving the user running the stage job system privileges, or by running the following as a
sys or DBA user:
execute dbms_java.grant_permission(upper('YOUR_ORS'),'SYS:java.net.SocketPermission','*','connect,resolve');.
Here, YOUR_ORS is the name of your ORS.
In order for a non-admin user to see packages in the Data Manager, they must have permission to use the tool
assigned by the admin. Non-admin users must also be granted the roles for the put packages (both get and put).
Oracle
Merge can fail unexpectedly during Match processing if the Oracle TNS Listener refuses connections. This is a
known Oracle issue. To address this, increase the processes on Oracle.
The index on STRP becomes unusable after first load. This may happen due to an Oracle bug when upgrading from
9.2.0.1 to 9.2.05. Apply the catcio.sql
Incorrect Driver version: If you see pervasive errors in various places, Oracle JDBC Driver may need to be
updated to v. 10.2.0.2.0.
Parallel degree on Oracle 9i: The recommendation is for Customers to set Parallel=1 if they're on 9i the following
error may be thrown if Parallel > 1
ORA-12828: Can't start parallel transaction at a remote site
Other
You can receive an out of memory exception when you import a very large number of match strings. The number of
imported strings that will trigger this error depends on your data and the memory configuration of your machine(s).
It is recommended that you Use Certify mode only. This property is set in
<cleanse_match_home>/resources/cmxcleanse.properties (on UNIX) and <cleanse_match_home>\resources
\cmxcleanse.properties (on Windows)
Schema Manager
16 of 22
When importing a column of data type NCHAR of NVARCHAR, its length will be the byte size rather than the char
size. So, if you import a NVARCHAR column whose char length is 50, it becomes 100 when imported. To address this,
import the column and then change the length to the char size.
If you have two base objects (parent and child) with the child having a foreign key Rowid_Parent; when you create
a match column on Rowid_Parent on the child table with the exact same physical name that is stored in the base object
(Rowid_Parent) and attempt to use any child match column in an inter-table match in the parent table, it fails to save.
An exception displays Unable to commit matching table C_CHILD_STRP because there is already a match column
named Rowid_Parent. To address this, rename the Physical Name of the foreign key match column used in the child
match columns.
If you are using the data type varchar or char for double byte strings, you might receive a validation error during
PUT. To address this, use the data type nvarchar or nchar instead.
Unicode
WebSphere
If you are using the WebSphere application server, you may encounter a memory constraint when you deploy your
application. To fix this,
Windows
1.
Open the WebSphere ejbdeploy.bat file for editing. By default, this file is in: C:\Program Files\WebSphere
\AppServer\deploytool\itp\ejbdeploy.bat
2.
Edit the following line:
"%JAVA_HOME%\bin\java" -Dwebsphere.lib.dir="%WAS_HOME%\lib" -Dws.ext.dirs="%WAS_EXT_DIRS%" -cp
"%ejbd_cp%" -Xms256M -Xmx512M com.ibm.etools.ejbdeploy.EJBDeploy %*
3.
Add the arguments in bold (-Xms256M -Xmx512M).
4.
Save and close the ejbdeploy.bat file.
UNIX
1.
Open the WebSphere ejbdeploy.bat file for editing. By default, this file is in: /opt/WebSphere/AppServer
/deploytool/itp/ejbdeploy.sh
2.
Edit the following line:
$JAVA_CMD -Xms256m -Xmx512m -Dws.ext.dirs=$WAS_EXT_DIRS -Dwebsphere.lib.dir=$WAS_HOME/lib
-cp $ejbd_cp $EJBDEPLOY_JVM_OPTIONS com.ibm.etools.ejbdeploy.EJBDeploy "$@"
3.
Add the arguments in bold (-Xms256M -Xmx512M).
4.
Save and close the ejbdeploy.bat file.
WebLogic
SIF
When using the GETLIST verb and passing in a DATE datatype, the default format for Oracle is "DD/MM/YYYY
HH24:MI:SS"
On WebLogic, using cascade unmerge through SIF API can cause timeout errors. Fix this by setting the
Services/JTA/Timeout Seconds in the WebLogic app server.
As of XT SP1, null strings are handled in a consistent way between the PUT and GET verbs. Both PUT and GET
now represent an empty string as a NULL value.
Data is not merged if the PUT and MERGE verb calls are in the same transaction. To address this, when executing
the merge verb in a transaction, you must perform a commit before the merge verb is called if the data prior to the
17 of 22
SIF/Tuning
merge is required. The merge verb will not be able to see the changes from the PUT if done in the same transaction.
Execute the merge separately.
When using the SIF API with WebLogic, you may see the following exception thrown: OracleXAResource
XAException XAER_PROTO. This may be caused by connections being closed before a transaction is complete. To
address this, use the recommended Oracle driver.
The MATCH verb will fail if you set security ON. To address this, turn off security.
SIF ORS API Generation:
SIF ORS API generation can fail if you have bad metadata. For example, duplicate entries in
C_REPOS_CL_FUNCTION because of an old schema manager bug where we didnt drop the entries when a mapping
was dropped. The easiest way to clean this up would be to update the function name from the UI, see which entry it
updated in C_REPOS_CL_FUNCTION and remove the dupes that are not relevant.
METADATA_CACHING_ENABLED_IND:
Metadata caching is disabled by default on the CMX_SYSTEM and ORS. It can be enabled for the purpose of
improving XML/SIF API performance on a production machine.
To enable caching for the Master or ORS:
update c_repos_db_release set metadata_caching_enabled_ind=1;
To disable caching for the Master or ORS:
update c_repos_db_release set metadata_caching_enabled_ind=0;
After enabling or disabling caching, all MRM servers and MRM-Cleanse servers connected to that Master or ORS must
be restarted or reinitialized. If MRM metadata caching is enabled for the Master or an ORS, the Console can not be
used to make changes to the configuration, so trying to acquire a Write Lock on it will give an error dialog.
Back to top
18 of 22
(4 digit numbers represent support case IDs, 5 digit numbers internal requests)
3142, 3144: Process (job) flow capability added in the form of Batch Groups
2734:
Unmerge is now transactional
2769:
PL/SQL Error Message now transferred to the Error Message Box on MRM Console
2883:
Rule information now returned for exact match
3030:
Support for VARCHAR2(4000) from console UI now available
3148:
Open batch process nodes now do not collapse when you select another process
3241:
BO LUD now populated on insert of new record, not just on update
3326:
All "Analyze table" statements have been converted to dbms_stats.gather_table_stats for data
3057:
Unmerge merged BOs with XREFs now migrates old XREFs back to the original BO
3238:
Unmerge child on parent unmerge now works for children with multiple parents
3394:
Metadata Validation tool made available in the console
3577:
Now able to clone an existing landing to staging mapping for another source
3393:
Able to choose which Rule Set to use when executing Match Batch jobs
3497:
Metadata validation now identifies invalid constraints e.g. columns indexed twic
3581:
Match and Link support configurable at BO level
3382:
Fetch Many Hops Limit in HM is now customizable
3428:
Non-system errors can now be raised from user exits from HM screens
3880:
Ruleset can now be removed even if it's the only ruleset available
3140:
Lookup column is now nullable whenever allow null foreign keys is selected
4240:
SIF developer now has more control over transactions
4367:
Performance improved for multimerge
14763: Allow the ability to select a specific rule set during a Match Batch Job.
15033: Ability to have secure JNDI nodes
10500: Relationship viewer now shows show pkey_src_object and source system
10528: The upd by, created by, upd date cols are now displayed in the history viewer
13863: Metadata validation will check if the query sql is out of synch with the C_REPOS_QUERY_COL entries
Back to top
Known Issues
Note that all numbers listed below are Siperians internal Problem Incident Reporting system (PIR) tracking numbers. Please refer to
this number when making enquiries to Siperian Support.
19 of 22
20 of 22
documents. Users can find all Siperian documentation in the external documentation folder found on the CD or FTP site.
Please contact Siperian Support for more information.
Load Process
9933: Load process aborts rather than rejecting records with a date in the future. The assumption is that once records have
been staged, no invalid dates should exist in the staging table.
13337: Load can fail with a deadlock error. This is an Oracle bug that may happen on certain platforms (not all).
Workaround: Set Parallel=1 on the base object.
Match Process
Match Validate has been deprecated.
10298: The consolidation indicator is incorrect after a match executed with no rules set. This error is benign. The records
with the inaccurate consolidation indicator are picked up in subsequent match jobs.
10928: The ROWID_USER columns are not populated in the match table.
11412: If you have records on hold (consolidation indicator = 9), as from a Match Analyze operation, refining your match
rules should trigger the Reset Match, resetting the records that are on hold. This expected behavior does not happen.
Workaround: You must reset the consolidation indicator to 4.
12450: The generate match tokens process can fail with a stack overflow error when the match key (set in the match
columns UI) is set to a column of a child base object and that child base object contains approximately 500 or more records
that belong to a single parent record.
12829: If you are using a clustered WebLogic configuration, and you bring a managed server down while a job is in
progress, the job does not terminate. For stage and match jobs, an error code is written to the database log. For loads and
merges, an error is sent to the console.
Workaround: Mark the process as incomplete and redo the match
14065: If your tokenization table fails due to lack of tablespace, you will not be able to recreate it. You can manually solve
recreate the STRPT table with this command
alter index SVR1_7UW_TMP rename to SVR1_7UW
alter TABLE c_address_strp rename constraint SVR1_7UW_TMP to SVR1_7UW;
The index names are unique so they wont be the same every time.
Merge
12555: If you are using the WebLogic application server with Oracle 9i, have the Parallel Degree set to 4, and run an
automerge with match validate turned on, the following Oracle error will be thrown: ORA-12828: Can't start parallel
transaction at a remote site
Workaround: Set parallel degree to 1.
13043: In the Merge Manager, there can be an issue with the status of an unmerged in the following situation: if you have a
set of unmerged records and you click begin merge, all records are returned correctly under Unmerged tab. If you then
highlight the last row, click the button "change the status for the selected record", and click Put on hold, you may see
following message:
Index: 9, Size: 9. In the console log, there will be an error: [AWT-EventQueue-0] ERROR.
15813: Automerge in batch jobs fails if a base object has more than 200 columns. This is a limitation of automerge.
Currently Siperian supports up to 200 user columns in the automerge process.
Message Queues
6747: The Schema Manager doesn't allow you to select which columns you want to monitor on an Insert trigger rule as it
does for an update trigger.
13070: If you have message queues configured, operations in the schema manager can take a long time. The reason this is
that for each data change that is associated with a message queue message, the monitoring thread will query the message
package.
Workaround: Manage the volumes in the message queue tables.
16403: The event triggers do not exist for the new Link/Unlink feature functionality.
MET Validation
15411: When you upgrade a schema to XU and then do MET validation, the metadata manager check for views may not be
in synch with database views. MET will display a warning. The workaround for this is to re-save the query.
15788: During metadata validation on an upgrade from an earlier schema, MET does not validate all triggers properly. If a
trigger is invalid, the user cannot create or edit match columns in the schema.
15917: When you do metadata validation on a new schema, MET does not detect missing PROXY_ROLE privileges.
15918: During metadata validation MET does not detect tablespace related inconsistencies. This might happen if users
change the tablespace after the table is created.
16113: When upgrading any pre-XU schema, metadata validation may fail with invalid packages on the first attempt.
Workaround is to repeat the validation.
Migration
21 of 22
9645: When migrating from MRM 3.6.2 SP1 or Siperian Hub XR to Siperian Hub XS or above, Siperian Hub inserts dummy
values into the staging src_rowid. This will cause an error when populating the reject table. To correct this situation, repeat
the stage process to generate the correct src_rowid.
10392: The migration script does not remove legacy DataFlux pipelines.
11593: If youre migrating from XT to XU, you must resave your exact match rules to properly update the views correctly.
11621: If you are migrating from XR to XT SP2 and have Leave Match Hit enabled in the pipeline, after migration the
cleanse list setting for "Leave Match Hit" is incorrect.
Oracle
16144: In AIX, the database process is not getting released when the message queue message gets drained. The
workaround is to apply the patchset provided by Oracle. Download the patchset for this issue (Oracle version 10.2.0.3) from
the Oracle metalink: https://metalink.oracle.com/metalink/plsql/f?p=200:101:4830616257230449809&
notification_msg=Invalid%20Login%20Credentials/76A7A626D755801A6A7C8BDC44715B73/
ORS Users and Groups
9749: All ORS groups not listed due to unknown error. If the schema has multiple users in the C_REPOS_USER table that
do not exist in the CMX_SYSTEM you may see this behavior.
12324: For Global or Private Password Policies, the number of grace logins is ignored.
Other
9332: Removing the datasource from Siperian Hub does not remove the datasource entry from WebLogic.
10910: In a clustered environment, if the application server that received a request to match, stage, or generate tokens fails,
the match, stage or generate tokens job does not terminate.
Workaround: Terminate the jobs manually.
12555: A combination of WebLogic, Oracle 9i and Parallel Degree set to 4 may cause the following error to be thrown
during batch jobs: ORA-12828: Can't start parallel transaction at a remote site. This is due to an Oracle 9i issue that was
resolved in version 10g.
Workaround: Set the Parallel Degree to 1.
12764: In the metadata, the updated_by field of cmx_ors.c_repos_user is always set to CMX.
12767: When you update a user to assign a different ORS to that user, the update may not be reflected in the metadata.
13367: Datasources still exist after unregistering the database in WebSphere 6 application server. If no longer required,
users can manually remove them via the WebSphere Administrator Console
Roles
15560: SAM roles may be converted when upgrading from XT to XU. Verify permissions for roles after upgrade.
Schema Manager
Relationship tables have been deprecated. Use relationship base objects for this functionality instead.
6874: The default value is blank after you enable the Has Default check box. If you add a default value for one column,
and then enable the "Has Default" checkbox for the same column, the default value you entered is gone and the check box
is not enabled.
8857: If saving the match rules fails because of network outages or connectivity issues, the indexes may get dropped on the
STRP tables. Contact Siperian support.
10258: It is possible to create nonsensical match rules, such as a match rule with 1 exact match column with segment
match. Siperian Hub will not stop you from doing this.
10923: After creating a Staging Table, the "Edit Lookup Column" button is enabled for ALL columns but should only be
enabled for those which have a lookup defined.
16404: If GBID is enabled and an invalid length value is entered, the message returned by the UI states that a length of 100
is required. This is not true, a value of 255 is the expected length.
Security Access Manager
16118: Some changes to the Security Providers setup require a server restart in order to take effect other types of
changes do not. For example, changes to Login Modules (enable/disable, moving providers up and down) take effect
immediately, while changes User Profile and Authorization providers require a restart.
16310: When using SAM Role Report, there may be incorrect information given regarding rights from the parent role. This
only affects the report when you have multiple parent roles.
Siperian Sample
15613: To use the Siperian Sample installer and schema you must have a valid license for Hierarchy Manager in the Hub.
16237: When manually deploying the sipsample.ear file, the deployment name will be sipsample (${sip.version} build ####
release XU. This is a labeling issue and will not affect functionality and usage.
15980: Deployment of the Siperian Sample will fail if the Sample application is already deployed (upgrade/update).
Workaround: Manually undeploy the Siperian Sample application via the application server Console and rerun
postinstallsetup
22 of 22
Security
12296: When enabling Secure IIOP transfer (IIOPS), the ORBTC log file will grow drastically on the desktop where the
Siperian Console is launched - this is a known IBM WebSphere issue. Workaround: Add a fake certificate to the
SiperianKey JKS file.
Services Integration Framework (SIF)
7113: The GETLIST verb ignores the page size if the page number is 0. The number of rows returned default to the
GETLIST default page size (200). If the page number is 1 or greater, it returns the page size requested.
10330: When you use the PUT verb, Siperian Hub does not reject rows with an invalid value in the dep_rowid_system
column.
10981: When using the MATCH API call on an exact match base object without rule set/rules, the result message indicates
success when this is not the case.
10995: For an exact match base object, the rule number isn't included in the XML response message.
11859: Match verb fails if you have data group security on.
Workaround: Turn data group security off.
12015: The MATCH API disregards the value of the distinct system setting on the base object.
12805: You cannot use setRecordState within a transaction.
13013: One or more exact rules on a fuzzy base object dont return rows for FAUTO or FBOTH.
13371: The generation of ORS-specific SIF APIs fails if the JDK is not available in the classpath.
Workaround: Add the JDK to the classpath.
16287: The SAM privileges required to execute searchHMQuery request are HM Profile READ, Package (columns) READ.
In this release, removing the READ privileges on specific columns does not work properly i.e. all columns in the Package
are returned regardless of whether the User has column READ access or not. The workaround is to create a new
PACKAGE which only includes the required columns.
16251: The Multi-merge call cannot rollback changes because a commit takes place after every merge.
16377: The PUT API will fail when attempting to execute a PUT XREF with GBID enabled.
Tool Configuration
12767: When you re-assign users to an ORS using the USERS tool, the creator and the updated_by values are not
updated in the ORS.
Uninstall
15498: When using the uninstall feature of the Hub Server Installer, the uninstaller may hang while running the
patchinstall/uninstall script. Workaround is to reboot the machine.
Unmerge
11378: An unmerge process can fail because of resource contention, for example table locks. If the unmerged objects have
child objects, this unmerge failure can result in inconsistent child objects.
15400: Cascade unmerge ALL fails in a grandparent/parent/child scenario, a three-levels+ unmerge of records.
16154: If child records are loaded after merging parent records, the lineage data needed to cascade unmerge child records
will not be populated, which means the cascade unmerge for child records will not function.Contact Support for a user exit
workaround.
Unicode
10427: A base object column of type nvarchar or nchar is not available to be selected as a match column. Only varchar
columns are available to be match columns.
10434: If you have the regional font set to something other than English, when youre using the Mapping tool, the text on the
warning dialogs switches to the local language.
10438: If you are using unicode, the tokenization process might reject records where the combined length of the data in your
match columns exceeds 2000 characters.
10542: You cannot store dates in a non-English format for UTF8 data.
Users
5438: When you edit one user and click save, all users get saved.
XML API
Important: The XML API has been deprecated and is no longer available for use with new Hub implementations. This functionality is
superseded by the Services Integration Framework (SIF). More information about SIF can be found in the
Siperian_Hub_SIF_Guide.pdf available with your software download.