Setting up Email Delivery Service

From RangerMSP Wiki - PSA software for MSPs and IT services providers
Revision as of 09:52, 9 July 2017 by Dina (talk | contribs) (Created page with "If you already use the Email Connector or Alerts Server or Report Schedulerthen you can skip this section as the CommitCRM Server service is already installed and...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

If you already use the Email Connector or Alerts Server or Report Schedulerthen you can skip this section as the CommitCRM Server service is already installed and there is nothing more you need to do besides scheduling your Reports.

Install Service

This part of the installation should be performed on the server itself.


Automatic installation       (requires CommitCRM 14 and up)

Log in to to your Server with a Window's Administrator account and run the installer from:

<Installation_DIR>\CommitCRM\Utils\Install\InstallServerSideWindowsServices.exe

OR   -  

Manual installation

  1. Open a command prompt window: Right-click the command prompt icon and and choose 'Run As Administrator'.

  2. Type the following command:

    <Installation_DIR>\CommitCRM\Server\CommitServer.exe -install

    Note: The <Installation_Dir> must refer to a LOCAL server path (e.g. c:\ or D:\Software, etc.) and NOT to a shared network name/path.
  3. Wait for a success message to appear, indicating the service was installed successfully.
  4. Open the Windows Services Management windows from Control Panel > Administration Tools > Services.
  5. Verify that a Windows service called CommitCRM Server is now displayed in the services list.
  6. If the service is not there, make sure again that you are running the command prompt Window using 'Run as Administrator' and try again.

Running CommitCRM Server Service

  1. Open the Windows Services Management windows from Control Panel > Administration Tools > Services.

  2. Locate the CommitCRM Server service and start the service (right-click > Start).

  3. Make sure that it is set to start automatically with a 'Delayed Start' (Startup type > Automatic Delayed Start) each time the server is restarted.

Outgoing Email Settings

The Outgoing Email Settings are used to send emails from CommitCRM Server.

Make sure to test your settings once defined, using the Test button in the configuration program, to make sure the emails can be sent using your settings.

Note that the same settings are used both by CommitCRM Alerts and Email Connector, and should be define only once. If you already defined this for the Email Connector, you can skip this part.
To define Outgoing emails settings:

  1. Log into the Server with a Windows Administrator user. Note that the setup program must run from the same server as the one where the CommitCRM installation sits and from where you plan to run the Email Connector.
  2. Run <Installation_DIR>\CommitCRM\Server\ServerConfig.exe.
    Note: there are two executable files under the server folder, make sure you are running the configuration program (ServerConfig.exe).
  3. In the window that opens, click the Outgoing Mail Server tab:
File:Commit email alerts outgoing setup window with data.gif

In this tab, you should define the following:

  • SMTP Host - enter your Outgoing SMTP Mail Server.
  • Port - enter the Outgoing SMTP port.
  • My outgoing server (SMTP) requires authentication - if checked, must fill in the authentication details below:
    • User Name - the User Name to be used for SMTP authentication
    • Password - the password related to the specified User Name

To reduce errors and improve security it is strongly recommended to use SMTP authentication, using a user name and password for SMTP access.

  • Test SMTP Connection - use the test button to verify that your account is working. If there is missing or incorrect information, such as your password, you will be prompted to supply or correct it.
  • Send Test Email - use this test button to send a test email using the settings you defined. After clicking it you need to specify the From email address and the To email address that will be used for sending the Test Email message.


Uninstall Service

To Uninstall CommitCRM Server service:

  1. Open the Windows Services Management windows from Control Panel > Administration Tools > Services.
  2. Stop the CommitCRM Server service.
  3. Open a command prompt window: Right-click the command prompt icon and and choose 'Run As Administrator'.
  4. Type the following command:
<Installation_DIR>\CommitCRM\Server\CommitServer.exe -uninstall