This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
devel:sslsupport [2008/09/18 19:24] – Minor correction xuesheng | devel:sslsupport [2011/06/03 22:16] – Fix some spurious CamelCase "inks xuesheng | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== SSL Support for the Windows version of POPFile ====== | ====== SSL Support for the Windows version of POPFile ====== | ||
+ | ^ This page only applies to the current POPFile 1.1.1 release and the earlier releases which offer support for SSL connections to mail servers. POPFile 1.1.2 (or later) uses improved SSL support which is built-in to the installer and does not involve any internet access during installation. ^ | ||
+ | The SSL support for the Windows version is being upgraded for the next release (POPFile 1.1.2, no release date has been announced yet). | ||
+ | |||
+ | A completely new SSL support package is being used which is more up-to-date and smaller than the support packages used by earlier releases of POPFile. The Windows installer will include all of the neceassry files and install them by default. This means the installer will no longer download (and possibly patch) the files during the installation. As a result the installer code has been simplified and made easier to maintain. | ||
===== Why are SSL patches sometimes required? ===== | ===== Why are SSL patches sometimes required? ===== | ||
- | POPFile has been able to make SSL connections to mail servers since the 0.22.0 release in September 2004. If the "SSL support" | + | POPFile has been able to make SSL connections to mail servers since the 0.22.0 release in September 2004. If the "SSL support" |
+ | |||
+ | POPFile 1.1.0 and later releases also download one SSL file from the ppm.tcool.org repository because the file found in the University of Winnipeg repository does not support the timeout feature POPFile uses to cope with slow servers. | ||
Downloading the SSL support files during the installation helps reduce the size of the installer and ensures that the installation uses the most up-to-date SSL support files. This scheme has worked very well because these SSL files are not updated frequently (see [[#SSL Support Files Status|table]] below). | Downloading the SSL support files during the installation helps reduce the size of the installer and ensures that the installation uses the most up-to-date SSL support files. This scheme has worked very well because these SSL files are not updated frequently (see [[#SSL Support Files Status|table]] below). | ||
Line 38: | Line 44: | ||
When SSL support is added to POPFile a log file is created listing the files which get added to POPFile and any SSL patches which were applied to make the files work properly with that particular installation. | When SSL support is added to POPFile a log file is created listing the files which get added to POPFile and any SSL patches which were applied to make the files work properly with that particular installation. | ||
- | Three log files are used at present. These log files are stored in the main POPFile program folder, as specified in the POPFILE_ROOT environment variable or in the window resulting from the Start -- Programs -- POPFile -- Support -- PFI Diagnostic utility (simple) shortcut: | + | Three log files are used at present: |
* '' | * '' | ||
Line 46: | Line 52: | ||
* '' | * '' | ||
+ | These log files are stored in the main POPFile program folder. The location of this folder is normally held in the POPFILE_ROOT environment variable and in the registry. Since it it not easy for users to check these values, the location of this folder can be displayed using the following shortcut created by the installer: | ||
+ | Start -- Programs -- POPFile -- Support -- PFI Diagnostic utility (simple) | ||
Line 56: | Line 63: | ||
====== SSL Patch Files on the POPFile Server (getpopfile.org) ====== | ====== SSL Patch Files on the POPFile Server (getpopfile.org) ====== | ||
- | The ''/ | + | The ''/ |
0.22.x.pcf | 0.22.x.pcf | ||
Line 62: | Line 69: | ||
1.0.0.pcf | 1.0.0.pcf | ||
1.0.1.pcf | 1.0.1.pcf | ||
+ | 1.1.0.pcf | ||
+ | 1.1.1.pcf | ||
SSL_pm.pat | SSL_pm.pat | ||
MD5SUMS | MD5SUMS | ||
Line 269: | Line 278: | ||
====== How the SSL.pm patch was created ====== | ====== How the SSL.pm patch was created ====== | ||
- | The patch used to downgrade SSL.pm v0.99, SSL.pm v0.999, SSL.pm v1.01 or SSL.pm v1.08 | + | The patch used to downgrade SSL.pm v0.99, SSL.pm v0.999, SSL.pm v1.01, SSL.pm v1.08 or SSL.pm v1.13 |
to SSL.pm v0.97 was created using the VPATCH package which is supplied with NSIS. The | to SSL.pm v0.97 was created using the VPATCH package which is supplied with NSIS. The | ||
following MS-DOS commands were used to create the patch file: | following MS-DOS commands were used to create the patch file: | ||
Line 279: | Line 288: | ||
GenPat.exe SSL_1.01.pm | GenPat.exe SSL_1.01.pm | ||
GenPat.exe SSL_1.08.pm | GenPat.exe SSL_1.08.pm | ||
+ | GenPat.exe SSL_1.13.pm | ||
</ | </ | ||
Line 287: | Line 297: | ||
* SSL_1.01.pm | * SSL_1.01.pm | ||
* SSL_1.08.pm | * SSL_1.08.pm | ||
+ | * SSL_1.13.pm | ||
- | These commands generate a '' | + | These commands generate a '' |
* **IMPORTANT NOTE** | * **IMPORTANT NOTE** | ||
Line 301: | Line 312: | ||
^ University of Winnipeg repository ^^^ | ^ University of Winnipeg repository ^^^ | ||
- | ^ Update Date ^ IO:: | + | ^ Update Date ^ IO:: |
| 1 August 2003 | v0.94 | v1.25 | | | 1 August 2003 | v0.94 | v1.25 | | ||
| 22 June 2005 | SSL files are now **binary** incompatible with POPFile 0.22.2 or earlier || | | 22 June 2005 | SSL files are now **binary** incompatible with POPFile 0.22.2 or earlier || | ||
Line 310: | Line 321: | ||
| 31 August 2007 | v1.08 | v1.30 | | | 31 August 2007 | v1.08 | v1.30 | | ||
- | * "SSL Support Files Status" | + | * "SSL Support Files Status" |
- | * On 22 June 2005 the University of Winnipeg' | + | * On 22 June 2005 the University of Winnipeg' |
Line 330: | Line 341: | ||
| 0.22.5 | | 0.22.5 | ||
| 1.0.0 | | 1.0.0 | ||
- | | 1.0.1 | + | | 1.0.1 |
+ | | 1.1.0 | ||
+ | | 1.1.1 | ||
+ | |||
+ | * "SSL Support Status for POPFile releases" | ||
- | * "SSL Support Status | + | * Starting with the 1.1.0 release POPFile now uses a timeout when connecting to the SSL server. This requires the use of IO:: |
Should you find anything in the documentation that is incomplete, unclear, outdated or just plain wrong, please let us know and leave a note in the Documentation Forum.