Transcription
Front coverContent ManagerImplementation andMigration CookbookCovering implementation basics andmaintenance topicsDescribing migration processfor various scenariosProviding practical casestudyWei-Dong ZhuJorge A. AndresKenneth S. ChristensenLiu ChunGlenn Drevesibm.com/redbooks
International Technical Support OrganizationContent Manager Implementation and MigrationCookbookApril 2006SG24-7051-01
Note: Before using this information and the product it supports, read the information in“Notices” on page xv.Second Edition (April 2006)This edition applies to Version 8, Release 3 of IBM Content Manager for Multiplatforms (productnumber 5724-B19); and Version 8, Release 2 of IBM Content Manager for z/OS (product number(5697-H60). Copyright International Business Machines Corporation 2004, 2006. All rights reserved.Note to U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADPSchedule Contract with IBM Corp.
ContentsNotices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvTrademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviPreface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviiThe team that wrote this redbook. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviiiBecome a published author . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxComments welcome. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxSummary of changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiApril 2006, Second Edition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiPart 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Chapter 1. Content Management products overview. . . . . . . . . . . . . . . . . . 31.1 Content management portfolio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41.1.1 IBM DB2 Content Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41.1.2 IBM DB2 Content Manager OnDemand . . . . . . . . . . . . . . . . . . . . . . . 61.1.3 IBM DB2 Content Manager VideoCharger . . . . . . . . . . . . . . . . . . . . . 71.1.4 IBM DB2 Content Manager CommonStore . . . . . . . . . . . . . . . . . . . . . 71.1.5 IBM DB2 Document Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81.1.6 IBM DB2 Records Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91.1.7 IBM WebSphere Information Integrator Content Edition . . . . . . . . . . 101.1.8 IBM Workplace Web Content Management . . . . . . . . . . . . . . . . . . . 111.2 Choosing the right solution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121.2.1 Content Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121.2.2 OnDemand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131.2.3 Document Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131.2.4 CommonStore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131.2.5 WebSphere Information Integrator for Content Edition . . . . . . . . . . . 141.2.6 Workplace Web Content Manager . . . . . . . . . . . . . . . . . . . . . . . . . . 141.3 What’s changed in Content Manager V8.3 . . . . . . . . . . . . . . . . . . . . . . . . 15Chapter 2. Content Manager architecture overview. . . . . . . . . . . . . . . . . . 192.1 Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202.2 Content Manager components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212.2.1 Library Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212.2.2 Resource Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232.2.3 Content Manager clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242.3 Architecture extensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 Copyright IBM Corp. 2004, 2006. All rights reserved.iii
Part 2. Understanding the product . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27Chapter 3. Data modeling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293.1 Data modeling entities. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303.1.1 Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313.1.2 Attribute groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333.1.3 Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353.1.4 Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393.1.5 Item type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433.1.6 Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 573.1.7 Semantic type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583.1.8 Relationships (links, auto-linking, references, foreign keys) . . . . . . . 593.1.9 Database indexes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 683.1.10 Text indexes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 703.2 The Content Manager meta model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 703.3 Comparison with earlier versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 723.3.1 Hierarchical item type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 723.3.2 Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 723.3.3 Versioning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 733.3.4 Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 733.3.5 References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 733.3.6 Attribute groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73Chapter 4. Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 754.1 Workflow options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 764.1.1 Document Routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 764.1.2 WebSphere Process Server (WPS) . . . . . . . . . . . . . . . . . . . . . . . . . 774.2 Document Routing concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 774.2.1 Work packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 784.2.2 Processes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 794.2.3 Defining a process in the graphical builder . . . . . . . . . . . . . . . . . . . . 964.2.4 Updating a process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1024.2.5 Deleting a process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1034.2.6 Worklists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1034.2.7 Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1074.2.8 Action lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1094.2.9 Customization options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111Chapter 5. Text indexing and searching . . . . . . . . . . . . . . . . . . . . . . . . . . 1175.1 Implementation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1185.1.1 Enabling text search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1185.1.2 Making documents text-searchable . . . . . . . . . . . . . . . . . . . . . . . . 1195.1.3 Making attributes text-searchable . . . . . . . . . . . . . . . . . . . . . . . . . . 1225.1.4 Defining text search options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123ivContent Manager Implementation and Migration Cookbook
5.1.5 Making documents text searchable on Unicode databases . . . . . . 1275.2 Administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1275.2.1 Updating the index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1275.2.2 Reorganizing the index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1285.3 Using text search. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1295.3.1 Searching for object contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1295.3.2 Searching for documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1295.3.3 Making user-defined attributes text-searchable . . . . . . . . . . . . . . . 1305.4 Performance considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130Chapter 6. Application development overview. . . . . . . . . . . . . . . . . . . . . 1316.1 Getting started. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1326.1.1 Where the APIs fit in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1326.1.2 Installing connectors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1336.1.3 Setting up your environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1356.1.4 Setting up WebSphere Studio Application Developer . . . . . . . . . . . 1376.1.5 Working with sample code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1396.1.6 Application development options . . . . . . . . . . . . . . . . . . . . . . . . . . 1416.1.7 Understanding the differences . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1436.2 Application development concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1446.2.1 Understanding components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1446.2.2 Representing items using Dynamic Data Objects (DDO) . . . . . . . . 1486.2.3 Working with Resource Manager . . . . . . . . . . . . . . . . . . . . . . . . . . 1496.2.4 Working with transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1506.2.5 Using logging and tracing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1546.3 Additional resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160Chapter 7. Query language. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1617.1 Query language overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1627.1.1 Parametric search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1637.1.2 Text search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1647.2 Understanding query language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1647.2.1 Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1647.2.2 Grammar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1657.2.3 Escape sequences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1657.3 Query strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1727.3.1 Basics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1737.3.2 Multiple item types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1747.3.3 Text search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1747.3.4 Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1767.3.5 References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1777.3.6 Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1787.3.7 System-defined attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178Contentsv
7.3.8 Resource items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1787.3.9 Document parts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1797.3.10 Lists. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1797.3.11 Attribute groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1807.3.12 Set operators. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1807.3.13 Row-based view filtering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1817.3.14 Query on checked-out items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1827.4 Using query language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1827.4.1 Query string. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1827.4.2 Query options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1837.4.3 Query results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1847.5 SQL queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1857.6 Other resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185Chapter 8. Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1878.1 Content Manager security concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1888.1.1 Content Manager security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1888.2 Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1898.2.1 LDAP integration overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1908.2.2 Single sign-on . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1928.3 Authorization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1958.3.1 Privileges. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1968.3.2 Users and user groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1988.3.3 Creating user IDs and passwords . . . . . . . . . . . . . . . . . . . . . . . . . . 2008.3.4 DB2 administration authority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2018.3.5 Changing password to Resource Manager . . . . . . . . . . . . . . . . . . . 2038.3.6 Changing database access passwords. . . . . . . . . . . . . . . . . . . . . . 2058.3.7 Access control lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2068.3.8 Access control list user exits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2128.3.9 Domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2148.4 Access to objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2188.5 WebSphere global security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2238.5.1 Java 2 security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2288.6 Content Manager and RACF. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2298.6.1 User IDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2298.6.2 RACF user exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2328.6.3 RACF import utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233Chapter 9. Tivoli Storage Manager for Content Manager . . . . . . . . . . . . 2359.1 IBM Tivoli Storage Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2369.1.1 Overview of Tivoli Storage Manager capabilities . . . . . . . . . . . . . . 2369.1.2 Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2389.1.3 Policy objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242viContent Manager Implementation and Migration Cookbook
9.1.4 Storage devices and media. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2459.1.5 Storage hierarchy and data migration . . . . . . . . . . . . . . . . . . . . . . . 2479.1.6 Media management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2489.2 Tivoli Storage Manager and Content Manager . . . . . . . . . . . . . . . . . . . . 2499.2.1 TSM server configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2529.2.2 Customizing the TSM API client files . . . . . . . . . . . . . . . . . . . . . . . 2529.2.3 Configuring a Resource Manager to use TSM . . . . . . . . . . . . . . . . 253Chapter 10. XML support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25710.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25810.2 How XML services work with other Content Manager programming layers25810.3 Working with Web services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25910.3.1 Web services overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26010.3.2 Content Manager Web services implementation . . . . . . . . . . . . . 26310.3.3 Integrating basic Web services into your applications or processes . .26410.3.4 Exporting item types to a WSDL file . . . . . . . . . . . . . . . . . . . . . . . 26810.3.5 Exporting a process as XML Text (Workflow) . . . . . . . . . . . . . . . . 27110.4 XML JavaBeans . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27310.5 XML schema mapping utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27610.5.1 Supported scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27710.5.2 Creating an XML schema file . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27710.5.3 Mapping a user-defined schema to a storage schema . . . . . . . . . 279Part 3. Content Manager implementation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283Chapter 11. Planning and designing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28511.1 Planning basics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28611.2 Analyze business operations and requirements . . . . . . . . . . . . . . . . . . 28611.3 Planning and designing system topology . . . . . . . . . . . . . . . . . . . . . . . 28811.4 Planning and designing data model . . . . . . . . . . . . . . . . . . . . . . . . . . . 29111.5 Planning and designing workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29211.5.1 Hardware and software requirements . . . . . . . . . . . . . . . . . . . . . . 29311.6 Capacity planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Content Manager Implementation and Migration Cookbook April 2006
