Upgrade HCL Verse to 3.0

Mindwatering Incorporated

Author: Tripp W Black

Created: 11/11 at 12:57 PM

 

Category:
Domino Upgrades / Installations
Software (Re)Configuration

Notes:
  • This update will require the Domino HTTP task to be shutdown.
  • Since files are being copied at the OS level, it is also recommended that Domino be shutdown for those steps.
  • We will extract the contents of the zip outside the Domino data folder. We will move them into place rather than expanding w/in the /local/notesdata directory structure. A move is much faster, and we don't need the readme clutter up the install.
  • With Verse 3.0.0, Notes mail template design must be 9.0.1 FP9 or later.
  • It is important the file copying and extraction is done as the notes user. Otherwise, there will be permissions issues with the files.
  • Check that Full Text indexing is available for all Verse users.


Part A: Download HCL Verse
1. Go to HCL Passport (Flex) site.
2. Go to new downloads, or Domino downloads. As there are many, we do a Cmd+F search for "Verse".
3. Download the newest version of Verse 3. For us, it is HCL_Verse_3.0.0.zip


Part B: Verify that all Domino Verse servers have the HTTP JVM entries.
1. Login to each Domino server has the following notes.ini entries:
$ ssh lotusnotes@mynotesserver.mindwatering.net
<notes>
<pwd for notes user>
$ cd /local/notesdata
$ cat notes.ini | grep "HTTPJVM"
HTTPJVMMaxHeapSize=2048M
HTTPJVMMaxHeapSizeSet=1

2. Only if the Domino server does not have those entries, use the command below to add them to the notes.ini. If the size value is higher, leave it.
To edit, use vi:
$ vi /local/notesdata/notes.ini


Part C: Extract the installation zip on the Domino servers:
1a. Copy the zip to a working directory on the server, or extract on another Linux or Mac workstation and transfer to the Domino server as the "notes" user.
(e.g. /home/notes/tmp/verse)

1b. Extract the contents of the zip within this temporary folder. We will move them into place rather than expanding w/in the /local/notesdata directory structure directly.
(We keep the server up-time longer/higher this way.)

There is a second zip w/in the first zip that extracts the updated jar files. Extract this one, as well. We'll move them to the /local/notesdata/domino/workspace/applications/eclipse/plugins/ folder later.

We immediately remove the following files. We don't need the NTF files, either, as our Domino servers have R12 versions of these templates, already.
$ rm /home/notes/tmp/verse/catalog12.ntf
$ rm /home/notes/tmp/verse/iwaredir.ntf
$ rm /home/notes/tmp/verse/readme.html
$ rm /home/notes/tmp/verse/License.txt
$ rm /home/notes/tmp/verse/Notes \& Information.txt

1c. Move the updated servers-lookup<version>.jar to the notesdata folder.
$ mv /home/notes/tmp/verse/servers-lookup-3*.jar /local/notesdata

Note:
The new file being placed in the main /local/notesdata folder will replace the older servers-lookup<version>.jar in the /domino/workspace/applications/eclipse/plugins folder.

2. Repeat for any additional Domino Verse servers.


Part D: Perform the upgrade of Verse via its jar files:
1. Via the Domino console, shut down http. or the entire Domino server.
> tell http quit
<wait for stop/quit>

2. Remove the old jar files from the plugins folder.
$ rm /local/notesdata/domino/workspace/applications/eclipse/plugins/ats-*.jar
$ rm /local/notesdata/domino/workspace/applications/eclipse/plugins/sequoia-osgi-*.jar
$ rm /local/notesdata/domino/workspace/applications/eclipse/plugins/core-*.jar
$ rm /local/notesdata/domino/workspace/applications/eclipse/plugins/servlet-*.jar
$ rm /local/notesdata/domino/workspace/applications/eclipse/plugins/servers-lookup-*.jar

3. Place the new jars into their location:
$ cd /home/notes/tmp/verse/domino/workspace/applications/eclipse/plugins/
$ mv *.jar /local/notesdata/domino/workspace/applications/eclipse/plugins/

3. In the Domino console, start http
> load http
<wait for HTT started>


Part E: Verify verse is working
1. Use a browser and verify that Verse loads with login.








previous page