This feature allows to supplant or replace the traditional method of roaming actions.xml via MC_NetworkDirectory by roaming it via HTTP.
Backup and Roaming of the actions.xml via HTTP takes place at the same point in time when we would upload or download the actions.xml from a network directory (when using MC_NetworkDirectory).
If MC_NetworkDirectory is specified in addition to HTTP roaming settings, it will take priority for download, with the HTTP target only serving as a fallback in case of failure. You can set MC_NetworkDirectory_Disabled=1 to ignore MC_NetworkDirectory for actions.xml download in this case.
However, the upload of the actions.xml will be done to both targets always.
If you exclusively want to roam actions.xml via HTTP, you have to remove MC_NetworkDirectory (but be sure you are not using this ini variable for anything else).
In order to enable this feature, you need to set one of these three ini variables (details on how to use them further below):
- MC_ActionXMLRoaming_HTTPMailfile - for roaming via the user's mailfile
- MC_ActionXMLRoaming_WebDAV - for roaming via WebDAV
- MC_ActionXMLRoaming_FTP - for roaming via FTP
Roaming via the user's mailfile
This method works through the webmail redirect and shared login. The upload happens directly to the mailfile via normal Notes access (via Notes RPC), just as a Backup action with a database target would. The download happens via HTTP before login. Because at this point the path to the mailfile is unknown, it needs the a redirect to work.
| notes.ini | Default | Example | Description |
|---|---|---|---|
| MC_ActionXMLRoaming_HTTPMailfile | https://webmail.acme.com | URL that will redirect to the users mailfile | |
| MC_ActionXMLRoaming_UseWebAccessRedirect | 0 | Needs to be set to 0 or 1, depending on your webmail setup. |
Roaming via WebDAV
For this method your either need a WebDAV that users can access without manually providing credentials (anonymous access or some form of shared login), or you need to provide username and password in the notes.ini.
| notes.ini | Description |
|---|---|
| MC_ActionXMLRoaming_WebDAV | The URL for the target WebDAV system |
| MC_ActionXMLRoaming_User | |
| MC_ActionXMLRoaming_Password |
Roaming via FTP
For this method you either need an FTP that users can access without credentials (anonymous access or some form of shared login), or you need to provide username and password in the notes.ini.
| notes.ini | Description |
|---|---|
| MC_ActionXMLRoaming_FTP | The URL for the target FTP server |
| MC_ActionXMLRoaming_User | |
| MC_ActionXMLRoaming_Password |
Additional Settings
These are all optional, and have default values that should cover the vast majority of use cases. They are only provided to help solve very specific issues or problems.
| notes.ini | Default | Description |
|---|---|---|
| MC_ActionXMLRoaming_WebTimeoutMs | OS-dependent | Specify the timeout in ms. If not specified, the timeout depends on OS settings. |
| MC_ActionXMLRoaming_BackupWebTimeoutMs | MC_ActionXMLRoaming_WebTimeoutMs | Set this if you want the timeout for backup be different than MC_ActionXMLRoaming_WebTimeoutMs |
| MC_ActionXMLRoaming_Key | ACTIONS_XML\%OS_USER% | The roaming key. Important: does not support placeholders that are notes-specific (like %NOTES_USER%) |
| MC_ActionXMLRoaming_BackupKey | MC_ActionXMLRoaming_Key | Set this if you want the backup to use a different roaming key than MC_ActionXMLRoaming_Key |
| MC_ActionXMLRoaming_Identifier | actions.xml | The identifier used in the target backup set |
| MC_ActionXMLRoaming_BackupRevisionDepth | 1 | Number of revisions of the actions.xml that are stored in the backup set |
| MC_ActionXMLRoaming_View | v_upload | Only used in conjunction with MC_ActionXMLRoaming_HTTPMailfile. The name of the view that is used to find uploaded backup sets. |
| MC_ActionXMLRoaming_HTTPMailfile_BackupDBLocation | <notes:userdetails_maillocation>
| Only used in conjunction with MC_ActionXMLRoaming_HTTPMailfile. This is the notes database location for the user's mailfile. The default should always be fine. |