Clarity

  • 1.  NSA and properties.xml

    Posted Jun 17, 2011 09:35 AM
    When you log into the NSA using the Administrator ID and make changes, such as a port number or file path, shouldn't those changes show up in the properties.xml file when you save them. Am I missing something? Is there a process on how the properties.xml file is updated?


  • 2.  RE: NSA and properties.xml

    Posted Jun 17, 2011 09:56 AM
    Yes they should.

    (Take care you are picking up the correct properties.xml file - it can get a bit confusing in a multi-server environment for example)


  • 3.  RE: NSA and properties.xml

    Posted Jun 17, 2011 10:08 AM
    The changes should be in the properties.xml file, correct. Always have a backup of the file as well.


  • 4.  RE: NSA and properties.xml

    Posted Aug 08, 2012 12:09 PM
    Hi,

    I know this is an older post but I can't help but comment that in the NSA, unless 'automatically detect changes' is checkmarked, often times you will have to stop and restart app services in order for changes to appear in your properties.xml.
    ~Dana


  • 5.  RE: NSA and properties.xml

    Posted Aug 08, 2012 12:26 PM
    Just wondering again....
    If you don't have
    'automatically detect changes' is checkmarked
    and you hit save, what exactly is saved and where?

    I can understand that that changes do not come into effect until you restart servervices.


    Martti K.


  • 6.  RE: NSA and properties.xml
    Best Answer

    Posted Aug 08, 2012 12:36 PM
    "Automatically detect changes" option is for the reading of the logging settings. It doesn't affect what gets saved or where or when, it affects whether Clarity will read the configuration at boot time only, or if it will re-read it whenever it might need to use the information (i.e. upon each occurrence of a potential log write, to see if logging is currently on or off for that level/category).

    In v13, the option "Check for configuration changes every (seconds)" is for other parameters in the CSA and properties.xml file, however this will not 'make sense' for some parameters to change themselves on the fly (if you change the port the app service is listening on for example, you would still need to issue a restart for it to re-bind to different ports).

    Pressing Save in the NSA/CSA should ALWAYS and IMMEDIATELY write any changes to the properties.xml / logger.xml, and if the DB is an a valid/installed state, to the CMN_CONFIG table as well (this table is the location of those files in a virtualized state for non-Tomcat environments). The NSA/CSA doesn't keep hold of any configuration changes for committing at a later date or anything, a Save is a direct and contained action.

    As was mentioned earlier in the thread, you do have to keep track of multiple properties.xml configurations in a clustered environment however, to be sure you're updating all the ones that need to be done.

    Edit: In case I misread the question, the 'automatically detect changes' option itself is written to the properties.xml file when pressing Save, it is the dynamicConfigurationEnabled property here:
    <logger alternateDirectory="" dynamicConfigurationEnabled="true" traceAlarmThresholdSeconds="0" multitenantErrorReportingEnabled="false"/>


  • 7.  RE: NSA and properties.xml

    Posted Aug 08, 2012 12:45 PM
    Thank you Nick. That certainly was fast.

    Could also tell when do the changes come into effect after you have hit Save?
    Do any come immediately or do any require service restart if so which ones and which service+

    Is that covered in documentation?

    Martti K.


  • 8.  RE: NSA and properties.xml

    Posted Aug 08, 2012 04:00 PM
    In general for all versions of Clarity though (including v13), there is some documentation yes. It is in an appendix at the back of either the Administration Guide or the Installation Guide (I'm offline at the moment to check which exactly) of the server properties available for configuration in the NSA, laid out in a table/grid, and one of the columns does give guidance on whether a change to the value necessitates a restart of the app and/or bg services in order for it to take effect. If they don't require a restart based on that column, then the setting would take effect straight away.

    For the new behaviour in v13 with the option set to check the configuration more frequently, I'd have to check when I can as I'm not 100% sure off the top of my head. The purpose of that setting though is to increase the quantity of those properties that could be picked up without needing to restart.


  • 9.  RE: NSA and properties.xml

    Posted Aug 08, 2012 04:28 PM
    Thanks.

    For 12.1SP1 they are in the installation guide.

    Martti K.