Files configuration properties

Overview

Modify properties in files-config.xml. After making changes, restart the Files server.

Restrictions:

• All configuration properties (except those with multiple values) are required.
• .enabled properties must have boolean values of either true or false.
• Number values must be integers.

Properties

activeContentFilter.enabled

Does not apply to this release.

api.indent.enabled

Whether the Files service API output is indented. Default is false. Enable to help with development and debugging. Default disabled as it affects performance.

cache.http.publicContentMaxAgeInSecs

Maximum age of the public content cache before it is refreshed, in seconds. The public content cache stores static web resources, such as JavaScript and images. Decrease to show resource changes more quickly. Must be greater than or equal to 0. We can force a resource update by editing LotusConnections-config.xml, and setting the versionStamp property to any token. This token is included in most urls, so changing this token changes the url. Since urls are cached by path and cache header, the new url overrides the old url and refreshes the resources. Some resources, such as some images, do not use version stamps. If we edit those frequently, we can decrease this value to show changes more quickly.

cache.http.publicFeedMaxAgeInSecs

Maximum age of the public feed cache before it is refreshed, in seconds. Public feeds pass information to the Public Files view. Consider raising in very large deployments (for example, over a million files) to avoid performance issues. It could also be decreased to have very up-to-date information in the public view. A value of 0 means no feeds are cached. Must be greater than or equal to 0.

cache.user.timeout

Number of milliseconds user objects stay in the user information cache, which stores metadata about users, such as names and email addresses. Controls the frequency of requests to the Files database for user information. Must be greater than or equal to 1. If the value of a user's data changes in the background (when the update user task or commands for MemberSynch are executed) the cache is invalidated.

db.dialect

Current database type. Typically specified during installation. Accepts the values DB2, Oracle, or SQL Server.

directory.community.membershipCache.maximumAgeOnLoginInSeconds

Number of seconds after a user logs in that community membership cache is refreshed. Only applicable if Community Files and Community Integration are enabled. Must be greater than or equal to 0. Refreshing the cache is required for a user to have the same access as the community, but it affects performance. A short time before refresh means Files is more up-to-date, but performance may be slower. A long time before refresh may affect performance less, but users do not have immediate access to what the community can access. We can decrease the value here and then tell users that logging out and then in again is the best way to refresh the cache.

To accomodate frequent requests, increase the number of seconds using...

directory.community.membershipCache.maximumAgeOnRequestInSeconds

directory.community.membershipCache.maximumAgeOnRequestInSeconds

Number of seconds after an application request that the community membership cache is refreshed. Only applicable if Community Files and Community Integration are enabled. Must be greater than or equal to 0. Refreshing the cache is required for a user to have the same access as the community, but it affects performance. A short time before refresh means Files is more up-to-date, but performance may be slower. A long time before refresh may affect performance less, but users do not have immediate access to what the community can access. If we decrease the value of...

directory.community.membershipCache.maximumAgeOnLoginInSeconds

...and then tell users that logging out and then in again is the best way to refresh the cache, we can increase this value to 10 or even 20 minutes, so that frequent requests will not affect performance.

directory.group.membershipCache.maximumAgeOnLoginInSeconds

Number of seconds after a user logs in that the group membership cache is refreshed. Only applicable if groups are enabled. Must be greater than or equal to 0. Refreshing the cache is required for a user to have the same access as the group, but it affects performance. A short time before refresh means Files is more up-to-date, but performance may be slower. A long time before refresh may affect performance less, but users do not have immediate access to what the group can access. We can decrease the value here and then tell users that logging out and then in again is the best way to refresh the cache. This would allow you to increase the number of seconds in directory.group.membershipCache.maximumAgeOnRequestInSeconds so that frequent requests would not affect performance.

directory.group.membershipCache.maximumAgeOnRequestInSeconds

Number of seconds after an application request that the group membership cache is refreshed. Only applicable if groups are enabled. Must be greater than or equal to 0. Refreshing the cache is required for a user to have the same access as the group, but it affects performance. A short time before refresh means Files is more up-to-date, but performance may be slower. A long time before refresh may affect performance less, but users do not have immediate access to what the group can access. If we decrease the value of...

directory.group.membershipCache.maximumAgeOnLoginInSeconds

