Upgrade > Pre-upgrade tasks > Customized Files Affected by the Upgrade

Customized Files Affected by the Upgrade

Before CSA is upgraded, you may need to back up customized files if they are not automatically restored or backed up by the upgrade installer. Automatically restored files retain their customizations after the upgrade. Automatically backed up files have been saved to the backup directory but must be manually restored after the upgrade.

This section lists customized files by location. The customized files listed are based on the features that you identified as being configured, customized, or used prior to the upgrade.

Note: You must recustomize CSA for the features configured, customized, or used prior to the upgrade only (complete only the tasks for features that were already configured, customized, or used prior to the upgrade).

If you want to configure, customize, or use any of these features for the first time, refer to the following guides for more information:

For files listed by feature and the actions to perform, refer to Recustomize CSA. For a list of customized files that must be manually backed up, refer to Initial Setup.

Caution If you customized a file that is not listed here, you must manually back up this file (to a directory outside of Windows: %CSA_HOME% or Linux: $CSA_HOME) before running the upgrade installer and then manually restore the file after running the upgrade installer. If you do not back up this file, the customizations will be lost after running the upgrade installer.

Customized Files Listed by Location

Windows: %CSA_HOME%\jboss-as\bin\

Linux: $CSA_HOME/jboss-as/bin/

File Action
Windows:standalone.conf.bat

 

Linux:standalone.conf

Automatically backed up, manually restore
Windows:vault.bat

 

Linux:vault.sh

Automatically restored

Windows: %CSA_HOME%\jboss-as\standalone\configuration\

Linux: $CSA_HOME/jboss-as/standalone/configuration/

FileAction
*.crtAutomatically restored
.keystoreAutomatically restored
standalone.xmlAutomatically restored

 

Windows: %CSA_HOME%\jboss-as\standalone\deployments\csa.war\custom\

Linux: $CSA_HOME/jboss-as/standalone/deployments/csa.war/custom/

FileAction
message.propertiesAutomatically restored

 

Windows: %CSA_HOME%\jboss-as\standalone\deployments\csa.war\custom-content\

Linux: $CSA_HOME/jboss-as/standalone/deployments/csa.war/custom-content/

FileAction
index.jspAutomatically restored

 

Windows: %CSA_HOME%\jboss-as\standalone\deployments\csa.war\dashboard\

Linux: $CSA_HOME/jboss-as/standalone/deployments/csa.war/dashboard/

FileAction
config.jsonAutomatically backed up, manually restore

 

Windows: %CSA_HOME%\jboss-as\standalone\deployments\csa.war\dashboard\messages\dashboard\

Linux: $CSA_HOME/jboss-as/standalone/deployments/csa.war/dashboard/messages/dashboard/

FileAction
message.propertiesAutomatically backed up, manually restore

 

Windows: %CSA_HOME%\jboss-as\standalone\deployments\csa.war\images\

Linux: $CSA_HOME/jboss-as/standalone/deployments/csa.war/images/

FileAction
*.gif, *.jpeg, *.jpg, *.pngAutomatically restored

 

Windows: %CSA_HOME%\jboss-as\standalone\deployments\csa.war\propertysources\

Linux: $CSA_HOME/jboss-as/standalone/deployments/csa.war/propertysources/

FileAction
*.jspAutomatically backed up, manually restore

 

Windows: %CSA_HOME%\jboss-as\standalone\deployments\csa.war\WEB-INF\

Linux: $CSA_HOME/jboss-as/standalone/deployments/csa.war/WEB-INF/

FileAction
applicationContext-security.xml 
ssologout.jsp

Automatically backed up, manually restore

web.xmlAutomatically backed up, manually restore (for the following feature(s): Cloud Service Management Console: session timeout , SiteMinder)

 

Windows: %CSA_HOME%\jboss-as\standalone\deployments\csa.war\WEB-INF\classes\

Linux: $CSA_HOME/jboss-as/standalone/deployments/csa.war/WEB-INF/classes/

FileAction
csa.propertiesAutomatically restored
log4j.propertiesAutomatically backed up, manually restore to log4j2.xml

 

Windows: %CSA_HOME%\jboss-as\standalone\deployments\idm-service.war\WEB-INF\classes\

Linux: $CSA_HOME/jboss-as/standalone/deployments/idm-service.war/WEB-INF/classes/

FileAction
csa-consumer-users.propertiesAutomatically backed up, manually restore
provider-users.propertiesAutomatically backed up, manually restore
integrationusers.propertiesAutomatically backed up, manually restore

 

Windows: %CSA_HOME%\jboss-as\standalone\deployments\idm-service.war\WEB-INF\spring\

Linux: $CSA_HOME/jboss-as/standalone/deployments/idm-service.war/WEB-INF/spring/

FileAction
applicationContext.propertiesAutomatically backed up, manually restore
applicationContext.xmlAutomatically backed up, manually restore
applicationContext-common.xmlAutomatically restored
applicationContext-security.xmlAutomatically backed up, manually restore

 

Windows: %CSA_HOME%\jboss-as\standalone\deployments\mpp.war\

Linux: $CSA_HOME/jboss-as/standalone/deployments/mpp.war/

FileAction
index.htmlAutomatically restored

 

Windows: %CSA_HOME%\jboss-as\standalone\log\

Linux: $CSA_HOME/jboss-as/standalone/log/

FileAction
*Automatically backed up, manually restore

 

Windows: %CSA_HOME%\portal\conf\

Linux: $CSA_HOME/portal/conf/

FileAction
*Automatically restored

 

Windows: %CSA_HOME%\portal\node_modules\mpp-ui\dist\

Linux: $CSA_HOME/portal/node_modules/mpp-ui/dist/

FileAction
*Automatically backed up, manually restore

 

Windows: %CSA_HOME%\portal\node_modules\mpp-ui\dist\locales\*\

Linux: $CSA_HOME/portal/node_modules/mpp-ui/dist/locales/*/

FileAction
rb.jsonAutomatically backed up, manually restore

 

Windows: %CSA_HOME%\Tools\ContentArchiveTool\

Linux: $CSA_HOME/Tools/ContentArchiveTool/

FileAction
config.propertiesAutomatically backed up, manually restore

 

Windows: %CSA_HOME%\Tools\DBPurgeTool\

Linux: $CSA_HOME/Tools/DBPurgeTool/

FileAction
config.propertiesAutomatically backed up, manually restore

 

Windows: <csa_jre>\lib\security\

Linux: <csa_jre>/lib/security/

FileAction
cacertsmanually back up, manually restore
java.securitymanually back up, manually restore

 

<user-specified location>
FileAction
*.jar (for dynamic queries)manually back up, manually restore

*.jsp (custom for the CSA dashboard defined in the configuration file:

Windows:%CSA_HOME%\jboss-as\standalone\deployments\csa.war\dashboard\

Linux:$CSA_HOME/jboss-as/standalone/deployments/csa.war/dashboard/config.json

manually back up, manually restore

keystore file (defined by the certificate-key-file property of the connector attribute in:

Windows:%CSA_HOME%\jboss-as\standalone\configuration\standalone.xml

Linux: $CSA_HOME/jboss-as/standalone/configuration/standalone.xml)

manually back up, manually restore