Chilkat Software Chilkat Software Chilkat Software
Chilkat Software Chilkat Software

  

  

  

  

  

 

Instructions for Installing and Configuring the 64-bit SMTPQ Service

0. Download and Unzip

Download Chilkat SMTPQ for 64-bit Windows:

Download: Chilkat SMTPQ GitHub Respository

Unzip to any directory.

1. Open an Administrator Command Prompt

On Windows 7, click on the "Start Menu", type "cmd" in the "Search programs and files" text box, then press CTRL-SHIFT-ENTER. A DOS command prompt window should appear having a title bar that indicates "Administrator:"

2. Install the SMTPQ Windows Service

  • Using the DOS command prompt, "CD" to the directory path where the SMTPQ files were unzipped.
  • From the command prompt, run the "register.bat" script to register the SmtpQMgr.dll, which is an ActiveX that will help with installling, starting, stopping, and uninstalling the SMTPQ service.
  • From the command prompt, run the "SmtpQSvcMgr64.exe" program. (Do this by typing "SmtpQSvcMgr64" and press RETURN.) A dialog box should appear. Press the "Install Service" button to install the Chilkat SMTPQ 64-bit service. Then press the "Start Service" button to start the service. It is automatically configured to auto-start each time the computer restarts.

3. Configure the SMTPQ Service

Still using the DOS command prompt, run the "SmtpQConfigure.exe" program. (Do this by typing "SmtpQConfigure" and press RETURN.) A dialog will appear showing the SMTPQ settings. These settings, such as the queue directory, max threads, etc. are stored in the Windows registry. When the SMTPQ Configure program starts, it initializes the text fields and checkboxes with the information found in the registry. If the registry values do not yet exist, the configuration settings initialize to default values. You may modify the configuration settings and then press the "Apply Changes" button to write the changes back to the registry. The SMTPQ service should be restarted after making changes. (The SMTPQ service can be started/stopped via the "SmtpQSvcMgr64.exe" program, or via the Windows Services control panel found in Control Panel --> System and Security --> Administrative Tools.)

4. Finished.

Setup is complete after the settings have been saved to the registry and the SMTPQ service restarted. An explanation of the SMTPQ settings follows...

  • Queue Directory The SMTPQ service looks in this directory for .eml files that are to be sent. The Chilkat MailMan object writes .eml files to the queue directory via any of the following functions: SendQ, SendQ2, SendMimeQ, and SendMimeBytesQ. The MailMan encrypts information such as the SMTP server's domain, the SMTP login/password, as well as other information and adds it to the .eml's header. When the SMTPQ service loads a .eml for sending, it decrypts these special headers, removes them from the .eml, populates it's internal MailMan object with these values, and sends the email. The end result is that the SMTPQ service sends the email in exactly the same way as what would've happened had the application sent the email directly.

    Because the SMTPQ service can only be "fed" by the Chilkat MailMan object, there is no license key or license file for the SMTPQ Service itself. Only a licensed "Chilkat Email" application using the MailMan object can deposit valid .eml files for the SMTPQ. The license for "Chilkat Email" includes the SMTPQ service.

    Also, it is not possible to drop any .eml file into the SMTPQ queue directory. The SMTPQ service can only send .eml files that have the special encrypted headers produced by the MailMan object.

  • Undelivered Directory If an email fails to be sent, then the .eml and a corresponding .xml error log will be saved to the "undelivered" directory.
  • Sent Directory If the "Delete after Send" checkbox is unchecked, then each .eml will be saved to this directory after it is successfully sent. Otherwise the .eml's for successful sends are deleted.
  • Log Directory The SMTPQ service log files are written to this directory. When the SMTPQ service starts, it writes an "---- SMTPQ Started ----" message to a log file that is named using the current date. New log files are created when the current date changes. The log files provide a good source of information about what the SMTPQ service is doing, or what it has done.
  • Delete After Send If this checkbox is checked, then successfully sent .eml's are deleted. Otherwise they are saved to the "sent" directory.
  • Max Threads The number of simultaneous threads that may be sending email at one time. It is not good for this number to be too high. If all emails are sent through the same SMTP server, then this is effectivly the number of simulaneous connections to that server. SMTPQ servers may have limits as to how many simultaneous connections are allowed from one IP address, or a limit on the total number of simultaneous connections, or even may disallow simultaneous connections for the same SMTP user account. Be careful that the SMTPQ settings don't cause errors with the SMTP server regarding these kinds of issues.
  • Max Retries Per Email The Max Retries can be configured to use from 0 to 10 retries. The delay time between each subsequent retry is according to this schedule:
    tryCount            delayTime
    --------            ---------
    1                   5 sec
    2                   10 sec
    3                   15 sec
    4                   1 minute
    5                   1.5 minutes
    6                   2  minutes
    7                   5 minutes
    8                   10 minutes
    9                   15 minutes
    10                  20 minutes
    


Privacy Statement. Copyright 2000-2018 Chilkat Software, Inc. All rights reserved.

(Regarding the usage of the Android logo) Portions of this page are reproduced from work created and shared by Google and used according to terms described in the Creative Commons 3.0 Attribution License.

Send feedback to support@chilkatsoft.com


Software components and libraries for Linux, MAC OS X, iOS, Android™, Solaris, RHEL/CentOS, FreeBSD, MinGW
Azure, Windows 10, Windows 8, Windows Server 2012, Windows 7, 2003 Server, 2008 Server, etc.