IBM Support

How to recover a corrupted or lost Framework Manager model.

Troubleshooting


Problem

How can you recover the model for a report? This process may be used when the Framework Manager project directory was deleted or lost. It will only recover the model for selected package

Resolving The Problem

Steps for CQM Model:

It's possible to recover a model from the Content Store by using a CQEConfig.xml file in the <Cognos_Root_Installation>/configuration directory and accessing a published packaged based on the deleted model within Cognos Report Studio.
The model will be saved within the directory <Cognos_Root_Installation>/data/cqe/RTModels.

Cognos 10.x.x :
Steps :
1. Backup <Cognos_Root_Installation>/configuration/CQEConfig.xml.sample
2. Rename CQEConfig.xml.sample to CQEConfig.xml:
3. Under XML tag : <component name="CQE"> add content :

<section name="General Options">
<entry name="KeepModelXML" value="1" />
</section>

4. Save file and stop Cognos service
5. Rename the directory <Cognos_Root_Installation>/data/cqe/RTModels to "ORIGINAL_RTModels" .
6. Restart the Cognos Service.
7. Launch Cognos Report Studio and create a new report using the package you wish to recover and run it, noting the time.
8. Verify that a new <Cognos_Root_Installation>/data/cqe/RTModels directory has been created and an xml file with a creation time matching the run time of the report exists.
9. Rename CQEConfig.xml created to CQEConfig.xml.recoversave or delete it.
10. Move the newly created <Cognos_Root_Installation>/data/cqe/RTModels directory to a working location.
11. Rename <Cognos_Root_Installation>/data/cqe/ORIGINAL_RTModels directory back to "RTModels".
12. Restart the Cognos Service.
13. Open Framework Manager, create and save a new empty project.
14. Close Framework Manager.
15. Locate the empty Framework Manager project directory and rename the model.xml file to model.xml.origin
16. Copy the the xml file created in steps 8 into the empty Framework Manager project directory and rename the file "model.xml".
17. It should now be possible to open the model in Framework Manager

Warning:
It may be prudent to rename the Package name in the Framework Manager model so as not to inadvertently overwrite the existing published package.

Steps for DQM model (and alternate method for CQM):

  1. Launch CMTools (<install location>/bin/utillities/cm/CMTools)
  2. On the Toolbar at the top, choose Window>Preferences. Here you need to adjust your CM URL to match your environment
  3. Once that is complete, refresh the Content Tree on the left and the contents of your content store will be displayed
  4. Depending on where your packages are located, you navigate to each of them and do the following:
  5. Under the package, click on model and its properties will be displayed on the right.
  6. At the top right, you will need to click on the icon to toggle to all properties.
  7. Once all properties as displayed, you can find model as one of the properties.
  8. Right click on the value beside model and copy the entire value.
  9. Open a text editor and do a 'Save As'. Make sure you save this blank file as UTF-8 :
  10. Save the file as model.xml (.. very important that you did step #9)
  11. Now paste the value copied from CM Tools into this file and save.
  12. At the top of the file, please add the following line:
<?xml version="1.0" encoding="UTF-8" ?>
and save again.

NOTE1: this will only create a model for the package contents .. ie. if the FM model was much larger but only a part of it was published, you will only have the published portion.

NOTE2: this will need to be done for each published package. Make sure when you save each model in a separate folder so that you know what package it was extracted from.

[{"Product":{"code":"SSEP7J","label":"Cognos Business Intelligence"},"Business Unit":{"code":"BU002","label":"Business Analytics"},"Component":"Framework Manager","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"10.1;10.1.1;10.2;10.2.1;10.2.2","Edition":"All Editions"}]

Document Information

Modified date:
15 June 2018

UID

swg21505488