ISMail, ISMail Pro, and ISMail EP Tools

• ASP script to send mail
• Import: mail account configuration
• Import/Export: mail account messages (imapsync)
• Import/Export: mail account messages (migrate.pl)
• Server Monitor

ASP script to send email using CDOSYS (works on IIS):

Download: cdosys_auth.asp

Description: Send an email message from an ASP script that is running on IIS using CDOSYS.

Usage: edit the script, replacing the test values with actual account name/password, domain name, and message contents. These are the lines to edit:

.Item(cdoSMTPServer) = "127.0.0.1"
Replace "127.0.0.1" with the mail server domain name.

.Item(cdoSendUsername) = "test@127.0.0.1"
Replace "test@127.0.0.1" with a valid account name

.Item(cdoSendPassword) = "test"
Replace "test" with a valid password

With iMsg
Set .Configuration = iConf
.To = """User A"" <test@127.0.0.1>"
.From = """User B"" <test@127.0.0.1>"
.Subject = "Hows it going? "
.CreateMHTMLBody "http://127.0.0.1/test.html"
.AddAttachment "C:\temp\test.txt"
.Send
End With
Replace the message fields with actual content. The ".AddAttachment" line is only required if an attachment should be sent; if sending an attachement, the file name of the attachment should be specified by this line.

Import mail account configuration: Perl scripts to add (or remove) ISMail account configuration

Download: adduser.pl, remuser.pl, IsMailMgr.pm

Description: The 'adduser.pl' script imports users specified in a CSV (comma separated value) file into ISMail as new accounts.The 'adduser.pl' script takes a list of users, one user per line, from an ASCII text file and creates a new ISMail account for each user. Each line in the CSV text file takes 4 values describing the new account; these values are in the order that is specified in the first line of the file.

The 'remuser.pl' script removes existing ISMail accounts. This script also uses a CSV file to specify the accounts to remove.

Note: ISMail is assumed to be installed into "c:\program files\instantservers\ismail". If a different installation directory is present, change the pathnames in the lines below.

Usage:

• copy the above Perl scripts to c:\program files\instantservers\ismail\apache\adm_perl
• open a DOS command window
• cd c:\program files\instantservers\ismail\apache\install
• spp2k.bat (this sets the PATH environment variable required to run Perl)
• cd c:\program files\instantservers\ismail\apache\adm_perl
• create a file "list.txt" whose first line is:

name,password,description,domain

• add a line describing each new user account to this file, e.g.:

fred,fredpassword,"This is fred account",mydomain.com
joe,joepwd,"This is joe account",mydomain.com
kathy,kathypwd,"This is kathy account",mydomain.com

• run the adduser.pl script in the DOS window as: perl adduser.pl list.txt

Once this script has been run, new mail accounts will be visible in the ISMail configuration manager.

To remove existing accounts:

• run the remuser.pl script in the DOS window as: perl remuser.pl list.txt

Once this script has been run, the mail accounts specified in list.txt will no longer appear in the ISMail configuration manager. (Note: the mailbox files for these accounts will not be deleted; the accounts may either be re-added later, or the mailbox files may be deleted from the file system separately).

Import/Export mail account messages: copy mail messages from one (IMAP) server to another

Download: imapsync [imapsync.zip]

Description: 'imapsync' copies mail account messages from one mail server to another. The servers must both support the IMAP protocol, and IMAP folder must contain only messages or other folders (not both messages and other folders).

Note: This is the recommended account migration script (legacy script is below).

Usage:

• download and install the ISMail-Webmail plugin from the download area
• download imapsync to c:\program files\instantservers\ismail\apache\install
• open a DOS command window
• cd c:\program files\instantservers\ismail\apache\install
• spp2k.bat (this sets the PATH environment variable required to run Perl)
• perl imapsync --host1 server1 --user1 account1 --password1 pwd1 --host2 server2 --user2 account2 -password2 pwd2 [--verbose]
  where:
  • server1 - hostname of original ('souce') mail server
  • account1 - user name of original ('source') mail account (Note: enter 'account2@domain1.com')
  • pwd1 - password of original ('source') mail account
  • server2 - hostname of new ('destination') mail server
  • account2 - user name of new ('destination') mail account (Note: enter 'account2@domain2.com')
  • pwd2 - password of new ('destination') mail server
  • Note: use '--verbose' for verbose output or enter 'perl imapsync' for options

Import/Export mail account messages: copy mail messages from one (IMAP) server to another

Download: migrate.pl

Description: 'migrate.pl' (included with the ISMail-Webmail plugin) copies mail folders (and messages) from one mail server to another. The servers must both support the IMAP protocol.

Note: This is a legacy mail account migration script; see above for the recommended account migration script.

Usage:

• download and install the ISMail-Webmail plugin from the download area
• open a DOS command window
• cd c:\program files\instantservers\ismail\apache\install
• spp2k.bat (this sets the PATH environment variable required to run Perl)
• perl migrate.pl -s1 server1 -u1 user1 -w1 pwd1 -s2 server2 -u2 user2 -w2 pwd2 [-v]
  where:
  • server1 - hostname of original ('souce') mail server
  • user1 - user name of original ('source') mail account
  • pwd1 - password of original ('source') mail account
  • server2 - hostname of new ('destination') mail server
  • user2 - user name of new ('destination') mail server
  • pwd2 - password of new ('destination') mail server
  • Note: use '-v' for verbose output