Firstly a big thank you from us for adopting our product. We hope that you like the software and find the next steps easy, but if you have problems or just want to ask a question, please either email support@pentagonsolutions.com or phone us on +44 (0)2890 455355 (Option 3)


TIP: Your anti-virus and anti-malware may need to 'whitelist' the software.

Some security systems can misinterpret PentagonMail Assistant's connection to Outlook and background indexing as potential threats, so if you encounter an error please don't assume the software has failed, instead ask your IT experts to white-list our software.

Let them know that there are three background processes:

PentagonMailAssistant.BackgroundFiler.exe
PentagonMailAssistant.Launcher.exe
PentagonMailAssistant.Indexer.exe


Also tell them that there is an Outlook Add-in named PentagonMail Assistant Outlook Addin


We want you to get the best from our software by making it as easy as possible for you to configure and deploy PentagonMail Assistant to you colleagues. We also want you to have the opportunity to learn from the experiences from others so in this section we don't just explain how to set the software up, we also provide some best-practice advice. 


So we recommend the following steps which are then detailed below:


    1. Read and consider the Best Practice Advice on folder structures
    2. Install the software on your own machine
    3. Activate your license
    4. Create a Group on the server
    5. Test it
      1. File some messages
      2. Search for them
    6. Allocate user licenses
    7. Deploy the software to users
    8. Consider the following:
      1. The default initial user experience and the use of filing tile's right-click option to add locations to the search index
      2. Cloning a pre-built profile


Read and consider the Best Practice Advice on folder structures

We have seen a lot of different approaches to folder structures, so to help you get it right straight away we have assembled some best practice guidance which we hope you will find useful. Whilst this guidance is based on Windows Folders and not M-Files classes, you may never-the-less find it useful to consider the concepts that it addresses. So please review the guidance on Recommended Location Structures before proceeding further. 

Install the software on your own machine

You have probably installed the software already but if you haven't, all of the installers are available in the Downloads & Change Logs section. To complete the next steps you will need to install the M-Files Configurator which is not installed by default, so Install the M-Files Configurator now.


Whilst there are no significant prerequisites we recommend that you take a quick look at the Prerequisites section too.

Activate your license

Depending on the type of license that you have purchased the activation process differs slightly. See the section on Activating Licenses to activate your license.

Create a Group on the server

Hopefully you will have read the best-practice guidance and will have a good idea of how you want to organise your filing. You may however be unfamiliar with the our terminology, so before you create your first Group please review the short section on Understanding Filing Groups.


Next follow the section on Creating an M-Files Group and repeat it for each of the Groups that you will need.

Connecting to your Group

You can now connect to the Group which will then populate the tiles in the Outlook interface with your filing locations. To do this follow the section on Connecting to an M-Files Group.

Test it

File some messages

So you can now try filing some messages to the locations.

NOTE: When you file to a location it will automatically be added to the list of locations to search. So the background indexer will index all the other messages in that location; if there are any. So if you then search that location you will not only see the message that you filed but also all the other messages in that location


TIP: If you want to be able to search for messages in a location but without filing to that location, right-click the tile and select Search. This will both add it to the indexer's list of locations to index and open a search window with the Location filter set to the location selected


Search for them

Try a simple keyword search to make sure that it is working correctly:



If you want to learn more about the search capabilities watch the videos or take a closer look at the Search sections of this help documentation.



Congratulations!  You now have the bones of a working filing system. You will probably want to test it more thoroughly with selected colleagues, so the next steps are to allocate licenses and deploy the software.


NOTE: You can mix filing locations, so if you have staff who not only need to file to M-Files but also to Winodws folders and cloud storage too, you can provide them with all three by following the guidance on setting up filing to Windows folders

Allocate user licenses

If you have purchased Enterprise licences you will not need to allocate them to staff as anyone with an email account ending with your domain name will be allocated a licence. If you have purchased named-user licenses you will have a pool of licenses that you can allocate to staff as required, so now would be a good time to follow the guidance on Managing Licenses

Deploy the software to users

Small organisations may allow staff to install software on their own computers but larger organisations will not only prevent users from installing software themselves, they will also want to remotely deploy the software to them. So PentagonMail Assistant can be silently deployed to staff using MSIEXEC. For details and examples see the section on Silent installation of the MSI package.

Consider the following:

Before you go further you may wish to reflect on what type of experience you would like your staff to have. Do you want them to start slowly and add more locations and results as they go, or do you want them to start with all the locations immediately available and their index pre-built with the content of the locations they will need?

Default initial user experience and the use of filing tile's right-click option to add locations to the search index

By default PentagonMail Assistant will only index those locations that the user has filed to or has selected for indexing by right-clicking the tile and selecting Search. So new users who click on the search button before taking any other action could think that the software is not working because there is nothing in the search results.

TIP: We recommend that you direct new users to the section for new users on Filing to M-Files as this not only takes them through the process of activating their license but also how to add a location to the search index and how to file.

Cloning a pre-built profile

If you have users starting in a new project office or joining a team where they will immediately need access to certain messages and either they can't wait for the indexing to happen or you have a concern about the impact of multiple machines all indexing the same locations, you should consider cloning a pre-built profile.