Config db ntf: 20150715214500
Analyze db ntf: 20150715214500
Help db ntf: 20150715214500 / Content: 20150715214500
Windows Version: 4.5.10 :: MAC OS X Version: 2.0.48 :: Linux Version: 2.0.42
Eclipse Plugin: 2.5.0


Major Improvements: Redesigned Backup and Roaming Actions, Various minor Fixes and Changes, Update for MarvelClient Upgrade, Important update for Intel Mac OS X


General Notes

Supported IBM Lotus Notes releases: 5.x, 6.x, 7.x, 8.x, up to 9.0.1 including the IBM Notes Browser Plugin
(Administrators need at least IBM Lotus Notes 8.x, selected administrative tasks, such as Online Update, also require Microsoft Windows)
Supported client-side operating systems: Microsoft Windows XP, 2003, 2008, Vista, 7, 8, and Citrix/WTS, Apple Intel Mac OS X 10.5-10.10 (Leopard, Snow Leopard, Lion, Mountain Lion, Mavericks, Yosemite), Linux
Supported server-side operating systems: any supported by IBM (operating system independent)
NOTE: Support is limited for platform and release combinations not supported by IBM
Linux & Mac OS X: Eclipse Management, Skinning, Realtime, Zip/Unzip and Attachment Blocking are not available on Linux or Mac OS X;
Citrix, Linux & Mac OS X: the MarvelClient Upgrade module is only available on Windows (=not on Citrix, Linux or Mac OS X)
MarvelClient on Mac OS X and Linux does not support the runtypes "Before Login - Init", "After Login - After Write", "On first server access", "Background - Init" and "Background" - any such actions must be set to run at a different supported runtype, e.g. "After Login"
IMPORTANT NOTESThis release contains select important updates highlighted in red

Configuration Database

FIXFixed an issue where the "What, When, Who and Admin" tabs would not display correctly with non-standard screen settings; Layout has also been adapted for DPI scaling notebooks.
FIXFixed an issue where members were not counted for Groups that contained a slash ("/") in the name (not a good idea, btw ;-))
FIXFixed an issue with the Eclipse\Manage Shortcut Buttons action, where What-tab fields where visible on other tabs, too
FIXFixed an issue with all Eclipse\* actions, where the "Add extra troubleshooting in the logs"-option was not just displayed on the What-tab, but on all
FIXFixed an issue where newly created bookmark actions could not be selected as template from within Desktop Icon actions
FIXFixed a problem where mailbased Installation caused ECL prompts for "-No Signature-" to appear. The mail and the button in it are now signed properly.
FIXFixed a problem in the Desktop Icon action, where field validation for x/y position was still done even if the fields were hidden (i.e. when the action was configured not to do anything).
FIX / CHANGEVarious fixes and improvements in OnlineUpdate
CHANGEIn previous releases, the Backup to MC Analyze (Windows) action with RunType "On First Server Access" always complained about usage of a non-recommended priority - this is now fixed.
CHANGEThe Objects\Desktop Icon action has been changed to make the selection of target server/local database easier.
CHANGEThe recommended priority range and default priority for the following Eclipse actions have changed:
Eclipse Logging: Recommended range: 1,000 - 9,999 -> Default: 5,500
Eclipse Restart Prompt: Recommended range: 10,000 - 4,999,999,999 -> Default: 2,500,005,000
Eclipse - all other actions: Recommended range: 10,000 - 4,199,999,999 -> Default: 2,100,005,000
CHANGEThe Menus Settings and Eclipse have been re-structured / re-ordered.
CHANGEThe Files\Backup action has been redesigned to best reflect all of its capabilities and include the new backup options.
CHANGEThe Files\Roaming action has been redesigned to match all new roaming options.
CHANGEThe menu items under Eclipse\Sametime have been renamed to be less redundant.
CHANGEThe Replicator Page Entry Template has been changed to now precisely distinguish between Fullmatch, Wildcard and RegExp searches for Locations
CHANGE / ENHANCEMENTThe Location, Replicator Page Entry Template and Replicator Page (System) actions will now automatically change <notes:location> references in the search/match field to <^notes:location$>. This ensures that the referenced location name gets escaped properly for regex matching.
CHANGE / ENHANCEMENTThe Replicator Page (System) action now supports selection of match type for the location field, with Full Match, Wildcards and RegEx being available.
CHANGE / ENHANCEMENTThe Objects\Profile Document action has been changed to make the selection of target server/local database easier.
Also, the action has been enhanced to select from various RunTypes during which the action shall be executed.
CHANGE / ENHANCEMENTThe database property "Restore as last viewed by user" is now set in the Configuration Database template.
CHANGE / ENHANCEMENTSeveral fields throughout the database now will properly escape special regular expression characters.
- A7.1. Location: Search type, Do not remove specific locations
- CRPS. Replicator Page (System): Search type
- A3.3. Replicator Page Entry Template: Search type
- JBAK. Backup: Source- Filename(s)/ -pattern
- JRR. Roaming/Rollback: Source- Filename(s)
- RUIC. Database Scope Condition: Match server, directory and filename
ENHANCEMENTThe Files\File Deployment Action has been enhanced to prevent attaching the same file(name) more than once.
ENHANCEMENTDatabase Scope Conditions now also support a feedback string
Requires DLL >= 4.5.6
ENHANCEMENTAdded a button to Mailbased/PostOpen Install, Program Files field to conveniently attach already downloaded binaries.
ENHANCEMENTThe GroupExplorer Automate Agent will now print a warning if the user or server, who is executing the agent, does not have the role [Server].
NEWAdded the option "Invoke Notes on vCard files" to the Settings\User Preferences action.

