|
|
|
|
CGIMAIL FAQ
- Q 1 Cgimail works but takes ages?
- Q 2 Do you have a list of error codes for CGIMail?
I keep getting either an error code E101 or E103.
- Q 3 I dont see my html output files, I see either
"email sent" or "email NOT sent" on an otherwise blank page.
- Q 4 How do I set the success_html_page and failure_html_page
settings?
- Q 5 Can I use cgiamil on Windows2000 server?
- Q 6 Do I need any other install or program to run
cgimail?
- Q 7 I've created CGI-BIN directoty, made an alias
with the same name, marked this directory as executable, placed cgimail.exe
in it, but... no responce when trying to connect from my web, and log
file is empty :(
- Q 8 The last variable that is in the ini file is
duplicated twice in the email sent to me. How to fix?
- Q 9 When I submit I get the email and one or all
of the variables do not have the value that was entered.
- Q 10 I got the message "error: The ini file could
not be opened.. ", what to do?
- Q 11 I cannot figure out where to enter the value
of the email address to which the information from the form would be
delivered to?
- Q 12 Is their any chance of a registered version
without the copyright / link to netwinsite on?
- Q 13 I cannot get it work
- Q 14 If you have more than 18 fields, the last
field will drop out of the resulting e-mail.
- Q 15 Is this greate program realy free? even in
professional use?
- Q 16 I have about 2000 checkboxes and I need to
send only info from 10. Is it somehow possible to have cgimail send
via e-mail just variables that are checked in type="checkbox" ?
- Q 17 I get error in cgimail.log file "wsock: (TCPwrite
failed in sendr) Socket Unkown error code 0" whats it mean?
- Q 18 I get error message "Internal Server Error
- The server encountered an internal error or misconfiguration and was
unable to complete your request...", what to do?
- Q 19 I tried to download cgimail. I received an
error the server could not be found.
- Q 20 Error 404 when I press the submit button?
- Q 21 They told me that if i use a script i must
use only BLAT command and not Sendmail, does cgimail work with BLAT?
- Q 22 I am running the cgimail on a Mac OSX server
and unable to have the success page come up after the form is submitted?
- Q 23 please let me know if i'm bugging you too
much!!!!
- Q 24 when i do this: headerline From: "use_submitted_variable_for_headerline
Name:" the cgi
will not work.
- Q 25 for the success_html_page, i have entered
all kinds of stuff like ../../dir/ok.html, and i cannot get it to work.
all i get is a "email sent" message. Help!?
- Q 26 Just wondering if there is a way to make
users fill out required fields with cgimail, before pressing the submit
button?
- Q 27 I get "Socket error -1" in the log file on
OSX?
- Q 28 success and failure pages dont work, all
I get is "email sent" or "email NOT sent"?
- Q 29 Is it possible to get the email with whoever
sent it as the 'From'?
Q 1 Cgimail works but takes ages?
A 1 - set log level to debug, submit the html form, then go through
and look for where there is a significant portion of time elapsed
e.g.
18th March 2002, 9:10:55 am ...
18th March 2002, 9:11:12 am ...
Here 17 seconds passed, check the messages to see what it was up to when
cgimail was paused. If the message line before the pause begins with "about
to send email to smtp server (...)" then it looks like you DNS settings
are not set correctly, set the [b]smtp sitename[/b] to be an IP
e.g.
smtp 10.0.0.50
Q 2 Do you have a list of error codes for CGIMail?
I keep getting either an error code E101 or E103.
A 2 - cgimail does not have error codes like E101 or E103 its probably
your web server returning those codes. Maybe try looking up those codes
in the documentation of your web server? If the web server is running cgimail,
check the cgimail.log file (right next to the executale) for any messages
from cgimail. If Cgimail was just running, there will be a recent timestamp
on the messages.
Q 3 I dont see my html output files, I see either
"email sent" or "email NOT sent" on an otherwise blank page.
A 3 - Either your success_html_page and failure_html_page settings
are not set correctly, see question below, or your files are not accessable
to cgimail, set logging to "debug", try again, then read cgimail.log
file, and see what error is associated with those file(s).
Q 4 How do I set the success_html_page and failure_html_page
settings?
A 4 - The settings are local file system parameters. On windows
set like this:
success_html_page c:\inetpub\wwwroot\cgi_ok.html
failure_html_page c:\inetpub\wwwroot\cgi_bad.html
On Linux, set like this:
success_html_page /home/httpd/wwwmessages/cgi_ok.html
failure_html_page /home/httpd/wwwmessages/cgi_bad.html
Remember that these are just examples, and you probably have the files in
a different location and with different file name. Do Not use hypertext
links as these are not valid parameters for cgimail.
Q 5 Can I use cgiamil on Windows2000 server?
A 5 - Yes.
Q 6 Do I need any other install or program to run
cgimail?
A 6 - Yes. You need to have a web server installed to run cgimail.
Windows 2000 comes with a web server, you may need to install it, goto start
-> controll panel -> Add/Remove Programs -> Add/Remove Windows
Components -> (select) Internet Information Services. and click on OK,
and follow on screen instructions. You should put cgimail in the \inetpub\scripts
directory (already set up for cgi programs) Older Windows operating systems
may have a web server that you can install as a service on the network properties,
it is called something like "Peer Web Services".
Q 7 I've created CGI-BIN directoty, made an alias
with the same name, marked this directory as executable, placed cgimail.exe
in it, but... no responce when trying to connect from my web, and log
file is empty :(
A 7 - Web server is not running cgimail. Have you checked that your
html submit file points to <form method="POST" action="/cgi-bin/mailer.exe"
...> ? Maybe your web server is case sensitive, check to make sure that
the directory and all the URLs match the same case.
Q 8 The last variable that is in the ini file is duplicated
twice in the email sent to me. How to fix?
A 8 - This is a bug in cgimail, add two empty lines to the end of
the cgimail.ini file to fix problem, or download latest version 1.0q or
later.
Q 9 When I submit I get the email and one or all of
the variables do not have the value that was entered.
A 9 - There is a typing mistake, you need to enter the name of each
form element in the ini file identically to how it is spelt in the HTML
form that submits the info. A common typo is entering "name" instead
of "Name:".
Q 10 I got the message "error: The ini file could
not be opened.. ", what to do?
A 10 - If there is a cgimail.ini file you probably dont have the
correct access rights on it, a very common problem on unix/solaris/mac osx
platforms.
Q 11 I cannot figure out where to enter the value
of the email address to which the information from the form would be delivered
to?
A 11 - You specify the "To: " header for the email. e.g.
in the ini file:
headerline To: my_email@my_domain_address.com
But use your email address. You can also specify CC: and BCC: in at least
verison 1.0q
Q 12 Is their any chance of a registered version
without the copyright / link to netwinsite on?
A 12 - Yes, send me an email and I will tell you details.
Q 13 I cannot get it work
A 13 - Um, what are you trying to make happen?
Q 14 If you have more than 18 fields, the last field
will drop out of the resulting e-mail.
A 14 - The internal limit is 1000 fields, could you please make
sure that you havn't made a typo with the nameing of the field?
Q 15 Is this greate program realy free? even in professional
use?
A 15 - Yes, its realy free, even for professional use :-)
Q 16 I have about 2000 checkboxes and I need to send
only info from 10. Is it somehow possible to have cgimail send via e-mail
just variables that are checked in type="checkbox" ?
A 16 - Yes, you list the names of the checkboxes that you want information
from. Also make sure that you have set "sendall false".
e.g. if the names of your checkboxes are "name1", "name2", "name3", etc... then in ini file:
sendall false
use_submitted_variable_for_bodycontent name1
use_submitted_variable_for_bodycontent name2
use_submitted_variable_for_bodycontent name3
use_submitted_variable_for_bodycontent name4
use_submitted_variable_for_bodycontent name5
use_submitted_variable_for_bodycontent name6
use_submitted_variable_for_bodycontent name7
use_submitted_variable_for_bodycontent name8
use_submitted_variable_for_bodycontent name9
use_submitted_variable_for_bodycontent name10
Q 17 I get error in cgimail.log file "wsock: (TCPwrite
failed in sendr) Socket Unkown error code 0" whats it mean?
A 17 - Some windows systems return an error code even when the function
succeeds. If you got the email and it was all fine, then ignore this error,
if you didn't get the email, or if it was badly formated, please download
the latest version of cgimail for your platform. Email me if you have any
further problems.
Q 18 I get error message "Internal Server Error -
The server encountered an internal error or misconfiguration and was unable
to complete your request...", what to do?
A 18 - It looks like the server cant execute the cgimail.exe file.
If you are using a linux or unix type machine, you may need to set the execute
flag on cgimail.exe or cgimail.cgi file.
e.g. chmod +x cgimail.exe
You may need to set the correct user and group name, usually "nobody"
on linux and unix systems.
e.g. chown nobody:nobody cgimail.*
If you are not sure, type in this command "ls -l cgimail.exe"
and send me the response you get. Try again after you have changed things,
and let me know how it goes.
Q 19 I tried to download cgimail. I received an error
the server could not be found.
A 19 - Please send me an email if this happens, and let me know
which file[s] you are after, and I will email them to you.
Q 20 Error 404 when I press the submit button?
A 20 - The web server cannot send data to the specified file. Perhaps
you downloaded the windows executable or incorrect Linux binary (and ran
it on something incompatible)? what happens when you try to run the cgimail
program from the command prompt? Is your web server configured to execute
binary files from the cgi-bin directory? Is the executable flag set on the
cgimail executable file? Does the cgimail executable have the correct user
and group settings?
Q 21 They told me that if i use a script i must use
only BLAT command and not Sendmail, does cgimail work with BLAT?
A 21 - Cgimail isn't a script that relies on sendmail or BLAT. Cgimail
does not use Sendmail or Blat, If you have to use Blat for security reasons,
like getting past a firewall, then you may well need a different product.
Cgimail incorporates the things that sendmail and blat do, so they are supurflous
for cgimail.
Q 22 I am running the cgimail on a Mac OSX server
and unable to have the success page come up after the form is submitted?
A 22 - success_html_page and failure_html_page are filenames, you
can use relative paths from the location of the cgimail.cgi file if you
like. you may need to name cgimail as cgimail.cgi cgimail.log filenames
aren't quite as advertised, if you rename cgimail.cgi to cgimail.exe it'll
work. if you keep cgimail.cgi as is, the ini and log names are cgimail.cgi.ini
and cgimail.cgi.log You need to set the ownerships to the correct settings
for your system, these have been reported to work :-) user: root group:
staff
e.g. run this command
chown root:staff cgimail*
Q 23 please let me know if i'm bugging you too much!!!!
A 23 - no worries, I'm being paid to reply to these emails :-)
Q 24 when i do this: headerline From: "use_submitted_variable_for_headerline
Name:" the cgi will
not work.
A 24 - Ah, no, cgimail is simple! it wont let you do that.
Q 25 for the success_html_page, i have entered all
kinds of stuff like ../../dir/ok.html, and i cannot get it to work. all
i get is a "email sent" message. Help!?
A 25 - Your webserver might be running cgimail from a location other
than the directory that cgimail is in. Set the logging to debug in the ini
file "logging debug" and run the script again through the web
server, look at the log, there will be indication of the cgi, ini and log
filename, the path prefix may indicate where it is running from, there will
also be a message saying "cannot open success file ... reason ..."
look at the reason, it may give you pointers on how to fix it.
Q 26 Just wondering if there is a way to make users
fill out required fields with cgimail, before pressing the submit button?
A 26 - JavaScript
Q 27 I get "Socket error -1" in the log file on OSX?
A 27 - There was a linking error in that version, download the latest
version.
Q 28 success and failure pages dont work, all I get
is "email sent" or "email NOT sent"?
A 28 - The settings are not URL settings so dont use http:// addresses.
use absolute file paths to the local files.
On Windows:
success_html_page c:\inetpub\scripts\cgimail_ok.html
failure_html_page c:\inetpub\scripts\cgimail_bad.html
Other:
success_html_page /home/httpd/www/cgimail_ok.html
failure_html_page /home/httpd/www/cgimail_bad.html
Q 29 Is it possible to get the email with whoever
sent it as the 'From'?
A 29 - Yes. You would have the ini file like this: headerline To:
parts@aftermarketmarine.com headerline Subject: F&S Web Site Request
For Info use_submitted_variable_for_headerline From: and you would have
an input field on your web page like this: <input type="text"
name="From:" value=""> (and all the others that you
wanted) and provided that they actually enter a valid email address, it
will be sent. If they do not enter a valid email address, the error page
will be shown. |
