IBM Support

Ask the Experts: Notes & Domino Smart Upgrade - 20 August 2014 (Q&A, Audio Replay, Presentation)



IBM hosted an Ask the Experts Q&A session on "Smart Upgrade and SURunAs" on August 20, 2014. The Q&A, audio replay and resources shared during the session are included below.


Audio Replay

  • 44:43 minutes in length
  • Q&A begins at 25:00



Q1. Can you address how you could go about upgrading Sametime?

Find step-by-step instructions (pictures included) in the following post from Jeff Mitchell's blog:
For Passport Advantage part numbers for Notes 9.0.1 + Fix Packs, see the following technotes:

Q2. In Domino Directory, under People View, there is the By Client Version. Is there a way to purge all the outdated versions. It is displaying information from Person document that is a multivalue field. So as users upgrade, they get the new version added. It never removes the old. Basically, I need to purge all old versions that are no longer being used and only what to see what is current. What updates that field?
I think some customers have done this themselves, written an agent to clear the appropriate fields in the person document. We've never documented such an agent however. There are a bunch of parallel fields that would all have to be deleted at the same time to properly clean up the documents.

Q3. IBM Support indicated that I need to go to my 1200 machines (Win 7) and replace the 8.5.3 SUService.exe with a 9.x SUService.exe. Also, SUService.exe runs with elevated rights, so a simple batch file to stop the service prior to copying an updated SUService.exe won't work.
I don't remember the exact details but there is a bug in the SUService.exe that shipped in 8.5.3 that prevents it from working correctly to elevate the install kit to allow the installation to proceed.

Yes, the SUService runs as a service so a "regular" user isn't going to be able stop and replace it. Are your Win7 machines part of a Windows domain? Do you have Domain Admins groups setup to have full control on those machines?

The bug is that the service thinks that the upgrade is done after about 90 seconds, when it's still running. And yes, I have a Domain Admins group at my disposal.
So you should be able to remotely stop the SUService ("sc \\machinename stop lnsusvc"). Copy in the new SUService ("copy suservice.exe \\machine\c$\pathtonotes") and then start the service again. ("sc \\machinename start lnsusvc"). And do it all in a batch file/vbs script

Q4. Has anyone been able to successfully use the /qb with the SURunAs exe? Our Win7 clients will say an interactive service is trying to communicate. I have to use /qn...
You can't use /qb with SURunAs and SUService. The /qb causes a progress bar to be displayed but since the install is running within the service context, Windows does that dumb annoying "interactive service" prompt.

Q5. In the SURunAs would you select the zipped EXE or do you need to grab all the files?
  • You can use the web kit too (zipped file) just pass -s -a before the command line parameters
  • You can use either the exploded kit or the package for the web kit. it just changes the command line parameters you'd pass thru.

Q6. Is there a useful list of the various switch that can be used? Switches passed to the command line.
See the following Help topics:
  • Performing a Notes silent install or upgrade on Windows "MSI command line arguments are available, and may be required, for running a Notes® command line install to add or remove Notes client features during initial install, release upgrade, or within the same Notes release..."

Q7. Does this work with Multi-user client install as well?
Yes. Multi-user is supported.

Q8. When I download from Passport advantage, I get an EXE that I gave a meaningful name. Example of an old on "notes_designer_admin853_w32en.exe". From what I am hearing and reading, I just add that file to the settings document. I also read, I need to add the /s when using this correct?
You need to add /s /a to that webkit. the /s makes the unpacking of the webkit silent. So a typical command line would be /s /a -s -qn -v "SETMULTIUSER=1"

I use the slash / to denote options for the webkit and the dash - for the options to the embedded installer; however, they are interchangeable.

Q9. I have experienced that when the upgrade from 8.5.3 to 9.0.1 runs, the PC suddenly restarts. I then put in the /W parameter and this made the upgrade run to the end.. It ended with an error and then the PC restarted. The Smart Upgrade tracking says interrupted. Anyone else have these experiences..???
If the installer is causing the reboot there should be something in the Installer log that indicates why the reboot was required. Files in use is the typical reason. There are command line options that you can use to suppress the reboot that occurs when doing a silent install

Q10. What are these command line options (regarding how to suppress the reboot)?
The command line would be /V REBOOT=ReallySuppress. See the Microsoft Developer Network "REBOOT property" article @

