Installing a Pre-packaged FarCry CMS


Here are the steps for setting up FarCry in your environment using files supplied to you by Daemon or a FarCry solution provider. These steps are slightly different to the normal ‘clean slate’ setup procedure.

Install Environment

  • Windows 2008 Server 32 bit with IIS 7.0
  • Microsoft SQL Server 2005
  • Adobe ColdFusion 9.0

Steps at a glance

  1. Create Database in MS SQL Server 2005
  2. Setup ColdFusion Admin Datasource for FarCry
  3. Download and unpack the farcry code base
  4. Configure IIS for FarCry access
  5. Setup and configure Friendly URL for FarCry

1. Create Database in MS SQL Server 2005

  • Create the database in MS SQL Server from the backup file
  • Create user with read/write access to the above database

2. Setup ColdFusion Admin Datasource for FarCry

  • Log into ColdFusion Admin
  • Create a new datasource using SQL Server driver
  • The data source name need to match the one used in the packaged solution
  • Test the connection to the database

3. Download and unpack the farcry code base

  • Unpack the code base in a directory/folder outside of the wwwroot folder
  • You should see these folders:
    • [install-root]/core/webtop/
    • [install-root]/projects/[project-name]/www/

4. Configure IIS for FarCry access

  • Point the website home directory or document root to: [install-root]/projects/[project-name]/www/
  • Create the ‘farcry’ IIS virtual directory (alias) pointing to [install-root]
  • Create the ‘webtop’ IIS virtual directory (alias) pointing to [install-root]/core/webtop/

5. Setup and configure Friendly URL for FarCry

  • Go to http://www.iis.net/extensions/URLRewrite and download the plugin
  • Stop the web server and the Windows Process Activation Service
  • Install the plugin
  • Restart the services
  • If you have IIS open, close it
  • Open IIS
  • Click on the website, then double click to open URL Rewrite
  • Add an Inbound Rules blank rule
  • Under Match URL
    • Requested URL: Matches the Pattern
    • Using: Regular expression
    • Pattern: ^([^\.]+)$
  • Under Conditions
    • Logical groupings: Match All
    • Click Add
    • Condition input: {URL}
    • Check if input string: Does Not Match the Pattern
    • Pattern: (^/farcry|^/webtop|^/flex2gateway|^/flashservices|^/cfide)($|/)
    • Uncheck Ignore case
  • Under Action
    • Action type: Rewrite
    • Action Properties: /index.cfm?furl=/{R:1}&{C:1}
    • Tick Append query string
    • Tick Stop processing of subsequent rules
  • Alternatively the rule can be imported and converted from the Apache version:
    • Open IIS
    • Select the website
    • Open URL Rewrite
    • Under Inbound Rules, click Import Rules…
    • In the Rewrite rules: box, copy and paste the following
      • RewriteCond %{REQUEST_URI} !(^/farcry|^/webtop|^/flex2gateway|^/flashservices|^/cfide)($|/)
        RewriteRule ^([^\.]+)$ /index.cfm?furl=/$1&%1 [L,PT,QSA]6. Click ‘Back to Rules’
    • Click Back to Rules
    • Select the rule and click on Rename to rename the generic name to an appropriate one
  • Test that Friendly URL has been successfully setup by visiting http://www.yoursite.com/pingFU
  • If successful, you should get an HTML page with these words: PING FU SUCCESS


Advertisements

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s