Serena® Collage® Version 5.1.2
Readme File

Last updated March 6, 2007

This file contains information on installing and using the current release of Serena® Collage®. For a list of the defects fixed since the last release of Collage, see release_notes.enUS.html.

To contact Serena Online Services, go to support.serena.com.

IMPORTANT:

If you are upgrading from a previous version, review the Supported Platforms section to verify support of your existing environment.

The following changes should be noted by all customers:


Table of Contents

1.0 What’s New in Serena® Collage® 5.1.2

1.1 HTML Filtering Enhancements

1.2 New Localized Editions

1.3 New Platform Support

2.0 What's New in Serena® Collage® 5.1

2.1 Collage Contributor

2.2 Improved Folder Trees

2.3 Deploy Improvements

2.4 Content Contribution System Enhancements

2.5 General Updates

2.6 Serena TeamTrack Integration

2.7 Platform Updates

3.0 Supported Platforms

3.1 Server OS and Requirements

3.2 Client and Browser OS and Requirements

3.3 Collage Deploy Agents

3.4 Supported Databases

3.5 Supported Web Servers

3.6 Supported Application Servers

3.7 Supported FTP Servers

3.8 Supported Mail Servers

3.9 Supported LDAP Directory Servers

3.10 Supported Integrations

4.0 Upgrades

4.1 General Upgrade Information

4.2 Upgrading on BEA WebLogic and IBM WebSphere

5.0 Known Issues

5.1 General Issues

5.2 Deployment Issues

5.3 Collage Contributor Issues

5.4 Integration Issues

5.5 Component Issues

5.6 Documentation Issues

6.0 Additional Important Information

6.1 Installation

6.2 Character Restrictions

6.3 Master Pages

6.4 Permissions

6.5 Spell Check

6.6 Deployment

6.7 Browser Configuration

6.8 Components

6.9 Collage Contributor

6.10 Integrations

7.0 Acknowledgements

 

Return to Contents


1.0 What’s New in Serena® Collage® 5.1.2

1.1 HTML Filtering Enhancements

All new (and upgraded) projects now include a file (AllowedFilterHTMLTags.xml) that specifies the specific HTML elements and attributes that contributors can enter when editing a document for which the Filter HTML setting is enabled. Contributors can save documents with any HTML elements and attributes that are explicitly listed in the AllowedFilterHTMLTags.xml file. Any elements and attributes that are not listed here are stripped out of documents, with the exception of HTML syntax that is allowed by the document definition file (DDF) for the document type.

For example, if <div> tags are not listed in the AllowedFilterHTMLTags.xml file, then they will be filtered out of all documents, by default. However, if the DDF for a particular document type is set to allow <div> tags, then contributors can add <div> tags to that type of document.

By default, the AllowedFilterHTMLTags.xml file is set up to filter exactly as previous versions had filtered. To customize the set of HTML elements and attributes allowed by default for documents for which Filter HTML is enabled:

  1. Create a new project, or upgrade an existing database to Collage 5.1.2 or later.

  1. Check out and edit the AllowedFilterHTMLTags.xml file from the following location:

/System /Internal Editor Setup

You can edit this file in any XML or text editor.

  1. To identify HTML attributes that should always be allowed, add the attributes to the following element:

  2. <AttributesAlwaysIncluded attributes="attribute1,attribute2"/>

  3. Add the following element for each HTML tag (and attributes within those tags) you want to allow, under the <AllowedTags> element:

<AllowedTag name="name" attributes="attribute1,attribute2"/>

For example:

<AllowedTag name="img" attributes="src"/>
  1. Save the file and check it in.

For more information, see Knowledgebase article 5005142, available from the Serena Support Website:

http://sos.serena.com/eSupport/Solutionshow.asp?solution_id=5005142

1.2 New Localized Editions

Collage is now available in French and German language editions.

1.3 New Platform Support

Collage now supports the following:

Return to Contents


2.0 What's New in Serena® Collage® 5.1

2.1 Collage Contributor

Collage Contributor is a simplified Web-based interface that allows you to easily contribute files to a Web site. The Collage Contributor Home Page provides easy access to all the tasks and files you are working on as well as assistants that simplify tasks through the use of customizable workflows.

2.2 Improved Folder Trees

Performance during the loading of folder trees in Collage has been improved using AJAX technology. Tree nodes are loaded on demand, drastically reducing initial render time.

