Saturday, February 26, 2011

Lotus Notes ( up to 8.5.2 ) AllClient issues and webkit package names and resulting download file names

It still seems that people are having issues with "Cannot upgrade AllClient installation to Notes client. The upgrade you are attempting is not supported" errors. Be very careful because it's easy to install the wrong webkit and then look up the error and change the installtype in the notes.ini ( btw changing the install type is not recommended under any circumstances and is not support by IBM ). Hopefully you are reading this and taking a second look.

Possible ways to get the AllClient error:

Right around the release of IBM Lotus Notes 8.5, the filename for downloaded Lotus Notes webkit files started changing with what seems to be no rhyme or reason. Before 8.5, the file names were the pack number ( CXXXXX )  I believe this may be confusing and causing an issue when upgrading older clients. Check the very end of this post for the file names and package names.

The other scenario is that the older client was installed with the admin/designer/notes and only the notes client is selected. I've heard of people just downloading the admin/designer/notes client and installing that on all computers with only the client selected at install. BEWARE because if this is your case, your installtype will still be 2 even though you only have the Lotus Notes client portion installed which should be installtype 6, clear as mud right? If this is the case, you need to install the admin/designer/notes client when you upgrade and not the notes only client ( I'm not sure what license issues this could be causing with everyone running the admin/designer/notes client too ). To fix this, you need to manually uninstall the current notes client and install the client only.

Last, IBM Lotus Notes version 8.0, 8.0.1, 8.0.2 all had a basic version of admin/designer/notes where 8.5 and later do not have a basic version of admin/designer/notes. This has nothing to do with instaltype but just wanted you to keep that in mind.

-a standard ( Eclipse ) install can launch the basic client by adding the -sa in the shortcut. If the shortcut has the notes.ini appended after the exe, put the -sa in between. 

-admin/designer/notes client cannot be installed as mutliuser

Below is an example of an All Client install ( admin/designer/notes ) ( installtype=2 )

Below is an example of a Notes Client install ( notes ) ( installtype=6 ) 

NOTE: like I stated above, if you install both these clients as is displayed on two different machines, they will only install the lotus notes portion of the client. However the install types are still different and you need to stick with the same install type. Even thought the All Client only has the Notes Client installed, you cannot install the Notes Client as an upgrade and vice versa.

Also you can check the person documents under Administration tab > Client Information > Notes client license(s). Note that this isn't full proof but it will give you an idea of who is running what without having to go to the physical machines. Make sure there is a pc and client build entry at the bottom:
If you have installtype=6 ( Notes client ) then it will display 
"Lotus Notes"

However if you have installtype=2 ( All Client ) Then it will display 
"Lotus Notes Designer
Lotus Notes Administrator"

Hope this helps!

IBM Lotus Notes Basic Install

installtype 6
IBM Lotus Notes Client 8.0 basic configuration Windows XP and Vista English (C13NAEN)
IBM Lotus Notes Client 8.0.1 basic configuration for Windows XP and Vista English (C18XHEN)
IBM Lotus Notes 8.0.2 basic configuration for Windows English (C1K34EN)
IBM Lotus Notes 8.5 Basic Configuration for Windows English (C1SP2EN) 
IBM Lotus Notes 8.5.1 Basic Configuration for Windows English (CZ5S1EN) 
IBM Lotus Notes Client 8.5.2 Basic Configuration for Windows English (CZIF7EN) 

installtype 2
IBM Lotus Notes, Designer and Administrator 8.0 Clients basic configuration English (C13NEEN) 
IBM Lotus Notes, Designer and Administrator 8.0.1 Clients basic configuration for Windows XP and Vista English (C18XMEN)
IBM Lotus Notes, Domino Designer and Admin 8.0.2 Basic Configuration for Windows XP and Vista English (C1K35EN) 

IBM Lotus Notes Standard ( Eclipse )

installtype 6
IBM Lotus Notes Client 8.0 Windows XP and Vista English (C13NBEN)
IBM Lotus Notes Client 8.0.1 for Windows XP and Vista English (C19U1EN) 
IBM Lotus Notes 8.0.2 for Windows English (C1K31EN)
IBM Lotus Notes 8.5 for Windows XP and Vista English (C1SP4EN)
IBM Lotus Notes 8.5.1 for Windows English (CZ5S3EN) 
IBM Lotus Notes Client 8.5.2 for Windows English (CZIF3EN)

installtype 2
IBM Lotus Notes, Designer and Administrator 8.0 Clients English (C13NFEN) 
IBM Lotus Notes, Designer and Administrator 8.0.1 Clients for Windows XP and Vista English (C19U0EN)
IBM Lotus Notes, Domino Designer and Admin 8.0.2 for Windows XP and Vista English (C1K33EN)
IBM Lotus Notes, Domino Designer and Admin 8.5 for Windows English (C1SQ5EN)
IBM Lotus Notes, Designer and Domino Admin 8.5.1 for Windows 32 bit English (CZ5S0EN)
IBM Lotus Notes, Domino Designer and Admin 8.5.2 for Windows XP and Vista 32 Bit English (CZIF0EN)

Saturday, February 12, 2011

Lotus Traveler 8.5.1 issue with iPhone / iPad

Ran into an issue with setting up an iPhone account with Lotus Traveler. When the Logon Name and Mail Address was filled out and the 'Generate' button was clicked, an error message on the web page would display in red color:

