How To
Summary
Customer had a working Controller Web system for some time (for example several months). After a while, the Controller Web suddenly stopped working (could not logon to the Controller Web system).
After diagnosing the problem, it is found that the 'backend' ('fcm.web') subsystem is the culprit. However, it seems impossible to work out what file is damaged/corrupt, so therefore they would like to reset the whole fcm.web backend portion of the system.
How can the customer do this?
Objective
How to reset Controller Web backend (fcm.web) subsystem to its standard/default configuration.
Steps
Perform the following:
- Archive/hide/rename your old/bad 'fcm.web' website
- Create a brand-new (empty) 'fcm.web' website
- Copy your customised configuration settings over to the new folder.
- Populate the new (empty) fcm.web website with the Controller backend code (the folder "wmc-rest.war")
- Restart the relevant services.
Steps:
1. Stop the Windows service 'IBM Cognos Controller Web'
2. Launch a command prompt, and change to the folder: ...\fcmweb\wlp\bin
- Example: cd c:\program files\ibm\cognos\ccr_64\fcmweb\wlp\bin
3. Type the following command: server create fcm.web2
- You should get a success message similar to:
4. Copy over the following configuration files from the original (bad) folder, to the new (good) folder:
- ...\fcmweb\wlp\usr\servers\fcm.web\apps\server.xml => ...\fcmweb\wlp\usr\servers\fcm.web2\apps\server.xml
- ...\fcmweb\wlp\usr\servers\fcm.web\com.ibm.cognos.fcm.web.properties => ...\fcmweb\wlp\usr\servers\fcm.web2\com.ibm.cognos.fcm.web.properties
5. Copy over the following Controller code folder from the original (bad) folder, to the new (good) folder:
- ......fcmweb\wlp\usr\servers\fcm.web\apps\wmc-rest.war => ......fcmweb\wlp\usr\servers\fcm.web2\apps\
6. Rename the old 'bad' folder: ...\fcmweb\wlp\usr\servers\fcm.web
- For example, change it to: ...\fcmweb\wlp\usr\servers\fcm.web_BAD
7. Rename the new 'good' folder: ...\fcmweb\wlp\usr\servers\fcm.web2
- Specifically, change it to: ...\fcmweb\wlp\usr\servers\fcm.web
8. Start the Windows service 'IBM Cognos Controller Web'
9. Test.
Document Location
Worldwide
[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SS9S6B","label":"IBM Cognos Controller"},"Component":"Controller Web","Platform":[{"code":"PF033","label":"Windows"}],"Version":"10.3.1;10.4.0;10.4.1","Edition":"","Line of Business":{"code":"LOB10","label":"Data and AI"}}]
Was this topic helpful?
Document Information
Modified date:
13 January 2020
UID
ibm11171390