2.3 Deploy Improvements

2.3.1 Reduced Deployment Time

The following changes were made in order to reduce the amount of time it takes to run a deployment:

2.3.2 Ability to Deploy Using SSH (SFTP)

When you set up a deploy web server, you can now choose to transfer files using any of the following options:

2.3.3 General Deployment Stability

2.4 Content Contribution System Enhancements

2.4.1 Ability to Edit Non-Contribution Documents Such as HTML and Plain Text

In the Preferences dialog box, you can now set up text files such as HTML, ASP, JSP, or plain text files to be editable using the Collage contribution editor.

2.4.2 Generation of XHTML Compliant Code

In the content contribution DDF file, you can now choose to make all code generated by the Collage Editor XHTML-compliant.

2.4.3 Server Side Spell Checker

The spell checker in the Collage contribution editor is now a server side function. As a result, Microsoft Word is no longer required for spell checking, and spell checking is supported for all supported browsers.

2.4.4 Enhanced CSS Support Including Global DDF for Managing Styles
2.4.5 Accessibility (Section 508) Enforcement for Content
2.4.6 Required Contribution Fields

Contribution fields can now be flagged as required.

2.4.7 Table Formatting Options

New formatting options include:

2.4.8 Edit Links in Contribution Editor

The Collage contribution editor now allows you to edit existing external links.

2.5 General Updates

2.5.1 Customizable E-mail Notifications

E-mail messages sent after a deploy has finished or when a task is transitioned can now be customized. For details, see KnowledgeBase article KB5002120 for deploy e-mail and KB5002121 for task e-mail messages on Serena Online Services.

2.5.2 Preview Masterpage

You can now set up a simplified masterpage to enable previews to load faster. Once you’ve created the simplified masterpage, you can assign it to the original masterpage. Preview operations for pages that use the original masterpage will then use the simplified masterpage, while deploys will continue to use the original masterpage. For details on setting up the preview masterpage, see KnowledgeBase article KB5002115 on Serena Online Services.

2.5.3 Single Sign-On

For single sign-on environments, Collage can be configured to authenticate against a Windows NT domain. For details, see KnowledgeBase article KB5001032 on Serena Online Services.

2.6 Serena TeamTrack Integration

The integration with Collage allows for the following functionality:

2.7 Platform Updates

Serena Collage 5.1 provides support for updated versions of several platforms. For details, refer to the section on Supported Platforms for more information.

Return to Contents


3.0 Supported Platforms

The components of this Collage release are supported on the platforms listed below.

3.1 Server OS and Requirements

3.1.1 Supported Operating Systems
3.1.2 Minimum Server Hardware Requirements

Processor

RAM (All platforms)

Disk Space (All platforms)

DVD-ROM Drive (All platforms)

Monitor Screen Resolution

Temporary hard drive space: 100 MB

IMPORTANT! Over time, as your projects grow, your database server (any platform) will likely require much more hard drive space than the minimum listed here. We therefore recommend starting with as much free space as possible, to alleviate maintenance issues later on.

3.2 Client and Browser OS and Requirements

3.2.1 Supported Operating Systems
3.2.2 Minimum Client Hardware Requirements

Windows:

Macintosh:

3.2.3 Supported Browser Applications

For Collage Classic, use one of the following browsers on Windows or Macintosh.

NOTE: You must enable ActiveX to using the Collage clients.

For Collage Contributor, use one of the following browsers on Windows and Macintosh.

NOTE: You must enable ActiveX to using the Collage clients.

NOTE: You will need the MSXML 4.0 SP2 plug-in.

IMPORTANT! Pop-up blocker browser plug-ins may cause issues with the Collage Web clients. For best results, disable any pop-up blockers before using the Web clients.

3.2.4 Supported Client JREs

You can find the installer under the JRE directory on the Collage DVD.

3.3 Collage Deploy Agents

3.3.1 Supported Deploy Agent Operating Systems

With Collage Enterprise edition, the Deploy Agent is supported on the following platforms:

3.3.2 Minimum Deploy Agent Hardware Requirements

512 MB minimum total RAM, 1 GB recommended. Total RAM requirement for the system depends on the demands of the application or Web server installed to it.

3.4 Supported Databases

You can use any of the following database servers with Collage to host your Admin database and project databases.

IMPORTANT!

Case-sensitive collation of databases is not supported.