Analyze Database

FIXFixed an issue where the view "ID-Files - by Act. & Expiry Date" could display up to two categories labelled "Unknown"
CHANGE / ENHANCEMENTThe view Runtime Analysis has been changed to no longer display negative values but a question mark, so that average values are now displayed correctly. Also the sorting and structure of the categories has been improved.
CHANGE / ENHANCEMENTThe database property "Restore as last viewed by user" is now set in the Analyze Database template.
NEW / ENHANCEMENTThe "Mail" tab in the user document and the view "Mail Overview" have been improved to display information about MMR (Mail Managed Replicas).
NEW / ENHANCEMENTThe view Lotus Notes\Mail Overview has been enhanced to display Managed Mail Replicas in a seperate category
NEWAdded a new Action "Run Audit" to main user profile documents to audit a document from within itself
NEWAdded a button to the header of main user profile documents which displays if a user's home/mail server is different from the server the document is being opened on - the button will then allow to directly open the main profile document on his/her home/mail server.


For users who have the role [CheckHomeServer] (must be added to the ACL for existing installations), the button will only be displayed if in fact the profile document on the home server is NEWER. Note that use of the role prolongues document open times (due to the necessary lookup on the homeserver of the user), but then again saves the time to open the corresponding document to check whether it is in fact newer.
NEWThe "ID Files\by Cert. and more" view now also shows whether Notes Federated Login (NFL) is in play
Requires DLL >= 4.5.0

MarvelClient Help

UPDATEUpdated release notes

MarvelClient Upgrade

MCUpgrade.exe (4.0.6.0)Added support for moving the data directories in ALL windows user profiles into a new path, for changing MultiUser installs from e.g., *\Lotus\Notes\Data to *\IBM\Notes\Data and similar.

The following MCUpgrade.ini entries control the migration of all data directories for multiuser installations (values shown are examples only):

MultiUserProfileMoveSearchRegExp=
;regular expression to find all old data directories underneath e.g. C:\Users or C:\Documents and Settings (User profiles root)
;if not set, this is automatically computed from OSLocalAppData suffix (e.g. AppData\Local) + Old Notes Data directory suffix (e.g. Lotus\Notes\Data)
;e.g. (.+)\\AppData\\Local\\Lotus\\Notes\\Data\\$
MultiUserProfileMoveReplaceRegExp=${1}\\AppData\\Local\\IBM\\Notes\\Data\\
;regular expression to transform any found old data directories
;if not set, this is automatically computed from OSLocalAppData suffix (e.g. AppData\Local) + New Notes Data directory suffix (e.g. IBM\Notes\Data)
;e.g. ${1}\\AppData\\Local\\IBM\\Notes\\Data\\

