home *** CD-ROM | disk | FTP | other *** search
/ PC Pro 2005 June (DVD) / DPPRO0605DVD.iso / Extras / PopFile / ADDSSL.TXT < prev    next >
Encoding:
Text File  |  2004-12-03  |  6.6 KB  |  166 lines
  1. ---------------------------------------------------------------------------
  2. POPFile SSL Setup wizard for Windows v0.0.10 ReadMe         3 December 2004
  3. ---------------------------------------------------------------------------
  4.  
  5. CONTENTS
  6.           Introduction
  7.           Patch to speed up SSL operations
  8.           SSL Configuration
  9.           Do not use "forking"
  10.           Capturing POPFile error messages
  11.           Capturing POPFile error messages (Win9x Instructions)
  12.           Finding the POPFile files
  13.           AddSSL log report
  14.  
  15.  
  16. INTRODUCTION
  17.  
  18. The Windows installer for POPFile 0.22.x does not install the files required
  19. to provide SSL support.
  20.  
  21. This wizard has been provided to make it easy to download and add all of the
  22. necessary extra Perl components and OpenSSL DLLs to an existing POPFile 0.22
  23. installation.
  24.  
  25.  
  26. PATCH TO SPEED UP SSL OPERATIONS
  27.  
  28. The Module.pm file distributed with POPFile 0.22.0 results in EXTREMELY SLOW
  29. message downloading so this utility automatically patches the module to make
  30. it match the version which is distributed with the 0.22.1 release. This patch
  31. makes SSL operation work at a similar speed to non-SSL operation. The original
  32. Module.pm file will be backed up as Module.pm.bk1 (in the same folder).
  33.  
  34.  
  35. SSL CONFIGURATION
  36.  
  37. This version of the wizard does not attempt to configure any email accounts
  38. to use SSL; it simply adds the necessary SSL support files to an existing
  39. setup. To change a POPFile-enabled account to use SSL, change the
  40. "servername:username" string to "servername:995:username:ssl"
  41.  
  42. Please note that the SSL connection is between POPFile and the mail server,
  43. so do not configure the mail client to use SSL for this account.
  44.  
  45.  
  46. DO NOT USE "FORKING"
  47.  
  48. If "Allow concurrent POP3 connections" shows "No" on the Configuration page
  49. in the UI then "forking" is disabled (this is the default setting).
  50.  
  51. If you have enabled forking, please disable it (otherwise POPFile will crash
  52. when accessing any SSL-enabled accounts).
  53.  
  54. To disable forking, change the "Allow concurrent POP3 connections" setting
  55. from "Yes" to "No" on the Configuration page, or change the "pop3_force_fork"
  56. parameter on the Advanced page in the UI from "1" to "0", or shutdown POPFile
  57. and edit the "pop3_force_fork" setting in the popfile.cfg file (0 = disabled)
  58.  
  59.  
  60. CAPTURING POPFILE ERROR MESSAGES
  61.  
  62. Since this is an experimental wizard, you are recommended to use POPFile's
  63. console mode when you run POPFile so you will be able to see any error
  64. messages output by POPFile.
  65.  
  66. An easy way to temporarily run POPFile in console mode without changing any
  67. configuration settings is to use the 'msgcapture.exe' program to run POPFile
  68. instead of the normal 'runpopfile.exe' program. The 'msgcapture.exe' program
  69. can be found in the same folder as 'runpopfile.exe'. Use the command
  70.  
  71.     msgcapture.exe /timeout=0
  72.  
  73. (that is a zero not a letter O at the end of the command) to ensure the
  74. msgcapture.exe program waits for POPFile to shut down or terminate.
  75.  
  76. The Message Capture Utility (msgcapture.exe) will display the POPFile console
  77. messages in a scrollable window and allow you to save them in a text file by
  78. right-clicking inside that window - this makes it easy to report any messages
  79. which result from problems with the SSL support installed by this wizard.
  80.  
  81.  
  82. CAPTURING POPFILE ERROR MESSAGES (Win9x INSTRUCTIONS)
  83.  
  84. On Win9x you should use the 'pfi-run.bat' batch file in the 'User Data'
  85. folder instead of using 'msgcapture.exe' (the batch file sets up the
  86. necessary environment data before running the 'msgcapture.exe /timeout=0'
  87. command).
  88.  
  89. An easy way to run this batch file is to double-click its icon. A DOS box
  90. should appear briefly, followed by the window for the "POPFile Message
  91. Capture Utility".
  92.  
  93. If all you see is a DOS box popping up and instantly disappearing (with no
  94. Message Capture Utility window appearing), you will need to allocate some
  95. more environment space for the batch file.
  96.  
  97. To do this, right-click the pfi-run.bat icon, select "Properties", select the
  98. "Memory" tab and look at the "Initial environment" value (at the top right).
  99.  
  100. If the setting is "Auto", select "512" from the list, click "Apply" then "OK".
  101. If the setting is not "Auto" then select a higher value (e.g. if it says "512"
  102. then change it to "768").
  103.  
  104. After increasing the environment space, double-click the pfi-run.bat icon to
  105. start the POPFile Message Capture Utility.
  106.  
  107.  
  108. FINDING THE POPFILE FILES
  109.  
  110. If you are not sure where the POPFile program files and/or the 'User Data'
  111. files are stored, use the following Start Menu shortcut to find out:
  112.  
  113. Start -> Programs -> POPFile -> Support -> PFI Diagnostic utility (simple)
  114.  
  115.  
  116. ADDSSL LOG REPORT
  117.  
  118. A timestamped log file (addssl.log) is created in the POPFile program folder
  119. listing the actions performed by the POPFile SSL Setup wizard.
  120.  
  121. ---------------------------------------------------------------------------
  122.  
  123. This product downloads software developed by the OpenSSL Project for use in
  124. the OpenSSL Toolkit (http://www.openssl.org/)
  125.  
  126. ---------------------------------------------------------------------------
  127.  
  128. CHANGE HISTORY:
  129.  
  130. 03-Dec-04 (v0.0.10) Suppress the patch status message box when the Module.pm
  131.                     version is neither 1.40 nor 1.41 (to avoid confusion)
  132.  
  133. 29-Oct-04 (v0.0.9) Source code size greatly reduced by making it "include"
  134.                    the main PFI library. The ReadMe now mentions that forking
  135.                    should be disabled.
  136.  
  137. 19-Oct-04 (v0.0.8) Source files (slightly rearranged) are now in CVS. Now
  138.                    using getpopfile.org as the POPFile homepage address.
  139.                    Revised this ReadMe file.
  140.  
  141. 28-Sep-04 (v0.0.7) The wizard now patches Module.pm (if necessary) to upgrade
  142.                    it to v1.41 to solve the extremely slow SSL mail transfer
  143.                    problem.
  144.  
  145. 14-Sep-04 (v0.0.6) Revised these notes (some account configuration information
  146.                    added, mentioned the /timeout=0 option and explained how to
  147.                    increase the Win9x environment space for pfi-run.bat)
  148.  
  149. 08-Sep-04 (v0.0.5) Added build instructions to the header comment.
  150.  
  151. 08-Sep-04 (v0.0.4) Revised ReadMe and WELCOME page text.
  152.  
  153. 08-Sep-04 (v0.0.3) Improved WELCOME page text and progress/log messages.
  154.  
  155. 06-Sep-04 (v0.0.2) Improved reporting of downloads.
  156.  
  157. 06-Sep-04 (v0.0.1) First public release.
  158.  
  159. ---------------------------------------------------------------------------
  160. Brian Smith (xuesheng@users.sourceforge.net)
  161.  
  162. POPFile (Bleeding Edge - Source Code) Discussion Forum
  163. http://sourceforge.net/forum/forum.php?forum_id=230652
  164. ---------------------------------------------------------------------------
  165. (end)
  166.