Release Notes for Advanced Catalog Management V11.0.0 Text Fix 6

IBM® InfoSphere® Master Data Management Collaboration Server - Advanced Catalog Management, Version 11.0.0, Test Fix 6 is now available. This test fix can be used with InfoSphere MDM Collaboration Server V11.0.0 GA or V11.0.0 Fix Pack 1. It contains all the fixes and enhancements delivered in ACM 11.0.0 Fix Pack 1, and changes in all previous test fixes. This release notes document addresses installation and known problems.

Contents

Description of this test fix

Advanced Catalog Management for WebSphere Commerce is a InfoSphere MDM Collaboration Server solution accelerator. A InfoSphere MDM Collaboration Server solution implementation team can leverage the asset for implementing a retail solution for catalog management with customization and extensions quickly.

It is strongly recommended that you apply the test fix only to a test system. Test fixes do not undergo official IBM testing.

Product enhancements

The following enhancements were delivered in ACM V11.0.0 Test Fix 6:

  • Support for displayable, facetable, comparable facets for attributes. (Work item 37401)
  • Support Search Engine Optimization for text, URL keywords, and meta keyword. (Work item 37399)
  • Support for Sequence Number (Work item 37398)
  • Support for CalculationCode. (Work item 37397)
  • Support for DescriptionOverride. (Work item 37396)
  • Support for Attribute Groups (Work item 34662)
  • Support for Multi-Occurrence Attributes (Work item 34661)
  • Support for Multi-Store (Work item 34660)
  • Support for multi-language (Work item 34659)
Attention:
  • Multi-occurrence attribute values are supported only for descriptive attributes. The system will throw an exception if you try to pass multi-occurrence values to other types of attributes.
  • In the IBM WebSphere® Commerce environment, the values supplied for multi-occurrence descriptive attributes must be unique throughout the environment for a given attribute. However, this check is not yet enforced on the InfoSphere MDM Collaboration Server side. You must ensure that the supplied values are unique.
Product fixes to problems reported by users

The following fixes were included in this test fix as a result of problems that were reported by users.

  • Improve error handling on running a report on catalog entry. (Defect 39964)
  • Improve error handling on catalog group export through workflows. (Defect 39963)
  • Store ID is not in the parent group element of request from ACM Catalog Entry Selective export. (Defect 39961)
  • Attribute dictionary integration error - duplicate attributes. (Defect 39957)
  • Catalog groups cannot be exported if their names include special characters. (Defect 39876)
  • Catalog groups down from level 3 (subcategory) cannot be transformed and exported from Catalog Group Export Workflow. (APAR JR48405)

Product fixes to problems identified by the development team

The following fix was included in this test fix as a result of a problem that was discovered by the development team. If you want to learn more the fix, you can use the internal defect number for reference when speaking to someone from IBM Software Support:

  • Long Description of 65 chars or more for Catalog Entry causes Catalog Entry Export to fail. (Defect 41056)

Installing text fix 6

Before you install this test fix, you must have installed InfoSphere MDM Collaboration Server, Version 11.0.0. In particular, make sure that you have applied all configuration changes. For example, any schema changes and common.properties updates as documented in the Requirements section of those release notes.

Step 1. Preparing to install the test fix

Before you install the test fix, make sure to complete these steps:
  1. Stop the InfoSphere MDM Collaboration Server application on the local server.
    1. Check the scheduler to make sure that no critical jobs are running or need to complete. If the queue is clear, stop the scheduler manually by running the following shell script:

      $TOP/bin/go/svc_control.sh --action=stop --svc_name=scheduler

    2. Check the workflow engine to make sure no critical workflow events are running or need to complete by running the following shell script:

      $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

    3. For all applications that are deployed in a cluster environment, stop all remaining InfoSphere MDM Collaboration Server services:
      Syntax
      abort_local.sh 

      This script is located in the $TOP/bin/go directory. Running the abort_local.sh shell script does not affect any of the other JVM services.

    4. Make sure that all processes have stopped using the ps command. Stop any other Java™ or RMI registry processes that remain after shutting down the InfoSphere MDM Collaboration Server instance. It might take several attempts to stop all Java processes, but continue stopping Java processes until they are all stopped.

  2. Backup your system.

    You should have separated the code of your custom implementation from the code shipped in Advanced Catalog Management. The installation will overwrite your current files with updated versions from the test fix. In particular, you must back up your ACM source code and any other artifacts that you have customized. If you have made changes in the code shipped in Advanced Catalog Management, you will need to manually merge your changes back. Until you separate your own code from the shipped ACM code, you will need to keep restoring your code every time you apply an ACM patch.

Step 2. Installing the test fix

See Installing and configuring Advanced Catalog Management for InfoSphere MDM Collaboration Server in the information center for detailed information to enable you to install and configure Advanced Catalog Management.

Step 3. Restarting the InfoSphere MDM Collaboration Server instance

Perform the following steps to restart the InfoSphere MDM Collaboration Server instance:
  1. Start InfoSphere MDM Collaboration Server:
    1. Run the start_local.sh shell script:

      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.

      Syntax
      start_local.sh 
    2. Run the svc_control.sh shell script to start the individual services.

      The svc_control.sh script supports starting multiple services from the same command:

      Syntax
      svc_control.sh --action=start --svc_name=<service name>[--svc_name=<service name>] 
      Example
      svc_control.sh --action=start --svc_name=appsvr --svc_name=admin --svc_name=scheduler 

    This process should only take approximately 30-40 seconds, depending on the speed of your CPU processor.

  2. Verify that all InfoSphere MDM Collaboration Server JVM services have started.
    Run the rmi_status.sh script and verify that the following services have started correctly:
    • admin_machine_Name
    • appsvr_machine_Name
    • appsvrgds_machine_Name (optional, if GDS feature is enabled)
    • eventprocessor_machine_Name
    • queuemanager_machine_Name
    • scheduler_machine_Name
    • workflow_machine_Name

    This script is located in the $TOP/bin/go directory.

Known problems

Known problems are documented in the Support knowledge base at http://www-947.ibm.com/support/entry/portal/overview/software/information_management/infosphere_master_data_management_collaboration_server. 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.

Contacting IBM Support

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.

Notices

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:

IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY  10504-1785
U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

IBM World Trade Asia Corporation
Licensing 2-31 Roppongi 3-chome, Minato-ku
Tokyo 106-0032, Japan

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:

IBM Corporation
J46A/G4
555 Bailey Avenue
San Jose, CA 95141-1003
U.S.A.

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.

Trademarks

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.