Q11. What if you have clients starting at different version? In other words, different machines are starting at different parts of the upgrade chain
You can use a * for Source version

Q12. Can Smart Upgrade force the template upgrade?
Smart Upgrade doesn't do that. That's actually done by another feature in Notes/Domino called Seamless Mail Upgrade, which is also located in the same Desktop Settings document. On the Basics tab, you can specify .... if a client is running a certain version you want them to be running a certain mail template version.

An alternative is going to the Server Console and issuing "load convert -u" which upgrades the folder design. You can do that for any and all users whenever you want.

So one method is to do this, where the policy will enforce as soon as you're on a certain client version to upgrade your mail template. Or, if you want to just wait, and smart upgrade everyone and then later on do the "load convert -u" on whomever you want, you could do that too.

Q13. Any changes in Smart Upgrade in 9.x?
No. I think Smart Upgrade hasn't really changed since early 8.5x.

Q14. About the upgrade pop-up, some users just don't want to upgrade. Is there any way we can force users to upgrade after a certain number of logins?
Yes. On the Desktop Settings document, you specify a deploy version and a deadline. When you specify a deadline, you can choose whether to remind them every hour after the deadline has passed. If you don't set to remind them, it will just tell them the deadline has passed and you have to upgrade now.

So even though they select, don't want to upgrade now, they'll still have to upgrade?
Right. There's actually only an OK button. They will not be given an option to not upgrade. Even if they click X to "just" close the prompt, their client will still be upgraded.

Q15. If we upgrade and hold people on one server, it's going to take a lot of bandwidth. Any advice on how we can launch this without really clogging up our lines?
A lot of customers make groups to upgrade if they're concerned with bandwidth. Either make several different kits (that have the same criteria) but they different users in the Allowed Users field.

So you can have one group that has twenty people in it and the kit for them is located on the server that's close to them. And you could make another kit that's the exact same criteria except with different people on the Allowed Users field and you would put that kit on a server that's close to them.

Or if everyone is around the same place and you just want to do the upgrade in shifts. People usually do about 50 users at a time if they are concerned about bandwidth, and then another 50 the next week.

Also, there is the Smart Upgrade Governor feature that you can use to limit the concurrent downloads.

Q16. Is /w still valid for 9.0.1?
For the Web kits, yes, if you are using it within SURunAs.

/w basically says to the package to the Web wrapper that sits over the whole install kit, "wait for the child process to return before you give status back to the calling process."

Normally if you are running it from the command line directly you don't need to worry about /w because there is no Parent process to the Web kit.

If you are running it within inside of something else, like SURunAs, then, yes, you would need to pass the /w so that it doesn't return after launching the child executable.

Q17. I'm doing an upgrade to a specific component, Sametime 9, in this instance. Running into an issue where these users are not able to detect matching kits when upgrading users to Sametime. If I add that user directly to the kit vs in a group, it finds a match.
I've seen this before. Check your group to see if the users are listed exactly in the group as they appear when you list them individually.

Q18. Even using the latest SURUNAS "tool", we are still experiencing the UAC issue going from 8.5.3 to 9.0.1 FP1 on Windows 7 machines. Can you give me an idea of how to resolve this issue? It hides the prompt to complete the install. So users think it doesn't complete...
If you used SURunAs to do the install on Win7 without ALLUSERS=1 then I'm surprised Notes is usable at all. We'll need to follow-up on this more directly via a PMR. Click here to open a Service Request (PMR) with IBM Support.

Helpful links

Understanding a Smart Upgrade Kit Document:

YouTube video on setting up Smart Upgrade (A replay of the demo delivered during the session):

Using the "Smart Upgrade Run As" feature to upgrade Notes clients:

About Open Mic Webcasts
IBM Collaboration Solutions (Lotus) Support wants to help you take full advantage of your products. Join us for our Open Mic Webcast series as technical experts share their knowledge and answer your questions. These webcasts are designed to address specific topics and provide an in-depth and focused technical exchange in a convenient online webcast format. For more information about our Open Mic webcasts, visit the IBM Collaboration Solutions Support Open Mics page.

Original publication date


Document information

More support for: IBM Notes

Software version: 9.0.1

Operating system(s): Linux, Windows

Reference #: 7042285

Modified date: 20 August 2014

Translate this page: