What is the significance of _annotations.idx file

What is the significance of _annotations.idx file

book

Article ID: KB0070881

calendar_today

Updated On:

Products Versions
TIBCO BusinessEvents Enterprise Edition 6.x

Description

The /BE_HOME/bin/_annotations.idx is where all jar files without custom functions are added.
 
Generally on the first startup of a BE application in a new environment, the agent has to load all jar files to validate if they include custom functions. That’s a one-time action. On next start of a BE application, the annotations.idx file helps identify which jars need to be loaded. Independent of the settings in the _annotation.idx file, class files referenced in the .beproject file are loaded on startup.
 
We have seen this file has been corrupted a couple of times, and is not easy to know what corrupted it, but it is possible that the following problems could happen:
 
1.- Manual manipulation or lack of permissions to read the file, so please avoid changing the file and validate file permissions.
2.- A server patching could lead to this corruption. To get more details on the patching done and the exceptions contact your infrastructure admin team.
3.- It is possible that two different terminals tried to initialize the same BE instance or tried to initialize an in-use BE instance.
4.- Another BE environment could be pointing to the same _annotations.idx.

 
If you see this problem verify if some update, patch, or other process was run on the server. To solve this just try re-creating the file or pulling it from a working machine with similar BE environment.

Issue/Introduction

This article shows some details of annotations.idx file and a related issue.

Environment

All