Four EZ steps to installing your EmailMover
program files.
IMPORTANT NOTE: After installing EmailMover, you may benefit from a mini-tutorial written by an EmailMover customer. It explains
and demonstrates the basics of getting started and is available as a free download at www.minitute.com.
IF YOU ARE INSTALLING THIS SOFTWARE OVER AN EARLIER VERSION OF
EMAILMOVER, MAKE SURE TO REPLACE YOUR GLOBAL.ASA FILE WITH THE NEW ONE
PROVIDED IN THE DOWNLOAD.
NOTE: If you add the
EmailMover files and/or database to a FrontPage project, FrontPage
may ask you if you want to create a new connection for the database you
just added. You must answer NO to this question.
Answering otherwise will cause FrontPage to create conflicting
statements in your global.asa file, that may cause EmailMover to
malfunction.
UnZip
the download file. Besides this ReadMe file, there are several other items in the Zip file... the
EmailMover folder, the EmailMover2.mdb database, a Global.asa file, a Stest.asp
file, a Path.asp and the Bonuses folder. (There may also me a text file
outlining recent revisions to the EmailMover application.)
The stest.asp file is the same ServerTest file you can
download from the EmailMover site. If you haven't yet tested your server,
you may want to upload this file to your website and point your browser to it. The file reports back test results in your browser.
Contact us if you have any questions.
1. Upload the EmailMover folder and all of its contents
(including all subfolders) to the
"root"
of your web server. A simple upload is all that needs to be done. (The root level is where you keep your index.htm,
default.asp or other default web file that gets accessed whenever someone visits
your site).
The EmailMover folder created by the upload must be fully accessible
from the web by anonymous users, and must NOT be password protected.
2. Upload the EmailMover2.mdb database
to wherever your web host has arranged for you to keep your database.
Hosts catering to FrontPage websites typically provide an fpdb folder for this
purpose. With other hosts, the database folder is sometimes NOT directly accessible
from the web, and can
only be accessed through script files or via ftp. Contact your host admin
if you have any questions about where to properly locate your database.
Any host providing database
support will generally provide a SPECIFIC folder for
the database to reside.
If the database folder is accessible from the web you can
upload the path.asp file from the EmailMover zipfile into the database folder,
and call it up in your browser. The file will display the physical path on
the server, that you will need later in step 3.
If the database folder is NOT accessible from the web you
will not be able to use the path.asp file. You CAN put the path.asp file
in your root directory to see the physical path to your root folder. This
may prove helpful in troubleshooting path issues in step 3.
ABOUT SECURE SERVERS: ("https://" at the
beginning of the URL instead of just "http://") EmailMover
has NOT been written to accommodate a secure server environment .
Do NOT place EmailMover files or the EmailMover database in secure
server space.
3. Decide
upon a course of action for a "global.asa" file. There
are two possible alternatives, and only one will apply to your situation.
Look for a file in your root web directory named "global.asa", and
complete this step using one of the following choices. If
choice b applies to you, and you feel uncomfortable making changes to
your file, simply Email it to us. We'll make the changes, and
Email it back to you... at no charge. This service is included as part of
your EmailMover support package.
If you already have a global.asa
file in your root web directory, make a backup copy of it before making
any changes. DO NOT PROCEED WITHOUT MAKING A BACKUP!
If you're not
sure what the physical path to your database is, contact your web host for this
information. If applicable, use the path.asp file as described in Step 2.
a. If you do not have a global.asa file, open
the EmailMover global.asa file in
any text editor such as MS Notepad
(WARNING: Do not use
FrontPage.. it will insert Html Code into the file) and edit the "EMdbpath" database path variable
to reflect the physical path to your database folder. Then upload the global.asa
file to the "root" folder of your web server .
b.
If there is already a global.asa file present... make a copy of it to work with.
Open the copy with any text editor
(WARNING: Do not use
FrontPage.. it will insert Html Code into the file)
and take a look at what's inside.
Compare your existing global.asa file
to the global.asa file from the EmailMover Zip file, and cut and paste code
from one into the other in order to create a combined file.
If there is an existing
Application_OnStart rountine, then ADD all the EmailMover code inside the
EmailMover Application_OnStart routine to the end of the existing
routine.... taking care not to duplicate the End Sub statement.
Make sure everything lays within the starting and
ending <Script> tags.
4. For
unattended automatic operation,
EmailMover's trigger file must be called regularly. This
can be implemented as follows...
Call EMauto.asp in an image tag. The benefit of this method is that it
allows the calling page (usually your home page) to appear on screen
very quickly, while all the email sending work is being done by the
code in the image tag SRC attribute.
To implement this method, open your
homepage source file in a text editor, and add the following
Html code somewhere near the bottom of your page. The image
is just a 1x1 pixel spacer, but should be placed where it won't
interfere with any formatting on your page. This
tag calls the EMauto.asp file instead of actually displaying an image.
<img border="0" src="../Emailmover/EMauto.asp"
width="1" height="1">
Now, whenever your homepage is called,
the EMauto.asp file will run in the background, sending all your emails.
While doing this, it will remain totally invisible to the visitor,
except for the message that an item (image) is still downloading in
their status bar.
When you have completed steps 1 through
4, then start up Microsoft's Internet Explorer,
and type in the URL of the EMailMover program as follows....
http://www.yoursitename.com/EmailMover
or, if necessary for your server....
http://www.yoursitename.com/EmailMover/default.asp
At this point, you should be looking at
the Initial Setup Information Screen. Simply follow the prompts
from this point on. Context sensitive Help is available by
clicking on any question mark anywhere in the program.
Note: The registration script includes a
'phone-home' process which will validate your copy of EmailMover with
our servers. A validated license number will be assigned and
automatically written to the database as a part of the setup process.
Once completed, you'll have the opportunity to create your own login
username and passcode. When you log into the system for the first
time, the Online Help screen will automatically open, to help you setup
and operate your new EmailMover system.
Make sure you go to the SetUp page
and check the SMTP Host Server URL that EmailMover has "guessed" for
your system... and correct it as needed. Entering an IP
address rather than the URL may improve the overall performance of the
email sending routines.
The EmailMover installation script automatically
senses your locale (for non-US customers) from your web server
parameters and sets up the program to run with date formats in your
local language and format. This may not produce the desired result
if your web host is located in a country different from yours. If
this is the case, drop us an Email and we'll help you manually adjust
your EmailMover installation.
FAQs:
Answers to most questions are available
through the Online Help System. Simply Click on any question mark,
and then Click on INDEX at the bottom of the help window. Follow the links to the topic of your choice.