Bug 1311174

Summary: Add a NOTE or WARNING to NEVER redirect the java store underneath the rhq-agent directory
Product: [JBoss] JBoss Operations Network Reporter: dsteigne
Component: DocumentationAssignee: Tyler Kelly <tkelly>
Status: CLOSED CURRENTRELEASE QA Contact: Mike Foley <mfoley>
Severity: high Docs Contact:
Priority: high    
Version: JON 3.0.1, JON 3.1.2, JON 3.2.3, JON 3.3.8CC: fbrychta, tkelly
Target Milestone: post-GAKeywords: Triaged
Target Release: JON 3.3.8   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2017-08-25 04:54:26 UTC Type: Enhancement
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description dsteigne 2016-02-23 14:44:37 UTC
Document URL: 
https://access.redhat.com/documentation/en-US/Red_Hat_JBoss_Operations_Network/3.3/html-single/Admin_and_Config/index.html#setting-in-java-opts
Section Number and Name: 

Describe the issue: 
Add a NOTE or WARNING to NEVER redirect the java store underneath the rhq-agent directory as it will get overwritten on an agent update/upgrade.
Suggestions for improvement: 

Additional information:

Comment 1 dsteigne 2016-02-23 14:50:41 UTC
To be more specific the /rhq-agent runtime directory.

Comment 2 Tyler Kelly 2017-07-24 03:09:37 UTC
Added "important" note to the end of the section:
Do not set the Java option within the rhq-agent runtime directory because this file is overwritten during &JON; agent updates. The default location for the rhq-agent runtime is <filename>$USERHOME/.java/.userPrefs/rhq-agent/default</filename>.

3.3
    Git Commit:
https://gitlab.cee.redhat.com/tkelly/doc-jon-docs/commit/fece5655f14117a572823909162dd8fab39d2a18
    Merge Request:
https://gitlab.cee.redhat.com/red-hat-jboss-operations-network-documentation/doc-jon-docs/merge_requests/38
    Pantheon Preview:
https://access.qa.redhat.com/documentation/en-us/red_hat_jboss_operations_network/3.3/html-single/admin_and_config/#setting-in-java-opts

3.2
    Git Commit:
https://gitlab.cee.redhat.com/tkelly/jon32/commit/8dbd9c3883dc34d00bc9a906e8783599cd4d2b1e
    Merge Request:
https://gitlab.cee.redhat.com/red-hat-jboss-operations-network-documentation/jon32/merge_requests/5
    Pantheon Preview:
https://access.qa.redhat.com/documentation/en-us/red_hat_jboss_operations_network/3.2/html-single/admin_and_config/#setting-in-java-opts

3.1
    Git Commit:
https://gitlab.cee.redhat.com/tkelly/jon31/commit/b36399f50f9d71a3c0904cae538d4f4af5183c19
    Merge Request:
https://gitlab.cee.redhat.com/red-hat-jboss-operations-network-documentation/jon31/merge_requests/13
    Pantheon Preview:
https://access.qa.redhat.com/documentation/en-us/red_hat_jboss_operations_network/3.1/html-single/admin_configuring_jon_servers_and_agents/#setting-in-java-opts
https://access.qa.redhat.com/documentation/en-us/red_hat_jboss_operations_network/3.1/html-single/installation_guide/#setting-in-java-opts

3.0 - Added to warning within the installation guide:
    Git Commit:
https://gitlab.cee.redhat.com/tkelly/jon30/commit/6084a7f4f5d5d2579abc57b8209e0581ac0a8aeb
    Merge Request:
https://gitlab.cee.redhat.com/red-hat-jboss-operations-network-documentation/jon30/merge_requests/4
    Pantheon Preview:
https://access.qa.redhat.com/documentation/en-us/red_hat_jboss_operations_network/3.0/html-single/installation_guide/#Preparing_the_Agent