SendMIME Pro Installation & Users Guide

Transcription

2 System Requirements Requirements under Windows X86 architecture only. Approximately 2 MB of hard disk space. Depending on version of Windows and your local system security policy you may require system administrative privileges to install SendMIME as the SendMIME executable is installed into your WINDOWS path so that it can be called from any current working directory. Requirements under Solaris Sparc architecture only. Minimum Solaris 2.6. Approximately 2 MB of hard disk space. Depending on your file system rights and local system security policy you may require root privileges to install SendMIME as the SendMIME executable is installed into your /usr/bin directory by default so that it can be called from any current working directory. Requirements under Linux X86 architecture only. Minimum 2.0 kernel. Approximately 2 MB of hard disk space. Depending on your file system rights and local system security policy you may require root privileges to install SendMIME as the SendMIME executable is installed into your /usr/bin directory by default so that it can be called from any current working directory. SendMIME Pro Installation & Users Guide Page 2 of 6

3 Installation Installation under Windows (all versions) ** If you have any problems please contact our support at Download the latest installer from Double click on the installer executable in the folder where you downloaded. You must read and accept the SendMIME License Agreement in order to install and use SendMIME Pro. Select the folder where you want to install the application files. The default is your system Program Files folder in a subdirectory named SendMIME Pro. Depending on your operating system type and system security policy you may require system administrative privileges to install SendMIME as the SendMIME executable is installed into your WINDOWS path so that it can be called from any current working directory. To install the registration key you received by o Save a copy of the sendmime.key file to your hard disk. o Open a Command Prompt and type sendmime reg and SendMIME will prompt you for the location of the sendmime.key file you saved to disk. o Enter the fully qualified path to the sendmime.key file, i.e. C:\Temp\sendmime.key, and press <ENTER>. o Your license key will be installed. Installation under Solaris ** If you have any problems please contact our support at support@sendmime.com. Download the latest installer from Run the following command to uncompress the SendMIME binary: gzip d c SendMIME_Pro_v1.0_Solaris.tar.gz tar xvf - cd into the newly created SendMIME_Pro_v1.0_Solaris directory and run install.pl. This script will walk you through installing the SendMIME binary. You must read and accept the SendMIME License Agreement in order to install and use SendMIME Pro. We recommend you use the default installation settings in order to be able to execute SendMIME from any current working directory. To install the registration key you received by o Save a copy of the sendmime.key file to your hard disk. o Open a command shell and type sendmime reg. SendMIME will prompt you for the location of the sendmime.key file you saved to disk. o Enter the fully qualified path to the sendmime.key file, i.e. /temp/sendmime.key, and press <ENTER>. o Your license key will be installed. Installation under Linux ** If you have any problems please contact our support at support@sendmime.com. Download the latest installer from Run the following command to uncompress the SendMIME binary: gzip d c SendMIME_Pro_v1.0_Linux.tar.gz tar xvf - cd into the newly created SendMIME_Pro_v1.0_Linux directory and run install.pl. This script will walk you through installing the SendMIME binary. You must read and accept the SendMIME License Agreement in order to install and use SendMIME Pro. We recommend you use the default installation settings in order to be able to execute SendMIME from any current working directory. To install the registration key you received by o Save a copy of the sendmime.key file to your hard disk. o Open a command shell and type sendmime reg. SendMIME will prompt you for the location of the sendmime.key file you saved to disk. o Enter the fully qualified path to the sendmime.key file, i.e. /temp/sendmime.key, and press <ENTER>. o Your license key will be installed. SendMIME Pro Installation & Users Guide Page 3 of 6

4 Usage Guide (Note: All command options are case sensitive) Usage: sendmime -S <your SMTP MTA> -f -t "Your subject." -m "Your message " -a "c:\path\to\file1.ext,c:\path\to\file2.ext,..." Option Parameter -reg This option does not accept any parameters and will walk you through the process of installing the registration key you received by when you purchased this product. -h This option does not accept any parameters and when present in the command displays the SendMIME help message and exits the program without any further processing. -l This option does not accept any parameters and when present in the command displays the SendMIME license agreement. -v This option does not accept any parameters and when present in the command displays the SendMIME version and build numbers. -d This option does not accept any parameters and when present enables debugging. This option cannot be used with the q option. -q This option does not accept any parameters and when present enables quiet mode. This option cannot be used with the d or log options. -log This option requires a parameter of a path to a local file. This option writes all SendMIME output and errors to the specified log file. Please note that the log file will be created if it doesn t exist and overwritten without warning if it already exists. This option cannot be used with the q option. -n This option requires a parameter of an integer. This option will send your message the number of times specified in the integer. Debugging information is minimized when d is used with this option. -r This option does not accept any parameters and when present enables delivery confirmation to all recipients of your message. -i This option requires a parameter of either High, Low or Normal and sets the message importance accordingly. Default is "Normal" when this option is not used or when an invalid parameter is used. -text This option does not accept any parameters and sends the message as plain text - no MIME formatting. This option cannot be used with the a or al options as an SMTP message automatically becomes MIME formatted when a file attachment is added. -S This option requires a parameter of the hostname or IP address of the SMTP MTA to be used to route/deliver the message(s). This option cannot be used with the nomta option and requires a minimum of either t, -c, -b, -tl, -cl or bl to be present. -nomta -auth This option does not accept any parameters and when present will attempt to send the message directly to all recipients domains avoiding the need for a local MTA but still requiring an Internet connection. When this option is used SendMIME will try to determine the local DNS nameservers, lookup the mail exchangers of all recipient domains and send directly to the recipients domain. This option cannot be used with the S or the n options and requires a minimum of either t, -c, -b, -tl, -cl or bl to be present. This option requires a parameter of the senders SMTP logon credentials in the format userid:password. Currently only the SMTP LOGIN authentication method is supported. This option cannot be used with the nomta option. -p This option requires an integer parameter of the port number to be used as the SMTP port specification. The default port 25 is used when this option is not specified. -f This option requires a parameter of the SMTP address the message will be sent from. All RFC822 valid SMTP addresses are acceptable however if the address contains spaces the entire address should be enclosed in double quotes. i.e. to send using a friendly name you could set f to SendMIME Support <support@sendmime.com> SendMIME Pro Installation & Users Guide Page 4 of 6