3.5 Supported Web Servers

The following Web servers are supported with Collage:

NOTE: For details on setting up Collage with IIS, see KB article KB 5002288 at http://support.serena.com.

3.6 Supported Application Servers

The following Application servers are supported with Collage:

IMPORTANT! In order to support changes to Daylight Savings Time (DST) in 2007, you must apply a patch to WebSphere 5.1. Please consult the following for more information:

http://www-1.ibm.com/support/docview.wss?rs=0&uid=swg21219396

IMPORTANT! In order to successfully install Collage to WebLogic, WebLogic must be running during installation.

IMPORTANT! In order to support changes to Daylight Savings Time (DST) in 2007, you must upgrade the Java installation on the WebLogic server. For critical information on this upgrade, please consult the following:

http://support.bea.com//support_news/Patch_for_2007_Daylight_Savings_Time_Changes.jsp

3.7 Supported FTP Servers

The following FTP servers are supported for use with Collage:

3.8 Supported Mail Servers

Collage supports SMTP as its mail server.

3.9 Supported LDAP Directory Servers

Collage supports the following directory servers:

3.10 Supported Integrations

Collage integrates with the following products:

3.10.1 Macromedia Products
3.10.2 WebDAV Integrations
3.10.3 FTP Integrations
3.10.4 Serena Products

NOTE:

For information on the integration with TeamTrack, see the Serena Collage Integration with Serena TeamTrack document that accompanies Collage.

For information on the integration with Version Manager, see the Serena ChangeMan Version Manager Administrator's Guide on the Version Manager CD-ROM.

For information on the integration with Dimensions, see the Serena ChangeMan Dimensions/Serena Collage Integration Guide on the Dimensions Documentation CD-ROM.

Return to Contents


4.0 Upgrades

4.1 General Upgrade Information

Consider the following important information about upgrading previous versions of Collage:

For detailed information on installing Collage, see the Serena Collage Installation and Setup Guide.

4.2 Upgrading on BEA WebLogic and IBM WebSphere

For instructions on upgrading Collage installations running on BEA WebLogic or IBM WebSphere, see Upgrading Collage on IBM WebSphere and BEA WebLogic (Collage WS BEA Upgrade.pdf) located in the documentation installation directory on the Collage server, and downloadable from the Serena Support Website.

Return to Contents


5.0 Known Issues

5.1 General Issues

5.1.1 Windows: Performing Backups on Oracle Causes Resource Leaks

Backing up the Admin database or projects running on a Windows Oracle server causes resource leaks. These leaks can eventually cause Oracle to run out of resources and crash. Use Oracle’s backup facilities instead.

5.1.2 (TR3982) Macintosh Clients: Connecting to the Collage Server via FTP

From a Macintosh OS X client, you can establish an FTP connection to a Collage Server, which allows you to check out and edit assets from editor applications that support FTP. To do this, simply enter ftp://machine name:port in your browser.

However, note that once you have established an FTP connection, the connection is not closed until you restart the Macintosh client.

5.1.3 (TR4269, TR4270) Bundled Sybase Server: Cannot Use Reserved Words for Project Name, Username, Password

If you purchased the bundled Sybase database server, do not use the words "date" or "time" as your database owner usernames or passwords.

5.1.4 (TR3481) LDAP: Users Must Log In to Receive Email Notifications

If you use LDAP to manage your users and groups, users must log into Collage at least once before they can successfully receive task notifications via email. Once they have logged into Collage the first time, using their LDAP usernames, their email addresses are registered in Collage and they will always receive their task notifications.

5.1.5 (TR2470) WebSphere: Audit Log Export Not Supported

You cannot currently export audit logs from the System | Audit Log view when Collage is running on the IBM WebSphere server platform.

5.1.6 (TR2297) Page Not Found Error When Previewing Assets from a Task

An error may appear if you attempt to preview a page while working in context of an open task, if that page has a master page associated with it that is not approved. If this error occurs, approve the associated master page.

5.1.7 (TR5736) Contribution Editor: Merging Cells May Lead to Unexpected Results

In the Collage contribution editor, when you use the table cell merge above/below functionality, the visual results can look different than expected. This can happen if you merge cells that span one or more columns. This occurs because the position of the cell in the row where the merge is started is different from the position of the cells that appear to be located above or below this cell.

5.1.8 (DEF106336) Stack-trace Error When Displaying Contribution Folders

