ShowTable of Contents
Overview
The IBM® Lotus® Quickr for Domino® (Quickr Domino) L3 team has found three common problems occurring during customer upgrades:
- Folder corruption issues in Quickr Domino's place.
- The child place's theme cannot be changed.
- The theme in the rooms cannot be reset.
As a result, the “qptool repair”, “qptool refresh”, and “qptool settheme” tasks were enhanced to address these issues.
Problem 1: Folder corruption issues
Three kinds of folder corruption issues have been reported to us:
(1) In the Web UI, the child folder is missing from its parent folder, but it can be displayed correctly by the Quickr Connector.
For example, figure 1 shows that folder1 is missing from “testfolder” in the Web UI (on the right-hand side), compared with the Connector (on the left-hand side).
Figure 1. Child folder missing from parent in Web UI
(2) In the second issue, in the Web UI, one child folder belongs to several different parent folders but, again, is displayed correctly by the Connector.
For example, figure 2 shows that “folder3” belongs to both “testfolder” and “testfolder1”, whereas actually “folder3” should belong only to “testfolder1” as displayed in the Connector (see figure 3).
Figure 2. One child folder belonging to multiple parent folders
Figure 3. “folder3” correctly displayed as belonging only to “testfolder1”
(3) The third folder corruption issue found was that the folder storage note is lost. It can still be displayed in the Web UI, but when you click the folder in the Web UI, the folder can no longer be opened.
Fixing the folder corruption issues
Actually there is no real data lost in the above cases. The issues' root cause is that the connection between folders is lost. Fortunately, the folder connection information is redundant in the Quickr Domino design, for example DocByFolder view, FolderByFolder view, and folder proxy doc, so we have enough information to recover from folder corruption.
In Quickr Domino versions 8.5.1.6-007a and above, QPTool repair has been enhanced to fix these folder corruption problems; specifically, if you see these problems in your place, just execute the command:
“load qptool repair -p yourplacename”
from the Domino console, and the problems will be fixed.
Problem 2: The child places' theme cannot be changed
In a classic user scenario (see figure 4), the Quickr Domino administrator creates a parent place; for example, a top-level place with a customized theme in a company, and creates the place type based on it. Then each team can create their child place based on that place type.
Figure 4. Classic user scenario
So all the child places will have a unique company-level customized theme. After that, team members can modify the home page of the child place as they wish, for example, by showing their team goal on the home page.
The benefit of this structure is that if an administrator wants to change the company-level theme, he just needs to use these steps:
- Change the theme in parent place.
- Execute the command, “qptool refresh -pt placetype”, to refresh the new theme to the place type.
- Execute “qptool refresh -a”, to refresh the new theme to all the child places.
You can see that the job is simple because the administrator does not need to change the theme on the child places one by one. However, there is problem after users migrate places from Quickr Domino 8.2 server to a Quickr Domino 8.5.1 server in that the “qptool refresh -a” command no longer works correctly.
The steps to migrate are as follows:
- Archive the places on the Quickr Domino 8.2 server.
- Copy the places from Quickr Domino 8.2 server to the Quickr Domino 8.5.1 server.
- Register and upgrade the places on the Quickr Domino 8.5.1 server.
Fixing the issue
The root cause of this issue is the limitation of the “qptool archive” command. To fix it, we enhanced “qptool refresh” in Quickr Domino 8.5.1.6-007a, adding a new parameter of “-theme”. So now, to refresh the theme of child places, an administrator can use:
qptool refresh -theme -a
Problem 3: The theme in the rooms cannot be reset
In Quickr Domino 8.5.1, a new theme was introduced that is much more user friendly than that in previous versions. Of course, after a user migrates his places from Quickr Domino 8.2 to Quickr Domino 8.5.1, he wants to use this default theme of Quickr Domino 8.5.1.
The “qptool settheme” command is the best method for changing the theme for all places; however, “qptool settheme” can change the theme only for a top-level place, not rooms.
Fixing the issue
The “qptool settheme” command has been enhanced as of Quickr Domino 8.5.1.1-002a to add a new parameter of “-allrooms”, so that administrators can use “qptool settheme -a -default -allrooms” to change themes for both a top-level place and for rooms.
Conclusion
Lotus Quickr for Domino is powerful document library software, and QPTool is a good tool set with which administrators can do various jobs. By design, Quickr for Domino's document information is redundant, which can help to recover from corruption problems and avoid permanent data loss.
Resources
Refer to the
developerWorks Lotus Quickr documentation page.
Refer to the
IBM Lotus Quickr 8.5 for Domino Product Documentation on the wiki.
Refer to the
developerWorks Lotus Quickr Product page.
About the authors
Zhuang Yu is a Staff Software Engineer at IBM's China Development Lab in Beijing, where he works Level 3 Support for the Lotus Quickr for Domino product. He has extensive experience with Web 2.0 applications and collaboration software. You can reach him at
yuzcdl@cn.ibm.com.
Lu Ming Hua is an Advisory Software Engineer at IBM's China Development Lab in Beijing. He is the Level 3 Support Lead for the Lotus Quickr for Domino product. He has extensive experience with Web 2.0 applications and collaboration software. You can reach him at
lumingh@cn.ibm.com .
Wang Zheng Wei is a Software Engineer at IBM's China Development Lab in Beijing, where he works Level 3 Support for the Lotus Quickr for Domino product. He has extensive experience with Web 2.0 applications and collaboration software. You can reach him at
zhwwang@cn.ibm.com.