Verse 1.0.7 to 1.0.8 Upgrade

Mindwatering Incorporated

Author: Tripp W Black

Created: 09/16/2019 at 03:44 PM

 

Category:
Domino Upgrades / Installations
Software (Re)Configuration

This tech document contains the steps for updating VOP from 1.0.7 to VOP 1.0.8.

Notes:
The upgrade from 1.07 to 1.08 includes a change to the source of the mail design for Vserse On-Premise (VOP). VOPDesign.nsf is no longer required. It can be removed after the upgrade. The updated Mail 9 template delivered with Domino 9.01 FP9 or StdR10Mail Domino 10.0.1 template is used instead.

These instructions assume you have already set-up VOP before. Those steps will not be included.

Preparatory Steps::
1. Download the Verse 1.0.8 zip file, from the HCL FlexNet repository, and unzip locally.
HCL_Verse_On_Premise_1.0.8.zip

2. Extract the main ZIP into its files:
IBM_Verse_On_Premise.zip
iwaredir.ntf
readme.zip

Now or later, in step 5, extract the IBM_Verse_On_Premise.zip. This creates an eclipse/plugins/ set of folders with the VOP jar files.
if you do it now, you'll copy the files into the final target:
e.g. /local/notesdata/domino/workspace/applications/eclipse/


3. Using the Admin client , verify all users have the latest Domino 9 mail template (FP9 or later) or the current Domino 10 mail template.

4. Confirm the Notes.ini still has the following notes.ini entries:
Note: Over time, the Domino server shifts them around. They are likely not near the end and no longer next to each other. That's okay.
HTTPJVMMaxHeapSize=2048M
HTTPJVMMaxHeapSizeSet=1

5. Locate the old Verse JAR files in:
/local/notesdata/domino/applications/eclipse/plugins/
(If Verse was installed as an OSGI plugin, then look inside the folder/local/notesdata/osgi/shared/eclipse/plugins/)

The old files to remove are:
ats-1.0.7-0.0-506.jar
core-1.0.7-0.0-282.jar
sequoia-osgi-1.0.7-0.0-506.jar
servlet-1.0.7-0.0-282.jar


Perform the Upgrade from VOP 1.0.7 to VOP 1.0.8:
1. Stop the Domino http service:
> tell http quit
(wait for the message that http services have quit)

2. Go to /local/notesdata/
a. Replace the old redirect app, iwaredir.ntf with the new one.
(e.g. Using Filezilla, replace and confirm with Overwrite.)

b. Remove VOPDesign.nsf
(e.g. Using Filezilla, highlight VOPDesign.nsf, right-click, and choose Delete.)

c. Return to the Admin client, and Files tab, locate and highlight your redirect application.
(Default filename is iwaredir.nsf, but we have a custom name for our mail redirect.)
Under File, on the menu, choose Application --> Refresh Design. Select your server, and click OK.

3. Go to /local/notesdata/applications/eclipse/plugins/
(Use the same location where jar files found in step 5.)

a. Delete the 1.0.7 jar files.
(e.g. Using Filezilla, highlight all 4 jar files, right-click, and choose Delete.)

b. Replace with the new ones.
(e.g. Using Filezilla, drag-and-drop the new jar files into the plugins folder.)


The new files, in IBM_Verse_OnPremise.zip, for the plugin folder are:
ats-1.0.8-0.0-529.jar
core-1.0.8-0.0-285.jar
sequoia-osgi-1.0.8-0.0-529.jar
servlet-1.0.8-0.0-285.jar

These files are in the IBM_Verse_On_Premises.zip w/in the ZIP extracted in step 2 above.
Extract them into the folder:
/local/notesdata/domino/workspace/applications/
or, if moving, then to:
/local/notesdata/domino/workspace/applications/eclipse/plugins/
Note: If this server runs Traveler, there is a Traveler jar already in the plugins folder. Don't remove it.

If the jar files are not readable and executable, then:
# cd /local/notesdata/domino/workspace/applications/eclipse/plugins/
# ls -l
< output shows jar files as rw/r/r - red color typically >
# chmod 755 ats-1.0.9-0.0-590.jar
# chmod 755 core-1.0.8-0.0-285.jar
# chmod 755 sequoia-osgi-1.0.8-0.0-529.jar
# chmod 755 servlet-1.0.8-0.0-285.jar


d. If the redirector is not set-up, open the redirector in the Admin client.
The about page typically displays with a button for Setup. Click: Setup --> UI Setup.
Enable Personal Options? No
Enable Login Options? Yes
Enable HCL Verse? Yes
Click Save & Exit


e. Check the Security Settings document for any user policies, click the ID Vault tab, and see if iNotes is allowed to use the Notes ID Vault.
Allow Notes-based programs to use the Notes ID Vault: Yes
We do both iNotes and Verse, so we make sure this is set to Yes.


4. Restart http:
> load http
(Wait and confirm you get the Verse "at your service" message and confirm the libraries load okay. before and afterwards.)


Post-installation:
1. Login to VOP, and verify Verse is functioning well:
e.g. https://www.mindwatering.net/verse/





previous page