In Collage Classic, displaying a contribution folder that includes HTML elements in the description may result in a stack-trace error. This occurs when you log in as a different user than the user who created the the folder. You are then unable to access the contents of the contribution folder.

To avoid this issue, remove any HTML elements from the description field for contribution folders. From the Content | Search view, you can quickly find any contribution folders with descriptions that include HTML. Choose Description contains and enter an angle bracket character "<." Then, from the Type list, choose Contribution Folders.

5.2 Deployment Issues

5.2.1 (DEF72414) Changing Convert Option Does Not Cause AssetQuery Page to Generate

This issue occurs when you have an AssetQuery page with a link to a Microsoft Office document. If you change the convert option for a Microsoft Office document, and then perform an incremental deploy, the AssetQuery page is not redeployed, causing the link to the document to be incorrect. To fix the issue, you must deploy the AssetQuery page or do a full deployment. After that, you can perform incremental deploys.

5.2.2 (DEF85793) Windows: Files Do Not Get Deployed to Backup Directory

On Windows, files are not deployed to the backup directory specified in the deploy map. The folders are created in the backup directory but the files are not created.

5.3 Collage Contributor Issues

5.3.1 (DEF83653) Language and Project Preferences Do Not Work

The Language and Regional Display and Automatically Open Project options in the Preferences dialog box do not work as intended. You can set these preferences in the following places instead:

5.3.2 (DEF83653) Date and Time Fields Are Not Localized

When you set the date and time fields throughout Collage Contributor, the order of the fields (month, day, and year) may not reflect the locale that you selected on the Login page. Additionally, the calendar control may not display the correct day for the beginning of the week for your locale.

5.4 Integration Issues

5.4.1 Macromedia Contribute: Cannot Preview in Browser Without Folder Permissions

When you access Contribute's Preview in Browser feature, you may see the following error:

An error occurred. Please contact your administrator.

This error will occur if you do not have the following asset permissions granted on the folder that contains the page:

To preview the page without these permissions, you can preview from Contribute's built-in browser.

5.4.2 (DEF74904) Macromedia Contribute: Deleting Files That Are Referenced by Other Files Fails Without Error

When you try to delete a file from Contribute that is referenced by other files, the deletion fails, and no error is displayed in Contribute. The Collage server log displays the error:

One or more assets being deleted are currently being used/referenced by other assets. Delete anyway?

To delete the file, use Collage instead.

5.4.3 (DEF74541) Macromedia Contribute: Links Are Prefixed with http://

In the Contribute Insert Link dialog box, when you manually type the file name of an asset located in the same folder (or a lower folder) as the page you are editing, the link is automatically prefixed with http:// If you want to manually type the file name, prefix it with ./ For example:

./myfile.htm

./myfolder/myfile.htm

Alternatively, you can browse to the file to which you want to create a link.

5.4.4 (DEF76616) Macromedia Contribute: Links Generated by AssetQuery Fail in Browser Preview

When you preview a page using Contribute's Preview in Browser feature, any links generated by the AssetQuery component will fail when you click them. You can preview the links using Contribute's built-in browser.

5.4.5 (DEF77211) Macromedia Contribute on Macintosh: Auto-Generated Images Are Not Visible in Edit Mode

On Macintosh, any auto-generated images are not displayed when you edit a page. The images are displayed when you preview the page in Contribute's built-in browser.

5.4.6 (DEF76694) Macromedia Contribute: Incorrect Path Created to Image When "Write links relative to the root" Option Selected

In the Contribute File Placement Rule dialog box, do not select the Write links relative to the root of the website option. If this option is selected and new images are added to an HTML document, the paths to the new images are incorrect, resulting in broken images when deployed.

5.4.7 (DEF75911) Macromedia Contribute: New Images Are Not Placed in Folder Defined by Document Definition File

When working on a contribution document in Contribute, any new images that you create are not placed in the folder defined by the document definition file by default. The new images are placed in a folder called "images", which is created in the same folder as the contribution document you are editing. This default can be changed by updating the File Placement options for the Contribute user's role.

5.4.8 (DEF76489, DEF76539) Macromedia Contribute: Able to Add Links and Images Not Allowed by Document Definition File

Contribute does not adhere to the Exposed folders setting for link and image fields in the document definition file. Contribute allows you to add links or images to or from any folders, even if the Exposed folders setting is restricted to contribution folders only.

