Four EZ steps to installing your EmailMover program files.
the downloaded file. There are 6 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 bonuses folder contains the bonus materials promised when you ordered
EmailMover. 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
to. The file reports back test results in your browser.
Contact us if you have any questions.
Upload the EmailMover folder and all of its contents to the
of your server. (The root level is where you keep your default.htm, index.htm,
default.asp or other default web file that gets accessed whenever someone visits
your site). A simple upload is all that needs to be done.
The EmailMover folder created by the upload must be fully accessible
from the web by anonymous users, and must NOT be password protected.
Do not change any access privileges to the EmailMover folder. You must ensure that the folder is set
up with standard read only privileges. Do not be tempted to apply
write, scan, create, modify, rename or delete privileges to anonymous users
for this folder.
Although not a requirement, it's nice to set up the EmailMover folder
so that it automatically fires off the EmailMover default.asp program when
accessed. Some hosts configure all web folders to do this, others
do not. Again, talk to your host administrator to get this
done if you are unsure of how to do it.
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 NOT directly accessible
from the web. The database is then "secure" from anonymous users, 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 an off-web 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 diplay 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.
If you are using FrontPage... FrontPage may sense the
presence of the EmailMover database. If so, FrontPage will present you
with a dialogue box asking you if you want to create a connection to the new
database. You should answer NO to this. Answering yes will create an
unnecessary global.asa file that may cause undue confusion in step 3.
NOTE: If you find that you must locate your database in a
web-accessible folder, then be forewarned that anyone with malicious intent can
easily access your database and download its contents. We strongly
discourage you from setting up the EmailMover database in a web accessible
ABOUT SECURE SERVERS: Secure
server space is generally recognized by having to put "https://" at the
beginning of the URL instead of just "http://", and is normally used for
financial transactions or other highly sensitive data. EmailMover
has NOT been written to accommodate a secure server environment .
Do NOT place EmailMover files or the EmailMover database in secure
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 for you, 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!
In the following steps... we strongly recommend
that if you're not
sure what the physical path to your database is, you 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
(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 your root web directory.
If there is already a global.asa file present... make a copy of it to work with.
Open it 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. Look for lines that look like:
the global.asa file from the EmailMover Zip file, cut and paste code into your existing global.asa 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.
Do the same for the Session_OnStart routine. Copy all the remaining
functions and subroutines from the EmailMover global.asa file into your existing
file. Make sure everything lays within the starting and
ending <Script> tags.
If there is no existing Application_OnStart
or Session_OnStart procedure in your existing global.asa file, it may be easier
to cut and paste what IS in your existing file into the EmailMover global.asa.
the global.asa file only gets triggered when as ASP page is called.
For optimum performance, you should rename your home page (or any other
frequently accessed page) so that your server treats it like an asp
page. First make a backup copy of your home page the way it
is. Then, if your home page is currently named index.htm or index.html, rename it to index.asp. If it's currently named default.htm,
rename it to default.asp. Of course, if your home page already has
an ASP extension, then just leave it as is.
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....
(if you did not or could not set up the folder to automatically run
the default.asp program.
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.
VERY IMPORTANT... If
your registration seems to be successful, but ends up cycling back to
the first screen again... there are two things you should check.
1) Make sure that the folder
you've placed the EmailMover database file in has the appropriate
permissions granted for anonymous internet users.
2) Make certain that you have
inserted the proper path into the EmailMover global.asa file, and
uploaded the global.asa file to the root of your web.
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.
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.
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.