You are previewing IBM Content Manager OnDemand Guide.
O'Reilly logo
IBM Content Manager OnDemand Guide

Book Description

This IBM® Redbooks® publication provides a practical guide to the design, installation, configuration, and maintenance of IBM Content Manager OnDemand Version 9.0.

Content Manager OnDemand manages high-volume storage and retrieval of electronic statements and provides efficient enterprise report management. Content Manager OnDemand transforms formatted computer output and printed reports, such as statements and invoices, into electronic information for easy report management. Content Manager OnDemand helps eliminate costly, high-volume print output by capturing, indexing, archiving, and presenting electronic information for improved customer service.

This publication covers the key areas of Content Manager OnDemand, some of which might not be known to the Content Manager OnDemand community or are misunderstood. The book covers various topics, including basic information in administration, database structure, storage management, and security. In addition, the book covers data indexing, loading, conversion, and expiration. Other topics include user exits, performance, retention management, records management, and many more.

Because many other resources are available that address subjects on different platforms, this publication is not intended as a comprehensive guide for Content Manager OnDemand; rather, it is intended to complement the existing Content Manager OnDemand documentation and provide insight into the issues that might be encountered in the setup and use of Content Manager OnDemand.

Table of Contents

  1. Front cover
  2. Notices
    1. Trademarks
  3. Preface
    1. Authors
    2. Now you can become a published author, too!
    3. Comments welcome
    4. Stay connected to IBM Redbooks publications
  4. Summary of changes
    1. September 2013, Third Edition
  5. Part 1 Basic system concepts and design
  6. Chapter 1. Overview and concepts
    1. 1.1 Overview of Content Manager OnDemand
    2. 1.2 Content Manager OnDemand concepts
      1. 1.2.1 Background information of an example company
      2. 1.2.2 Reporting and documenting
      3. 1.2.3 Application, application group, folder, and cabinet
      4. 1.2.4 Indexing methods
    3. 1.3 Content Manager OnDemand server and its components
      1. 1.3.1 Library server and object server
      2. 1.3.2 Content Manager OnDemand server components
  7. Chapter 2. Setting up a Content Manager OnDemand instance
    1. 2.1 Introduction
    2. 2.2 Architecture and platform
      1. 2.2.1 Configuration consideration
      2. 2.2.2 Library server and object server functions
      3. 2.2.3 Choosing a platform
    3. 2.3 Implementing a Content Manager OnDemand instance on a Multiplatform UNIX environment
      1. 2.3.1 Defining a single instance
      2. 2.3.2 Starting and connecting to the new instance
    4. 2.4 Implementing a Content Manager OnDemand instance on IBM i
      1. 2.4.1 Configuring the instance
      2. 2.4.2 Changing an instance configuration
      3. 2.4.3 Starting and stopping servers
    5. 2.5 Implementing a Content Manager OnDemand instance on z/OS
      1. 2.5.1 Installation overview
      2. 2.5.2 Creating an instance on z/OS
      3. 2.5.3 Starting and verifying the new instance
  8. Chapter 3. Administration
    1. 3.1 Report administration
      1. 3.1.1 Storage sets
      2. 3.1.2 Application groups
      3. 3.1.3 Applications
      4. 3.1.4 Folders
      5. 3.1.5 Cabinets
      6. 3.1.6 The report wizard
    2. 3.2 User and group administration
      1. 3.2.1 User types, authorities, and functions
      2. 3.2.2 System administration
    3. 3.3 Content Manager OnDemand XML Batch Administration
      1. 3.3.1 Using the XML Batch Administration program
      2. 3.3.2 Special features of the XML batch program
      3. 3.3.3 Tips on using the ARSXML command
  9. Chapter 4. Database structure
    1. 4.1 System control tables
    2. 4.2 Main data table structures
    3. 4.3 Relationship between tables when loading data
    4. 4.4 Search sequence
    5. 4.5 System log
    6. 4.6 Database creation and relationships on z/OS
      1. 4.6.1 System tables for Content Manager OnDemand z/OS
      2. 4.6.2 Data tables for Content Manager OnDemand z/OS
  10. Chapter 5. Storage management
    1. 5.1 IBM Tivoli Storage Manager for Multiplatforms
      1. 5.1.1 Tivoli Storage Manager overview
      2. 5.1.2 Configuring Content Manager OnDemand for Tivoli Storage Manager archive management
      3. 5.1.3 Content Manager OnDemand storage management
      4. 5.1.4 Storage set definition
      5. 5.1.5 Application group storage management
      6. 5.1.6 Advanced application group storage management
      7. 5.1.7 IBM System Storage Archive Manager
      8. 5.1.8 The arsmaint command
    2. 5.2 Object access method for z/OS
      1. 5.2.1 OAM components and SMS terminology
      2. 5.2.2 OAM configuration recommendations
      3. 5.2.3 Defining a storage set
      4. 5.2.4 Storing data in Virtual Storage Access Method data sets
    3. 5.3 Archive Storage Manager for Content Manager OnDemand for i
      1. 5.3.1 Migration policy
      2. 5.3.2 Application group storage management
      3. 5.3.3 Advanced application group storage management
      4. 5.3.4 Advanced application group database information
  11. Chapter 6. Security
    1. 6.1 Content Manager OnDemand security overview
    2. 6.2 Code security
    3. 6.3 Data separation
      1. 6.3.1 Multiple systems
      2. 6.3.2 Multiple object servers
      3. 6.3.3 Multiple archive servers
    4. 6.4 API access
    5. 6.5 Data security
      1. 6.5.1 Content Manager OnDemand object-owner model
      2. 6.5.2 Administrative features
      3. 6.5.3 SQL macro support
      4. 6.5.4 Annotations security
      5. 6.5.5 Securing access with ARSSTASH and the stash file
    6. 6.6 Data encryption
      1. 6.6.1 Encrypting data at rest
      2. 6.6.2 Encrypting data in motion: Secure communications
    7. 6.7 Security exits
      1. 6.7.1 User security and permissions exits
      2. 6.7.2 Security systems other than SAF (z/OS only)
      3. 6.7.3 Unified logon exit (ARSPTGN): z/OS only
      4. 6.7.4 System log user exit
    8. 6.8 Summary
  12. Part 2 Data indexing, loading, retrieval, and expiration
  13. Chapter 7. Indexing and loading
    1. 7.1 Introduction
      1. 7.1.1 Transferring files for loading and indexing
      2. 7.1.2 Understanding input data types
      3. 7.1.3 Choosing an indexer
    2. 7.2 Getting started with PDF indexing
      1. 7.2.1 Limitations
    3. 7.3 Performance considerations
      1. 7.3.1 PDF fonts and output file size
      2. 7.3.2 PDF indexing with report wizard
      3. 7.3.3 Reducing output file size with PDF documents
    4. 7.4 Getting started with ACIF indexing
      1. 7.4.1 Understanding the input data
      2. 7.4.2 The index file
      3. 7.4.3 AFP input
    5. 7.5 OS/390 indexer on AIX
    6. 7.6 OS/400 indexer on OD for System i
    7. 7.7 User exits
      1. 7.7.1 ACIF user exits
      2. 7.7.2 OS/390 indexer user exits
    8. 7.8 Additional references
  14. Chapter 8. User clients
    1. 8.1 Choosing the correct client for your implementation
      1. 8.1.1 Viewer options
      2. 8.1.2 Client infrastructure options
      3. 8.1.3 Client compatibility
    2. 8.2 Content Manager OnDemand client options
      1. 8.2.1 Web client options that are based on ODWEK
      2. 8.2.2 IBM Content Navigator
      3. 8.2.3 Content Manager OnDemand Windows client
      4. 8.2.4 CICS Client
      5. 8.2.5 Integration with other Enterprise Content Manager products
      6. 8.2.6 Federated search with IBM Information Integrator
      7. 8.2.7 Integration with IBM FileNet P8
    3. 8.3 Client APIs overview
      1. 8.3.1 Content Manager OnDemand Web Enablement Kit
      2. 8.3.2 Content Management Interoperability Services
      3. 8.3.3 Other client-based API options
  15. Chapter 9. Data conversion
    1. 9.1 Overview of data conversion
      1. 9.1.1 Why convert data streams
      2. 9.1.2 When to convert data streams
      3. 9.1.3 How to convert the data
    2. 9.2 The generic transform interface
      1. 9.2.1 Overview
      2. 9.2.2 Configuration
      3. 9.2.3 Basic implementation: Executable interface
      4. 9.2.4 Advanced implementation: Custom Java interface
  16. Chapter 10. Migration and expiring data and indexes
    1. 10.1 Introduction
    2. 10.2 Loading and storing the data
      1. 10.2.1 Storing the report (document) data
      2. 10.2.2 Storing the index data
      3. 10.2.3 Storing the resource data
    3. 10.3 Configuring for migration and expiration
      1. 10.3.1 Migrating index data
      2. 10.3.2 Expiring data and indexes
      3. 10.3.3 Expiring document data
      4. 10.3.4 Expiring annotations
    4. 10.4 Reloading data
    5. 10.5 Expiration processing on Multiplatforms and z/OS
      1. 10.5.1 Content Manager OnDemand based expiration: ARSMAINT
      2. 10.5.2 Removing documents from Tivoli Storage Manager archive
      3. 10.5.3 Storage Manager-based expiration
    6. 10.6 Expiring data on Content Manager OnDemand for i
      1. 10.6.1 Content Manager OnDemand based expiration
      2. 10.6.2 Storage Manager-based expiration
  17. Chapter 11. Exits
    1. 11.1 Introduction to user exits
    2. 11.2 ACIF exits
      1. 11.2.1 A new macro for user exits
      2. 11.2.2 Input record exit
      3. 11.2.3 Index record exit
      4. 11.2.4 Output record exit
      5. 11.2.5 Resource exit
      6. 11.2.6 Debugging input user exit programs
    3. 11.3 OS/390 indexer exits
      1. 11.3.1 The ANYEXIT exit
      2. 11.3.2 The INPEXIT exit
      3. 11.3.3 The INDXEXIT exit
    4. 11.4 System administration
      1. 11.4.1 System log exit for Multiplatforms
      2. 11.4.2 System log exit for z/OS
      3. 11.4.3 Print exit for Multiplatforms
    5. 11.5 Customized functions (Multiplatforms and z/OS only)
      1. 11.5.1 The user exit header file (arscsxit.h)
      2. 11.5.2 Load exit
      3. 11.5.3 Report specifications archive definition exit
      4. 11.5.4 Tablespace creation exit
      5. 11.5.5 ARSYSPIN and sample APKACIF exit on z/OS
  18. Part 3 Advanced system concepts and design
  19. Chapter 12. Scalability, reliability, and availability architectures
    1. 12.1 Scalability, reliability, and availability defined
    2. 12.2 Scaling a Content Manager OnDemand system
      1. 12.2.1 Vertical scalability
      2. 12.2.2 Horizontal scalability: Library server
      3. 12.2.3 Horizontal scalability: Multiple object servers
      4. 12.2.4 Horizontal and vertical scalability: Storage manager
      5. 12.2.5 Horizontal scalability: Multiple logical partitions and systems
      6. 12.2.6 Multiple server configuration rules
    3. 12.3 High availability
      1. 12.3.1 Redundant systems: All platforms
      2. 12.3.2 Multiple LPAR sysplex: z/OS
      3. 12.3.3 High availability: IBM i
      4. 12.3.4 Horizontal and vertical scalability summary
  20. Chapter 13. Performance
    1. 13.1 Tuning Content Manager OnDemand to enhance performance
      1. 13.1.1 Content Manager OnDemand configuration
      2. 13.1.2 System logging
      3. 13.1.3 System management
      4. 13.1.4 Storage management
    2. 13.2 Data loading performance
      1. 13.2.1 Factors that affect the load performance
      2. 13.2.2 Recommendations
      3. 13.2.3 Load testing
    3. 13.3 Data retrieval performance
      1. 13.3.1 Data retrieval parameters
      2. 13.3.2 Factors that affect retrieval performance
      3. 13.3.3 Retrieval testing
      4. 13.3.4 System testing
    4. 13.4 Performance issues based on data type
      1. 13.4.1 PDF data
      2. 13.4.2 Line data
      3. 13.4.3 AFP data
      4. 13.4.4 Image data
  21. Part 4 Enhancement options
  22. Chapter 14. Report distribution
    1. 14.1 Introduction to Content Manager OnDemand Distribution Facility
      1. 14.1.1 What documents are needed
      2. 14.1.2 Who receives the documents
      3. 14.1.3 When are the documents retrieved and delivered
      4. 14.1.4 Where are they delivered
      5. 14.1.5 Cross platform access
    2. 14.2 Defining the objects with the Administrator Client
      1. 14.2.1 Adding a recipient
      2. 14.2.2 Adding a recipient list
      3. 14.2.3 Adding a report ID
      4. 14.2.4 Adding a distribution
      5. 14.2.5 Adding a report bundle
    3. 14.3 Defining the objects using Batch Administration
      1. 14.3.1 Recipient
      2. 14.3.2 Report ID
      3. 14.3.3 Distribution and Report Bundle
    4. 14.4 Customizable user exits
      1. 14.4.1 ARSRMFST: Manifest exit
      2. 14.4.2 ARSRBANL: Banner exit
      3. 14.4.3 ARSRPREA: Pre-allocation exit
      4. 14.4.4 ARSRNOTE: Email notification exit
      5. 14.4.5 ARSRATTE: Email document exit
      6. 14.4.6 User security exit
    5. 14.5 Status and monitor tool
      1. 14.5.1 Main panel options
  23. Chapter 15. Full text search
    1. 15.1 Introduction to full text search in Content Manager OnDemand
    2. 15.2 Full text search architecture in Content Manager OnDemand
      1. 15.2.1 Full Text Search Server
      2. 15.2.2 Index structure
      3. 15.2.3 Indexing document through FTS Exporter
      4. 15.2.4 Searching
    3. 15.3 Planning and installing FTS
      1. 15.3.1 Component overview
      2. 15.3.2 Installing FTS Server
      3. 15.3.3 Operating system resources
      4. 15.3.4 Workload
      5. 15.3.5 Memory heap size
      6. 15.3.6 Index considerations
    4. 15.4 Configuring and operating full text search
      1. 15.4.1 Base configuration in Content Manager OnDemand
      2. 15.4.2 Configuration of the Full Text Search Exporter
    5. 15.5 Running full text indexing process
      1. 15.5.1 Automatically indexing new data during load
      2. 15.5.2 Indexing existing data through arsdoc
      3. 15.5.3 Indexing existing data through ODWEK
      4. 15.5.4 Running the FTS Exporter
    6. 15.6 Using full text search in Content Manager OnDemand Clients
      1. 15.6.1 Syntax
      2. 15.6.2 Boolean searches
      3. 15.6.3 Wildcard searches and optional terms
      4. 15.6.4 Fuzzy and proximity searches
      5. 15.6.5 Weighted searches (boosting terms)
    7. 15.7 Troubleshooting tips
      1. 15.7.1 Content Manager OnDemand server log
      2. 15.7.2 Full Text Search Server log
      3. 15.7.3 Full Text Search Exporter trace
      4. 15.7.4 Authentication and FTS Exporter errors
  24. Chapter 16. Enhanced Retention Management
    1. 16.1 Enhanced Retention Management overview
    2. 16.2 Configuring Enhanced Retention Management
      1. 16.2.1 Configuring Enhanced Retention Management
      2. 16.2.2 Configuring application groups
      3. 16.2.3 Configuring application group fields
      4. 16.2.4 Configuring application group permissions
      5. 16.2.5 Configuring users
      6. 16.2.6 Configuring holds
      7. 16.2.7 Configuring folders
    3. 16.3 Applying and releasing holds
      1. 16.3.1 Managing holds
      2. 16.3.2 Applying holds
      3. 16.3.3 Creating and removing custom holds
      4. 16.3.4 Search for hold documents
    4. 16.4 Enhanced Retention Management use cases
      1. 16.4.1 Ad hoc holds
      2. 16.4.2 Load holds
  25. Chapter 17. Content Federation Services for Content Manager OnDemand and IBM Enterprise Records
    1. 17.1 Content Federation Services for Content Manager OnDemand and IBM Enterprise Records overview
    2. 17.2 Administration of Content Federation Services for Content Manager OnDemand for Enterprise Records
      1. 17.2.1 Configuring Content Federation Services for Content Manager OnDemand
      2. 17.2.2 Configuring application groups
      3. 17.2.3 Configuring application group fields
      4. 17.2.4 Configuring application group permissions
      5. 17.2.5 Federating document metadata to Content Federation Services for Content Manager OnDemand
    3. 17.3 Content Federation Services for Content Manager OnDemand architecture overview
    4. 17.4 Deployment considerations
  26. Part 5 Troubleshooting, hints, and techniques
  27. Chapter 18. Troubleshooting and tracing
    1. 18.1 Troubleshooting common problems
      1. 18.1.1 Indexing and loading issues
      2. 18.1.2 Content Manager OnDemand maintenance issues
      3. 18.1.3 Monitoring the main server task arssockd
      4. 18.1.4 Installation and migration issues
      5. 18.1.5 Common server messages
    2. 18.2 Information collection
      1. 18.2.1 Indexing or loading
      2. 18.2.2 Database
      3. 18.2.3 Tivoli Storage Manager
      4. 18.2.4 Content Manager OnDemand client logon
      5. 18.2.5 Performance
      6. 18.2.6 ODWEK
      7. 18.2.7 Content Manager OnDemand server hangs or crashes
      8. 18.2.8 Exporting information to a local server
    3. 18.3 Content Manager OnDemand trace facility
      1. 18.3.1 Enabling the trace facility
      2. 18.3.2 Setting trace parameters
    4. 18.4 Other tracing options
      1. 18.4.1 ARSLOAD
      2. 18.4.2 MidServer trace
      3. 18.4.3 ODWEK trace
      4. 18.4.4 TCP/IP packet trace
      5. 18.4.5 Language Environment
      6. 18.4.6 ARSSUPPORT utility
      7. 18.4.7 ARSJESD
      8. 18.4.8 PDF Indexer trace
      9. 18.4.9 Trace resolver
      10. 18.4.10 Conclusion
  28. Related publications
    1. IBM Redbooks
    2. Referenced websites
    3. How to get IBM Redbooks
  29. Back cover