An error was encountered trying to read file c:\lotus\domino\data\traveler\cfg\client\Apple.xml.

In this instance the server was a partition server and the second partition is not running. The data\traveler\cfg folder did not contain a \client\ folder. However on the second partition located at c:\lotus\domino\data2\ had a \client\ folder with the AppleTemplate.xml file.

First I stopped the traveler task
tell nTraveler quit

Then copied the \client\ folder from c:\lotus\domino\data2\traveler\cfg\ to c:\lotus\domino\data\traveler\cfg\ folder. Then I started the traveler task
load traveler

When the task was finished loading the Apple.xml file was created from the AppleTemplate.xml in the correct folder c:\lotus\domino\data\traveler\cfg\client\Apple.xml

More info:
Customizing the device configuration process for Apple

Tuesday, February 8, 2011

Lotus Notes 8.5.2 Roaming - No prompt to upgrade

Last week I hit an issue of a user not getting the prompt for roaming user upgrade. I've down graded roaming, then re-setup roaming but still the user didn't receive the prompt. The adminp process only shows

Update Roaming User State in Person Record
       (Green Checkmark) Server/Test performed action on: 02/01/2011 8:00 PM

Which the document link shows In Progress and an hourglass next to the person document. The person logs into a different computer almost every time. So the issue must reside either in the person document or mail file right?

Well I ended up creating a new person document for the user by clicking "Add Person" and copying and pasting all the data from the old person document to the newly created one. Before I saved the newly created document I deleted the old one ( also I copied and pasted into a temp nab on my machine just in case ) and hit save and close on the newly created person document. The idea being a setting or field that is not displayed in the form is preventing the user from upgrading. The next day I still had issues with the user not getting prompted.

Finally I checked the local log.nsf of the user and found this error message:

Unable to get roaming upgrade lock, exiting roaming upgrade

When I Google searched for that error, I found one link to the forum that someone else had a similar issue and they had the notes.ini parameter client_clock=1 enabled on their client. Fortunately this person posted all the code because I noticed a line saying:

Preseting path to roaming lock db to CN=BELEUMAIL02/O=VWRI!!mail\lsteenho
Entering GetUpgradeLock()
Using Mail file as lock db
Using preset value CN=BELEUMAIL02/O=VWRI!!mail\lsteenho, as the mail file path
Path to the lock DB = CN=BELEUMAIL02/O=VWRI!!mail\lsteenho
Roaming lock already exists
03/11/2009 14:15:32 Unable to get roaming upgrade lock, exiting roaming upgrade.

So I re-created the mail file by doing File > Database / Application > New Copy on the server. Then moved the current mail file outside the data folder and renamed the new copy the same as the moved mail file. A few days later the user received the roaming upgrade prompt! The only downside is the user has to reset their unread marks. If that didn't work I thought about creating a new blank mail file just to get them to upgrade roaming and then revert to the old mail file ( not sure if this would work though ).

I then checked the last thread in the forum and the user basically said the same process fixed his issue too. DOH! Maybe next time I will read the entire thread and save my self the headache!

I sure would like to know if a profile document or regular document is created for this lock. I've tried to 'break' roaming to re-create this but with no success. I am interested if anyone else can shed some light on this roaming upgrade lock process.


Subject: Roaming In Progress, not completing

Tuesday, February 1, 2011

Lotus Traveler SSL and uninstalling issues

I've had two major issues with Lotus Notes Traveler recently ( only applies to version ):

1. Uninstalling the Lotus Mobile Installer goes through ok but uninstalling Lotus Notes Traveler yields "Uninstall not successful". I've had some what 80% success installing Lotus Notes Traveler on top of the old version but in other cases I had to wipe the phone. I found a technote regarding this issue with uninstalling Lotus Notes Traveler. Before you uninstall go to your home screen and press Menu/Options > Settings. Next open Security / Location & Security. Next find 'Select Device Administrators' and open it. You should see "Lotus Traveler Security" checked. Uncheck this and you will be able to uninstall. I've included a link at the bottom.

2. Using SSL. I tell you what, I've had strange issues but fortunately they are all documented and addressed.

SSL issue # 1. Self signed certificate doesn't allow you to download the Lotus Mobile Installer from the web browser. This issue seems to be related to the Android browser and self signed certificates. See the link for workarounds. FYI the self signed SSL certificate works great with Lotus Notes Traveler besides this issue.

SSL issue # 2. Signed SSL certificate causes communication between Android devices and server to stop communicating. I had a self signed certificate and I moved the server to a wild card commercially signed certificate. Some communication worked but over the next couple of days all the devices stopped working / alerting when new mail arrived. After re-installing the Lotus Mobile Installer, it prompts me to download the Lotus Notes Traveler and then gives me an error. This is an issue with a / in the ou or organizational unit of the certificate. The fix is to grab the new LotusInstaller.apk and LotusTraveler.apk files from fix central and copy them to the server overwriting the old versions and change the VersionInfo.txt to reflect the new versions. The bad thing is that you have to re-install both installer and traveler on all devices.

Problem downloading and installing the Lotus Mobile Installer for Android devices

Traveler APAR affecting Android SSL users (includes well-known certificates)

Recommended Maintenance - Lotus Notes Traveler APAR LO57088 for Android (Fix 1 for install post
Fix central - LNT_Android_8521_FIX1