Sunday, October 31, 2010

Bundled Install: Sametime & Notes

Notes 8.5.2 ships with an embedded Sametime client.  It is still version 8.0.2, however, and therefore one of the first things you have to do is then run the installer that is part of the 1.7 Gb Sametime client download to upgrade this embedded client.  While this is not that big of a deal for small installations, if you do not have an automatic distribution method for software in a larger organization or very geographically dispersed one, this can pose challenges.  To solve this, we are able to manipulate and customize the Notes installer.

The first step is to extract the Lotus Notes 8.5.2 installation package.  Assuming you are doing this from a download, launch the installer that you obtained from IBM, and select the option to save the installation files as opposed to removing them after installation.


You can specify a new location for the files if you like, so that you can more easily locate and differentiate your custom installation package from an unmodified one that may already exist.  If Notes is already installed, you can cancel the installer right after it extracts the files.  I then make a working directory and copy all of the contents of the extracted installer, minus the Utility directory, into the working directory.  It is also necessary that you remove the “Read-only” bit from any items to be manipulated by the customization utility.  Right-click the working directory and clear the Read-only box.  Click Apply and be sure to propagate these changes to all subdirectories and items.  You will now have a clean installer to customize.

You will then find a Utility directory in the root of where you originally extracted the installer.  This contains a small set of tools to assist with this procedure.  You can use the Notes Customization Kit to reduce the installer in size to eliminate unwanted components, or also use it to add additional components.  For optimal results, you may want to do both.  Extract the to someplace you will be able to find it again.  I tend to just leave it in the Utility directory.

** TIP** There is an alert when you first launch the Trim UpdateSite utility indicating that it needs to have zip.exe and unzip.exe.  If you are running this from a Lenovo laptop, you should have these utilities in your Program Files\Common Files\Lenovo\infozip directory.  Copy these files to the NotesCustomizationkit directory.  Run the Trim UpdateSite utility and remove any unwanted elements, like Symphony and Sametime.  The utility makes backups of the original files it manipulates which we preserved by creating the working directory.  Remove these “Copy of…” files.

Since in this exercise, we are working with Sametime + Notes, I also downloaded the Sametime Standard 8.5.1 client bundle and ran the installer for the Sametime embedded client with the option to save the installation files and not clean them up after installation.  Make sure you specify a path for installation that you will be able to find again.

Back in the Utility folder where you originally unzipped the Notes client, there is another utility called addToKit.exe.  This  will be how we merge the two update sites together.  To prep the Sametime update site, I first renamed it from to  Next I changed all references in the deploy\install.addon.xml file from the Sametime embedded installer to reference the new update site zip file name and saved it as install.xml.

To merge the two together, you can run the addToKit.exe with two parameters.  The first is the path to Sametime, and the second is the path to the Notes installer we are customizing.  I was then able to add/modify the plugin_customization.ini file in the Lotus Notes installer’s Deploy directory to include the appropriate settings.  You can refer to the Sametime product wiki or InfoCenter to find out more about the appropriate entries to add/modify here.  Before using your new installation package, you just have to remove the install instruction from the setup.ini in the Notes installation package for the included Sametime components and you should be all set.

In researching how others have used this as well, I found a blog article on Usable Software that suggested to also unzip the resulting file as it will speed up the installation process.  It is up to you and your installation requirements if this is something you also adopt.  The full article can be found here.

Tuesday, October 12, 2010

LS11 Call for Abstracts

Reminder… Friday is the deadline for submission.  This is the extended date, so I don’t suspect it will be extended again.  Good luck to all submitters.  Looking forward to another great conference.

If you need the link to submit your idea, here it is:

Monday, October 11, 2010

Sametime Advanced 8.0.1 on Windows 64bit

IBM has so nicely provided us with a single package installer for the prerequisite apps required for Sametime Advanced.  This list is not short, and the installers, scripts, etc tally up to a 1.7 Gb download.  This does not even include WAS or ST:Adv it’s self.  Installing these days on a 32bit system seems to be far and few between.  I wanted to capture my recent experiences in Windows 2003 64bit and Windows 2008.

Windows 2008 is not supported according to the documentation.  If you want to install on Windows 2008, there are numerous workarounds required.  I would suggest at that point, not using the prereq bundled installer and plan to install the components separately.  You will likely want to reach out to techline or IBMSERV to have them validate the versions of MQ, Event Broker, DB2, etc before you begin.  I was able to confirm with IBM Support that you should be able to use DB2 9.5.1 which ships with Sametime Standard 8.5.1 and use that with some helpful scripts they were able to provide.

When installing on Windows 2003, the most notable issue I encountered was the prerequisite install failed when installing the fix pack in the bundle for WebSphere MQ 6.0.  This is the update to take it to, where the fix for this particular issue was targeted to be corrected.  You will encounter an issue similar to the one outlined in  The error will read:

"Ensure the prerequisite 'Microsoft Visual C++ 2005
Redistributable Package (x64)' is installed before continuing
installation of this Fix Pack. (AMQ4765)"

The fix pack installation will fail, halting the bundle installer, and present you with an error.  I addressed this as follows:

  1. DO NOT CLEAR THE ERROR.  The side effect of the error halting the installation of the next components gives you opportunity to correct the current issue and still complete the installation successfully.
  2. Launch regedit
  3. Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\IBM\MQSeries\CurrentVersion\
    Maintenance and add a string value VC80Redistcheck with a value of 0.
  4. Next, navigate to the %TEMP%\WZSE0.TMP\STA8_PI\SupportingFiles\MQ-image directory and launch the fix pack installer.
  5. Let the fix pack install on it’s own and then clear the error from the bundle installer.  It will then run to completion.

I also found that the prerequisite server was not listening on port 1506 as it should be.  Follow the steps in this article for correcting this condition:

Don’t forget to restart the system.  I hope this helps.