Welcome to the documentation notes for Content Server 7.5 Patch 5. These notes are cumulative. They describe the Content Server product guides and major changes to their content since the 7.5 release.

Check the FatWire e-docs web site regularly for the latest updates to these notes and the product documentation.

Documentation History

Date Description of Change
October 21, 2010 Updated in CS 7.5 Patch 5:
  • Content Server Developer's Guide. Added inCache configuration section with procedures for enabling remote Satellite Server to serve invalidated pagelets while they are regenerated in background (p. 166).
  • Property Files Reference. Added new property and logger, both related to serving of invalidated pagelets:
    • serveStale property (p. 184)
    • com.fatwire.logging.cs.cache.ehcache logger (p. 24)
September 14, 2010 Released: CS 7.5 Patch 5
  • Updated
    • Rollup installation guide.
    • Content Server Tag Reference. FCKEditor input type was added to ASSETMAKER.INPUTFORM.
  • New
    • inCache page caching framework. Overview and configuration procedures are available in the Content Server Developer's Guide.
      The Cache Management Tool, mentioned in Release Notes, is distributed on DeveloperNet as an unofficial tool. One of its dialogs, "Cluster Info," is integrated with CS 7.5 Patch 5 and made available in the Advanced interface for verification of inCache cluster members. "Cluster Info" is documented in the Content Server Developer's Guide. Information about the Cache Management Tool is provided on DeveloperNet.
    • Clarkii Online Image Editor (OIE). Configuration procedures are available in the Content Server Developer's Guide. User information is available in the Dash and Advanced user guides.
    • Properties related to caching and Clarkii OIE. Added to Property Files Reference:
      • propagatecache, in futuretense.ini and satellite.properties
      • xcelerate.imageeditor.clarkii4.basepath, in futuretense_xcel.ini
      • cs.approvalLockStriping, in futuretense.ini
      • scratch.cleanup.schedule, in satellite.properties
    • Approval query for enhancing mirror and RealTime publishing efficiency. See the Content Server Administrator's Guide, p. 286.
    • Asset management via Content Server REST API. Code samples for creating, deleting, reading, and updating basic and flex assets (referenced in the WEM Framework Developer's Guide) are available in Content Server's Samples directory.
September 2, 2010 Updated in Patch 4:
  • Content Server Developer's Guide
    • Added information on computation of page expiration time ("Content Server Caching," p. 119)
    • Revised section on customizing asset type elements (pp. 312–315)
    • Added prerequisite steps for configuring FCKEditor to work correctly with Internet Explorer when Content Server is configured to use the cp1252 character set (p. 380)
    • Added mark_publish property to section on approving flex assets with BulkApprover (pp. 486, 488)
    • Added instructions for enabling extra parameters for FCKEditor (pp. 494, 513)
    • Added instructions for using Engage visitor-tracking property (vis.useSessionVisitorConnection) on CM systems
      ("Enabling Memory-Centric Visitor Tracking," p. 805)
    • Updated code in "Asset API" chapter ("Reading Key-Value Mappings," p. 828)
  • Content Server Property Files Reference:
    • Updated cs.eventhost property description to include clustered environments
    • Corrected default values of xcelerate.defaultcscacheinfo and xcelerate.defaultsscacheinfo properties. Revised property descriptions.
    • Added two properties (in uiadmin.properties): display.assettree.leaf and display.siteplantree.leaf
    • Revised vis.useSessionVisitorConnection property description to include usage of the property on CM systems
  • Content Server Dash User Guide, Advanced User Guide:
    Updated product features table with list of design assets (ch. 1)
  • WEM Framework Administrator's Guide:
    Revised section on assignment of site admins to AdminSite (p. 8). Updated security configurations table (p. 38).
August 4, 2010 Updated in Patch 4: WEM Framework 1.0 Developer's Guide: Added chapter on developing custom REST resources.
July 12, 2010 Updated:
  • CS-LDAP Integration Guide: Added table of system-defined roles.
  • Internationalization Reference: Page 22. Corrected language pack installer name.
Both guides are CS7.5 patch 2 guides that apply to higher patches.
June 28, 2010 Released: Content Server 7.5 Patch 4.

Updates and editorial changes to Administrator's Guide, Lucene configuration chapters:
  • Merged chapters 23–24. Documented configuration of attribute-based searches.
  • Added content from Developer's Guide, chapter 28 ("Developing with the Lucene Search Engine"; removed chapter 28).
March 23, 2010 Released: Content Server 7.5 Patch 3. Changes to product documentation set:
  • Rollup Installation Guide
    Updated with instructions for installing FatWire Web Experience Management (WEM) Framework with Content Server 7.5 Patch 3.
    Describes changes to Content Server during installation of the WEM Framework option.

  • Satellite Server Installation Guide
    Updated with installation instructions supporting WEM Framework.

  • Advanced User Guide, Dash User Guide, Administrator's Guide
    Updated to reflect new login page for Content Server installations running WEM Framework (URL remains unchanged).
    Contains various editorial changes.

  • Property Files Reference
    Added new properties and property file supporting WEM Framework.

  • Javadoc

  • New: Web Experience Management Framework product guides:
    • Administrator's Guide
      Provides instructions for authorizing access to applications running on WEM Framework. Contains site management guidelines.
    • Developer's Guide
      Supports application development on WEM Framework. Provides sample application code; demonstrates sample applications for content management and for SSO on production sites; contains procedures for registering applications; describes the REST security model.
    • REST API Resource Reference
    • REST API Bean Reference
September 17, 2009 Released new guides for Content Server 7.5 Patch 2
  • Installing Content Server 7.5 Patch 2 with IBM WebSphere Portal Server (see also the updated SPD)
  • Engage Performance Guide (available under "Content Server Performance-Sizing Guides")
September 8, 2009 Released: Content Server 7.5 Patch 2.
  • KeyView has been replaced with Apache Tika and docx4j implementations. The following guides have been updated to reflect the changes:
  • The memory-centric model for tracking site visitors has been modified. Changes are documented in the Developer's Guide.
June 29, 2009 Updated code samples in the Developer's Guide. See Appendix D: Asset API tutorial, section "Asset API Write."
June 1, 2009 Released the following guides with Language Packs:
  • Internationalization Reference with instructions for installing Language Packs
  • Dash Interface User's Guide in French, German, Italian, Japanese, and Spanish
  • April 3, 2009 Updated the following guides:
  • Customizing the Dash Interface
  • Javadoc
  • March 31, 2009 Released: Content Server 7.5 Patch 1. Other Content Server 7.5 guides, included with this release, remain unchanged.

    TOP

    Table of Contents

    Released with Content Server 7.5

    Highlights

    For Installation Engineers

    For Architects and Developers

    For System Administrators

    For Content Providers

    Released with Content Server 7.5

    The following documentation set was released with Content Server 7.5:

    Upgrade, Installation, Configuration Guides

    Developer’s Documentation

    Administrator’s Documentation

    User Guides

    TOP

    Highlights

    For Installation Engineers

    For Architects and Developers

    For System Administrators

    For Content Providers

    For Installation Engineers
    Configuring Third-Party Software Provides instructions for installing and configuring Content Server's supporting software (listed in the Supported Platform Document):
      New in CS7.5:
    • Installing IBM HTTP Server 6.1
    • Installing Internet Information Services 7.0 on Windows
    • Installing Active Directory Server 2008
    • Setting Up IBM Tivoli Directory Server 6.x
    • Creating and Configuring a XEN Virtual Machine
    • Creating a Zone in Solaris 10
    • Installing and Configuring VMWare ESX 3.5
    Installing Satellite Server Provides instructions for installing and configuring Satellite Server, both co-resident and remote. Applies to web and portal installations.
    Integrating Content Server with LDAP Provides instructions for installing and configuring Satellite Server, both co-resident and remote. Applies to web and portal installations.
    Internationalization Reference Provides instructions for configuring your environment to support the UTF-8 character encoding used by Content Server.
    Backup and Recovery Guide Provides guidelines and instructions for backing up and recovering:
    • Content Server Installation Directory
    • Shared Directory
    • CS Web Application
    • CS Portal Application
    • Content Server Database
    • LDAP
    Includes instructions for running recovered applications.
    Property Files Reference Contains information about properties used to specify operating parameters for Content Server and its applications. This guide is also essential to developers and administrators of Content Server systems.
      In CS7.5 Patch 3:
    • Added new properties related to the WEM Framework:
      • cs.ssovalidator in futuretense.ini
      • singlesignon in futuretense.ini
      • wem.enabled in futuretense_xcel.ini
      • xcelerate.userimageattr in futuretense_xcel.ini
    • Added new property file related to the WEM Framework: fatwire_settings.properties
      In CS7.5 Patch 2:
    • Removed “KeyView Property Files” section and “KeyView” section (from futuretense_xcel.ini).
    • Renamed keyview properties (functionality remains unchanged):
      • keyview.imgdir is now transformer.imgdir
      • keyview.imgurl is now transformer.imgurl
    • Added new properties: xcelerate.transformpath and cs.binarypath (in futuretense_xcel.ini).
    • Deprecated search engine properties (all properties on the futuretense.ini "Search" tab are now deprecated).
      New in CS7.5 Patch 1:
    • Memory-centric tracking of Engage visitors.
      A new property named vis.useSessionVisitorConnection is documented in the "visitor.ini" section. This property is described in terms of both database- and memory-centric tracking methods.
      New in CS7.5:
    • Added CS 7.5 properties for customizing the Dash interface, controlling the behavior of Site Preview functionality, and more:
      • In futuretense.ini
        • bs.invalidheadernames
        • cs.sitepreview
      • In uiadmin.properties
        • cascadedmaxitems
        • cs.batchtimeout
        • popupsearchtablerowcount
        • searchresultscount
        • searchtableattrcols
        • searchtablerowcount
        • sitestablerowcount
      • In futuretense_xcel.ini
        • xcelerate.approval.dependency.chunksize
        • xcelerate.searchResultCols
        • xcelerate.systemid
    • Added index of deprecated properties
    • Added index of new properties

    TOP

    For Architects and Developers
    Developer's Guide Provides conceptual and procedural information regarding data modeling, page design, page caching, security, web services, and much more.
      In CS7.5 Patch 2:
    • KeyView-related changes:
      • Updated "Registering a Transformation Engine" with new title ("Enabling a Transformation Engine"), new introduction, and new steps corresponding to the implementation that replaces KeyView.
      • Updated "Document Transformation Filter" to reflect the current default transformation engines and document transformer implementation.
    • Memory-centric visitor tracking now implements batch saving of history attributes to reduce memory utilization. History attributes in memory are first written to the file system, then batch saved to Content Server’s database (see page 815).
      New in CS7.5 Patch 1:
    • New FCKEditor features. Chapter 18 contains procedures and guidelines for:
      • Implementing lazyload
      • Configuring the style sheet plugin to support custom style sheets
      • Creating style sheets (standalone or using CSS)
      • Enabling FCKEditor for use in the InSite interface
      • Enabling Image Picker for the FCKEditor toolbar
      • Enabling selected asset types for use with FCKEditor (users can create assets directly from within an FCKEditor-enabled field. Developers can limit the user's choice of asset types.)
    • Memory-centric Visitor Tracking: Chapter 42
      • Applies to Engage assets
      • Provides an overview, compares database- and memory-centric models, and concludes with a set of diagrams illustrating how memory-centric tracking works.
      • Introduces a new tag, render:overridedeps, which enables developers to limit the number of dependencies that are logged to Content Server's database and therefore improve performance. This tag applies to both memory- and database-centric methods.
        New in CS7.5:
      • Chapter 25: Best Practices for Creating Site Preview Templates and Assets
        Covers usage of the asset:filterassetsbydate tag
      • Chapter 28: Developing with the Lucene Search Engine
      • Addition of write operations to Asset API (appendix D)
      • Appendix E: Public Site Search
        Introduces search framework and discusses usage of the Search API in building public site searches
      • Appendix F: Asset and Publish Events in Content Server
        Contains tutorial for creating asset event listeners
      • Updates to web services chapters (in part 6)
    Customizing the Dash Interface
      New in CS7.5 Patch 1:
    • Updates to information regarding the AssetEditPane table (page 17):
      For basic assets, assetdefid is -1 (rather than null).
    • New section, "Working with JavaScript in CSElement-Based Attribute Renderers" (in chapter 4).
    • Updates to chapter 7 ("Validation"): new preupdate.xml and validation.jsp code.
    • Commented JSPs:
      • htmltextdatadisplayRenderer
      • htmltextdataRenderer
      • multivaluedTextRenderer
      • The JSPs are located in the Dash Customization_sampleCode folder.
    New in CS 7.5.
      This guide provides methodologies for:
    • Changing the general “look and feel” of the Dash interface:
      • Changing the style of ADF components
      • Customizing the site selection page
      • Customizing settings for search results lists, and more
    • Regulating access to tabs and attributes on Create/Edit/Inspect screens
    • Customizing the rendering of attributes on Create/Edit/Inspect screens
    • Creating filters to refine searches and regulate access to FatWire Content Server’s tree
    • Displaying Advanced UI screens in the Dash interface
    • Validating assets
    • Redefining users’ privileges to functions such as inspect, edit, and delete
    Note: This guide is provided in a zip file that also contains sample code (in .jsp and .java files) to support examples of custom attribute renderers.
    Developer's Tag Reference Contains reference pages for Content Server public XML and JSP tags, CS Web Services, and Java API.
    Javadoc Contains details on Content Server's public Java API.
    Delivery Portlet Developer’s Guide Guides portal developers through the process of writing their own portlets using Content Server’s asset model.

    TOP

    For System Administrators
    Administrator's Guide Provides conceptual and procedural information regarding user and system management, workflow planning and configuration, revision tracking, publishing, and database maintenance.
      In CS7.5 Patch 2:
    • The keyview.imgdir property, listed in the "CS-Desktop" section, has been renamed to transformer.imgdir. Functionality remains unchanged.
      New in CS7.5 Patch 1:
    • Updates to "Visitor Tables (Engage)" section in appendix B. Updates describe effects of memory-centric tracking of Engage visitors on table size.
      New in CS7.5:
    • Part 4. RealTime publishing - Complete, Delayed, and On-Demand. Includes:
      • Overview of publishing process, modes, and options
      • Instructions for configuring RealTime publishing
      • Guidelines and instructions for using RealTime publishing
    • Updates to Mirror and Export publishing. Updates reflect changes to the interface (e.g., inclusion of publishing arguments).
    Property Files Reference Listed under "Installation Engineers"

    TOP

    For Content Providers
    Dash Interface User's Guide Shows content providers how to work with Content Server's Dash interface, which provides quick, intuitive access to the tools for creating and managing content. The user-friendly design simplifies content management tasks, facilitates access to information, provides full-text search, incorporates Web 2.0 features (such as tagging), and supports different locales and languages.
      New in CS 7.5 Patch 1:
    • New FCKEditor features and functions:
    • Summary of new features and functions: pages 86–88
    • Procedures and guidelines for linking assets via FCKEditor are documented in chapter 10:
      • Linking assets via hypertext links
      • Including one asset in another
      • Linking via an image asset
      • Invoking Image Picker from the FCKEditor toolbar
      • Linking assets to URLs
      • Creating (and linking to) target assets from FCKEditor enabled fields
      New in CS7.5:
    • Site Preview (chapters 7 and 8): Usage of start/end dates and their impact on previews, approval, and publishing
    • Updates to search functionality to reflect the newly added Site Preview feature (and other product development)

    Note: Chapter 1 provides a features list comparing Dash and Advanced interfaces.

    Advanced Interface User's Guide Guides content providers through creation, management, and publication of content, collaboration in workflows, and usage of recommendation assets to support marketing campaigns.
      New in CS7.5 Patch 1:
    • New FCKEditor features and functions:
    • Summary of new features and functions: pages 113–115
    • Procedures and guidelines for linking assets via FCKEditor are documented in chapter 4:
      • Linking assets via hypertext links
      • Including one asset in another
      • Linking via an image asset
      • Invoking Image Picker from the FCKEditor toolbar
      • Linking assets to URLs
      • Creating (and linking to) target assets from FCKEditor enabled fields
      New in CS7.5:
    • Site Preview (chapters 5 and 6): Usage of start/end dates and their impact on previews, approval, and publishing
    • Updates to search functionality to reflect the newly added Site Preview feature (and other product development)

    Note: Chapter 1 provides a features list comparing Advanced and Dash interfaces.

    TOP