IBM Tivoli Composite Application Manager for Application Diagnostics, Version 7.1.0.1
Details of configuration file merging
When the Managing Server is updated from version 6.1 to 7.1 (any maintenance level), configuration files are merged to ensure that previous manual configuration changes are preserved as fully as possible.
This is not performed when a maintenance level is uninstalled. Also, when updating from a 7.1 maintenance level to another 7.1 maintenance level, the configuration files are unchanged.
When updating from version 6.1, the update installer performs the following changes:
- First, new properties files are created for all components for which were present in older configuration:
- kl*.properties
- klwd*.properties
- ps*.properties
- aa*.properties
- sam*.properties
- log-kl*.properties
- log-ps*.properties
- log-aa*.properties
- log-sam*.properties
- Next, properties are migrated from the old configuration files (in the old MS_home/etc directory) into new ones:
- aa*.properties, excluding ENABLE_DATATRIMMER, MEMORY_DATA_DELETE_TIME, GC_DATA_DELETE_TIME, SR_OVERVIEW_DATA_DELETE_TIME, IMS_THREAD_DATA_DELETE_TIME, WEBSERVER_CHART_DATA_DELETE_TIME
- aa_deletedata.properties
- ccmdb-sim.properties
- cyn-cclog.properties
- cynlogging.properties excluding CYN.msg.listenerNames, CYN.trc.listenerNames, CYN.trc.level
- kl*.properties
- klwd*.properties excluding kernel.rfs.host=localhost
- ms.properties
- pa.properties
- ps*.properties excluding ve.host, ve.port
- sam1.properties
- ve.properties excluding ve.framework.pdf
- log-aa*.properties excluding *.publishserver.*, CYN.handler.snap.convertExceptions
- log-kl*.properties excluding CYN.handler.snap.convertExceptions
- log-md.properties excluding CYN.handler.snap.convertExceptions
- log-ps*.properties excluding CYN.trc.level, CYN.handler.snap.convertExceptions
- log-sam*.properties excluding CYN.handler.snap.convertExceptions
- log-ws.properties xcluding CYN.handler.snap.convertExceptions
- Log.properties
- dal/dal.properties (renamed properties are migrated correctly)
- Scripts (*.sh) in the MS_home directory are overwritten, except am-start.sh, am-stop.sh, am-status.sh, am-status_codes.sh, and am-forcestop.sh
- A command is appended to am-start.sh: echo "ITCAM MS started"
- A command is appended to am-stop.sh: echo "ITCAM MS stopped"
- The following properties are migrated from the old setenv.sh into the new version:
- KERNEL_HOST*
- PORT_KERNEL_CODEBASE*
- PORT_KERNEL_RFS*
- PORT_KERNEL_RMI*
- PORT_ARCHIVE_AGENT*
- PORT_ARCHIVE_AGENT*
- PORT_MESSAGE_DISPATCHER
- PORT_PS*
- PORT_PA*
- PORT_SAM*
- KERNEL_INSTANCE
- PS_INSTANCE
- AA_INSTANCE
- HEAP_MIN_SIZE_*
- HEAP_MAX_SIZE_*
- LOG_COMMON_DIR
- CERT_PATH
- KEYSTR_LOC
- KEYSTR_PASS
- KEYSTR_KEYPASS
- NODE_USERID
- NODE_IP
- USE_SSL
The update installer does not overwrite the dal/TEMAQuerySchema.xml file, so all settings in this file remain active for the new version.
Parent topic:
Upgrade and update the Managing Server on Windows