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: