shim
shim

 
Introduction

This installation guide will walk you through the process of installing ClickFix V1.0.  Before you attempt to install ClickFix V1.0 it should be noted that these instructions assume you are somewhat knowledgeable  with making minor changes to Coldfusion scripts, setting up and configuring a SQL compliant database AND data sources; and that you have proper permissions on your web server to upload files via FTP and creating directories.  If you are not familiar with any one of these things, you should consider paying Revorg, LLC to set this up for you.

Remember, if you run into any installation problems, you can always turn to our Knowledge Base (http://www.clickfix.com/support/kb/) and Support Forum (http://www.clickfix.com/support/forums/). If you prefer to e-mail the Revorg, LLC

Support Team, you can of course send e-mail to us at support@revorg.net.

 
Quick Steps

Follow these steps to begin working installing ClickFix:

  1. Place the clickfixv1.key.cfm file in your clickfix subfolder
  2. Open the sitevars.cfm file located in the _includes folder for clickfix.
    Ex: c:\inetpub\revorg\clickfix\revorg\clickfix\_includes\sitevars.cfm

    • Set the attributes.clickfix.dbtype variable to your database type, Ex: access, oracle, mysql, mssql
    • Set the attributes.clickfix.datasource variable to your datasource name you defined for ClickFix in the Coldfusion Administrator

  3. Open your browser to the installation directory.
    http://www.yourdomain.com/revorg/clickfix/tools/install_v1/

  4. You may run the installation script now.

  5. Delete the tools subfolder for security reasons.

 

 
Installing ClickFix

This chapter describes ClickFix system requirements, how to begin the installation, and how to uninstall ClickFix.

Note:   In this chapter, revorg_root refers to your installation directory of OUR WEB FILES. By default, this directory is c:\inetpub\revorg\clickfix\ (Web Server Root + Revorg Files) on Windows.

 
ClickFix Product Editions

The following table below describes each edition of ClickFix:

Edition

Description

Licensing

     

Personal Edition

Deployment for Windows only.

One installation and ability to serve ads to 1 Web site using Microsoft Access.  CAN NOT be deployed under any other database type but Microsoft Access. 

     

Professional Edition

Deployment for Windows only.

Includes every feature in the Personal Edition, and also provides:

  • No Repeat Module
  • Publishers Module
  • Full support for Flash Remoting
  • Automated Email Reporting Feature

One installation, and ability to serve ads to 2 Web sites

     

Web Portal Edition

Deployment for Windows only.

Includes every feature in the Personal Edition, and also provides:

  • No Repeat Module
  • Publishers Module
  • Full support for Flash Remoting
  • Automated Email Reporting Feature
  • Directory Driven Portal Features

One installation, and ability to serve ads to 2 Web sites

     

Enterprise Edition

Deployment for Windows only.

Includes every feature in the Professional Edition, and also provides:

  • Unlimited Web sites

One installation, and ability to serve ads to an unlimited number of Web sites/domains

     

ISP Edition

Deployment for Windows only.

Includes every feature in the Enterprise Edition, and also provides:

  • Multiple Web Site Administrators

One installation with the ability to administer and serve ads to an unlimited number of Web sites/domains. Each Web site can have it's own administrator

 
*Note: Development under Unix and Bluedragon are currently under development

 
System Requirements

This section lists the system requirements for ClickFix for Windows:

 

ClickFix Product Edition

Requirement

Personal

Professional

Web Portal

Enterprise

ISP

           

Windows Version

Minimum Processor

500 mhz

750 mhz

750 mhz

1000 mhz

1500 mhz

Recommended Processor

1000 mhz

1000 mhz

1000 mhz

1500 mhz

2000 mhz

Minimum RAM

64 MB

256 MB

256 MB

512 MB

1000 MB

Recommended RAM

256 MB

512 MB

512 MB

1000 MB

2000 MB

Hard disk space

25 MB

300 MB

300 MB

300 MB

300 MB

Hard Drive Type

EIDE

EIDE

EIDE

EIDE

EIDE

Recommended  Hard Drive Type

EIDE

SCSI

SCSI

SCSI

SCSI

Software

Coldfusion 5.0*

x

x

x

x

x

Coldfusion MX

x

x

x

x

x

SMTP Server

x

x

x

x

x

Web Servers

ColdFusion MX stand-alone web server

x

       

ColdFusion Red Sky stand-alone web server

x

       

Microsoft IIS 4.0, 5.0, 6.0

x

x

x

x

x

Netscape Enterprise Server 3.6x

x

x

x

x

x

iPlanet Enterprise Server 4.x, 6.x

x

x

x

x

x

Apache web server 1.3.12-1.3.22, 2.x

x

x

x

x

x

Databases

Microsoft Access

x

x

x

x

x

Oracle 8.1.7, 9i, 11i

 

x

x

x

x

Microsoft SQL Server 7.0, 2000

 

x

x

x

x

MySQL 3.23+

 

x

x

x

x

Coldfusion Tags
CFFILE

x

x

x

x

x

CFDIRECTORY

x

x

x

x

x

* For Macromedia Flash Remoting and Coldfusion Components, Coldfusion MX or Red Sky is required

 
Database Considerations

Before you begin installing ClickFix, there are a few things that you need to do first.  You should first make sure that your system meets all of the software requirements.

For more information on creating a datasource, please visit Macromedia's official Web site.

http://livedocs.macromedia.com/cfmxdocs/Administering_ColdFusion_MX/datasources_ADV_MJS3.jsp

 
Microsoft Access Configuration

Before you begin installing ClickFix, there are a few things that you need to do first.  You should first make sure that your system meets all of the software requirements.

Some helpful information is listed below:

  1. Use the ColdFusion Administrators to create a datasource connection.  Be sure to specify the correct user ID and password for this database (use the 'CF Settings' button to expose the 'ColdFusion Login' UserName and Password settings).
  2. Verify that ColdFusion can access the new datasource.

 
Oracle Configuration


Before you begin installing ClickFix, there are a few things that you need to do first.  You should first make sure that your system meets all of the software requirements.

Some helpful information is listed below:

  1. Create a new Oracle user ID, granting the user 'connect' and 'resource', or 'DBA' status.
  2. Use the ColdFusion Administrators to create a native-driver datasource connection using the new Oracle user ID.  Be sure to specify the correct user ID and password for this database (use the 'CF Settings' button to expose the 'ColdFusion Login' UserName and Password settings).  Verify the correct host string or SID.
  3. Verify that ColdFusion can access the new datasource.

 
MySQL Configuration


Before you begin installing ClickFix, there are a few things that you need to do first.  You should first make sure that your system meets all of the software requirements.

Some helpful information is listed below:

  1. Create a new MySQL database
  2. Assign the user a DBA role or 'Grant All' for this database.
  3. Use ColdFusion Administrators to create an ODBC datasource for this new MySQL database.  Be sure to specify the correct user ID and password for this database (use the 'CF Settings' button to expose the 'ColdFusion Login' UserName and Password settings).
  4. Verify that ColdFusion can access the new datasource

 
SQL Server Configuration


Before you begin installing ClickFix, there are a few things that you need to do first.  You should first make sure that your system meets all of the software requirements.

Some helpful information is listed below:

  1. Using 'Enterprise Manager', create a new SQL Server database.
  2. Create a new user or use an existing one
  3. Assign the user a 'db_owner' role for this database.
  4. Use the ColdFusion Administrator to create a datasource for this new SQL server database.  Be sure to specify the correct user ID and password for this database (use the 'CF Settings' button to expose the 'ColdFusion Login' UserName and Password settings).
  5. Verify that ColdFusion can access the new datasource.

 
Getting Started


Now that you are ready to begin installing ClickFix, simply follow the steps in the order that are listed below:

  1. Getting Started
  2. File Structure
  3. Script Configuration

Create a directory off of your main Web site named "REVORG" (revorg_root).  This directory will house the ClickFix software.  For example, if your domain name is http://www.yourdomain.com and your web root or absolute path is "c:\intetpub\wwwroot\", your ad management files will look similar to this http://www.yourdomain.com/revorg/clickfix/ and be placed at "c:\intetpub\wwwroot\revorg\clickfix\". 

NOTICE: YOUR DOMAIN NAME CAN NOT BE CHANGED! THIS IS YOUR PART OF YOUR ENCRYPTION KEY

Unzip ClickFix into this directory.  ClickFix includes several sub-directories.  These include images, backup folders and Coldfusion components.   You must maintain this directory structure and include the sub-directories.  

DO NOT PLACE A COPY OF OUR ZIP FILE ANYWHERE ON YOUR WEB SITE.

Update the SiteVars.cfm script to specify your datasource name, and database type.  Macromedia recommends Merant Type IV drivers, but any ODBC compliant drivers will work. 

Open the application in your browser (http://www.yourdomain.com/revorg/clickfix/tools/install_v1/).  This will install ClickFix V1 for you.

Open the application in your browser (http://www.yourdomain.com/revorg/clickfix/ and select preferences and change the administrative password.  The username is currently set to "Administrator" and password is currently set to "install".

Now proceed to the getting started guide available from the ClickFix Help menu and be sure to update your preferences to reflect your particular server settings.  The preferences define important parameters used throughout the program.  You can begin by adding an advertiser, banner, campaign and zone in this order.

 
File & Directory Structure

The figure below is a graphical representation of the file structure that is used by ClickFix.  Please do not alter edit or decrypt any of the web files or folders listed below with written consent from Revorg, LLC.

Directory

Description

   

administrators

ISP Edition Only.  This is where site administrators go to login.

advertisers

This is where Web site advertisers go to login.

backups

Any modifications to the sitevars.cfm file is backuped here

cfc

Coldfusion Components are stored in this directory for Flash Remoting.

css

Cascade Style Sheets

exports

Exported Files are placed here

images

ClickFix images are stored here

js

JavaScript files are placed here.

publishers

This is where site publishers go to login, this feature is not available in the Personal or Lite Edition

queries

This is where ClickFix queries are stored.

serve

This is where your main ad management files is placed

tools

All upgrading and installation scripts here

_includes Include files are placed here for directory structure

 

 

 
Script Configuration


Before you begin configuring any scripts, you need to make sure that you use a proper text editor to edit the scripts first. We recommend that you use either Windows Notepad, Coldfusion Studio or Macromedia Dreamweaver MX. You should not use an editor that applies any type of formatting such as Microsoft Frontpage.  The following figure is a graphical representation of what you will see when you the SiteVars.cfm file.

shim
 
Copyright © 2000 - 2003 Revorg, LLC. All rights reserved