Upgrading Quickr (Domino) 8.1 to 8.2

Please be aware of the fact that before upgrading to Quickr 8.2 the Domino server has to be upgraded to release 8.5.x also.

If your Quickr server is part of a Domino domain where other servers are also located you have to think about a strategy how to upgrade your domain etc. before upgrading the first server to Domino 8.5.x. This is not covered by this document but shouldbe handled as a normal Domino domain upgrade procedure.

The following steps imply that your Quickr server is the only server in the domain. They also imply that Domino is running on Windows and is installed in the following directories:

 Lotus Domino Program directory:    C:\Lotus\Domino
 Lotus Domino Data directory:       C:\Lotus\Domino\data

If your installation differs from this configuration you have to adapt all path names accordingly.

Before starting the upgrade create a full backup of all files in C:\Lotus\Domino and C:\Lotus\Domino\data including all subdirectories. This is a very important step as you never know what could happen during the upgrade. You should also make sure your update is still available some time after the upgrade has been finished in case you will discover a problem not immediately but some time later.

• Stop your Domino server.

• Start the EXE file of Domino 8.5.1 (part number for English: CZ5RTEN) and unpack the server code to a temporary directory. Afterwards the server setup should automatically start. (You should use Domino 8.5.1 as with this version some performance issues in the HTTP stack have been fixed.)

• Double-check the directories for program and data (should be displayed already correct) and make sure you install a “Domino Enterprise Server”.

• If your server has a language pack installed before, you now need to install the Domino 8.5.1 version of the language pack also (part number: CZ93NDE for German language pack). To do so start the EXE file and extract the content to a temporary directory (be sure to remember the directory name!)

• Change to that temporary directory and run “DOMLP85_W32.EXE” and follow the instructions.

• If you are asked if you want to install an English Domino server answer “No” as you already have installed it. Double check the program and data directories and then choose “Add Language Pack to Domino server”.

• Start your Domino server

• If you will be asked if the design of your Domino directory should be upgraded, answer with “Y”

• Wait until the design refresh has been finished and also the design of the EVENTS4.NSF has been successfully upgraded.

• Then stop the Domino server again.

• Make sure you have the parameter “Create_R85_Databases=1” in your NOTES.INI so that new databases will be created with the new ODS 51 (and the old databases will be upgraded by running the compact task later.

• Open a command line windows and change to the Domino program directory (“C:\Lotus\Domino”)

• Run the following command: nfixup -f -j -v -l

• Run the following command: ncompact -c -i (Caution: If you are running incremental backups by using transaction logging: This command changes the DBIID of all logged databases. Therefore you need to perform a full backup afterwards!) For large data volumes this command can run a very long time. You might consider to only run this compact command on the system databases which are normally in use and cannot be compacted during server runtime and run a compact task on all other databases later (e.g. over night) if the server is already up and running again.

• Run the following command: nupdall -RX

• Run the following command: ndesign

• As the servertasks “Sched”, “CalConn” and “RnRMgr” normally are not needed on a Quickr server, you should delete them permanently from the SERVERTASKS= line.

• Start the Domino server again and make sure that it is running without any problems

• Quickr 8.2 now needs to have the Domino servlet engine enabled. If you did not already did that for Quickr 8.1 open the server document and go to “Internet Protocols → Domino Web Engine. Below “Java Servlets”, select Domino Servlet Manager in the Java servlet support field.

• Then shutdown the Domino server again.

The follwoing steps are necessary to upgrade the Quickr server to 8.2:

• Start the EXE file (part number: CZ2M2EN for English version, CZ34VML for West European Language (French, German, Italian, Portuguese Brazilian, Spanish) version (could be AH10ZML if downloading via Partnerworld)) and extract the files to a temporary directory (be sure you remember the directory name)

• Change to that temporary directory, switch to the subdirectory “Server” and start “SETUP.EXE”

• Follow the instructions on the screen. Double check if the directory names are correct.

• If the Quickr setup has been finished install the latest Quickr hotfix. Check http://www-01.ibm.com/support/docview.wss?uid=swg24023631 for the most current fix level.
  • Before you can install the hotfix you need to install the Sun Java runtime engine. Then you also need to add the Domino program directory to the end of the Windows system path. (You should have done this already for Quickr 8.1).
  • Afterwards you copy the hotfix JAR file to the path ”<Domino program dir>\jvm\lib\ext“ and double click on it. The hotfix installer is then started. Follow the instructions on the screen.

• Delete all files in the following cache directories:

   C:\Lotus\Domino\data\domino\cache
   C:\Lotus\Domino\data\domino\quickplace\cache

• With Quickr 8.1 the settings for folders within Quickr (e.g. number of displayed items, sort order etc.) were saved in a browser cookie. Due to performance reasons the default behaviour has changed with 8.2 and the cookie is no longer written. If you want to save these settings with Quickr 8.2 you need to add the following section into QPCONFIG.XML:

   <cookies>
      <folder enabled="true" />
   </cookies>

• After installation has been finished you have to perform the following steps (Important!):
  • Start the Quickr server
  • If you are using Quickr policies you need to save the policies before as the “qptool unregister” command below will delete them. Please follow the instructions on http://www-10.lotus.com/ldd/lqwiki.nsf/dx/06012009013655PMWEBNNM.htm
  • From the Domino console run the following commands. Wait for one command to finish before starting the next one:

load qptool unlock –a
load qptool upgrade -f –server 
load qptool upgrade -f –a -saveformprefs [Note: "-saveformprefs" will work starting with Fixpack 1 only]
load qptool refresh -r -d Wiki
load qptool refresh -r -d Blog 
load design
load qptool unregister -a -placecatalog
load qptool unregister -server

Now it might be a good idea to check PLACECATALOG.NSF if there are any remaining entries for places, rooms and servers and to delete all of them before re-registering. Afterwards run the following commands to re-register server and places.

load qptool register -server
load qptool register -a -placecatalog

• Restart the Quickr server.