Config db ntf: 20160401161500
Analyze db ntf: 20160401161500
Help db ntf: 20160401161500 / Content: 20160401161500
Windows Version: 5.0.0 :: MAC OS X Version: 2.0.51 :: Linux Version: 2.0.51
Eclipse Plugin: 2.5.3


Major Improvements: Cloud Onboarding, location and replicator page improvements, MMR, File Operation, Recent Contacts management, set registry values, IPv6 support, IP Adapter condition, roaming of print settings, rework of config variables regarding userdetails/usermailbox, Citrix/laptop detection improvements, Plugin (Un-)Install enhancements, keep several sets of logfiles


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 and ICAA.
(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, 10, 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 a problem with removing profile fields in the Profile Document action.
FIXRemove the "Before login" from run section options for the Profile Document action (was never supported by the DLL)
FIXFixed a problem in Bookmark and Bookmark Folder actions, where the image source option "Local (Primary) Addressbook" did not work.
FIXFixed a display issue with the licenses required for the ECL management action.
FIXFixed an issue with the download views for GE Automate which caused the wrong multi-value separator to be used in some regions (e.g. Australia).
FIXFixed an issue in the Backup action where the action priority on the Admin tab was allowing values that were too large.
FIXFixed an issue with the GESync agent where it sometimes failed for actions with certain settings on the Who-tab. This only occurred for actions where EXCLUDE or ONLY FOR were disabled, but still had enabled entries.
FIX / CHANGEField validation in numeric conditions made less restrictive.
FIX / CHANGEVarious fixes to improve layout for DPI scaling
FIX / CHANGEIt is now possible in OnlineUpdate to choose not to create a help database and still continue with the rest of OnlineUpdate.
CHANGE / ENHANCEMENTSeveral changes have been made to OnlineUpdate and how it locates other MarvelClient databases.

The use of the %notes_homeserver% placeholder is now deprecated in the OnlineUpdate form (and only there, it still is fine for notes.ini variables on the Client). It will continue to work, but <onlineupdate:currentserver> should be used instead from now on. 
The old placeholder can lead to problems because it depends on the location settings of the administrator who starts OnlineUpdate. The new variant will instead always use the same server as the current Config DB (which makes much more sense).

The default values for Analyze and Help DBs have also been changed to always use <onlineupdate:currentserver> as server, and the same directory as the Config DB.

This change has of course no effect on existing settings in the OnlineUpdate form, they will continue to work as before.

Additionally, to help prevent problems for existing installations, a warning message will now appear if %notes_homeserver% is used and resolves to a server different from the current Config DB server.
ENHANCEMENTAdded an option to Mail Blocking which allows end-users the choice to ignore mail blocking messages and send the mail.
This option also has separate feedback strings.
ENHANCEMENT / NEWZip/Unzip Settings now have an option to show a dialog for Drag&Drop and Copy&Paste where they can select encryption and zip settings. Requires DLL >= 5.0.0
ENHANCEMENT / NEWThe User Preferences action now also supports the Mail\Internet\Image Security preference. Requires DLL >= 5.0.0
ENHANCEMENT / NEWAdded a new option to the Eclipse Plugin Uninstall action to also try to uninstall a plugin from the framework directory. Requires Plugin >= 2.5.3
ENHANCEMENT / NEWAdded a new option to the Eclipse Plugin Install action to allow plugin version downgrades. Requires Plugin >= 2.5.3
ENHANCEMENT / NEWThe Desktop Icon action now has direct support for creation and conversion of Managed Mail Replicas.

If the action is set to "Usermailfile" on the General tab, the new option is available on the Local Replica tab, including advanced settings (which will use the default values if not selected).

Because of this new functionality, the layout of options on the Local Replica tab has been changed for other types of replicas as well.
Requires DLL >= 5.0.0
ENHANCEMENT / NEWThe replicator page settings in the Desktop Icon action now allow to choose between "Do Nothing", "Create/Update" and "Remove". Requires DLL >= 5.0.0
ENHANCEMENT / NEWReplicator Page Entry Templates now have additional "change existing" options. Requires DLL >= 5.0.0
ENHANCEMENT / NEWThe Location action now has additional options to control replicator page creation. By default a full replicator page will be created (instead of an empty replicator page, as in older versions. Requires DLL >= 5.0.0
ENHANCEMENT / NEWThe Replicator Page (System) action now can be used to managed several additional system entries, including IBM Roaming-related entries. Requires DLL >= 5.0.0
NEWAdded new action Advanced\Abort IBM Notes Launch; it allows to prevent Notes from starting. This is helpful for example when you don't want an initial client start to happen when no network connection is available. Requires DLL >= 4.5.36
NEWAdded new action: File Operation. This allows to perform many file operations like copy, move, delete, zip, unzip and comes with many filtering options. Requires DLL >= 5.0.0
NEWAdded new action: Manage Recent Contacts. This can be used (among other things) to remove recent contacts from the user's personal address book and allows filtering options. Requires DLL >= 5.0.0
NEWAdded new action: Set Registry. Requires DLL >= 5.0.0
NEWAdded new condition: IP Adapter
This condition is an improvement over the IP Range condition which can match many more properties of an IP adapter, like DNS or gateway servers, making it easier to prevent false positives. This action also fully supports IPv6 addresses.
Requires DLL >= 5.0.0
NEWAdded new action: Cloud Detection.
This action is the first part of any IBM Cloud Onboarding using MarvelClient. It enables MarvelClient to detect if a user is ready to be onboarded into the cloud and makes this information available to be used in conditions and for reporting in the Analyze DB.
Requires DLL >= 5.0.0
NEWAdded new action: Cloud Onboarding.
This action automatically onboards any user that has been moved to the cloud, and can take care of round-robin replication of the usermailfile, location settings and folder design updates. It is a full replacement for the client onboarding solution from IBM.
Requires DLL >= 5.0.0

Analyze Database

FIXThe Notes.INI\by Notes.INI Entry view should no longer wrongly categorize entries that contain a backslash character.
FIXFixed a problem where the form for Addons\Locations entries sometimes displayed the wrong information for mail file fields (displayed the mail path of the current user instead of the one uploaded).
FIXVarious fixes to improve layout for DPI scaling
FIX / CHANGEThe Audit agent has been improved to better deal with problematic/invalid special characters in uploaded XMLs.
CHANGE / ENHANCEMENTThe warning for incorrectly configured Managed Mail Replica settings in the User Profile now contains more details about the detected problem.
CHANGE / ENHANCEMENTThe Notes.INI\Preferences view (and related form) now also contains categories for the "Slide in summary" preference.
ENHANCEMENTThe Mail tab in the User Profile form now also contains the size of the local mail file (if available).
ENHANCEMENTThe OS/HW tab in the User Profile form now also contains the computer description.
NEW

Added view Users\Cloud Onboarding. This view works in tandem with the new Cloud Onboarding actions and serves to display onboarding progress.


The categories give an overview over the current cloud status of all users (i.e.: whose mail file has been moved to the cloud) and the current onboarding status (i.e.: whose client has been configured to work with the cloud server).

It is an essential tool to plan and to oversee the progress and success of onboarding with MarvelClient.

MarvelClient Help

UPDATEUpdated release notes
InstallWizardThe Install Wizard has been changed. 
- The confusing option about installing on the Client has been removed
- The database paths entered during the Wizard will now automatically be pre-configured in the OnlineUpdate form of the installed Config DB. 
- The Wizard now also removes the master template settings from the help database in which it is started, therefore preventing problems because of several templates existing during OnlineUpdate.

MarvelClient Upgrade

MCUpgrade.exe (4.7.0.0)- No Changes -

Eclipse Plugin

FIX (2.5.3)Fixed a problem in the Eclipse Manage Shortcuts action, where the action wouldn't work if the sidebar was fully collapsed (not even icons visible).
FIX (2.5.3)Fixed a potential problem in the Plugin Install action: Will no longer try to uninstall the wrong version of a feature when a specific version is specified (the uninstall won't work if the version is wrong, but we shouldn't be trying in the first place).
ENHANCEMENT (2.5.3)Plugin Install action: The "enable immediately" option for plugin installs now works on unpacked plugins (and still works on normal plugins too)
ENHANCEMENT / NEW (2.5.3)Plugin Install action: New option to allow features/plugins to be uninstalled from the framework directory. MC will still only try to uninstall from the workspace directory by default, but there is a new option to allow searching the framework directory for features to uninstall too.
ENHANCEMENT / NEW (2.5.3)Plugin Install action: added new option "allow downgrade" for feature installs, so you can force an install of an older version of a feature without having to find and uninstall the newer version first.

.DLL Updates (Windows)

FIX (5.0.0)Fixed a bug where replication stubs created by MarvelClient would not get a proper title if the database property "Send application title and catalog info to other replicas" was not set.
FIX (5.0.0)Fixed a wrong text on the ZIP dialog when encryption is set; was "Password does not match", is now "Password not set".
FIX (5.0.0)Fixed a bug where removing fields using the profile document action did not work.
FIX (5.0.0)Fixed a bug where truncation info could get lost from replicator page entries. This bug only occurred in Lotus Notes 5.
FIX (4.5.39)Fixed a bug that caused <mc:actions_xml_upload> not to work in some cases.
FIX / CHANGE (5.0.0)The option "Extend MassChange to locations" in Mass Change actions now only applies to locations that have the mail type "on server".
FIX / CHANGE (5.0.0)Match formulas in Location and Connection actions that change fields will now automatically flag a document as modified by the action and trigger a document save.
FIX / CHANGE (5.0.0)The default value for a volume blocking feedback string was in the wrong language (English instead of German). This has been fixed.
FIX / CHANGE (5.0.0)Fixed a bug where the shutdown guard did not properly work on basic clients in rare cases.
FIX / CHANGE (5.0.0)A missing images.xml will no longer be logged as an error.
FIX / CHANGE (5.0.0)SmartFileDownloader related logging in background should no longer leak through if log level is not set explicitly.
CHANGE (5.0.0)Some of the logging around database open timeouts has been reworked to be less confusing.
CHANGE (5.0.0)The variable <os:slow_machine> is depracated and has been removed.
CHANGE / ENHANCEMENT (5.0.0)Several config variables will now get refreshed more often. Memory, disk and network related information will not get refreshed at the start of every run time.
CHANGE / ENHANCEMENT (5.0.0)The logic used to locate the MC Config DB has been improved. In earlier releases of MarvelClient, the path in <ini:MC_DB> would be tried first, and <ini:MC_DB_Unavailable> second.

From now on <ini:MC_DB_LastReachable> and <ini:MC_DB_NotResolvable> will also be tried if the first two both fail.
CHANGE / ENHANCEMENT (5.0.0)The handling of userdetails and usermailbox information has been improved. All the involved config variables will be available and up-to-date (for example if a location change action runs) and therefore be more reliable.

Userdetails:
The information from the public NAB (found in <notes:userdetails_*>) now gets read automatically on every start, directly at the beginning of afterlogin (and therefore is available in any run section without the need for a location action to run first).

In previous releases, this lookup was always performed on <mc:configdb_server>. Now it will be tried on several servers in case this fails.
The order is now: <mc:userdetails_lookup_server_override>, <mc:configdb_server>, <notes:um_server>, <mc:userdetails_lookup_server_fallback>
- <mc:userdetails_lookup_server_override> can be set to force another server to be tried first, in case <mc:configdb_server> is not a good first choice
- <mc:userdetails_lookup_server_fallback> can be set to have a reliable fallback

If a local mailfile is found, the userdetails will also be enriched with some information from it: path, ODS, size and whether it is a Managed Mail Replica.

Furthermore userdetails will now also contain information about the IBM roaming configuration from the user document, to be found under<notes:userdetails_rui_*>.

Additional fields can now also be added to the lookup using <mc:userdetails_lookup_additional_fields> (list of fields separated using commas); this variable needs to be set beforelogin to work.

Location info:
More information about the mailfile according to the current location has been added to the config (server, path, mail type, replicaid). As with userdetails, this is enriched with information about the local replica (path, ODS, MMR, size).
These new variables can be found under <notes:location_*>

um_*:
The config variables <notes:um_*> and <notes:homeserver> will now always be the best guess for the current mail file. If available, information from userdetails will be used, if that is not available the current location will be used, and if that is not possible, the information will be taken from the notes.ini.
ENHANCEMENT (5.0.0)Improved performance when creating a zipped attachment out of multiple files; in some cases files were unnecessarily copied to a temporary directory.
ENHANCEMENT (5.0.0)<os:virtual_machine>, <os:virtual_machine_type> and <os:rdp_session> are now always available in config.xml. 

It is no longer necessary to use the "Detect RDP Session" and "Detect VMWare / Virtual PC" action (though it is harmless to leave them enabled).
ENHANCEMENT (5.0.0)Several improvements have been made regarding the detection of desktop virtualization (Citrix etc).

Detection of <os:logonsessions> has been improved (this also affects <os:citrix_no_logonsessions>). In case this new method causes problems, the old behavior can be forced by setting <ini:MC_MC_DetectLogonSessions_ForceWMI > to 1.

Furthermore we have added a new way of detecting desktop virtualization; its results can be found in <os:terminalserver_session> and <os:terminalserver_session_type> - we believe the new method is superior to all the previous methods, and in a future release they might replace the current way of detecting desktop virtualisation (i.e. <os:citrix> and related might be switched to this new method).
ENHANCEMENT (5.0.0)Improved <os:mobile> detection; short-term batteries/USPs should no longer cause a desktop to be detected as a laptop. Because of this, <os:mobile_no_usv> now always has the same value as <os:mobile>.

In case this new detection method leads to problems, the old behavior can be forced by setting <ini:MC_DetectMobile_ForceWMI> to 1.
ENHANCEMENT (5.0.0)Any dialog/UI text that is configurable now supports the newline separator "\n" (without quotes). 

This includes mailblocking/attachment blocking feedback strings, as well as dialogs for zip and IDVault.
ENHANCEMENT (5.0.0)Mail Blocking can now give users the option to ignore the warning message and send the mail anyway. This is configurable in the MailBlocking action; per default users cannot ignore the warning.
ENHANCEMENT (5.0.0)IPv6 is now fully supported; IPv6 addresses are now available as <os:ip_address_v6>.
ENHANCEMENT / NEW (5.0.0)The config.xml now contains a new section <network> which has detailed information about all network adapters.
ENHANCEMENT / NEW (5.0.0)The MAC addresses of all network adapters are now available as <os:mac_addresses>
ENHANCEMENT / NEW (5.0.0)There are now several config variables available which indicate current network status:

<os:connectivity_internet> is 1 if "internet connectivity" is available (as detected by the operating system), 0 otherwise.

<os:connectivity_internet_ipv4> and <os:connectivity_internet_ipv6> do the same, but specifically to each protocol type.

<os:connectivity_internet_ipv4_details> and <os:connectivity_internet_ipv6_details> provide a description of the type of connection that is available (again, as detected by the operating system). If no interface has any connectivity, the config value is not present at all.
It can be one of the following values:
"internet" -> internet is accessible
"localnetwork" -> there is connectivity to a routed network
"subnet" -> there is connectivity to the local subnet
"notraffic" -> there is connectivity to a network, but no traffic is detected 

<os:connectivity_internet> and related are only available when referenced.
ENHANCEMENT / NEW (5.0.0)The computer description is now available as <os:computer_description>
ENHANCEMENT / NEW (5.0.0)Information about the current locale available as <os:locale_*>. This contains things like: Country, language, currency and timezone settings.
ENHANCEMENT / NEW (5.0.0)The boot time of the machine is now available via <os:boot_time> (the UTC time when the machine was booted) and <os:boot_duration_since> (duration since boot in milliseconds).
ENHANCEMENT / NEW (5.0.0)The actions.xml will now store the current Notes user and will do an action XML refresh if the user changes. This helps in case several Notes users share an operating system account.
ENHANCEMENT / NEW (5.0.0)<mz:mailblocking_window_title> and <mc:zip_window_title> can now be used to change the title for all zip (attachment blocking, password, progress bar) or attachment blocking related windows.
ENHANCEMENT / NEW (5.0.0)Log file handling has been improved in several ways. 

- Separate log files will now be created for all tasks by default. Set <ini:MC_LogAllTasks> to 0 to disable this. The log files for other tasks can be found in the "logs" subdirectory with the MC working directory.
- On each client start, a backup of all log files (the primary log.xml and all logs for other tasks) will be created below the "logs" subdirectory. By default, the 5 newest backups will be kept. This can be controlled with <ini:MC_LogBackupCount> (defaults to 5, set to 0 to disable).
ENHANCEMENT / NEW (5.0.0)The dialog that allows to select zip/encryption when attaching files now also works for drag&drop as well as copy&paste.
ENHANCEMENT / NEW (5.0.0)Realtime Relocations and Restriction actions now support all types of rules (string, number, time, ip_*, etc); also, the rules can now use references to any config namespace instead of being limited to a small set of useable values.
ENHANCEMENT / NEW (5.0.0)The desktop icon action now has additional support for Managed Mail Replicas. MMRs can now be created or converted to/from, and general handling of MMRs by the action has been improved.
ENHANCEMENT / NEW (5.0.0)The replicator page settings in the desktop icon action have been extended. The options to "remove" and to "leave as is" have been added to the Desktop Icon action, and a few additional "change existing" options are now available in the Replicator Page Entry Template.
ENHANCEMENT / NEW (5.0.0)Replicator page handling in Location actions and in general has been improved.

MarvelClient will no longer automatically create empty replicator pages; Location actions have new options to control how the replicator page should be created (with options: empty, full, system entries only, copy from existing location). This applies to new locations and existing locations without a replicator page.
ENHANCEMENT / NEW (5.0.0)The Replicator Page (System) action has been extended; besides Synchronize Contacts it now also contains options to manage:
- Synchronize Activities
- Local Free Time Info
- Application Templates (NTFs)
- IBM Roaming

The IBM Roaming option will create roaming entries according to the settings in the user document from the public NAB.
ENHANCEMENT / NEW (5.0.0)The progress bar that can be displayed during shutdown has been improved significantly. 

It's visual design has been updated to a more modern look, and it now is skinnable. 
Use <mc:pbar_bg> to set the path to the background image, and <mc:pbar_logo> to set the path to the logo you want to display. Both are optional and can be set to relative paths inside the data directory as well as absolute paths. Supported formats include GIF, JPEG and PNG (transparency is also supported for most formats).
The spacing between the content and the top/bottom border of the background image can be set using <mc:pbar_content_top> and <mc:pbar_content_bottom> (in pixels).

The progress bar can be forced back to the old style by setting <mc:pbar_classic_style> to 1.
NEW (5.0.0)It is now possible to terminate agents running in background/fsac when the client shuts down. Previously, shutdown would be delayed until the agents are finished, now a timeout can be specified after which the agents will be aborted.
Use <mc:shutdown_wait_timeout_bg> and <mc:shutdown_wait_timeout_fsac> to define those timeouts.

Furthermore, <appstate:shutdown_signaled> will be set to 1 while waiting for agents to finish. This variable should be checked within loops in potentially long-running agents as a signal to gracefully abort (or risk being terminated from the outside).
This signal will be set regardless of a configured shutdown wait timeout.
NEW (5.0.0)MarvelClient roaming now also includes print settings (header/footer/page setup). This is included automatically, no additional configuration is needed.
NEW (5.0.0)New action: Set Registry. Can be used to modify the Windows registry.
NEW (5.0.0)New action: File Operation. This action can be used to perform many file operations, like copy, move, delete, zip, or unzip; it comes with many filtering options.
NEW (5.0.0)New action: Manage Recent Contacts. This action can be used to clean up recent contacts in a user's address book.
NEW (5.0.0)New action: Cloud Detection. This action is used to help MarvelClient detect whether a user has been migrated to the cloud. 

The server filter configured in the action is stored in <mc:cloud_mail_server_pattern>, and this filter is used to maintain new config variables. For each of <notes:homeserver>, <notes:um_server>, <notes:userdetails_mailserver>, and <notes:location_mail_server> there will now be an additional config variable which indicates whether that server is a cloud server. 
They have the same name, but with "_is_cloud" appended, e.g.: <notes:um_server_is_cloud>, and are set to 1 of the server is in the cloud, and 0 if not.
NEW (5.0.0)New action: IBM Cloud Onboarding for Mail. This action can be used to fully automate cloud onboarding on the client side without having to rely on the tool provided by IBM.
NEW (5.0.0)Added a way to set timeouts for actions.xml up- and download, and for Roaming and Backup actions.

Use <ini:MC_NetDirTimeout> to set the number of milliseconds after which any actions.xml up-/download operation will time out. Set to 0 to use the default value (5000). After one timeout has occured, further operations anywhere on that drive will fail immediately.
NEW (5.0.0)New condition: IP adapter. This condition allows matching for many different properties of IP adapters.

.dylib Updates (Mac OS X)

.dylib (2.0.51)- No Changes -

.so Updates (Linux)

.so (2.0.51)- No Changes -