How the property "be.engine.cluster.cacheNaming.isDescriptive" works.

How the property "be.engine.cluster.cacheNaming.isDescriptive" works.

book

Article ID: KB0093705

calendar_today

Updated On:

Products Versions
TIBCO BusinessEvents Enterprise Edition -
Not Applicable -

Description

Description:
A new property was added beginning with BE 5.2.2 which allows Shared Nothing folder names to be shortened and to remove qualifiers prefixing the actual folder/space name. This solution provides more details on the property.

Issue/Introduction

How the property "be.engine.cluster.cacheNaming.isDescriptive" works.

Resolution

This new property, when set to "false", excludes descriptive information such as "dist/repl, unlimited/limited, nobs/bs", etc. from folder names of shared nothing store. It allows Shared Nothing (SN) files to look the same for limited and unlimited cache configurations. You can switch to one or the other without worrying about file names which used to have qualifiers like limited or unlimited prefixing them. Note that when the "is-descriptive" flag is set to "false", the only thing that changes is the top level directory/path of the SN folders. The file names are not impacted.

Example: A folder name like


Test/dist-unlimited-bs-readOnly-Test--be_gen_Concepts_Clock/...
Test/repl-unlimited-TestBQL--TypeIds/...

Becomes 


Test/Test--be_gen_Concepts_Clock/...
Test/TestBQL--TypeIds/...

The property was primarily designed for new TIBCO BusinessEvents clusters. If you want to shorten the names of SN folders in existing environments,


- You have to script rename the folders to remove the qualifiers prefixing the folders. 

- Re-start with the isDescriptive property set to "false" and we will recover all the data. 
- Any new SN store folders that are created will be created without the qualifiers as the property is now set to "false".