5.4.9 (DEF76513) Macromedia Contribute: Switching Home Pages in Contribute Preview Causes Error

If you have multiple connections enabled, and you switch home pages using the Home Page button in the Contribute toolbar, you may receive the following error:

HTTP Status 500 Internal Error. Unknown Error Occurred.

To correct this problem, click the Refresh button in the Contribute toolbar.

5.4.10 (DEF76625) Macromedia Contribute: Collage Switches from Contents of Current Project to Project Opened in Contribute

You can preview pages using the Preview in Browser feature in Contribute. If you do this on a machine on which the Collage UI is currently open, Collage will switch to display the project to which the page belongs. To prevent this from happening, use a different browser to preview pages in Contribute than the browser that you use for Collage.

5.4.11 (DEF76915) Macromedia Contribute: Extension of Contribution Documents in Recycle Bin Does Not Change

Enabling the Contribute integration changes the extension of existing contribution documents from .xml to .ccd. The extension of any contribution documents in the Recycle Bin does not change. If you restore the contribution documents from the Recycle Bin, you will not be able to work with them in Contribute.

In this situation, the restored assets will have to be manually updated to use the .ccd file extension. After changing the file extension, verify that the Asset Type and Mime-Type are correct for this contribution asset. After this change, the documents can be modified through Contribute.

5.5 Component Issues

5.5.1 (DEF67661) WAR Filer Component: WAR Files Are Not Deployed

The WAR Filer Component, which you can use to automate the packaging and deployment of WebARchive (WAR) files, may fail to deploy the compiled WAR files. This failure occurs due to changes in the deployment features.

To ensure that WAR files successfully deploy, complete the following steps, in addition to the instructions provided in the collage_warfiler_component.pdf file. This file is available from Serena Online Services in KnowledgeBase article #70204.

  1. Create an empty WAR file on your system.

  1. Give the empty file the same name that you specified for the Web Application's Context Name property, in the component property settings (in the Project | Components view). The file must have the .war file extension.

  2. Add or upload the empty file to the \WarContents deploy folder.

  3. Approve the file.

The WAR file should now successfully deploy.

5.6 Documentation Issues

5.6.1 (DEF05205) Components Guide: Incorrect Example for Metafilter Property

In the Components User’s Guide, the AssetQuery section displays an incorrect example for the metafilter property. The guide states:

The correct example is:

5.6.2 (TSK04894) Web Services Guide: Updates to Setup Steps

The Web Services Getting Started Guide has not been updated for this release. The following corrections should be noted:

5.6.3 (DEF05848) Help: Link Broken on Select Your Project Page

The help link for the Select Your Project Page does not work. To access the help for this page, log in and click the Help link. On the Contents tab, navigate to Getting Started | How to Log Into a Project.

5.6.4 (DEF06274) TeamTrack Integration Guide: Incorrect Import Step

The TeamTrack Integration Guide incorrectly states that you should import the database schema from the file ttintegr_schema.xml. However, doing so results in the following error: "Wizard Error: Cannot import a TeamTrack solution."

To correct this issue, you should instead import the following file: ttintegr_schema_aux.xml.

5.6.5 (DEF06390) Components User's Guide: Incorrect AssetQuery Explanation

The Components User's Guide incorrectly states that the AssetQuery component will only return assets that will be deployed. The AssetQuery component does not actually have this limitation.

5.6.6 (DEF06392) Components User’s Guide: Invalid Macro Examples for Select Component

The Components User’s Guide lists invalid examples of data field macros. For example, for $type.assetid macros, the included usage examples are:

Each of the above example macros is incorrect. They should be: $node.assetid, $publishmap.assetid, and $parent.assetid. The same errors appear in subsequent examples of other types of macro.

5.6.7 (DEF06393) Components User’s Guide: Incorrect Example Usage of creator Macro Type

The Components User’s Guide includes the following incorrect example usage of the creator data field macro type:

For example, to display the ID of the user who created the asset’s deploy map:

$parent.creator

This example is incorrect. The macro should actually be:

$publishmap.creator

5.6.8 (DEF06046) Undocumented Properties from nas.properties File

The Collage Installation and Setup Guide contains information on how to update properties in the nas.properties file. However, the following properties are missing from the nas.properties appendix:

Key

Description

LoginHeader

Sets the header for the login page.

