Versions Compared

Old Version 3

changes.mady.by.user Geoff Bowers

Saved on

compared with

New Version 4

changes.mady.by.user Geoff Bowers

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Database

Version

Download

MS SQL

2000+

http://www.microsoft.com/Sqlserver/2005/en/us/express.aspx

MySQL

4.1+

http://dev.mysql.com/downloads/mysql/

H2  

Railo Express

http://www.h2database.com/

...

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

Code Block
/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

Code Block
/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:

  • Adobe ColdFusion (Developer Edition)
  • MySQL 5.1
  • Apache 2.x
  • Eclipse IDERailo 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 (http://www.farcrycore.org/download)
  2. Copy Demo Media into webroot (Course materials will be available from your Instructor)
  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 installation
    3. Browse the project and make sure you can see all the relevant FarCry code base directories
  4. Create a database (suggested steps assume mySQL 5.1)
    1. Open MySQL Administrator
    2. Create a new blank database (aka Catalogue)
    3. Open the ColdFusion Administrator and create a MySQL datasource pointing to your newly minted database
  5. Browse to http://localhost/farcry
  6. 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.
  7. Run through the Install Wizard
    1. Select Sub Directory Install
Note
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.

Note

Please ensure that your development environment is full functional before proceeding. This is critical for the success of the rest of the course.