Uploaded image for project: 'OpenAM Agents'
  1. OpenAM Agents
  2. AMAGENTS-3577

AM Console, WPA Profile (i)Pop-Up for log file Size (2 settings) are bootstrap props; NOT Hot-Swappable



    • Type: Bug
    • Status: Closed
    • Priority: Major
    • Resolution: Fixed
    • Affects Version/s:, 5.6.3, 5.7.0
    • Fix Version/s: 5.7.0
    • Component/s: Web Agents
    • Labels:
    • Target Version/s:
    • Verified Version/s:
    • Sprint:
      2020.09 - Agents
    • Support Ticket IDs:
    • Zendesk ID:


      See screenshot and read on...

      Support confirms these settings are  bootstrap properties, and can ONLY be MODIFIED by updating the agent.conf and restarting the Agent.  So having both (debug + audit) Log File Size settings present in the console is misleading, but may be reserved for the Agent Profile CREATE Task.

      1. The caveat in the  popUp Hot-swap: Yes should be No
      2. Also!  The sentence from the description of the Post Data Dir setting (Not yet in the AM console) should be included in the debug and audit log descriptions; so all three of these bootstrap settings are insulated the same way; besides the setting NAME! itself.

      NOTE: IF these are 'suppose' to be Hot-swappable, then this should change from a DOC to product bug.

      Web Agents 5.6 UGuide - configure-web-pa-advanced-props

      • Agent Debug File Size
        Debug file size in bytes beyond which the log file is rotated. The minimum is 5242880 bytes (5 MB), and lower values are reset to 5 MB. AM sets a default of 10000000 bytes (approximately 10 MB).
        Hot-swap: no. This is a bootstrap property.
        Default: 10000000
        Property: com.sun.identity.agents.config.debug.file.size

      Tip (present in WPA 5.5 Guide, dropped/removed in WPA 5.6??)
      If com.sun.identity.agents.config.debug.file.rotate is enabled, setting com.sun.identity.agents.config.debug.file.size to -1 in the agent.conf file will rotate debug log files once every 24 hours rather than at a specified size limit.


      • Local Audit Log Rotation Size
        Specifies the maximum size in bytes of the local audit log files. Web agents rotate audit log files when they reach this size.
        Default: 52428800
        Property: com.sun.identity.agents.config.local.log.size
        Hot-swap: no. This is a bootstrap property.


      • POST Data Storage Directory (Not yet in the AM console)
        The directory local to the agent installation where the agent writes preserved POST data while requesting authorization to AM.
        This is a bootstrap property.  Configure it in the agent.conf file, even when the agent is configured in centralized mode.
        Default: /web_agents/agent_type/log 
        Property: org.forgerock.agents.config.postdata.preserve.dir


      In my opinion, both fields should be removed from the console UNLESS there's some value-add by having these two fields present.  It seems like these are here for Profile creation PRIOR to Agent Installation, but useless to work with post Agent Installation.   Support will test to see if after a centralized Agent Profile has been created with non-default values for each, that they are saved (or not/bug TBD) into the Agent's agent.conf as expected.  Whereby the user only needs to restart the Agent after making centralized changes via the console.


          Issue Links



              richard.hruza Richard Hruza
              ashley.hale Ashley Hale
              0 Vote for this issue
              5 Start watching this issue