...and then tell users that logging out and then in again is the best way to refresh the cache, we can increase this value to 10 or even 20 minutes, so that frequent requests will not affect performance.

directory.typeaheadSearch.maximumResults

Maximum number of names to display when a user searches for user or group names in a search field. Sets a maximum for both typeahead results and search results (when they click the search icon). Must be greater than or equal to 1. If the value is very large, such as 1,000, and there are 1,000 or more matches, all names are returned and performance is greatly reduced. If the value is low, such as 10, users typing a generic name might not see all matches.

download.modIBMLocalRedirect.enabled

Whether the IHS serves downloaded files instead of the WAS redirect servlet. We can configure IBM Connections to have the IHS download files. This is strongly recommended in production environments. If true, also specify a URL in the property...

download.modIBMLocalRedirect.hrefPathPrefix

If the property is set to false, the WAS redirect servlet downloads files.

download.modIBMLocalRedirect.hrefPathPrefix

Path to the file system directory where Files data is stored. The file path should not include a trailing slash. This is only relevant if the download.modIBMLocalRedirect.enabled property is true.

download.stats.logging.enabled

Level of detail to log about file downloads. If true, the Files application logs detailed download statistics, including the names of authenticated users who download files, and the version they most recently downloaded. If false, the applications only log the number of times a file is downloaded. Specify true for a better user experience and auditing.

emailNotification.addOnMediaDownload.enabled

Whether to send email notification to users who download a file when the file is edited. The download.stats.logging.enabled property must be true for this to work.

file.attachment.maximumSizeInKb

Does not apply to Files. Files does not have attachments, the value in this property will not affect the application.

file.media.maximumSizeInKb

Maximum size allowed for media, in kilobytes. In Files, media are files. Must be greater than or equal to 1. This property is useful if you want a relatively large quota size for libraries, but you do not want users upload very large files, such as .iso files. After changing this value, the maximum size limit will not change for users until their browser cache is refreshed. We can force a refresh by running a command to update the product version stamp. see Required post-customization step for more information on forcing a browser cache refresh.

file.page.maximumSizeInKb

Does not apply to Files. Files does not have pages, the value in this property will not affect the application.

file.restrictions.enabled

Enable or disable ability to restrict the types of files that users can upload in Files. Accepts the values true or false.

file.restrictions.mode

Mode for file extension restrictions. Accepts the values allow or deny. If the value is allow, then users can only upload files with extensions on the list, or change the extension of existing files to those on the list. If the value is deny, then users can only upload files with extensions not the list, or change the extension of existing files to those not the list.

For example:

<file>
 ....
 <restrictions enabled="true" mode="allow">
  <extensions>
   <extension>odt</extension>
   <extension>odp</extension>
   <extension>ods</extension>
  </extensions>
 </restrictions>
</file>

file.storage.rootDirectory

Path to the file system directory where Files data is stored. This can be set during installation and be different for each node in a cluster. If a directory is specified in during installation this value (a variable by default) is populated by the WAS. However, we can specify any directory. IBM Connections looks for a files and a temp directory in this directory. If they are not there they are created. The temp directory stores data while the data is uploaded or virus scanned (if enabled). The files directory contains the binary data that must be backed up.

file.versioning.enabled

Whether file versioning is allowed. Specify true or false. If false, the versioning interface does not display and the first version is always current. If we disable this after multiple versions of a file are created the latest version becomes the current and only version. Note that new versions are created only when content changes, not title or tags or other metadata. Specify false to simplify and reduce data storage.

preview_enabled

If set to true, allows the thumbnail grid and Preview dialog with an enlarged thumbnail image to display in Files and Community Files.

publicMedia.maximumResults

Maximum number of files displayed in public views.

For example, the default setting of 1000 means public views can only have 1000 files. Adjust this property to improve performance. Must be greater than or equal to 100.

renditions

Whether Files can generate previews for files types that can be displayed inline in areas as the activity stream, embedded experience gadget, and media gallery widget. Only JPEG, JPG, GIF, and PNG file types are available for preview. The generated previews can be in JPG (default) or PNG format. The following renditions enabled sample enables display of thumbnail images and specifies image format and size for each preview style:

<renditions enabled="true">
    <small format="JPG" width="100" height="100"/>
    <medium format="JPG" width="250" height="250"/>
    < large format="JPG" width="500" height="500"/>
</renditions>

For data existing before Connections 4.0, we can use the following scheduled task to enable and generate previews for supported file types.

<task name="RenditionDailyGeneration" interval="0 0 0 * * ?" enabled="true" type="internal"></task>

scheduledTasks.DirectoryGroupSynch.args.maximumDataAgeInHours

Number of hours that group information can remain in the Files database before the synchronization task can run on it. Does not run if groups are disabled. Must be greater than or equal to 0. The synchronization task runs automatically in the background, synchronizing group names in the Files database with the Connections user directory. It queries the user directory with the directory ID and when it finds a match it synchronizes the group name.

The task runs on any group information older than the value specified in the property...

scheduledTasks.DirectoryGroupSynch.args.maximumDataAgeInHours

It pauses between groups for the amount of time specified in the property...

scheduledTasks.DirectoryGroupSynch.args.pauseInMillis

scheduledTasks.DirectoryGroupSynch.args.pauseInMillis

Number of milliseconds the synchronization task should wait before updating the next group's information. Use this to add a small amount of time between synchronizing items in the queue to avoid overloading the user directory as the task runs. Does not run if groups are disabled. Must be greater than or equal to 0. The synchronization task runs automatically in the background, synchronizing group names in the Files database with the Connections user directory. It queries the user directory with the directory ID and when it finds a match it synchronizes the group name.

The task runs on any information older than the value specified in the property...

scheduledTasks.DirectoryGroupSynch.args.maximumDataAgeInHours

It runs at a frequency specified in the property...

scheduledTasks.DirectoryGroupSynch.interval

It pauses between groups for the amount of time specified in the scheduledTasks.DirectoryGroupSynch.args.pauseInMillis property. Zero is an acceptable value if the remote user directory can handle many simultaneous queries.

scheduledTasks.DirectoryGroupSynch.enabled

Enable or disable synchronization task for groups. The default is true. The synchronization task runs automatically in the background, synchronizing group names in the Files database with the Connections user directory. It queries the user directory with the directory ID and when it finds a match it synchronizes the group name. If the group name is not found in the user directory, it is removed from the database.

scheduledTasks.DirectoryGroupSynch.interval

Frequency with which the synchronization task runs. Chronological expression. The synchronization task runs automatically in the background, synchronizing group names in the Files database with the Connections user directory. It queries the user directory with the directory ID and when it finds a match it synchronizes the group name. The task runs on any group information older than the value specified in the property...

scheduledTasks.DirectoryGroupSynch.args.maximumDataAgeInHours

It runs at a frequency specified in the property..

scheduledTasks.DirectoryGroupSynch.interval

It pauses between groups for the amount of time specified in the property...

scheduledTasks.DirectoryGroupSynch.args.pauseInMillis

Adjust this property to speed up or slow down the process of synchronizing group information.

scheduledTasks.FileActuallyDelete.args.softDeleteMinimumPendingTimeInMins

Number of minutes that files must be in the pending deletion queue before the delete files task will delete them.

For example, the default value of 720 means they will be deleted if they have been in the pending deletion queue 720 or more minutes. Must be greater than or equal to 0.

More pending time allows users to finish downloads of files added to the pending deletion queue. It also allows looser online back up policies. For example, for online backups that take less than this number of minutes you do not need to pause the file deletion task.

scheduledTasks.FileActuallyDelete.enabled

Enable or disable delete files task. The default is true. The task deletes files if they are marked as pending deletion, and they are older than the value specified in the property...

scheduledTasks.FileActuallyDelete.args.softDeleteMinimumPendingTimeInMins

scheduledTasks.FileActuallyDelete.interval

Frequency with which the delete files task runs. Chronological expression. Files are deleted if they are marked as pending deletion, and they are older than the value specified in the property..

scheduledTasks.FileActuallyDelete.args.softDeleteMinimumPendingTimeInMins

scheduledTasks.MetricsDailyCollection.enabled

Whether to collect metrics. Specify true or false. The collection task runs near midnight in the server timezone, so all of the date-based metrics include data from most of a given day. Metrics entries only require a few kilobytes per day, so there is little performance impact to enabling them.

scheduledTasks.MetricsDailyCollection.interval

