Difference between revisions of "Troubleshooting Catglobe Sink Setup"

From Catglobe Wiki
Jump to: navigation, search
 
(51 intermediate revisions by 2 users not shown)
Line 1: Line 1:
= Catglobe Smtp Event Sink<br> =
+
<accesscontrol>Main:MyGroup</accesscontrol>
 +
[[Category:Miscellaneous]]
 +
== I. CatGlobeSmtpEventSink.dll.config <br> ==
  
== I. CatGlobeSmtpEventSink.dll.config <br> ==
+
<source lang="xml">
 +
<xml version="1.0" encoding="utf-8"&nbsp;?&gt; &lt;
 +
<configuration>
 +
  <appSettings&gt;
 +
      <add key="Debug" value="true"/>
 +
      <add key="LogPath" value="C:\Temp\CGSink_58.log"/>
 +
      <add key="Impersonate" value="true"/>
 +
      <add key="domain" value=""/>
 +
      <add key="userName" value="ASPNET_Impersonated" /&gt;
 +
      <add key="password" value="Catglobe" /&gt;
 +
      <add key="ConnectionString" value="connect timeout=60;server=servername;uid=username;pwd=password;database=CatGlobeAdministration"/>        
 +
      <add key="BlockedDomains" value="abcxyz.com"/>
 +
  </appSettings>
 +
</configuration>
 +
</source>
  
== II. RegisterSink.bat <br> ==
+
== II. RegisterSink.bat <br> ==
 +
<source lang="vb">
 +
C:\Windows\Microsoft.NET\FrameWork64\v2.0.50727\regasm CatGlobeSmtpEventSink.dll /codebase
 +
cscript smtpreg.vbs /add 1 OnArrival CatGlobeMailTransportSubmission_VersionName CatGlobeSmtpEventSink_Heisenberg.CatGlobeMailTransportSubmission "RCPT TO=*@*.catglobe.com"
 +
cscript smtpreg.vbs /setprop 1 OnArrival CatGlobeMailTransportSubmission_VersionName "Source" Priority 20000
 +
</source>
  
== III. UnRegisterSink.bat <br> ==
+
== III. UnRegisterSink.bat <br> ==
 +
<source lang="vb">
 +
cscript smtpreg.vbs /remove 1 OnArrival CatGlobeMailTransportSubmission_VersionName
 +
REM "if you are going to uninstall the sink on a 32bit Windows 2003 Server, remove the REM tag from the below line"
 +
REM C:\Windows\Microsoft.NET\FrameWork\v2.0.50727\regasm CatGlobeSmtpEventSink.dll /unregister
 +
REM "if you are going to uninstall the sink on a 64bit Windows 2003 Server, remove the REM tag from the below line"
 +
C:\Windows\Microsoft.NET\FrameWork64\v2.0.50727\regasm CatGlobeSmtpEventSink.dll /unregister
 +
</source>
  
== IV. Other config files: RestartSMTP.bat &amp; StartSMTP.bat &amp; StopSMTP.bat  ==
+
== IV. Other config files: RestartSMTP.bat &amp; StartSMTP.bat &amp; StopSMTP.bat & EnumSinks.bat  ==
 +
1. RestartSMTP.bat
 +
<source lang="vb">
 +
call StopSMTP.bat
 +
call StartSMTP.bat
 +
</source>
 +
2. StartSMTP.bat
 +
<source lang="vb">
 +
net start iisadmin
 +
net start w3svc
 +
net start smtpsvc
 +
</source>
 +
3. StopSMTP.bat
 +
<source lang="vb">
 +
net stop iisadmin /y
 +
</source>
 +
4. EnumSinks.bat
 +
<source lang="vb">
 +
cscript smtpreg.vbs /enum
 +
pause
 +
</source>
  
[[Category:Network_Setup]]
+
== V. Step by Step install and remove Catglobe SMTP Sink ==
 +
I. '''Install SMTP Event Sin'''k<br>
 +
1.Install CatGlobeSmtpEventSinkSetup.msi<br>
 +
2.Execute RegisterSink.bat to register Catglobe Smtp Event Sink.<br>
 +
3.Verify SMTP Event Sink was registered successfully by execute EnumSinks.bat<br>
 +
[[File:Catglobe_Sink.png]]<br>
 +
4.Prepare CatglobeSMTPEventSink configuration file.<br>
 +
5.Restart SMTP server by execute RestartSMTP.bat<br><br>
 +
6. Check Sink log to make sure Sink works well.
 +
II. '''Remove SMTP Event Sink'''<br>
 +
Execute UnRegisterSink.bat
 +
 
 +
 
 +
 
 +
== VI. Troubeshooting Catglobe SMTP Sink  ==
 +
 
 +
