Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

...

CFML Server

Version

Download

Adobe ColdFusion

8.0+

http://www.adobe.com/products/coldfusion/

Railo

3.3.0+

http://www.railo-technologiesgetrailo.comorg/
Info

OpenBD support is probably no not far off – give the community a shout if you are interested in this platform

...

Info
titleContact Daemon for Support Options
Note
titleOther Databases

You may have varying degrees of success with other database platforms or version numbers. Adding additional platform support is certainly possible, but talk to the community first before embarking on such an ambitious project.

...

Note
titleURL Rewrites

Your web server implementation will require some form of URL re-write engine in order to activate the FarCry Friendly URL sub-system. For example, mod_rewrite on Apache or an ISAPI Rewrite filter for IIS (several open and commercial options are available. https://farcry.jira.com/wiki/display/FCDEV50/Friendly+URLs

Installation Options

Info
titleDeployment Configurations

Detailed information on deployment options is available on the developer WIKI
http://farcry.jira.com/wiki/display/FCDEV50/Deployment+Configurations

...

An enterprise configuration that allows for an unlimited number of projects to share a single core framework and library of plugins. Sharing is done through common reference to specific ColdFusion mapping of /farcry.

Advanced Configuration (Webserver Mapping)

...

An enterprise configuration that allows for an unlimited number of projects to share a single core framework and library of plugins. Sharing is done through common reference to specific web server mapping (aka web virtual directory) of /farcry.

Tip
titleDaemon Commercial Support

Daemon provides commercial priority support offerings for installation, and ongoing operational maintenance.
http://www.daemon.com.au/

...

This course and its associated walkthroughs, labs and sample code are based on the following local development environment:

...

  • Railo 3.3 (Express Version)
  • H2
  • Resin

The courseware is based on a FarCry "Sub Directory" installation under the webroot of the local Apache web server. Please ensure that both the developer and the ColdFusion service have write permissions for the entire directory structure in which the FarCry solution is to be deployed.

...

titleOther Environments

...

Express demo installation, which has its own database and web server built-in.

Info
titleFarCry Express

Download the latest FarCry Express installation or a dedicated training installation provided by your instructor: http://www.farcrycore.org/builds/

Walkthrough: Installing Your Local Development Environment

The Jump Start course is suitable for any valid FarCry installation. The walkthrough details the "sub directory" FarCry Express demo installation as this is arguably the easiest to install (ie. you do not need to know how to configure the web server). Database references throughout the course assume MySQL 5.1the built-in H2 server, however, any supported database would be suitable for the course.

Tip
titleCheck Port 8888

When starting the FarCry Express edition, remember that the server runs on http://localhost:8888 and so you will need to ensure nothing else is running on this port when you start the server.

In this walkthrough you will install and configure your local development environment.:

  1. Copy FarCry Bundle into Webroot the FarCry Express installation onto your local development workstation (http://www.farcrycore.org/download)
  2. Copy Locate the local Demo Media into webroot (Course materials will be available from your Instructorand Docs folders (they should be located within the FarCry Express distribution)
  3. Create a development project in your IDE
    1. Open the Eclipse IDE installed on your desktop
    2. Create a CFEclipse Project from the webroot of your local web server installationFarCry Express installation; for example, INSTALL-ROOT/farcry-express-install/webroot
    3. Browse the project and make sure you can see all the relevant FarCry code base directories
    Create a database (suggested steps assume mySQL 5.1)
  4. Open MySQL Administrator
  5. Create a new blank database (aka Catalogue)
  6. Open the ColdFusion Administrator and create a MySQL datasource pointing to your newly minted database
  7. Your H2 database is already in place – there is no need for a database installation
  8. Start your FarCry Express installation (review the README.txt notes for specific instructions for your OS)
  9. Browse to http://localhost:8888/farcry
  10. FarCry should have detected that you need to install and redirected you to the installation wizard; if it hasn't speak now or forever hold your peace.
  11. Run through the Install Wizard
    1. Select Sub Directory Install

...

  1. webtop
Note
titleDouble Check That Everything is Working

Please ensure that your development environment is full functional before proceeding. This is critical for the success of the rest of the course. Friendly URLs will not work with the FarCry Express installation. This is a limitation of the Express demo only.

Tip
titleOther Environments

The course sample code should work in any operational environment that supports FarCry. However, the specific references in the walkthrough may need to be adjusted to reflect your actual development environment.