Enable selective file caching

Use the following steps to configure your site for selective file caching. Procedure Make the following updates to the fmsmaster.xml and fsc.xml files: Ensure FSC IDs contain only letters, numeric digits, underscores ("_"), and hyphens ("-"). Specifically, remove or change any of the following characters in any of the FSC IDs: Commas (",") Colons (":") Semicolons (";") Apostrophes ("'") Question marks ("?") Asterisks ("") Any characters that cannot be used as part of a file name, such as horizontal tabs and quotation marks. Any characters or character sequences that may interfere with the parsing of regular expressions. For example, "[0-9]". For any combination of FSC ID lists that will be deployed as part of the site's selective file caching implementation, shorten any FSC IDs that would collectively exceed 512 bytes of escaped, comma-separated, URL-encoded UTF-8 text. If shortening is problematic, consider using the asterisk ("") character as a wildcard to represent all FSCs. Using the Business Modeler IDE, set up the custom business rules by which selective file caching will work at your site. Conditions return true if the dataset is to be cached. Conditions return false if the dataset is not to be cached. Fnd0DatasetShouldFSCCacheThisDataset condition This condition defines the dataset instances that are not cached on restricted FSC servers, using the Dataset_Selective_File_Caching_Rule_Condition_And_Blacklist preference. By default, the condition is set to isTrue(), specifying that all datasets are to be cached. Override this condition with a custom template defining the business rules for your site's selective file caching. The definition of this condition depends entirely on your site's security requirements. As an example, the following expression returns true for all datasets with an IP classification set to anything other than "top-secret". Copy o != NULL AND o.ip_classification != "top-secret" Note Always add a check for o != NULL before accessing any field on the "o" object. Doing so ensures that files not associated with any dataset object are restricted by the FSC deny list configured in the rule preferences. Without this check, evaluating the condition on a file not associated with any dataset object could cause unexpected results. Additional {DatasetType}ShouldFSCCacheThisDataset conditions The {DatasetType}_Selective_File_Caching_Rule_Condition_And_Blacklist preferences define dataset type-specific instances that are not cached on restricted FSC servers. Each applies to datasets of the type specified by {DatasetType}, for example, TextShouldFSCCacheThisDataset or MSWordShouldFSCCacheThisDataset. The dataset type-specific preferences override the default Dataset_Selective_File_Caching_Rule_Condition_And_Blacklist preference, but only for datasets of the type that appears in the preference name. These conditions do not exist by default, so must be created. The definitions of these conditions depend entirely on your site's security requirements. The key requirements for a signature are that it should take a dataset object as input and the expression should include the check for o != NULL before accessing any field on the "o" object as shown in the earlier example for Fnd0DatasetShouldFSCCacheThisDataset. Log on to Teamcenter as an administrator with dba privileges, using the rich client to set the following preferences: FMS_Enable_Selective_File_Caching Determines if selective file caching is enabled. Set FMS_Enable_Selective_File_Caching to true to enable selective file caching. (This preference is visible and accessible only to Teamcenter administrators.) Dataset_Selective_File_Caching_Rule_Condition_And_Blacklist Specifies the condition that handles files for any dataset type, unless overridden by other type-specific {DatasetType}_Selective_File_Caching_Rule_Condition_And_Blacklist preferences. By default, this preference is set to Fnd0DatasetShouldFSCCacheThisDataset:. If the COTS condition name in this preference is changed, that condition must be defined in the Business Modeler IDE. {DatasetType}_Selective_File_Caching_Rule_Condition_And_Blacklist Specify the conditions to be evaluated to determine the dataset type-specific instances that are not cached on the specified FSC servers. Note These preferences should be created with system protection scope and their names hidden to be accessible only by Teamcenter administrators. For each dataset type, set the following values: Dataset Type Set to the type of data, for example, Text or MSWord. Restricted FSCs In a comma-separated list, list the FSC ID of each server on which the dataset type should not be cached. The "" wildcard can represent all FSCs. Limit the list of restricted sites to ten sites or fewer for each {DatasetType}_Selective_File_Caching_Rule_Condition_And_Blacklist preference. Dataset Condition Set to the dataset type-specific condition for this dataset type, for example, TextShouldFSCCacheThisDataset or MSWordShouldFSCCacheThisDataset. Example Preference: Text_Selective_File_Caching_Rule_Condition_And_Blacklist Preference value: TextShouldFSCCacheThisDataset:FSC_NYC1,FSC_NYC2,FSC_LA1,FSC_Lon1 Or Preference: Word_Selective_File_Caching_Rule_Condition_And_Blacklist Preference value: WordShouldFSCCacheThisDataset:* Note Recall that the FSC lists in the preferences are deny lists. Sensitive datasets of the type specified by the preference name are not cached on the specified FSCs. Restart the pool server to deploy the changes to all Teamcenter server instances.