Page History

After the Notes client is upgraded to a new client version the users should get also the new version of the mail template. Or you like to deploy a customized mail.
MarvelClient offers two ways to automate replacing the design of the a user’s mail database if the template version is not up to date:

...

:

1. With MarvelClient Upgrade you can initiate replacing the Replace Design design of the user’s mail database direct immediately after the a Notes client is upgraded.Scheduled agent in MC Analyze database:
   , using the "success" email generated by the upgrade process.
2. Based on user data (Notes version and current mail template name) in the MC MarvelClient Analyze database a Replace Design of the , you can replace the design of a user’s mail database can be processedusing a scheduled agent.

Both options (MarvelClient Upgrade

...

success email and

...

scheduled agent) can be used side by side, and

...

Preparations of your infrastructure

...

if necessary option 2 can complement option 1.

This can be useful for updating a user's mail template to the latest version after the Notes client is upgraded to a new client version. It can also be used to deploy a customized mail template to specific users.

Preparing Your Infrastructure

Domino Server Configuration

• Replicate the new mail template(s) to all mail servers using the same path relative to the Domino Data directory.
• The signer of the 'Replace Database Design' scheduled agent needs to have at leased least Designer rights to the mail databases.
• The signer of the scheduled agent also needs to be in “Full the "Full Remote Console Administrators” Administrators" field for the server document of all mail servers configuration:
   Image Removed

...

• :
   Image Added
• In addition it's possible that the server that the agent runs on needs to be listed in the "Full Remote Console Administrators" field as well as the "Trusted Servers" field for all mail servers that have mail databases that might be updated:
  Image Added

This HCL technote has more information on these requirements: https://support.hcltechsw.com/csm?id=kb_article&sysparm_article=KB0093468

MarvelClient Config DB Configuration

In order to detect what mail templates are currently being used, you will need two different MarvelClient actions to run on your users' machines:

1. Create a Run Agent action that runs the the agent ‘X. Addon PERNAB: Collect LocalNamesDetails’ from the MarvelClient Analyze DB. Instructions for setting this up can be found in the article: Get Location and Connection Information
   
   1. This requires the agent from MarvelClient Analyze DB template version 20230420 or higher
   2. If you are already using a Run Agent action with this agent, you will need to open it in edit mode and use the "Check For Update" button to get the latest version of the agent from the Analyze DB after you've updated your template version
      Image Added
      
      
2. Create a Backup action that saves MarvelClient XML files to your Analyze DB. You can use the example action in the Config DB for this purpose, as described here: The readily prepared backup Action in detail

Replace Design Configuration in the MarvelClient Analyze database

The same configuration in the MarvelClient Analyze database is used by both the MarvelClient Upgrade and the scheduled agent options.

In the left navigation -hand navigator, go to ‘MarvelClient Upgrade – Mail template by Notes version’ to see the Notes version vs Mail template name of your users. This view requires the collection of the user’s mail template name which is described in way 2from the ‘X. Addon PERNAB: Collect LocalNamesDetails’ agent as described above.

This view lists the mail template name by Notes client version and gives an overview of your current mail database design situation. Full clients only: no Nomad (iOS, Android, Nomad Web) clients

Next navigation entry is the The view below that in the navigator is ‘Replace Design Configuration’:

This view will be empty at first. In order to create configuration entries, simply use the 'Reload templatenames' button. This button will add an entry for each mail template name found in the ‘Mail template by Notes version’ view above it, leaving existing entries untouched. If there are any additional mail template names in your environment that need a configuration entry, simply press the button again to create one for them.

Every entry represents a single configuration.•    The

• The ’New Mail template path’ is required and is relative to the home mail server of each user. Use ‘Set – Mail template path’ to enter the path or click in view to edit.

...

• The ‘Min Notes version to process’ is only required if the configuration should be processed by the scheduled agent. Use ‘Set – Notes version’ to select a version (based on existing MC Analyze data) or click in view to edit.

...

• The ‘MCUpgrade package name’ is only required if the configuration should be processed by an incoming MarvelClient Upgrade SMTP success email. Use ‘Set - MCUpgrade package name’ to select a name (based on existing MC Analyze data) or click in view to edit.

Replace Design using MarvelClient Upgrade with SMTP mail

In the MarvelClient Config DB, on the MarvelClient Upgrade configuration on the ‘Tracking’ tab are the options to , choose one the 'Send...' options for ‘Send SMTP Progress Emails’.

Image RemovedImage Added

Using this option: , after the a Notes client is successfully upgraded the success Email triggers directly the template replace for that user’s mail. Which will be done , an email will be sent to the MC Analyze DB. This triggers a template replacement for that user’s mail database in the following way:

1. The success email is processed by the agent ’(Before New Mail Arrives - MarvelClient Upgrade)’

...

1. in the MC Analyze DB
2. This agent searches the 'Replace Design Configuration' view for documents matching the user's Current Mail template and MCUpgrade packagename

...

1.  
2. If a

...

1. match is found, and the matching document is enabled, a console command (load convert -u …) is

...

1. sent the

...

1. user's Mail server. This command will be processed immediately on the

...

1. server.
2. After the

...

1. mail template upgrade is successfully completed

...

1. , the next time the user opens

...

1. their mail database they will see the new design.

NOTE: If a Replace Design Configuration document matching the user's Current Mail template and MCUpgrade packagename is not found, nothing will be done!

Replace Design using a

...

Scheduled Agent in MarvelClient Analyze database

You need to prepare something small:

...

Setting up the scheduled agent requires the following steps:

1. Make sure all the steps in the Preparing Your Infrastructure and Replace Design Configuration sections above are complete
2. Make sure the 'Replace Database Design' agent is enabled and scheduled (double-check the agent signer again after doing this!)

The scheduled agent ‘Replace database design’

...

The scheduled agent ‘Replace database design’ processes all enabled configurations and find the user’s where ‘searches the 'Replace Design Configuration' view for documents matching the user's Current mail template name’ and the ‘Min Notes version’ matches a configuration: . 

If a match is found, and the matching document is enabled, a console command (load convert -u …) is send sent the users user's Mail server. This command will be processed immediately on the user’s home mail serverserver, and the next time the user opens their mail database they will see the new design.

NOTE: As always, please test thoroughly before implementing. Your users will thank you!

...

Related articles

...

...