LoginText

Sets the login text on the login page.

LogoutURL

The URL that the user gets redirected to after logout.

BrowserKeepAliveInterval

The amount of time in, in seconds, between pulses from the applet and the Collage server. This setting maintains the session for a specific amount of time even if you are not actively using it.

webServiceTimeout

The maximum inactive time in seconds for a web services session

docConvertPath

Sets the URL to the Microsoft Office document converter. Set by installer during install to:

http://localhost/PDFConverterServlet/pdfservlet

VMRootPath

Points to the path where the Version Manager client is located when the VM integration is installed.

DimensionsRootPath

Points to the path where the Dimensions client is located when the Dimensions integration is installed.

EmailHost

The name of the SMTP server to use to send emails from Collage.

EmailSource

The name of the sender of email sent from Collage.

locale

The default locale of the server to use when user's locale is not found.

MaxInactivityTimeout

In seconds, maximum amount of time any client can be inactive before the session is timed out.

DeployTransferTimeout

The socket timeout in seconds for transfering files using FTP.

DeployTransferAttempts

The number of times an attempt to transfer a single file will be made before considering it a failed transfer.

DeployConnectAttempts

The number of connection attempts to FTP server before considering it a failed connection.

logfilelimit

Size in KB. Limits the size of the Collage log file.

altTempPath

Temp directory used by client side applet. If you enter a value, this path is tried after the default paths (C:\temp and A:\temp).

MarkupASP

Value of false prevents any code within ASP or JSP <%%> blocks from being tracker.

MarkupPHP

Value of false prevents any code within PHP <%%> blocks from being tracked.

CCFilterExp

Prevents certain tags from being stripped from CCS documents that use the Filter HTML option. See Support Knowledgebase article KB70526 for details.

RemoveTrailingLineBreaks

Value of true removes all trailing <br> or <br/> tags from any contribution fiels after the user saves the document. Value of false will only remove <br> or <br/> tags if one of these tags is the only content in the field.

AllowBlankPasswords

Value of false forces all users to enter a password on the login screen.

5.6.9 (DEF05989) Restoring a Project Database on Sybase or SQL

The Project Manager’s Guide does not explain how to restore a backup of a project database with Sybase or MS SQL database servers. You must complete these steps before you can load the database back into Collage.

To restore a project database you must:
  1. Shut down Collage. For information on starting and stopping Collage, refer to the Serena Collage Installation and Setup Guide.

  1. Do one of the following:

    DB Platform

    Procedure

    Bundled Sybase

    Copy the database files from the backup location to the project database location. For example, on Sybase, copy the backup copy of the admin.db file (and its corresponding log and data files) back to the Collage\Project directory.

    MS SQL

    You or your database administrator must first restore the backed up project database to your MS SQL server, using the MS SQL Server Enterprise Manager.

  2. Restart Collage.

  3. Next, you can load the project into Collage. For information on loading projects, see the Collage Installation and Setup Guide.

5.6.10 (DEF06604) Installing the Collage Agent on AIX

The Collage Installation and Setup Guide does not explain how to install the Collage Agent on AIX.

To do this:

  1. Insert the DVD.

  1. Copy the appropriate file from the following directory on the DVD to an empty directory on your system: /DeployAgent/agentSetupAIX

  2. Go to the directory to which you copied the file from the DVD and enter the following command to run the installer:

GUI installer: ./agentSetupAIX

Text-based installer: ./agentSetupAIX -console

  1. Follow the onscreen prompts to complete the install. With the exception of the Windows Service option and the default install directory (/opt/serena/agent on UNIX or Linux), the install options are identical to the install options for Windows platforms.

NOTE Unless you logged in as root, you must set the port number to a value greater than 1024. By default, the port number is 9999.

5.6.11 (TSK06842) Installation and Setup Guide Describes Obsolete Server Properties

The following obsolete server properties are documented in Appendix A of the Collage Installation and Setup Guide:

These have been superceded by two new server properties, MaxInactivityTimeout and BrowserKeepAliveInterval. These properties are described in "(DEF06046) Undocumented Properties from nas.properties File" on page 17.

5.6.12 (IDD DEF06135) Imported LDAP Certificate Format

The Collage Installation and Setup Guide incorrectly states that when importing an LDAP certificate, the file must be in pk7 format. The certificate should in fact be X.509 format. An error appears if you attempt to import a pk7 certificate.