;If the Shared Data directory ("All Users Shared data") is to be migrated, too, the following ini entries can be used to control MCUpgrade:
MultiUserSharedDataMigration=DEL|DELETE|MOVE|SKIP
;defaults to not set = DELETE
;DEL and DELETE are effectively the same, when using this option, MultiUserSharedDataNew does not need to be specified
;DELETE=brute force deletion of Old Shared Data Parent Directory
;MOVE=Move entire contents of Old Shared Data Parent Directory to New Shared Data Parent
;SKIP=Leave Old Shared Data Directory as is - similarly to DEL|DELETE option, not MultiUserSharedDataNew directory needs to be specified with this option
MultiUserSharedDataOld=C:\ProgramData\Lotus\Notes\Data\Shared
;recommended to be set via <notes:shareddata_directory>
MultiUserSharedDataNew=C:\ProgramData\IBM\Notes\Data\Shared
;recommended to be set to actual shared data directory of target install, e.g. <os:common_app_data_directory>\IBM\Notes\Data
;if MultiUserSharedDataOld or MultiUserSharedDataNew end with "\Shared", the effective path used for further processing is one level up - e.g. C:\ProrgamData\Lotus\Notes\Data\Shared --> C:\ProgramData\Lotus\Notes\Data

If one or more multiuser data directories are migrated (excluding shared data directory migration, if applicable), then SkipNotesDataDirectoryMigration is set to 1 for further processing (not in MCUpgrade.ini itself), as the user's own data directory is then already migrated through the multiuser data directory migration option.
MCUpgrade.exe (4.0.7.0)Fixed an issue where migration of the shared data directory would count toward the total number of migrated directories;
whilst this should never be an issue with correctly configured values for multiuser directory migration, the code now works with possible misconfiguration, too
MCUpgrade.exe (4.0.7.0)The following OS environment variables will now be set in the data directory migration code block - especially for possible re-use in MultiUserProfileMoveSearchRegExp and MultiUserProfileMoveReplaceRegExp:
MC_LOCALAPPDATA_SUFFIX (e.g. \AppData\Local)
MC_OLDNOTESDATA_SUFFIX (e.g. \Lotus\Notes\Data)
MC_NEWNOTESDATA_SUFFIX (e.g. \IBM\Notes\Data)

Eclipse Plugin

MC Eclipse Plugin (2.5.0)- No Changes -

.DLL Updates (Windows)

