How to set up a Far Cry Development Environment

I just spent 2 days trying to get Farcry to install without making major modifications to the code. The two modifications that are left will not impact the code and both are documented in the farcry-beta forums.

This document assumes that you are installing FarCry as a development platform to play with in preparation to helping with the fusebox web site and that you are not going to be running any other farcry sites at the same time. I tried that, I failed.

Please follow these steps in the order described and exactly. If you are going to change the name of the fusebox directory, make sure that you are consistent across all steps.

Download Farcry

Download Farcry from the Nightly builds available at http://www.jeffcoughlin.com/?pg=11. Download the Farcry 4.0 Beta Zips (farcry_core, fourq, and farcry_mollio). Also download the farcry_lib.farcrycms file from the Farcry 4.0 Libraries.

Create a Directory Structure

I'm going to use the directory setup I set it up with which was d:\wwwroot. While, you can place this anywhere you want, make sure that you substitute your particular directory structure for d:\wwwroot throughout the rest of these instructions.

Under d:\wwwroot, create the following subdirectories:

d:\wwwroot\farcry

d:\wwwroot\farcry\farcry_core

d:\wwwroot\farcry\farcry_lib\farcrycms

d:\wwwroot\farcry\fourq

d:\wwwroot\farcry\fuseboxorg

Unzip Files to this directory structure

  • Unzip farcryNightlyBuild-farcry_core-trunk.zip to d:\wwwroot\farcry\farcry_core
  • Unzip farcryNightlyBuild-farcry_lib.farcrycms-trunk.zip to d:\wwwroot\farcry\farcry_lib\farcrycms
  • Unzip farcryNightlyBuild-fourq-trunk.zip to d:\wwwroot\farcry\fourq
  • Unzip farcryNightlyBuild-farcry_mollio-trunk.zip to d:\wwwroot\farcry\fuseboxorg

Set up Virtual Directories

Set up the following virtual directories:

  • farcry pointing to D:\wwwroot\farcry\farcry_core\admin
  • fuseboxorg pointing to D:\wwwroot\farcry\fuseboxorg\www
  • fuseboxorg/farcry pointing to D:\wwwroot\farcry\farcry_core\admin

If you are using ColdFusion without IIS (i.e., using the built in JRun web server), you need to setup virtual mappings in the WEB-INF/jrun-web.xml file. Near the end of that file, after the virtual mapping for /WEB-INF, add this XML: 

  <virtual-mapping>
    <resource-path>/farcry</resource-path>
    <system-path>D:/CFusionMX7/wwwroot/farcry/farcry_core/admin</system-path>
  </virtual-mapping>

  <virtual-mapping>
    <resource-path>/fuseboxorg</resource-path>
    <system-path>D:/CFusionMX7/wwwroot/farcry/fuseboxorg/www</system-path>
  </virtual-mapping>

  <virtual-mapping>
    <resource-path>/fuseboxorg/farcry</resource-path>
    <system-path>D:/CFusionMX7/wwwroot/farcry/farcry_core/admin</system-path>
  </virtual-mapping>

Database Setup

Create a database in your Program of choice. Farcry supports Oracle, MySql, SQL Server and PostreSQL

ColdFusion Admin Settings

Setup a DSN in the administrator called fusebox. Make sure ColdFusion can connect to it.

Set up the following ColdFusion Mapping

farcry pointing to d:\wwwroot\farcry

First Farcry Code Modification

There is a bug in the installer that will stop you from installing. So open D:\wwwroot\farcry\fuseboxorg\www\install\FlightCheck.cfc. Scroll down to line 194.

Change
<cfinclude template="/install/ping/index.cfm" /> to
<cfinclude template="ping/index.cfm" />

Install Farcry

Point your web browser to http://localhost/fuseboxorg/install.

Fill out this form with the following information:

  • Application Name: fuseboxorg
  • Project DSN fusebox
  • Database Type *Choose your database*
  • Database Owner * I choose dbo. Your mileage may vary depending on the db*
  • Project Web Mapping /fuseboxorg
  • Farcry Web Mapping /fuseboxorg/farcry
  • Make sure farcrycms is checked.

Hit the "Install button" - If the intallation process times out, then just hit reload.

Second Farcry Code Modification

Once you have a successful installation, but before you do anything else. Open D:\wwwroot\farcry\fuseboxorg\www\Application.cfm

In the <farcry:farcryInit Tag, add the following to the bottom (before the /> )

  • ProjectURL="/fuseboxorg"

Stop and then Restart the ColdFusion Server

Gotta do it to make sure this fix takes

Launch Development Site

Hit the URL /fuseboxorg in your browser.

If you get a styled site, you are good to go. If you get a plain site, then check your source and make sure that the href for a css link says "href="/fuseboxorg/css/". If it doesn't, correct the ProjectURL variable in Application.cfm and stop and restart the ColdFusion server until it does.

Launch Farcry Admin

Hit the URL /fuseboxorg/farcry in your browser. The default login will be username farcry / password farcry (I couldn't find that anywhere in the documentation - Sean Corfield)

You should now be good to go.

Integrating FarCry and fusebox.org

If you're feeling adventurous, you can now attempt to follow Sean Corfield's instructions on how to integrate the old fusebox.org site into your new FarCry installation!

Disclaimer from Sandy

I am not a Farcry person. Never did anything with it before. But I am stubborn. A much better place to get farcry help (even if its a bit vague) are the farcry forums listed earlier in this article.