|
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.
Follow these steps to begin working installing ClickFix:
- Place the clickfixv1.key.cfm file in your clickfix
subfolder
- 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
- Open your browser to the installation directory.
http://www.yourdomain.com/revorg/clickfix/tools/install_v1/
- You may run the installation script now.
- Delete the tools subfolder for security reasons.
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:
|
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 |
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
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:
- 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).
- Verify that ColdFusion can access the new datasource.
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:
- Create a new Oracle user ID, granting the user 'connect'
and 'resource', or 'DBA' status.
- 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.
- Verify that ColdFusion can access the new datasource.
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:
- Create a new MySQL
database
- Assign the user a
DBA role or 'Grant All' for this database.
- 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).
- Verify that ColdFusion
can access the new datasource
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:
- Using 'Enterprise
Manager', create a new SQL Server database.
- Create a new user
or use an existing one
- Assign the user a
'db_owner' role for this database.
- 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).
- Verify that ColdFusion
can access the new datasource.
Now that you are ready to begin installing ClickFix, simply
follow the steps in the order that are listed below:
- Getting Started
- File Structure
- 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 |
| |
|
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.
|