SYNOPSIS
--------

PROJECT:    ASP Nuke
VERSION:    0.80
LICENSE:    Gnu General Public License
RELEASED:   03/10/05
HOME:       http://www.aspnuke.com/

ABOUT
-----

ASP Nuke is a dynamic content management system written in ASP for
windows computers running Internet Information Server 5.0 or better.
It provides a dynamic web portal and content management system that
is easy to administer and customize.

It is highly modular allowing you to swap in new modules and edit
or remove any existing modules at any time.  An update system will
allow you to receive module updates and download additional modules
at any time you like.

Our goal is to use no third party components in the core system
(and core modules).  Other people may provide add-in modules however
they like.  We strive to use caching of content wherever possible to
limit the load on your server.

The home page for the ASP Nuke project is:

http://www.aspnuke.com/

and the project is managed through SourceForge at:

http://sourceforge.net/projects/aspnukecms/

REQUIREMENTS
------------

In order to run ASP Nuke on your web server, you will require the
following items.

Windows NT/2000 Pro/XP Pro
Internet Information Server (IIS) 5.0 or better
Database Server (one of the following):
  Microsoft SQL Server 2000*
  MySQL for Windows (w/MyODBC 3.51 Driver)

* may also work with SQL Server 7 though this is not tested

Of course the Nuke software is written using ASP which comes with
your IIS web server software.  We require IIS 5.0 because it comes
with ASP version 3.0.  We are not sure if you could bootstrap an
older version of IIS with ASP 3.0.

INSTALL
-------

Steps

1. Unpack the archive in your web site folder (C:\InetPub\wwwroot)
2. Configure a new web site (using IIS) for the web site folder
3. Set the default home page for the web site to "index.asp"
4. Make sure your domain name is setup correctly
5. Setup your SQL Server Database
6. Run the Setup Wizard

2. Configure your Web Site

To install the ASP Nuke package, you must create a new web site
under the IIS control panel.  This is found under "Administrative
Tools" and then "Internet Information Services".

Set the default home page to "index.asp" by opening the web site
"Properties" and navigating to the "Documents" tab.  Add "index.asp"
as a default document type and make sure it shows up at the top of
your list of documents.

Under the "Home Directory" tab for your web server properties, make
sure that you set "Execute Permissions" to "Script Only".  Also,
you should make sure that only "Read" access is allowed for visitors
who come to your site by checking "Read" and unchecking "Script
Source Access", "Write" and "Directory Browsing".

You have four options for configuring your ASP Nuke site:

  A. Setup a standard web site (dedicated IP address)
  B. Setup a virtual host site (shared IP address)
  C. Setup a virtual directory under an existing site
  D. Simply drop the ASP Nuke application into a folder under one
     of your existing sites (should require no IIS setup)

4. Make sure your domain name is setup correctly

If you have create a domain for your nuke site, you will need to
configure your web server with the domain name and make sure you have
the proper DNS records pointing to the server for the new site.  If
you require a free DNS service, I recommend http://www.dyndns.org,
it is an excellent free DNS service, you can even register a free
domain name there if you wish.

5. Run the Setup Wizard

As soon as you have installed the web site, you can open the Setup
Wizard in your browser to setup the database and configure your nuke
appliation.  This is done by loading the first stage of the setup
process like:

  http://www.yourdomain.com/installfolder/setup/setup1.asp

  or if not installed in a sub-folder:

  http://www.yourdomain.com/setup/setup1.asp

Of course you will want to replace the "/installfolder" with the
folder or virtual directory you placed ASP Nuke under.  If you didn't
use one of those methods, you can eliminate the "/installfolder"
component altogether.

Simply follow the instructions on your screen to configure ASP Nuke.
The wizard will guide you through all of the steps in order to setup
the database schema, import the initial set of data and finally: do
the configuration of your nuke portal.

WARNING

The final step of the setup wizard (setup3.asp) contains a "tabbed
interface" that you will need to navigate to define the configuration
settings for ASP Nuke.  If you don't complete configuration of the
portal software, you may experience undesired results.

Should you have any problems with the automated database setup, you
might want to check your database connection string and make sure it
is correct.  Another option is to setup the database schema and also
import the initial data set using the supplied scripts.  More info
can be found in the file: readme_database.txt.

6. Administrator Login

Once configuration is complete you can view your site and login to
your admin area at the url:

  http://www.yourdomain.com/installfolder/module/admin/

  or if not installed in a sub-folder:

  http://www.yourdomain.com/module/admin/

The default password for the aspnuke admin is:

username: nukeadmin
password: changeme

Be sure to change this password immediately to prevent unauthorized
access to your web portal.  This is done by clicking on the "Users"
nav item and then finding the "nukeadmin" and clicking the "edit"
link.  Enjoy!

CONTRIBUTIONS
-------------

Up to this first release, all of the code has been developed by one
person.  In order to make the project as useful as possible, we are
looking for contributions to the project.  The main contributions
we are looking for are:

1.	New modules
2.	Internationalization (language translations)
3.	Suggestions for new features

If you think of a project that you would be interested in that
isn't in this list, please let us know through our message boards
or by e-mailing us at support@aspnuke.com.

Documentation will be coming soon on methods you can use to help
contribute in these areas.

WHERE TO GET HELP
-----------------

You can post any questions, comments or suggestions to our message
forum found on the main site at:

e-mail:  support@aspnuke.com.
forums:  http://www.aspnuke.com/forum/