Testing Mail Server Connections - Mailbox Importer - Foundation 23.1 - Foundation 23.1 - Ready - OnBase - Premier - Standard - external - Standard - Premier

Mailbox Importer

Platform
OnBase
Product
Mailbox Importer
Release
Foundation 23.1
License
Standard
Premier

If issues arise concerning connections to the mail server, you can run a test to verify whether the mail server is configured and installed properly.

To test mail server connections:

  1. Open a command prompt and navigate to the location of Hyland.MailboxImporter.exe. In a default installation, this is located in C:\Program Files (x86)\Hyland\Services\Mailbox Importer.
  2. Enter Hyland.MailboxImporter.exe /test and then the parameters to be tested and their corresponding values. Not all available parameters have to be used during testing, and they do not have to be entered in any particular order. However, the parameter must always be followed by its corresponding value. For example, -port 993 . The following parameters are available:

    Parameter

    Description

    -port

    The port number used for the mail server account.

    Note:

    If the configured Account Type is using EWS, a port number is not used.

    -username

    The user name for the associated mail account. Typically, this is an email address.

    -accountType

    The type of account the mail server uses. For example, IMAP , POP3 , or EWS .

    -useSSL

    Whether the account uses SSL encryption. The value is either true or false .

    -serverURL

    The mail server account address. For example, machinename.doman.net .

    Note:

    Ensure that the parameters in the command line match exactly the values entered in the Account Settings and Mail Account dialog boxes in the Configuration module. For more information on locating these dialog boxes, see the section on adding an account in the Configuration chapter of the Mailbox Importer module reference guide.

    For example, to test all the available parameters, enter the following command line:
    Hyland.MailboxImporter.exe /test -serverURL machinename.domain.net -port 993 -username someone@onbase.net -accounttype imap -usessl true
  3. Execute the command. If the -username parameter was entered, you are prompted to enter a password. The server is tested, and either a successful or failed connection is displayed. If a failed connection is encountered, a failure reason is also displayed.