Windows NT Installation Notes

- README File for Windows NT Servers

- Mail Sending
- Windows IIS Server

# README File for Windows NT Servers

Please follow these directions to have any hope in getting Mojo Mail running on Windows NT. You'll need to make some tweaks to the Config.pm file; all variables, unless otherwise noted are located in the Config.pm file.

Please Please Please Note: Mojo Mail is developed for a Unix-centric server in mind. There are a few major differences between a server, like Apache which Mojo Mail is tested on extensively and a server, like Microsoft's Internet Information Server, which isn't tested by us at all. At the moment, there is no interest for me (as the developer) to make it work on a Microsoft platform. The reason for this is my lack of time to invest and my lack of a server to test on. I leave this as an invitation for a different party.

## Mail Sending

Your most likely going to have to use SMTP for all mailings; Sendmail usually isn't available for Windows. As such, you need to specify an SMTP address in the $SMTP_ADDRESS variable, example:

            $SMTP_ADDRESS = '216.18.218.211';

You may also want to tell Mojo Mail use SMTP sending right off the bat, instead of having to configure it everytime you make a list. You do this by adding a new line in the %LIST_SETUP_DEFAULTS hash:

            %LIST_SETUP_DEFAULTS = (
                    send_via_smtp => 1,
            );

    These may be other entries in this file, you can put this particular entry either above, or below any other ones:

            %LIST_SETUP_DEFAULTS = (
                    use_pop_before_smtp => 1,
                    smtp_server         => $SMTP_ADDRESS,

                    send_via_smtp       => 1

            );

    While you're at it, you may also want to add the 'strip_message_headers' and set it to 1:

            %LIST_SETUP_DEFAULTS = (
                    use_pop_before_smtp   => 1,
                    smtp_server           => $SMTP_ADDRESS,
                    send_via_smtp         => 1,
                    strip_message_headers => 1,
            );

## Windows IIS Server

Perl CGI scripts need to be run in No Parse Header mode, set the $NPH variable to 1:

            $NPH = 1;

    You may also need to rename the mojo.cgi script to nph-mojo.cgi, but try that after you've done everything else.

There is also a patch that you may need to apply to IIS, more information is available here:

http://support.microsoft.com/support/kb/articles/Q280/3/41.ASP

If the patch is moved or removed, do a search on Microsoft's support site for it.

You may also need to change the first ``shebang'' line in mojo.cgi from:

            #!/usr/bin/perl

    to something like:

            #!C:/perl/bin/perl.exe

Mojo Mail uses something called `fork()` that may or may not be available to Windows Versions of Perl. `fork()` is very critical to bulk mailings, but you can make bulk mailings, provided that you don't use batching, by setting the $FORK_SMTP_BULK_MAILINGS varaible to 1

            $FORK_SMTP_BULK_MAILINGS = 1;

Your version of Windows my not support File Locking, this is extremely important in keeping the subscription list uncurrupted. You may want to look into using a SQL backend to use as your subscription list. There may also be unknown complications with the templating in Mojo Mail as well. YMMV.

Your copy of Mojo Mail should be all set to run on a Windows Server. If you still cannot run the program, open up the mojo.cgi script and find these two lines:

            use lib './'; #look for the MOJO folder in the same directory as the script
            use lib './MOJO';

you may have to change these to the full absolute path of where they're at (example:)

            use lib 'D:\somewhere\else\mojo';
            use lib 'D:\somewhere\else\mojo\MOJO';

That wasn't too painful. Good luck!