INITIAL SETUP INFORMATION


STOP: READ THIS CAREFULLY!  TAKE TIME NOW AND PREVENT A HEADACHE!


(This is the ReadMe file text.  If you've already read it, then just click 'continue'.)

Four EZ steps to installing your EmailMover program files.

1.  UnZip 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 "root" 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 folder. 

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 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 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. 

b.  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:

Using 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.

4.   Finally, 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....

http://www.yoursitename.com/EmailMover  or,

http://www.yoursitename.com/EmailMover/default.asp (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.

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.