SUMMARY
Instance Application Properties
ISSUE
Purpose
Application used to modify properties for an instance.
Description
There is a concept in our system called instance properties. These are specific flags that can be set on an instance by instance basis when it would not be appropriate to set a global flag. The applications that use this property will need to be coded to look for them, but once coded, they can be set outside of the system, but stored in the database.
Cause
Sometimes it is good to have properties set on an individual instance to help fine tune the DPU and give users better control over various aspects of DPU behavior.
Resolution
This tool should only be used by tech support when tunneled onto a customer DPU.
An application is included in the /usr/bp/bin directory called app-properties. When run it produces a small menu with four options, like the menu below:
[1] Set a keyword/value property for an application instance.
[2] Get a keyword/value property for an application instance.
[3] Delete the application instance keyword entry. The keyword must exist and the instance id will be checked and confirmed that it is a value entry in the application instances table.
[4] Quit.
Enter the number of your menu choice:
Option 1 allows the user to set a property on an instance. In this case the property we want to set could be compress-synth-backup (excluding quotes). This has a value of “no” or “yes”, case does not matter but spelling is critical. When option 1 is selected you are asked for the instance ID that this property applies to. Enter the instance ID number and press return. You are now asked for the Keyword (name of property), which is compress-synth-backup, and press enter. The next prompt asks for the value to associate with this property. In the case of compression it is either “yes” (compress the synthesized full) or “no” (not compress the synthesized full). Press enter and the property and value for the instance ID is displayed. You are done adding the property. The value is anything defined by the application or developer that is using this property. It will always be a string. So depending on how the developer coded the property it could be yes, no, one, two, 1, 2, or it could possibly be some default string, anything.
Option 2 is used to query the property value. It first asks for the Instance ID, enter this value and press return. It then asks for the property, in this case is would be compress-synth-backup and press return. The result is the property setting for this property and instance ID.
Option 3 is used to remove a property value.
Option 4 is to quit the application.
Third-Party Sources
None.