Contents:

• Requirements
• Installation & Configuration
• Admin Console
• I.C.E. Concepts
• Create New Site
• Create New Channel
• Create New Page
• Create New Media
• Add I.C.E. Users
• Create New Component
• Create New Container
• Create New Language
• Create New Label
• Finding & Managing Site Assets
• Uploading Files
• I.C.E. Settings
• Send Messages
• Manage Tasks
• Custom Database Tables
• I.C.E. Widgets
• To Publish or Not?
• URL and Session Variables

Installation & Configuration

1. Installation

Installing I.C.E. is vey straight forward. Unzip the ZIP file into the root of the Web server you plan to use. This will unpack a single folder called 'ice' in your Web root. Common locations are:

IIS: C:\InetPub\wwwroot\ice
Coldfusion Built-in Web Server: c:\JRun4\servers\cfusion\cfusion-ear\cfusion-war\ice 

Note: If you mistakenly unzip the files into another folder, simply copy the 'ice' folder to your Web server's root.

2. Configuration

Database - Once the 'ice' folder has been placed in the root of your Web server, it's time to set up the database. In the ice/db/ folder is a SQL file called ice.sql. Depending on the tool you use to manage you MySQL database, you can install the database, either by importing the SQL file, or by copying the contents of the file into a query window and running the query. In either case, a database called 'ice' will be created with all the required tables.

After installing the database, navigate to the ice_settings table and modify the following settings to match you environment:

ice_path - (physical path to your I.C.E. installation e.g c:\inetpub\wwwroot\ice)
ice_url - (absolute URL to your I.C.E. folder e.g. http://127.0.0.1/ice)
db - (the Coldfusion datasource for I.C.E.; the default is 'ice')

email_account - (the email account used to send messages)
email_password - (the email account password)
email_server - (the SMTP server used to send e-mails)

Optional:

bounce_email_account - (catch-all email account for newsletter tracking)
bounce_email_password - (catch-all email account password)
bounce_email_server - (the POP server on which the catch-all e-mail account is set up)

Note: These settings can be further tuned from within the I.C.E. Admin Console

Datasource - Next, login to Coldfusion Administrator and create a MySQL 4.0/5 datasource called 'ice' or whatever you entered in the ice_settings table. Make sure that the datasource is verified.

Webserver - If you are using an external Web server such as IIS, it is recommended that you set up a Website or virtual server (call it 'ice' or 'admin' or whatever suits you) pointing to the 'ice' folder as entered for ice_url in the ice_settings database table. For example, if you ice_url was set to 'http://www.mydomain.com/ice', this needs to be reflected in you Web server set up. Later, you will also need to create indvidual websites or virtual servers pointing to the folders for any sites you create. These folders will be located under ice/sites/

Note: For development purposes you may use built-in server that comes with your coldfusion installation by moving the 'ice' folder to C:\JRun4\servers\cfusion\cfusion-ear\cfusion-war\ or equivalent depending on your Coldfusion 8 installation. Remember to specify the port for the Coldfusion webserver when accessing the CMS via the browser. E.g. http://127.0.0.1:8300/ice

Admin Console - To access the  Admin interface, simply use a Web browser to navigate to http://127.0.0.1/ice (IIS) or http://127.0.0.1:8300/ice (Coldfusion 8 Webserver) or the URL you specified in ice_url in the ice_settings database table. Login with the following default credentials E-mail: admin@admin.com Password: password. You can then change the password (browse users and click Edit), configure the CMS further by clicking on Settings in the Admin interface.