Preserved files and folders when upgrading Cognos Analytics

You can install a new version of IBM® Cognos® Analytics over your current, running version of the product without overwriting configuration settings from the previous version.

Files to be preserved during an upgrade are listed in the install_location\configuration\preserve\.ca_base_preserve.txt file. Do not edit this file. Instead, edit the install_location\configuration\preserve\preserve.txt file if you want to remove or preserve certain files or directories when upgrading. Instructions about using preserve.txt are included in the file itself.

Tip: Hard or soft links created by customers within the Cognos Analytics file structure are not supported.

By default, the following folders and files are preserved when upgrading Cognos Analytics:

Folders
install_location\deployment
install_location\data\cmstorage
install_location\data\search
install_location\drivers
install_location\ldapschema
install_location\informix
install_location\configuration\certs
install_location\configuration\csk
install_location\configuration\data
install_location\configuration\caSerial
install_location\webapps\p2pd\WEB-INF\AAA\lib
install_location\iso-swid
install_location\apacheds\instances\cognos
install_location\war\AuditExt
Configuration files
install_location\configuration\cogconfig.prefs
install_location\configuration\cogconfig_reg.txt
install_location\configuration\coglocale.xml
install_location\configuration\cogstartup.xml
install_location\configuration\dispatcher.properties
install_location\configuration\install_gatewayurl.xml
install_location\configuration\installData.properties
install_location\configuration\ipfclientconfig.xml
install_location\configuration\configuration\caSerial
install_location\configuration\xqe.diagnosticlogging.xml
install_location\configuration\c11AuditExtension.keystore
install_location\configuration\local-server.xml
Miscellaneous files
install_location\webapps\p2pd\WEB-INF\web.xml
install_location\wlp\usr\servers\cognosserver\bootstrap.properties
install_location\wlp\usr\servers\cognosserver\jvm.options
install_location\wlp\usr\servers\cognosserver\server.xml
install_location\wlp\usr\servers\dataset-service\bootstrap.properties
install_location\wlp\usr\servers\dataset-service\jvm.options
install_location\wlp\usr\servers\dataset-service\server.xml
install_location\cgi-bin\web.config
install_location\wlpdropins\AuditExt.war
Webcontent files
install_location\webcontent\web.config
install_location\webcontent\bi\web.config
TM1 files
install_location\templates\ps\portal\variables_TM1.xml
install_location\templates\ps\portal\variables_plan.xml
install_location\templates\ps\portal\icon_active_application.gif
install_location\webcontent\planning.html
install_location\webcontent\tm1\web\tm1web.html
install_location\webcontent\PMHub.html
install_location\templates\ps\system.xml
install_location\templates\ps\portal\system.xml
PowerPlay files
install_location\webcontent\skins\series7\ppwb
install_location\webcontent\skins\presentation\ppwb
install_location\webcontent\skins\modern\ppwb
install_location\webcontent\skins\corporate\ppwb
install_location\webcontent\skins\contemporary\ppwb
install_location\webcontent\skins\classic\ppwb
install_location\webcontent\skins\business\ppwb
install_location\webcontent\bi\skins\series7\ppwb
install_location\webcontent\bi\skins\presentation\ppwb
install_location\webcontent\bi\skins\modern\ppwb
install_location\webcontent\bi\skins\corporate\ppwb
install_location\webcontent\bi\skins\contemporary\ppwb
install_location\webcontent\bi\skins\classic\ppwb
install_location\webcontent\bi\skins\business\ppwb
install_location\webcontent\bi\ppwb
install_location\webcontent\ps\powerplaystudio
install_location\webcontent\fragments\ppesAdmin
install_location\webcontent\ppwb
install_location\webapps\p2pd\WEB-INF\fragments\applications\cogadmin\pages\ppesAdminPage.xml
install_location\webapps\p2pd\WEB-INF\fragments\applications\cogadmin\fragments\ppesAdmin.xml
install_location\msgsdk\ppesAdminStrings_en.xml
install_location\msgsdk\ppesAdminStrings_ldkspec.xml
install_location\eclipse\plugins\org.eclipse.equinox.cm_1.0.400.v20120522-1841.jar
install_location\eclipse\plugins\org.eclipse.equinox.ds_1.4.1.v20120926-201320.jar
install_location\eclipse\plugins\org.eclipse.equinox.event_1.2.200.v20120522-2049.jar
install_location\eclipse\plugins\org.eclipse.equinox.util_1.0.400.v20120917-192807.jar
install_location\eclipse\plugins\org.eclipse.osgi.services_3.3.100.v20120522-1822.jar
install_location\eclipse\plugins\org.eclipse.osgi.util_3.2.300.v20120913-144807.jar
LCM files
install_location\wlp\usr\servers\lcm\server.xml
install_location\project
install_location\benchmarks
install_location\configuration

You need to manually migrate these files and folders only under the following circumstances:

  • You are installing the new version in a new directory.
  • You are uninstalling the current version, and then installing the new version.

    Uninstalling the current version completely deletes the install_location directory.