IBM® InfoSphere® Master Data Management Collaboration Server Version 10.0.0, Limited Release Interim Fix 1 is now available. This release notes document addresses system requirements, installation, and known problems.
InfoSphere MDM Collaboration Server provides a highly scalable, enterprise Product Information Management (PIM) solution. InfoSphere MDM Collaboration Server is the middleware that establishes a single, integrated, consistent view of products and services information inside and outside of an enterprise.
The following fixes were included in this limited availability interim fix as a result of an authorized program analysis report (APAR). You can search for and view existing APARs here: InfoSphere MDM Collaboration Server Support site. You can also review the associated PMR (if one is identified) for the fix, with the Electronic IBM Service Request tool Web site: Service Requests.
The following fixes were included in this limited availability interim fix as a result of issues that were discovered by the development team. If you want to learn more about one of these fixes, you can use the internal defect number for reference when speaking to someone from IBM Software Support:
You can review the release notes of previous maintenance releases for InfoSphere MDM Collaboration Server, version 10.0.0, to see what enhancements or product fixes were included previously:
| Fix Release | Release Date |
|---|---|
| fix pack 4 | 12/13/2012 |
| interim fix 3 | 10/08/2012 |
| fix pack 3 | 08/21/2012 |
| interim fix 2 | 06/28/2012 |
| fix pack 2 | 05/22/2012 |
| interim fix 1 | 04/25/2012 |
| fix pack 1 | 02/06/2012 |
For information about hardware and software compatibility, see the detailed system requirements document at: http://www.ibm.com/software/data/infosphere/mdm_server_pim/requirements.html.
Before you install this limited availability interim fix, you must take care of these important points:
The steps for installing this limited availability interim fix 1 include:
Step 1. Preparing to install the limited availability interim fix 1
Before you install the limited availability interim fix, make sure to complete these steps:
$TOP/bin/go/svc_control.sh --action=stop --svc_name=scheduler
$TOP/bin/go/svc_control.sh --action=short_status--svc_name=workflowengine
If no events are running, shut down the workflow engine manually by running the following shell script:
$TOP/bin/go/svc_control.sh --action=stop --svc_name=workflowengine
$TOP/bin/go/abort_local.sh Running the abort_local.sh shell script does not affect any of the other JVM services.
$TOP/bin/gdsmsg.sh stop Wait for a few minutes to allow GDS message listener to finish processing the messages that it has already picked up, and then run this script:
$TOP/bin/gdsmsg.sh abort The installation will overwrite your current files with updated versions from the limited availability interim fix 1. If any issues occur when installing the limited availability interim fix 1, you can use this backup copy to roll back the installation.
Step 2. Installing the limited availability interim fix
To install this limited availability interim fix, you must perform the following steps:
For example: $TOP/10.0.0-WS-MDMCS-LA001.tgz
cd $TOP
chmod -R 755 $TOPFor example, when using the GNU tar utility, the following command extracts and unzips the .tgz file by using an absolute path:
gtar zxvf $TOP/10.0.0-WS-MDMCS-LA001.tgzIf the encrypt_password parameter in the [db] section of the env_settings.ini file is set to yes, specify the dbpassword argument when invoking configureEnv.sh. If you do not specify the dbpassword argument, you will be prompted to enter the password.
$TOP/bin/configureEnv.sh -dbpassword=database_passwordPlease also note that by running configureEnv.sh two or more times, you can lose the original customized configuration files. This is because the backup copy of a configuration file gets replaced in place (same file name is used for a given configuration file every time configureEnv.sh is run).
The application server shell script, install_war.sh, installs InfoSphere MDM Collaboration Server into the WebSphere application server.
install_war.sh [ --wsadminUsername=<WAS admin user name> --wsadminPwd=<password for WAS admin user>]The install_war.sh script will install the WAR file for each app server defined in the [services] section in env_settings.ini. When WebSphere Application Server security is enabled, add the wsadminUsername and wsadminPwd arguments to the install_war.sh command.
install_gds_war.sh Step 3. Updating the configuration files
To successfully use the fixes and enhancements in this maintenance release you must modify InfoSphere MDM Collaboration Server configuration files.
InfoSphere MDM Collaboration Server uses the following configuration files:
List of configuration file changes
New properties introduced in the common.properties file for version 10.0.0 fix pack 1:
# set to true for filtering out non indexed attributes from being selected for rich search.
# This will not affect existing search template(s) and saved search.
rich_search_indexed_only=true# Controls the number of background processor threads per parent worker thread to convert data into XML for saves
# Can be set higher if operations like imports are cpu bound and there are more processors available.
# See log.xml.default for changing the log level of the EntryXmlProcessor class to debug to see if more threads may help speed up imports.
# Default value is 2
num_xml_processor_background_threads=2New properties introduced in the common.properties file for version 10.0.0 Interim Fix 3:
# Configures the category path separator for the UI, Java API, and scripting.
# Default is "/".
# This value MUST NOT exist in your category path values.
# This value is also the default used for the Java and scripting APIs.
# Consequently, exercise care before changing this. Evaluate Java API and scripting
# calls to methods that take an optional category path delimiter before changing this.
# Must be exactly one character long
category_path_separator=/Step 4. Enabling the Global Data Synchronization feature of InfoSphere MDM Collaboration Server (Optional)
Complete this step only if you plan to use the Global Data Synchronization feature of InfoSphere MDM Collaboration Server starting with this limited availability interim fix release; otherwise, proceed to Step 5.
To enable the Global Data Synchronization feature of InfoSphere MDM Collaboration Server, Version 10.0.0, you must perform the following steps:
Step 5. Modifying the database schema
No migration is required for this limited availability interim fix 1.
Step 6. Verifying the installation
Every time that you install an interim fix, verify that the installation was successful. To verify the installation of this limited availability interim fix 1, complete these steps:
The shell script, start_local.sh, located in the $TOP/bin/go directory, starts all the services that you need to run InfoSphere MDM Collaboration Server.
The svc_control.sh supports starting multiple services from the same command:
svc_control.sh --action=start --svc_name=<service name>[--svc_name=<service name>] svc_control.sh --action=start --svc_name=appsvr --svc_name=admin --svc_name=scheduler gdsmsg.sh startThis process should only take approximately 30-40 seconds, depending on the speed of your CPU processor.
start_local.sh --redeploy --waitforappsvr=<number of seconds>or
svc_control.sh --action=start --svc_name=admin --svc_name=scheduler [ --svc_name=appsvr --redeploy
[--waitforappsvr=<number of seconds>] ]- where the <number of seconds> is the number of seconds (positive integer) that the deployment command will wait for the appsvr services to become ready to initiate the re-deployment of Web services. The default value of this option is 5 seconds.
The waitforappsvr option must be used with the redeploy option. When the waitforappsvr option is omitted in a command with the "redeploy" option, the default value of waitforappsvr takes effect.
Users are advised to supply values slightly greater than the required startup time of the appsvr service, which can be monitored using the rm_status.sh command as shown in step 6.2 below. Too low a value for the waitforappsvr option can result in errors with stack dump on screen or log files.
The --svc_name=appsvr option in the svc_control.sh command must be accompanied by the redeploy and optionally the waitforappsvr command options.
Run the $TOP/bin/go/rmi_status.sh script and verify that the following services have started correctly:
Run the following script to verify that the GDS messaging services have started correctly:
$TOP/bin>./get_ccd_version.sh
10.0.0-LA001#04Step 7. Enabling GDS Migration
Upgrading GDS data model to comply to BMS v2.8 specifications
GDS supply side upgrade
GDS supply side users need to run the migrationScript.sh script to upgrade to the 1Sync 6.8 specification.
$TOP/src/db/schema/gds/SUPPLY-SIDE/Transora/v50/migrationScript.sh --company_code=<code>
--from_release=<your_current_version>where
GDS demand side upgrade
GDS demand side users need to run the migrationScript.sh script to upgrade to the BMS 2.8 specification. Before running migrationScript.sh script, you must download the ModifySpecs.wpcs file from ftp://ftp.software.ibm.com/software/websphere/mdmpim/fixpacks/10.0.0-IF003/ModifySpecs.wpcs and save it in the $TOP/src/db/schema/gds/migration/v10/scripts/sa2 directory.
$TOP/src/db/schema/gds/DEMAND-SIDE/WWRE/v6/migrationScript.sh --company_code=<code>
--from_release=<your_current_version>where
Known problems are documented in the form of individual technotes in the Support knowledge base at http://www.ibm.com/support/entry/portal/Overview/Software/Information_Management/InfoSphere_Master_Data_Management_Server_for_Product_Information_Management. As problems are discovered and resolved, the IBM Support team updates the knowledge base. By searching the knowledge base, you can quickly find workarounds or solutions to problems.
You can search for and display a list of all published technotes for InfoSphere MDM Collaboration Server. For information about how to search all published technotes, see Searching knowledge bases
You can search for keywords within this complete list of technotes.
Before contacting IBM Support, your company must have an active IBM software maintenance contract, and you must be authorized to submit problems to IBM. For information about the types of maintenance contracts available, see "Enhanced Support" in the Software Support Handbook at: techsupport.services.ibm.com/guides/services.html
After you define the problem gather background and diagnostic information, and determine the severity of the problem, you can submit your problem to IBM Support in one of the following ways:
If the problem you submit is for a software defect or for missing or inaccurate documentation, IBM Support creates an Authorized Program Analysis Report (APAR). The APAR describes the problem in detail. Whenever possible, IBM Software IBM Support provides a workaround that you can implement until the APAR is resolved and a fix is delivered. IBM publishes resolved APARs on the IBM Support web site daily, so that other users who experience the same problem can benefit from the same resolution.
IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to:
For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:
The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.
This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.
Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.
IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.
Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:
Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.
The licensed program described in this information and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement, or any equivalent agreement between us.
Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.
Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.
This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.
COPYRIGHT LICENSE:
This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs.
Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows:
© (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. © Copyright IBM Corp. _enter the year or years_. All rights reserved.
If you are viewing this information softcopy, the photographs and color illustrations may not appear.
IBM, the IBM logo, and ibm.com® are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both. These and other IBM trademarked terms are marked on their first occurrence in this information with the appropriate symbol (® or ™), indicating trademarks that were owned by IBM at the time this information was published. A complete and current list of IBM trademarks is available on the Web at http://www.ibm.com/legal/copytrade.shtml.
Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both.
Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc., in the United States, other countries, or both.
Other company, product, or service names may be trademarks or service marks of others.