Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
tree: 5686d0c022
Fetching contributors…

Cannot retrieve contributors at this time

file 172 lines (118 sloc) 4.7 kb
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172
# $Id: INSTALL,v 1.24 2012/04/13 09:14:22 gilles Exp gilles $
#
# INSTALL file for imapsync
# imapsync : IMAP sync or copy tool.

INTRODUCTION
------------

 imapsync works fine under any operating system with Perl and Perl modules (listed below).
 imapsync.exe works fine standalone under Windows XP, Vista, Seven, 20XX, either 32 or 64bit.


UNIX
----

 Purchase imapsync at
 http://imapsync.lamiral.info/
 You'll have access to a compressed tarball called imapsync-x.xx.tgz
 where x.xx is the version number. Untar the tarball where
 you want (on Unix):

 tar xzvf imapsync-x.xx.tgz

 Go into the directory imapsync-x.xx and read the INSTALL file.
 You're already reading the INSTALL file.

WINDOWS
-------

a) Simplest way:

- Buy imapsync.exe at http://imapsync.lamiral.info/
- Run imapsync.exe in a command prompt (execute cmd.exe).

b) Hard way:

- Get imapsync-x.xx.tgz
- Install Perl if it isn't already installed.
  Strawberry Perl is a good candidate
- Use PPM to install modules listed in the PREREQUISITES section.
  PPM is Perl Package Manager.


PREREQUISITES
-------------

This section doesn't concern Windows imapsync.exe users.

You need :
- Perl
  try : perl -v

  Get Perl here:
  http://www.perl.org/

- Some perl modules. To verify you have
  all modules in one command, just run:

  perl -c imapsync

  The good answer is "imapsync syntax OK".

Here is some individual module help:

- Perl Mail::IMAPClient module
  try :

  perl -mMail::IMAPClient -e ''
  
  Get the latest Mail::IMAPClient module here:
  http://search.cpan.org/dist/Mail-IMAPClient/

  In fact I use both Mail-IMAPClient-2.2.9 and latest Mail-IMAPClient-3.xx
  (xx >= 25) To know the version you have on your system try :

  perl -mMail::IMAPClient -e 'print $Mail::IMAPClient::VERSION, "\n"'

  New Mail-IMAPClient-3.xx works now very well with imapsync,
  better than Mail-IMAPClient-2.2.9 with memory and other things,
  at least with Mail-IMAPClient-3.25 (previous may bug).
  Don't hesitate to use latest Mail-IMAPClient-3.xx

- Perl Digest::MD5 module.
  try:

  perl -mDigest::MD5

  http://search.cpan.org/
  http://search.cpan.org/~gaas/Digest-MD5-2.36/
  To know the version you have on your system try :
  perl -mDigest::MD5 -e 'print $Digest::MD5::VERSION, "\n"'
  I use 2.36 (debian etch package)

- Term::ReadKey
  perl -mTerm::ReadKey -e ''

- IO::Socket::SSL
  perl -mIO::Socket::SSL -e ''

- File::Spec
  perl -mFile::Spec -e ''

- File::Path
  perl -mFile::Path -e ''

- Perl Digest::HMAC_MD5 module
  Good for non plain text password over network.

- Perl Authen::NTLM
  perl -mAuthen::NTLM -e ''

Test everything in one command:

  perl -mMail::IMAPClient -mDigest::MD5 -mTerm::ReadKey -mIO::Socket::SSL \
       -mFile::Spec -mDigest::HMAC_MD5 -mAuthen::NTLM -e ''

You can install easily those Perl modules in latest release via the
following commands (with root permissions)

  perl -MCPAN -e 'install Mail::IMAPClient'
  perl -MCPAN -e 'install Digest::MD5'
  perl -MCPAN -e 'install Term::ReadKey'
  perl -MCPAN -e 'install IO::Socket::SSL'
  perl -MCPAN -e 'install File::Spec'
  perl -MCPAN -e 'install Digest::HMAC_MD5'
  perl -MCPAN -e 'install Authen::NTLM'

You can install them easily too by using the standard install
command on your system if the packages have been made on it
(so you may not have the latest but most of the time it
doesn't care).
Example on Debian/Ubuntu:

  aptitude install libmail-imapclient-perl # Mail::IMAPClient'
  aptitude install libdigest-md5-file-perl # Digest::MD5'
  aptitude install libterm-readkey-perl # Term::ReadKey'
  aptitude install libio-socket-ssl-perl # IO::Socket::SSL'
  aptitude install libfile-spec-perl # File::Spec'
  aptitude install libdigest-hmac-perl # Digest::HMAC_MD5'
  aptitude install ? # (not free?) # Authen::NTLM

INSTALLING on Unix
------------------

To see what will be done, just run:

  make -n install

To install imapsync, just run (as root):

  make install

or copy the file imapsync where you want it to be.

TESTING on Unix
---------------

The test will break as they are home specific.
You need a running imap server on localhost with several accounts
toto with a password located in the file $HOME/var/pass/secret.toto
titi with a password located in the file $HOME/var/pass/secret.titi
tata with a password located in the file $HOME/var/pass/secret.tata

Of course, you can change the file tests.sh and run the tests with :

sh -x tests.sh

The tests.sh script break on first failure ("set -e" directive).

Since I added more tests you also need a remote imap server see the
file tests.sh and help yourself. No time to make a universal test
file.
Something went wrong with that request. Please try again.