Return to Contents


6.0 Additional Important Information

6.1 Installation

6.1.1 Installing to WebLogic

In order to successfully install Collage to BEA WebLogic, WebLogic must be running during installation.

6.2 Character Restrictions

6.2.1 Non-ASCII Characters Converted in URLs

Collage allows you to use non-ASCII characters when naming projects and folders. However, because browsers do not universally support non-ASCII characters in URLs, Collage converts any non-ASCII characters in file references to ASCII escape characters. For example, you can create a folder with the following characters in its name:

If you then create references to files in the folder, Collage will convert these characters to encoded ASCII characters, such as: %F6%E4. For example, <img src="¶/image.gif"> will be encoded to be <img src="%F6%E4/image.gif">. To avoid such URL and path conversion, do not include non-ASCII characters in folder or project names.

6.2.2 Restricted Characters for Project Names

The characters listed below cannot be used in project names:

6.2.3 (TR2239) Do Not Use Commas (,) or Plus Signs (+) in Asset or File Names

Do not add files to Collage that include commas (,) or plus signs (+) in their names. Errors may occur when you attempt to check in, check out, preview, or display source code for assets with commas or plus signs in their names.

6.2.4 Do Not Use Commas (,) in Asset Type Names

Do not create asset type names that include commas (,). This causes problems when you create new files using an assistant in Collage Contributor.

6.2.5 (TR746) Use Western European Characters Only for Document Type Names

When creating contribution document types, use Western European characters only (ISO 8859-1 character encoding) to name them. Though Collage may appear to successfully create document types that are named using other characters, such as Asian characters, errors may result.

6.2.6 Restricted Characters for User and Group Names

The characters listed below cannot be used in group or user names. Even when using LDAP security, these characters may cause problems:

6.2.7 (103482) Do Not Use Non-ASCII Characters in Asset Names

Non-ASCII characters, such as Cyrillic and Greek characters, are not supported for asset names in Collage.

6.2.8 (TR5498) Copying Projects with Non-Western European Metadata Names

If you attempt to copy a project that includes metadata fields with non-Western European characters (such as Asian characters) in their names, the copy may fail. To ensure that you can successfully copy projects with non-Western European metadata field names, first rename the metadata fields using Western European characters, copy the project, then restore the characters in the new, copied project.

6.3 Master Pages

6.3.1 (TR1376) Using Master Pages with Microsoft Office Files

You can apply master pages to most types of Microsoft Office files, including Microsoft Word and Excel files. When you deploy the files, if Office and GhostScript are installed to the Server, Collage will convert the files to HTML and apply the master pages to them.

However, because Microsoft PowerPoint files (.PPT) are saved to multiple HTML files when they are converted, you cannot apply master pages to them.

6.4 Permissions

6.4.1 (ENH64736) Users Can Delete Assets While Working in a Task

Note that all users, while working in context of an open task, can delete assets that are associated with that task, so long as the assets are not yet approved. To prevent contributors from accidentally deleting assets, you can set asset permissions appropriately.

6.5 Spell Check

6.5.1 Using Spell Checker with Other Languages

The Collage spell checker includes a Locale2LexiconMapping.xml file, located in install directory/sql/lex, that maps locales to the appropriate language dictionary. If the country code for a locale doesn’t exist in the mapping file, the first entry that contains the appropriate language is used. For example, if you are spell checking Australian English (enAU), the UK dictionary is used, as this is the first entry in the mapping file that contains the English language.

You can move the entries in this mapping file so that your desired language dictionary is used for country codes that aren’t in the file. For example, you can move the enUS entry to the top of the "en" languages. In this case, if spell checking Australian English, the American English dictionary would be used.

For more information, see the KnowledgeBase article number 5000940 from the Serena Support Web-site.

6.6 Deployment

6.6.1 Reserved Word Fields Renamed in Database Deploy

When you deploy contribution documents to a database, the contents from those documents are typically stored in a database column that is named after the content field. For example, if a content field called Body is deployed to a database, content from this field is stored in a database column called Body.

However, if any of the content field names are reserved SQL words (such as Date or Time), an underscore is appended to the end of the field name, when creating the corresponding database column. For example, content from a content field called Date will be stored in a database column called Date_.

6.7 Browser Configuration

6.7.1 Solaris and Linux Server Installs: Windows IE Clients Hang

