Setup and Installation

The following sections describe how to set up and install treeMailS on the Lotus Domino server under Windows 32/64 bit.

Installation and Required Parameters

For the Installation of treeMailS on the Lotus Domino server (Win 32 or Win 64), a Notes User with full admin rights is required. Make sure that the Notes User used for this is registered in the arrays “Full Access Administrators” and “Administrators” in the “Security” tab of the particular server document within NAMES.NSF.

For an installation under Windows, treeMailS provides a setup program that runs the installation automatically.

The following requirements have to be met:

a. Copy the treeMailS directory to a server that the Domino server can access.
b. In addition, a Lotus Domino administrator group has to be made available.

The setup program for the treeMailS server installation is located in the folder

Lotus Domino Win 32-bit system:

“…\treeMailS\program files\mk-server\win32\InstStreeMailS.exe”.

Lotus Domino Win 64-bit system:

“…\treeMailS\program files\mk-server\win64\InstStreeMailS.exe”.

List of Parameters Required During the Installation

  • Administrator group for treeMailS

  • Group for all treeMailS / MFT users

Follow these steps to install the treeMailS/MFT Bridge server under Windows (32/64 bit):

  1. Copy the treeMailS archive to the relevant Domino Server.

  2. Unpack the treeMailS archive.

  3. Navigate to the directory that was created during step 2.

  4. The installation programs for the actual systems are located in the subdirectory
    “…\program files\mk-server”.

  5. Depending on your Windows/Domino system, the installer is located under win32 (32 bit) or win64 (64 bit).

  6. Start the installer (InstStreeMailS.exe) which will guide you throughout the installation.

treeMailS Installation Wizard

After accepting the treeMailS license agreement you can select whether you want to install the first treeMailS server or add an additional one. In the same dialog, please confirm that you also want to install the MFT Bridge “Install MFT Bridge on treeMailS Server”.

In the next step, please specify the program path for your Lotus Domino server installation. The installer will try to automatically detect and display the path. As you are also installing the MFT Bridge, the installer automatically suggests a temporary path for the data upload from the Lotus Domino server to Thru.

In the next dialog, you see the basic parameters of the treeMailS configuration. These include the two server processes (administration process and signature process), the subdirectory where the treeMailS databases will be stored, the name and description of the treeMailS Gateway database, the group of users authorized for the administration of treeMailS, and the URL-Address of Thru Server.

After pressing the “Forward” button you have to enter the “THRU application ID” (normally you do not have to change this parameter) and your “THRU password for SSO”. Keep in mind that you have also to customize your Thru Server for this password.

In the next dialog, you will be asked for your standard company address. This is necessary for the treeMailS standard signature process to automatically assign a company profile to each user. The parameter “Assign this profile to the following group” should contain a Lotus Domino group for all MFT users.

If your server is password-protected, please enter the password for the ID file.

After a short waiting period, you see the confirmation that treeMailS was installed successfully.

To activate treeMailS you have to restart the Lotus Domino server. This can also be done later after customizing of your treeMailS / MFT system.

If you are using Thru Web Cloud Service it’s necessary that you add the following Entry to your NOTES.INI on your domino server (TLS1.2 must be deactivated):SSL_DISABLE_TLS_12=1

After restarting the Lotus Domino server you will see the treeMailS server tasks in the Domino console (“show task”). As you also installed the MFT Bridge, the corresponding threads “MFT Upload”, “MFT Download” and “MFT Internal” are also displayed.

After installation, the permission for the Administrators group must be reassigned within the access control to view the button “MFT Bridge Configuration”. For this purpose open the access control and remove the role “MFTAdmin” for the Administrators group, then confirm with Ok. Then open again the access control and sets the role “MFTAdmin” again.

If you install treeMailS/MFT on an additional Lotus Domino Server, it is recommended to shut down this Domino Server before you start the treeMailS installation wizard.

Signing Data Documents

Please ensure that the data documents in your treeMailS databases are properly signed before initial installation and after any future online updates. To do so, open the Domino Administrator, navigate to the location of your treeMailS databases, right click on all treeMailS databases and sign “All Data Documents”.

Notes User with full admin rights is required

Configuring ACL Rights on Database App

  • For the administration of the treeMailS Configuration database, the group “LocalDomainServers” requires manager access (including “Delete” authorization) as well as the admin roles “[Admin]” and “[MFTAdmin]”. The system administrator should give the same rights to him/herself. Users responsible for maintaining the personal profiles, company profiles, templates, and language configurations have to be entered as “Editor” (without “Delete” authorization). All other users do not require access to the treeMailS Configuration database by default.

  • For the administration of the treeMailS Gateway database, the group “LocalDomainServers” requires manager access (including “Delete” authorization). The system administrator should give the same rights to him/herself. All other users do not require access to the treeMailS Gateway database.

  • For the administration of the treeMailS Log database, the group “LocalDomainServers” requires manager access (including “Delete” authorization). The system administrator should give the same rights to him/herself. All other users do not require access to the treeMailS Log database by default. If specific users need access to the treeMailS Log database, it is sufficient to give them read authorization.

  • For the administration of the treeMailS / MFT Bridge database, the group “LocalDomainServers” requires manager access (including “Delete” authorization). The system administrator should give the same rights to him/herself. All other users do not require access to the treeMailS MFT Bridge database by default.

The following parameters are added to your NOTES.INI on Domino server:

  • M_MKDVDBPFAD=treeMailS\mktreekodb.nsf

  • A_MKDVDBPFAD=treeMailS\mktreekodb.nsf

  • MKMBSYSHOOK=M

  • NSF_HOOKS=mkbhook,…

  • ServerTasks=…,mkengine –SA, mkengine –SM,…

treeMailS Server De-Installation

treeMailS Server

  • Stop the treeMailS engine on the Lotus Domino server.

  • Delete/adjust the following parameters in the NOTES.INI:

    • NSF_HOOKS=mkbook,…

    • MKMBSYSHOOK=M

    • SERVERTASKS=…,mkeninge –SA,mkengine –SM,…

  • Delete the databases/template mktree*.

  • Delete the address book entry for the Mailin database treeMailS – Gateway database.

To deactivate treeMailS on your Lotus Domino server you have to restart your Domino server.