Uploading to Web Server

This page will give you step-by-step instructions on how to install the software by uploading to your server via FTP. Once you finish this section, you can move on to Step 1 of the online Installation script.

If you have not yet completed all steps above, please review the Prep for Install section of this manual.

Simply login to your Ultimate Locator Member's Account and click the link provided to download the software to your computer. It will be a compressed (zip) file. Save the Zip file to your local hard drive when prompted.

After you have downloaded the Zip file to your computer, you will have to extract (Unzip) the files onto your computer's hard drive. You will have to use software programs such as WinZIP or WinRAR to do this. Windows XP users may have Unzipping built in to their operating system. If you do not, you will need to install the unzipping software.

After unzipping the download, you will have a new file name Locator_Setup.exe on your hard drive. Simply launch this file by double-clicking it. You will be presented with a few screens that will ask you for your server's FTP information so that the setup can connect to your server and upload the files automatically. You can get more help (with screenshots) on the Auto Uploader tool here.

Setup will also attempt to change permissions on a few select files and folders. If it fails with this step, it will notify you that it could not change permissions and will ask you to do this manually. In most cases, Setup will not be able to change permissions on a windows server.

Setup will also attempt to install the needed IonCube Loaders that are needed to run the Admin Control Panel. Auto Uploader will detect your server type and automatically upload the correct IonCube loaders to your server, if they are not already detected and installed.

Complete all steps of the Auto Uploader to have Ultimate Locator installed onto your web server. After setup is complete, you will be automatically taken to the install.php script on your server where you will continue setting up your software through your web browser.

If you experience trouble using the Auto-Uploader tool, you do have the option to download the non-ionCube version from your member's account and install via FTP manually. Follow instructions below.

Login to your Member's Account and download the non-ionCube version of our software. You will download a zipped file containing all the locator files that need to me FTP'ed over to your server.

After you have all the files on your computer, you will need to transfer all the files and folders to your server. This can be easily achieved via FTP. Try WS_FTP Home or SmartFTP. Please refer to your FTP programs help system on how to transfer file to your server.

We suggest you create a new directory on your server called 'locator' and upload all your files into it. Of course, it can be any directory name or structure you wish.

Connect to your server via FTP and create a new directory called 'locator'. Double click this new 'locator' folder, and enter inside it. Now you can begin to transfer all your files into this new directory.

You will want to use ASCII transfer mode for all files except images and admin control panel files.

You should keep the same directory structure as in your download, and do not rename any of the files. Doing so will cause the install to fail. You must keep the default filenames and folders as is.

For instance, you will want to make sure and upload the /admin/add.php page on your computer to the /locator/admin/ directory on your server. And this holds true for all files.

Once you have all the files transferred to your server, you should end up with the following directory structure:

Directory Name:	File Details:
/locator/ (root installation folder)	includes: install.php, index.php, results_details.php etc..
/locator/admin/	includes: add.php, edit.php, delete.php etc...
/locator/dbackup/	empty but used for system files
/locator/dbackup/zipdata	used for importing/exporting zip code data
/locator/dbackup/restore	used for system restore files
/locator/key/	empty: but install will create a license.php file inside during first execution
/locator/templates/	includes: index.htm, results_details.htm etc...
/locator/templates/admin/	includes: add.htm, edit.htm, delete.htm etc...
/locator/templates/images/	includes graphics used in the Locator. arrowBlue.gif etc

If you are confident that you have uploaded the files correctly, then you may continue.

Ultimate Locator needs special write permission on some files and folders on your server. In order to perform an import or backup, the program must be able to write to files on your server. By default, your files and folders to do not have any special permission.

You will have to change the permission of the following files and folders manually.

The way a file permission is changed for a file or a folder is different among server types. With a Unix/Linux based system, you can simply change file permission with most FTP software. On a Windows server, you will have to launch your hosting control panel and give a specific web user full read/write/modify access to these files/folders. Always ask your hosting support team or web administrator what the best way to change file permissions are. Their help documents will probably inform you as well.

You will need to locate the files/folders on your server and issue a CHMOD command for each file so the permission can be changed to 777, which gives Read-Write-Execute permissions to a specific file or folder. This is easily done with the FTP programs mentioned previously, such as WS_FTP Home or SmartFTP. All you must do is select the file on the server that you wish to change permissions on, and "right-click" that file. You will see the alternate menu popup, where you select the CHMOD choice.

Right Click the file you wish to change permissions on: Choose Properties. Simply place a check mark into each box giving Read-Write-Execute permission for each the Owner, Group and Other. Click OK.

Right Click the file: Choose Properties / CHMOD: Simply place a check mark into each box giving Read-Write-Execute permission for each the Owner, Group and Public. Click OK.

Simply stated: you need to right click each file/folder above and select CHMOD then give the proper permissions for each. All other files should not need to be changed. If you are not comfortable issuing full read/write permissions (0777) on your server, then you can try to use others and see if they work. We recommend only trying 0755.

Changing the permissions of a Windows server can be a bit trickier than on a Unix/Linux box. You can not use FTP software to perform this task. You must use your windows manager panel or a control panel provided by your hosting company that allows you to change permissions. If you don't know how to change file permissions on your server, then you may want to ask your support department how to achieve this. They should be glad to help.

If you are renting your Windows account from a professional hosting company, such as Hostway, Interland or Verio, then these companies do provide you with a control panel that you can log into and change permissions on your files you have in your account.

Determine the best way to make your file permission changes, then perform them on the files and folders as indicated above.

Now that all the files are on your server and have the proper read/write permissions, you are ready to begin the real installation of the system.

You need to launch the installation script by pointing your browser to the install.php file on your server.

Of course, you need to replace the mysite.com above with your real domain, and also point to your root install directory.