5 -reply This option requires a parameter of an SMTP address that the SMTP Reply-To address will be set to. All RFC822 valid SMTP addresses are acceptable however if the address contains spaces the entire address should be enclosed in double quotes. i.e. to send using a friendly name you could set reply to SendMIME Support <support@sendmime.com> -t This option requires a parameter of the SMTP address(es) to send the message to. Use a comma to separate multiple recipients. All RFC822 valid SMTP addresses are acceptable however if the address contains spaces the entire address should be enclosed in double quotes. i.e. to send using a friendly name you could set t to SendMIME Support <support@sendmime.com> -tl This option requires a parameter of the path to a local text file containing list of SMTP TO recipients. The text file should be formatted with one SMTP address per line or optionally with an SMTP address followed by a friendly name per line. i.e.: support@sendmime.com SendMIME Support info@sendmime.com SendMIME Information feedback@sendmime.com SendMIME Feedback This example list would send to all SMTP addresses and display the friendly name in the SMTP TO header. -c This option requires a parameter of the SMTP address(es) to carbon copy the message to. Use a comma to separate multiple recipients. All RFC822 valid SMTP addresses are acceptable however if the address contains spaces the entire address should be enclosed in double quotes. i.e. to send using a friendly name you could set c to SendMIME Support <support@sendmime.com> -cl This option requires a parameter of the path to a local text file containing list of SMTP CC recipients. The text file should be formatted with one SMTP address per line or optionally with an SMTP address followed by a friendly name per line. i.e.: support@sendmime.com SendMIME Support info@sendmime.com SendMIME Information feedback@sendmime.com SendMIME Feedback This example list would send to all SMTP addresses and display the friendly name in the SMTP CC header. -b This option requires a parameter of the SMTP address(es) to blind carbon copy the message to. Use a comma to separate multiple recipients. All RFC822 valid SMTP addresses are acceptable however if the address contains spaces the entire address should be enclosed in double quotes. -bl This option requires a parameter of the path to a local text file containing list of SMTP BCC recipients. The text file should be formatted with one SMTP address per line or optionally with an SMTP address followed by a friendly name per line. i.e.: support@sendmime.com SendMIME Support info@sendmime.com SendMIME Information feedback@sendmime.com SendMIME Feedback This example list would send to all SMTP addresses but no addresses would be displayed as BCC recipients are not disclosed. -s This option requires a parameter of the subject text for your message. If your subject text contains more than one word the string must be enclosed in quotes. -m This option requires a parameter of the message text for your message. If your message contains more than one word the string must be enclosed in quotes. -a This option requires a parameter of the fully qualified path to a local file to attach to the message. Commas should separate multiple file attachments and the entire parameter should be enclosed in quotes. i.e. C:\Temp\file1.txt,C:\Temp\file2.txt. -al This option requires a parameter of a path to a local text file containing a list of files to attach to the message. The text file should be formatted with one fully qualified path to a file per line: C:\Temp\file1.txt C:\Temp\file2.txt SendMIME Pro Installation & Users Guide Page 5 of 6

6 Examples 1. Basic command line syntax to send a message with a file attachment: sendmime S mail.sendmime.com f support@sendmime.com -t user@domain.com -s Example #1 m Example #1 message with a file attachment. a C:\Temp\file1.txt ** Basic syntax is what you would also use to configure Windows scheduled tasks or UNIX cron jobs. 2. SendMIME called from a Perl script using the system command: #!/usr/bin/perl -w use strict; my $mailer = 'sendmime.exe'; my $smtphost = 'mail.sendmime.com'; my $from = 'user@domain.com'; my $to = 'user@domain.com'; my $subject = 'Test message. my $message = "Test message using SendMIME."; my $file1 = 'C:\path\to\file1'; my $file2 = 'C:\path\to\file2'; = ("$mailer", "-d", "-S $smtphost", "-f $from", "-t $to", "-s \"$subject\"", "-m \"$message\"", "-a \"$file1,$file2\""); my $results = system(@args); print "$results"; 3. SendMIME called from a Perl script using Win32::Spawn: #!/usr/bin/perl -w use strict; my $mailer = 'sendmime.exe'; my $smtphost = 'mail.sendmime.com; my $to = 'user@domain.com'; my $from = 'user@domain.com'; my $subject = 'Test message.'; my $message = "Test message using SendMIME."; my $attach = C:\Temp\file1.txt'; my $Args = '-d -S '. $smtphost. ' -f '. $from. ' -t '. $to. ' -s '. '"'. $subject. '"'. ' -m '. '"'. $message. '"'. -a '. '"'. $attach. '"'; Win32::Spawn( $mailer, $Args, $Pid ); SendMIME Pro Installation & Users Guide Page 6 of 6