FIX (4.5.1)Fixed a bug where ZapNotes sometimes caused notesmm.exe to hang after client shutdown. This could lead to problems if the user restarted notes while this task was still hanging. ZapNotes now will ignore notesmm.exe.
FIX (4.5.2)Fixed a bug where Backup actions during First Server Access or Background run times could cause an empty images.xml to be written and uploaded. This bug was introduced with MC DLL 4.5.0.
FIX (4.5.4)Fixed a bug where during intial Notes Client setup the small password dialog was displayed instead of the regular dialog. This issue was introduced with MC DLL 4.5.0.
FIX (4.5.5)Fixed a problem where MarvelClient would cause the IBM Notes Setup Wizard to not show up. This issue was introduced with MC DLL 4.5.4
FIX (4.5.5)Fixed a bug in Mail Blocking where a Database Scope Condition would compare directory and filename against the absolute path of a database instead of the path relative to the data directory (e.g.: C:\Lotus\Notes\Data\mail\user.nsf instead of mail\user.nsf)
FIX (4.5.6)Fixed a bug in the Mass Change action where changing an icon could lead to the whole icon stack being hidden. This bug was introduced with MC 4.5.5
FIX (4.5.6)Fixed a problem where the workspace directory (<notes:eclipse_data_directory>) would be resolved as the notes data directory. This was caused by a bug in a Notes API call that was fixed in 9.0.1 FP3.
FIX (4.5.7)Fixed a bug where bookmarks which have a formula as their title were not roamed properly. This caused the "New->Mail" toolbar action to disappear.
FIX (4.5.7)Fixed a problem where no keyfile.xml (enabled via Extended XML Export) would be created for NSL (Notes Shared Login) enabled ID-files.
FIX (4.5.7)Fixed a problem in Zip where attachments zipped using Deflate64 compression method of 7-Zip were not unzipped properly.
FIX (4.5.8)Fixed a problem where config values that represent the operating system version (<os:version*>) were set to older version numbers. This was caused by an API change in Windows 8.1.
FIX / CHANGE (4.5.8)The config value <os:version_string> will now be set correctly for Windows 8.1 and Windows 10.
FIX / CHANGE (4.5.8)The calculation of the next free icon position on the desktop has been improved. It will now better detect when an icon should be put in a new row and should no longer put icons too far on the right.
FIX / CHANGE (4.5.8)Fixed a bug in the Roaming action where the "Force Restore" option ignored the isRoamingSet flag of a backup set. The roaming action will no longer roam or rollback anything from a fileset unless it is flagged as roaming set. Roaming/Rollback from databases is unchanged.
CHANGE / ENHANCEMENT (4.5.1)Improved logging: "cannot convert to UTC" warning should no longer happen
CHANGE / ENHANCEMENT (4.5.2)Improved logging for all login / id-file related calls to include the text 'in-mem' when in memory id files are involved (Notes Federated Login).
CHANGE / ENHANCEMENT (4.5.2)Relocate/Realtime: actual relocations/restrictions now show up in log without having to raise default log-level (log level 2 instead of 4)
CHANGE / ENHANCEMENT (4.5.5)Improved logging: added a log line if user opted to cancel password prompt
ENHANCEMENT (4.5.6)For managed replicas, Desktop Icon actions will now be prevented from performing actions which would be invalid, like removing the local icon or hiding the stack.
ENHANCEMENT (4.5.7)To increase performance, reading of extra info from desktop*,ndk/dsk After Login is disabled where possible. 

This means information about view sort order, search bar settings and current view selection oftentimes will not be included in the desktop.xml generated at After Login, and therefore not be available for roaming.
MC will still always read desktop extra info in shutdown, and the old behavior during After Login can be forced by setting <mc:desktop_roam_extrainfodump_afterlogin> (bool, optional, defaults to false). Set this to true if you intend to do roaming based on data from After Login instead of Shutdown.
ENHANCEMENT / NEW (4.5.6)The window title of all MarvelClient dialog boxes can now be customized as following:

<mz:mailblocking_window_title> for all dialog boxes related to Attachment/Mail blocking
<mc:zip_window_title> for all Zip/Unzip dialog boxes
<mc:idvault_userdiag_window_title> for the ID-Vault user-name prompt and error message-box (defaults to <ini:MC_idvault_userdiag_window_title>)
<mc:zapnotes_window_title> for the ZapNotes dialog box (defaults to <ini:MC_zapnotes_window_title>)
ENHANCEMENT / NEW (4.5.6)Set notes.ini MC_RR_relocator_allow_cluster_mates=0 (defaults to 1) to prevent Realtime Relocation actions from relocating to cluster mates. 

Without this setting, relocating from one cluster mate to another will happen for Realtime Relocation actions like */company ---> mailserver/company. Using above setting this behavior can be disabled, so that relocations within the same cluster will not happen anymore.
NEW (4.5.1)New config section: time. 
Allows to access time-related information using references. Currently supported variables:

<time:current-date>
<time:current-time>
<time:current-datetime>

Each can be extended by _local or _utc, like so: <time:current-time_utc> or <time:current-datetime_local>. Without it, all results are in UTC.
All results are in ISO-format.

A few examples:
<time:current-time> - 195513Z
<time:current-time_local> - 215513
<time:current-time_utc> - 195513Z
<time:current-date> - 20150418
<time:current-date_utc> - 20150418
<time:current-datetime> - 20150418T195513Z
<time:current-datetime_local> - 20150418T215513

.dylib Updates (Mac OS X)

.dylib (2.0.48)Fixed an issue where a single exception (e.g. attempt to get database properties of a local database encrypted by another used) during reading of the desktop would lead to no desktop management and an empty desktop.xml (not *.dsk/ndk).

.so Updates (Linux)

.so (2.0.42)- No Changes -