Versions Compared

Version Old Version 6 New Version 7
Changes made by

Iuliia Zigangirova

Iuliia Zigangirova

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Open the FixEdge properties file (FIXEdge.properties by default).
  2. Find 'TransportLayer.TransportAdapters' property
    1. Add 'TransportLayer.TransportAdapters' property in case it does not exist

  3. Set 'TransportLayer.SmtpTA' to the value of 'TransportLayer.TransportAdapters' property:

    Code Block
    languagexml
    TransportLayer.TransportAdapters = TransportLayer.SmtpTA

    1. If 'TransportLayer.TransportAdapters' property already has a value - append ',TransportLayer.SmtpTA' to the value:

      Code Block
      languagexml
      TransportLayer.TransportAdapters = ...,TransportLayer.SFSAdaptorDLL,TransportLayer.SmtpTA

  4. Add 'TransportLayer.SmtpTA.Description' property with value - SMTP adaptor name:

    Code Block
    languagexml
    TransportLayer.SmtpTA.Description = SMTP Transport Adaptor DLL

  5. Add 'TransportLayer.SmtpTA.DllName' property with value - path to the SMTP adaptor dll:

    Code Block
    languagexml
    TransportLayer.SmtpTA.DllName = bin/SMTPAdaptorDll.dll

  6. Add 'TransportLayer.SmtpTA.Type' property with 'DLL'value:

    Code Block
    TransportLayer.SmtpTA.Type = DLL

  7. Add the set of default properties:

    Code Block
    TransportLayer.SmtpTA.SMTPSessions.DefaultServerName = mail.test_test.com
TransportLayer.SmtpTA.SMTPSessions.DefaultServerPort = 25
TransportLayer.SmtpTA.SMTPSessions.DefaultSendingTimeout = 10
TransportLayer.SmtpTA.SMTPSessions.DefaultConnectionTimeout = 10
TransportLayer.SmtpTA.SMTPSessions.DefaultSmartEmailProcessing = false

  8. Add 'TransportLayer.SmtpTA.SMTPSessions property with value - the set of SMTP client's names:

    Code Block
    TransportLayer.SmtpTA.SMTPSessions = TestSmtp

  9. Add properties for each client, like this:

    Code Block
    TransportLayer.SmtpTA.SMTPSession.TestSmtp.ServerName = mail.test_test.com
TransportLayer.SmtpTA.SMTPSession.TestSmtp.ServerPort = 25
TransportLayer.SmtpTA.SMTPSession.TestSmtp.To = jsg@test_test_btobits.com
TransportLayer.SmtpTA.SMTPSession.TestSmtp.From = jsg@test_test_btobits.com
TransportLayer.SmtpTA.SMTPSession.TestSmtp.CC = 
TransportLayer.SmtpTA.SMTPSession.TestSmtp.BCC = 

 

  1. Restart FixEdge to apply changes

After changes are applied the FixEdge properties file may look like this:

Code Block
languagebash
#------------------------------------------------------------
# Transport Layer Section
#------------------------------------------------------------ 
TransportLayer.TransportAdapters = TransportLayer.SmtpTA ....
#------------------------------------------------------------ 
# SMTP Adaptor settings 
#------------------------------------------------------------ 
# SMTP adaptor name 
TransportLayer.SmtpTA.Description = SMTP Transport Adaptor 
# Contains path and name of the SMTP adaptor dll. Property is required 
TransportLayer.SmtpTA.DllName = ./bin/SMTPAdaptorDll.dll 
# Type of the adaptor library, has contains value 'DLL'. Property is required 
TransportLayer.SmtpTA.Type = DLL 
TransportLayer.SmtpTA.SMTPSessions = testSmtp 
# SMTP server host. Required when DefaultServerName not defined 
TransportLayer.SmtpTA.SMTPSession.testSmtp.ServerName = mail.test_test.com 
# SMTP server port. Required when DefaultServerPort not defined 
TransportLayer.SmtpTA.SMTPSession.testSmtp.ServerPort = 25 
# email receiver. Required 
TransportLayer.SmtpTA.SMTPSession.testSmtp.To = jsg@test_test_btobits.com; 
# email sender. Required when DefaultFrom not defined 
TransportLayer.SmtpTA.SMTPSession.testSmtp.From = jsg@test_test_btobits.com 
# email CC receivers. Not required 
TransportLayer.SmtpTA.SMTPSession.testSmtp.CC = 
# email BCC receivers. Not required 
TransportLayer.SmtpTA.SMTPSession.testSmtp.BCC =

...

By default the SMTP adaptor puts log messages into the FIXEdge log. Ececute the following steps to configure the SMTP adaptor logging into a separate file:

  1. Open FixEdge properties file

  2. Add 'Log.SMTPAdaptor.File.Name' property with value - path and name of the SMTP adaptor log file.

    Code Block
    Log.SMTPAdaptor.File.Name = SMTP.log

...

  2. Restart FixEdge
When the SMTP adaptor starts the following record will be written into the log file (xxx is the SMTP adaptor version):
 Code Block
[NOTE] 20070215-11:20:12.437 - SMTP Adaptor v.xxx started.
FAQ
...
Q: Is it possible to use another prefix of the SMTP adaptor properties (not 'TransportLayer.SmtpTA')?
A: The SMTP adaptor requires the 'TransportLayer.SmtpTA' prefix for adaptor's properties, another prefix is prohibited.
Troubleshooting
Problem
Solution
FixEdge start fails and the FixEdge log file contains the following record:
[FATAL] 20070215-11:42:25.250 - Transport Layer has failed to initialize: Error loading DLL './/../SMTPAdaptorAddin.dll '. : The specified module could not be found. (126)
FixEdge is unable to find the SMTP adaptor library file. Make sure that 'TransportLayer.SmtpTA.DllName' contains valid path and name.
FixEdge start fails and the FixEdge log file contains the following record:
[FATAL] 20070215-11:45:12.312 - Transport Layer has failed to initialize: Cannot find the 'TransportLayer.SmtpTA.XXX' property.
The SMTP adaptor was not configured properly. The required 'TransportLayer.SmtpTA.XXX' property does not exist in the FixEdge property file.
FixEdge is started but the FixEdge log file does not contain 'SMTP Adaptor v.xxx started' record.
Make sure that the SMTP adaptor was configured properly in the FixEdge property file:
  1. 'TransportLayer.SmtpTA' added into the 'TransportLayer.TransportAdapters' property
  2. 'Log.SMTPAdaptor.File.Name' property that redirects the SMTP adaptor log into another file does not exist.
Make sure that the FixEdge log file does not contain any related error messages.
...