RUNNING LINK POPULARITY CHECKER

NAME

install - Installing Link Popularity Checker

SYNOPSIS

This document describes the process of installing the Link Popularity Checker on your machine.

REQUIREMENTS

Link Popularity Checker requires the following:

An account on a webserver that allows you to run custom PHP scripts. If you're not sure whether yours does, your hosting provider should know. The application itself is around 2 megabytes, but we suggest that you have at least 25 megabytes of disk space available on your server to accommodate future files and posts.
An FTP program to upload the necessary files to your webserver, or shell access if you wish to install the system from the shell.
A web browser with Javascript enabled.

UPGRADING LINK POPULARITY CHECKER

If you wish to upgrade the link popularity checker, please follow the same steps as outlined under the topic INSTALLING LINK POPULARITY CHECKER.
When you reach the step of the installation wizard ( www.yourdomain.com/linkpop/install ), then select Upgrade from 1.x to 1.2 as the Installation Type.

INSTALLING LINK POPULARITY CHECKER

Downloading

The distribution can be downloaded from the CheckURL web site at http://my.checkurl.info.

After downloading, the file that you downloaded is saved either in .zip or .tar.gz format; this is a compressed bundle containing the files in the Link Popularity Checker distribution. Unpack this archive.

Uploading Files

Connect to your webserver
Open your FTP program and open an FTP connection to your web server.
Upload the application
In your FTP program, if the directory where you chose to install the Link Popularity Checker does not exist, create it. Then open that directory.
Upload all of the files in the Link Popularity Checker distribution to your webserver.

NOTE: be careful when doing this, as certain files must be uploaded in ASCII mode, whereas others must be uploaded in binary mode. If you get it wrong, the scripts WILL NOT WORK.

Upload these files/folders in ASCII mode:
Folders
- cache
- extlib
- themes

Upload these files/folders in Binary mode:
Folders
- config
- install
- lib
- themes/checkurl/images
Files
- admin.php
- export.php
- index.php
Set permissions
Set the permissions of all of the following files/folders to 777.
- config/config.inc.php
- cache
Permissions set to 777 means that all users on the system have Read, Write, and Execute permissions.

If your FTP client uses a graphical display for setting permissions, that display will look something like this:

If you are setting permissions through a Unix shell, simply use the command from the scripts root folder
```
$ chmod 777 config/config.inc.php cache
```

Initializing the System

Open your web browser and point it at the URL for the install directory on your site. For example, if your site is http://www.your-site.com/, and you uploaded the the Link Popularity Checker files into the /linkpop directory, you'd type http://www.your-site.com/linkpop/install/.

If you get a Fatal error: Smarty error: unable to write to $compile_dir, then you did not set the correct permissions for the cache folder. Please refer to the Set Permissions topic for assistance.

If successful, the installer will report its success. If unsuccessful, it will report the error that occurred.

VERY IMPORTANT SECURITY NOTE:

Afer running installer successfully, you should remove the install folder from the directory where you installed the Link Popularity Checker. Failure to remove the install folder could enable someone else to overwrite your configurations and gain access to the administration panel. FAILURE TO DELETE THE install FOLDER INTRODUCES A MAJOR SECURITY RISK. So you should delete it now.

RUNNING LINK POPULARITY CHECKER

Now that you have installed the system, you are ready to start using it.

Open your web browser and point it at the URL for the Link Popularity Checker. For example, if your site is http://www.your-site.com/, and you installed the Link Popularity Checker into the /linkpop directory, you'd type http://www.your-site.com/linkpop/ to access the Link Popularity Checker.
That's it! You're now ready to start using the Link Popularity Checker for your domain names.