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/