When you access Solaris or Red Hat Linux installations of Collage with Microsoft Internet Explorer on Windows, Internet Explorer may hang. This occurs because, by default, Internet Explorer does not support more than two connections at a time to any server that uses HTTP version 1.1. Solaris and Red Hat Linux installations of the Collage Server use HTTP version 1.1, and the Collage client uses multiple frames, each of which may connect concurrently to the Collage Server.

To resolve this issue, update the Windows registry setting on each client machine to allow Internet Explorer to use more than two HTTP 1.1 connections at a time. To make this change, add a registry key in HKEY_CURRENT_USER\Software\Microsoft\Windows\ CurrentVersion\Internet Settings called MaxConnectionsPerServer and give it a value of 00000004.

A .reg file to help automate this process is available in KnowledgeBase article KB70176, accessible on Serena Online Services.

For more information on this Internet Explorer limitation, see http://support.microsoft.com/default.aspx?scid=kb;en-us;279745.

6.7.2 Windows XP SP2: Security Settings May Disrupt Viewing of Online Help

When you upgrade to Windows XP Service Pack 2, default security settings are changed. These changes can cause messages to appear that prompt you to explicitly allow the Help system to be viewed.

To allow the Help system to be viewed without seeing warnings, perform the following steps.

  1. Open Internet Explorer.

  1. Go to Tools | Internet Options.

  2. Click the Advanced tab.

  3. Scroll down to the Security section.

  4. Select the Allow active content to run in files on My Computer check box.

  5. Click OK.

6.7.3 (DEF79437) Windows XP SP2: Security Settings May Cause Popup Menu Error

With Windows XP SP2, the following security warning may appear when working in Collage:



 
Windows has blocked this software because it can't verify the Publisher
Name: PopupMenu.dll
Publisher Unknown Publisher

To allow access to popup menus, add the Collage host name to the list of trusted sites in Internet Explorer (Tools | Internet Options | Security | Trusted Sites).

6.8 Components

6.8.1 Solaris and Linux: Errors Generating Images

On Solaris or Linux, if you will use any image effects or image generation features, such as the Navigation Bar component to generate image-based navigation buttons, see KnowledgeBase article KB70344, accessible on Serena Online Services.

6.9 Collage Contributor

6.9.1 (DEF90495) Advanced Search Issues in Firefox

When you start an advanced search in Collage Contributor, using the Firefox browser, you may encounter the following error message:

A script on this page may be busy, it may have stopped responding. You can stop the script now, or you can continue to see if the script will complete.

Firefox displays this error when a script takes longer to load than is allowed by a specific browser setting. To avoid seeing this error:

  1. Enter about:config in the Firefox address bar.

  1. Scroll to the following value: dom.max_script_run_time

  2. Set the value to something higher than the default, which is just 5 seconds.

6.10 Integrations

6.10.1 Dreamweaver 4: No UTF-8 Support Results in Truncated Layout Files

Macromedia Dreamweaver 4 does not support the UTF-8 character set, which is the recommended character set for contribution layout pages. If you check in layout files that are not correctly UTF-8 encoded, the layout files may be truncated, which can result in data loss. If you are using Dreamweaver 4 to edit CCS layout pages, you must convert the html file to UTF-8 before checking it in to Collage. You can use Windows Notepad to convert files to UTF-8 by choosing File | Save As and specifying the UTF-8 character set.

6.10.2 (DEF74519) Macromedia Contribute: Exception in Server Log When Deleting a File

When you delete a file from Contribute, Contribute attempts to create a copy of the deleted file and a design notes file (.mno). This causes errors in the Collage server log. To prevent this from happening, make sure that the Contribute option Remove rollback versions on delete is selected on the Edit Role Name Settings dialog box (Folder/File Access category).

Return to Contents


7.0 Acknowledgements

Sun Technology Licensing Information

This product includes code licensed from RSA Security, Inc. Some portions licensed from IBM are available at http://oss.software.ibm.com/icu4j/.

Solaris: Collage Uses Public GNU Tool

Collage uses the GNU Ghostscript tool, which is protected under the GNU Public License. This license agreement states that you have the right to access the source code for this tool. The source code can be found online at the following location:

ftp://ftp.gnu.org/gnu/ghostscript/

Return to Contents


End Readme
Copyright © 2005-2007 Serena Software, Inc. All rights reserved.