Frequency with which daily metrics collection task runs. Only the default is supported: the task can only run at midnight in the server timezone. Do not edit this property.

scheduledTasks.TagUpdateFrequency.enabled

Whether to run the tag frequency update task. This task finds the most frequently used tags in public files updates the public files tag cloud.

scheduledTasks.TagUpdateFrequency.interval

Frequency with which the tag frequency update task runs. This task finds the most frequently used tags in public files and updates public tag clouds and the autocomplete lists that display when users type a tag name in the tag filter field. For example, it measures how often the tag human-resources is used in public files and updates the cloud and lists accordingly. Chronological expression. Update tag frequency data is resource-intensive, so you may want to adjust this value as your deployment grows. In small deployments 60 minutes is appropriate. In large deployments, once per day is recommended. Only updating once per day in large deployments should not cause problems, since the 100 to 500 most-used tags do not change very often. This property only affects public tags. Tag clouds for one person's set of files are updated in real time and are not affected.

scheduledTasks.SearchClearDeletionHistory.enabled

Whether to run the task. Specify true or false.

scheduledTasks.SearchClearDeletionHistory.interval

Frequency with which the task runs. Chronological expression

scheduledTasks.RenditionDailyGeneration.enabled

Whether to run the rendition task. Specify true or false.

scheduledTasks.RenditionDailyGeneration.interval

Frequency with which the rendition task runs. Chronological expression.

search.seedlist.maximumIncrementalQuerySpanInDays

Number of days that deletion records are saved before they are eligible to be deleted by the SearchClearDeletionHistory task. Must be greater than or equal to 1.

Files keeps records of deleted files. These records are eligible to be deleted by the SearchClearDeletionHistory task after the number of days specified in this property. The incremental search crawler needs these deletion records to update the search index. If the records are deleted before the incremental crawler reads them, updates will be incomplete. This is not allowed, so Files performs a full crawl instead of an incremental crawl. Full crawls delete the existing search index and create a new one, which is more time consuming than incremental crawls.

To avoid frequent full crawls, set this value higher than the span of days between incremental crawls. For example, if incremental crawls happen every four days, set this value higher than 4. This ensures that incremental crawls capture all deletion records.

search.seedlist.maximumPageSize

Maximum number of items on search return page. Must be greater than or equal to 100.

security.inlineDownload.enabled

Enable inline display of files. This is useful when we use the Files API to download and display active content, such as Adobe Flash (.swf) files, in our own HTML pages. By default, the Connections server passes Files application files to browsers with the header Content-Disposition: attachment. This means files display as attachments; when users click the attachment they are prompted to open or download the file. It also prevents embedding files. To embed files in our own HTML page using an <embed> tag, the content disposition must be inline. This affects active content, such as Adobe Flash (.swf), and HTML pages referenced with <iframe>. Configure a property in files-config.xml to change the content disposition from attachment to inline. Then set the inline parameter to true in the Files API download requests. Files uses the attachment disposition for security reasons. Uploaded files could potentially contain malicious code that can exploit the cross-site scripting vulnerabilities of some browsers. If we switch to inline disposition, you should configure an alternate domain download for greater security. Accepted values are true and false.

security.logout.href

Logout URL for single-sign on solutions that require their own logout page.

If we are configuring IBM Connections to work with Tivoli Access Manager, specify the following value:

/files/ibm_security_logout? logoutExitPage=<url>

...where <url> is the Tivoli Access Manager junction URL (this is usually the host name of the server).

Use fully-qualified domain names. If short names are used, secure communications between servers will fail.

If we customize the contextroot for Files in WebSphere Application Server and LotusConnections-config.xml, also change the contextroot in the security.logout.href value. Otherwise, users will be unable to log out.

tagFilter

Maximum number of tags to filter Files search results. The default is 3. A value greater than 10 is not recommended for performance reasons. Format is :

<tagFilter maximumTags="5"/>

Parent topic:
Change Files configuration property values

Related:
Secure applications from malicious attack
Scheduling tasks
Disable file versioning
Enable single sign-on for Tivoli Access Manager
Back up Files data
Configure file downloads through IBM HTTP Server
Required post-customization step
Display files inline
Restrict file types in Files
Files administrative commands
Common configuration properties