- After install Sink, We should clean up all bad mail; mails in drop then restart SMTP service.<br> - Catglobe Sink Log will show when mail come to SMTP server<br> + We could telnet to SMTP to force sent mail by command to see Catglobe SMTP work or does not work<br> &lt;source lang="vb"&gt; Telnet to hostname on port 25<br> HELO your_domain_name or whatever<br> MAIL FROM:you@hostname.com (ie, your email address)<br> RCPT TO:them@someplace_else.com (email address you want to send to)<br> DATA<br> You type your message then CRLF period CRLF (ie, type a period on a line by itself then hit ENTER)<br> QUIT &lt;/source&gt; <br> - If something go wrong but We not sure what it come from We should go to "Registry" and check GUID of Catglobe SMTP Event was cleanup or remove successfully Go to svn source code: \CatglobeSMTPEventSink\CatglobeSmtpEventSink.cs search a keyword "[Guid("3C1A63D3-A828-42F2-BDED-C896D5A54071")]" Go to Registry find that key and delete them if they were exits (only delete them if they do not necessary anymore)
 +
 
 +
- If all incoming mail go to "Drop" include valid mail. We should check to make sure Catglobe sink was installed correctly<br>
 +
 
 +
+ Dump all Catglobe sink instances on server then make sure that foreach version we have only one Sink instance

Latest revision as of 03:22, 18 October 2013

<accesscontrol>Main:MyGroup</accesscontrol>

I. CatGlobeSmtpEventSink.dll.config

<xml version="1.0" encoding="utf-8"&nbsp;?&gt; &lt;
<configuration>
   <appSettings&gt;
      <add key="Debug" value="true"/>
      <add key="LogPath" value="C:\Temp\CGSink_58.log"/>		
      <add key="Impersonate" value="true"/>
      <add key="domain" value=""/>
      <add key="userName" value="ASPNET_Impersonated" /&gt;
      <add key="password" value="Catglobe" /&gt;
      <add key="ConnectionString" value="connect timeout=60;server=servername;uid=username;pwd=password;database=CatGlobeAdministration"/>	        
      <add key="BlockedDomains" value="abcxyz.com"/>
   </appSettings>
</configuration>

II. RegisterSink.bat

 
C:\Windows\Microsoft.NET\FrameWork64\v2.0.50727\regasm CatGlobeSmtpEventSink.dll /codebase
cscript smtpreg.vbs /add 1 OnArrival CatGlobeMailTransportSubmission_VersionName CatGlobeSmtpEventSink_Heisenberg.CatGlobeMailTransportSubmission "RCPT TO=*@*.catglobe.com" 
cscript smtpreg.vbs /setprop 1 OnArrival CatGlobeMailTransportSubmission_VersionName "Source" Priority 20000

III. UnRegisterSink.bat

cscript smtpreg.vbs /remove 1 OnArrival CatGlobeMailTransportSubmission_VersionName
REM "if you are going to uninstall the sink on a 32bit Windows 2003 Server, remove the REM tag from the below line"
REM C:\Windows\Microsoft.NET\FrameWork\v2.0.50727\regasm CatGlobeSmtpEventSink.dll /unregister
REM "if you are going to uninstall the sink on a 64bit Windows 2003 Server, remove the REM tag from the below line"
C:\Windows\Microsoft.NET\FrameWork64\v2.0.50727\regasm CatGlobeSmtpEventSink.dll /unregister

IV. Other config files: RestartSMTP.bat & StartSMTP.bat & StopSMTP.bat & EnumSinks.bat

1. RestartSMTP.bat

call StopSMTP.bat
call StartSMTP.bat

2. StartSMTP.bat

net start iisadmin
net start w3svc
net start smtpsvc

3. StopSMTP.bat

net stop iisadmin /y

4. EnumSinks.bat

cscript smtpreg.vbs /enum
pause

V. Step by Step install and remove Catglobe SMTP Sink

I. Install SMTP Event Sink
1.Install CatGlobeSmtpEventSinkSetup.msi
2.Execute RegisterSink.bat to register Catglobe Smtp Event Sink.
3.Verify SMTP Event Sink was registered successfully by execute EnumSinks.bat
Catglobe Sink.png
4.Prepare CatglobeSMTPEventSink configuration file.
5.Restart SMTP server by execute RestartSMTP.bat

6. Check Sink log to make sure Sink works well. II. Remove SMTP Event Sink
Execute UnRegisterSink.bat


VI. Troubeshooting Catglobe SMTP Sink

- After install Sink, We should clean up all bad mail; mails in drop then restart SMTP service.
- Catglobe Sink Log will show when mail come to SMTP server
+ We could telnet to SMTP to force sent mail by command to see Catglobe SMTP work or does not work
<source lang="vb"> Telnet to hostname on port 25
HELO your_domain_name or whatever
MAIL FROM:you@hostname.com (ie, your email address)
RCPT TO:them@someplace_else.com (email address you want to send to)
DATA
You type your message then CRLF period CRLF (ie, type a period on a line by itself then hit ENTER)
QUIT </source>
- If something go wrong but We not sure what it come from We should go to "Registry" and check GUID of Catglobe SMTP Event was cleanup or remove successfully Go to svn source code: \CatglobeSMTPEventSink\CatglobeSmtpEventSink.cs search a keyword "[Guid("3C1A63D3-A828-42F2-BDED-C896D5A54071")]" Go to Registry find that key and delete them if they were exits (only delete them if they do not necessary anymore)

- If all incoming mail go to "Drop" include valid mail. We should check to make sure Catglobe sink was installed correctly

+ Dump all Catglobe sink instances on server then make sure that foreach version we have only one Sink instance