Dashboard > FarCry 5.0 Developers Guide (Fortress) > Home > FarCry Installation
Added by Blair McKenzie , last edited by Geoff Bowers on Feb 24, 2009  (view change)
Labels: 
(None)

Overview

The FarCry Installation guide should assist in basic scorched earth installations in addition to upgrading and migrating existing FarCry 4.0 projects.

Installer

The Fortress Release Requires An Updater

Fortress has a modified installer that accommodates all of the underlying schema changes that are part of the 5.0 release. You cannot use Fortress with an existing FarCry project without modification. Be sure to read through Upgrading From Earlier Versions if you have an existing installation.

Latest Build

Look for the most recent FarCry Community distribution here:
http://www.farcrycore.org/go/download

Simple Install From Webroot

  • Make sure you do not have a web mapping for /farcry (if you do, remove it now)
  • Download the latest milestone release (http://www.farcrycore.org/go/download)
  • Unpack the zip in to a folder called ./farcry under the webroot
  • You should have ./farcry/core, ./farcry/projects, ./farcry/plugins, ./farcry/skeletons when you are done
  • Create a blank database and point a datasource to it in CF Administrator
  • Browse to http://localhost/farcry or equivalent (you should be redirected to http://localhost/farcry/core/webtop/install)
  • Follow the installer instructions on your screen
  • Yep. It's that easy.
CRITICAL: Remove Old FarCry CF Mappings

If you are installing farcry framework under the webroot, make sure you do not have a coldfusion mapping for /farcry. This may be the case if you are installing on a server where a previous version of FarCry was installed.

There are four Deployment Configurations supported by the Fortress installer:

  • Standalone
  • Sub-Directory
  • Advanced: CF Mapping
  • Advanced: Web Server Mapping

Subversion

Watch this space...
  • download latest core
  • download skeleton
  • download plugins (note: webroots for plugins must be updated; manifest and application.cfc)

Install Case Studies

Contribute Your Case Study

If you have a case study of how you installed FarCry in your specific environment we'd love to hear about it. Please feel free to create a page describing your installation and set the parent to this page. A link will automatically appear in the list above

In step 6 of the Simple Install from Webroot, I receive error:

Could not import the tag library specified by "/farcry/core/tags/admin".
The following error was encountered: C:\Inetpub\wwwroot\farcry\core\tags\admin. Please ensure that you have specified a valid tag library.

The CFML compiler was processing:

  • a cfimport tag beginning on line 52, column 2.

The error occurred in C:\CFusionMX7\wwwroot\farcry\core\webtop\index.cfm: line 52

50 : <cfprocessingDirective pageencoding="utf-8" />
51 :
52 : <cfimport taglib="/farcry/core/tags/admin" prefix="admin" />
53 :
54 : <!--- Get sections --->

Any thoughts on a solution to this?

Posted by Anonymous at Aug 21, 2008 11:17 | Reply To This

Sounds an awful lot like you have an existing /farcry mapping in place. Confirm that any old /farcry mappings (both web virtuals and cf mappings) have been removed.

If I am installing FarCry on a remote machine, is the best way to deal with the IP address checking simply to comment out lines 6 through 9 in core/webtop/install/Application.cfm?

A better option is to add your IP address to the list of allowed IPs. Otherwise you need to remember to put the security check back in place once you have finished running the installer. It's often easier to build the app locally and deploy remotely, rather than trying to install remotely but it shouldn't matter either way.

Hi, just tried to do the stand alone install of version 5.0. The progress bar doesn't go, and the page just stops running at some point. I check the root, and the site is there....I can log in initially to farcry. When I'm in farcry if I click on the site tab, there appears to be a dump in the left side navigation area...

when I try to get into the admin with the farcry account from another machine, I am unable to login.

Any help would be appreciated.

Mark

Posted by Anonymous at Dec 17, 2008 03:01 | Reply To This

Hi Mark, i think you get a better response when you ask this kind of questions in the google groups:

Developer group: http://groups.google.com/group/farcry-dev (Developing Farcry)
User group: http://groups.google.com/group/farcry-user (Using Farcry)

Personally can't say 1 2 3 what this can be, but you might also provide more info about what your setup is like, dbtype, farcry version, etc etc.

Marco

I have the same issue as the first comment.

I'm new to Farcry, but not Coldfusion. I would like to give it a go, but . . .

The install process doesn't seem to be very well documented.

The installer never appears after browsing to the Farcry directory as it implies in the Simple Install.

I've downloaded the 5.0.2 package. It didn't have a projects folder as the Simple Install says it should.

I've been to the Google groups and the Wiki, but don't see documentation or comments about this issue.

I don't think this is a Farcry mappings issue as I've never installed Farcry before.

Does anyone have information about what I should do next?

Thanks,
Red

Posted by Anonymous at Feb 23, 2009 03:10 | Reply To This

It looks like the new build ANT task is missing the index.cfm in the root of /farcry. This simply pushes folks with no installation to ./farcry/core/webtop/install to run the installer. You can go direct to http://mydomain/farcry/core/webtop/install instead.

'Simple Install from Webroot' instructions no longer hold true for the 5.0.2 community release.

There is no ./farcry/projects folder in the zip.

There is nothing in the base folder (for example an index.cfm) that might perform the redirect
from http://localhost/farcry to http://localhost/farcry/core/webtop/install (and so it does not work that way).

However if I browse to the latter folder, then the install proceeds as it should.

This is on Vista Ultimate with iiS 6, CF 8

Wiki documentation (above) is oiut of date as is the PDF lesson set.
The lesson set is missing the 'Media' installation. (Is it intended that people be able to run the training course themselves ?)

Posted by Anonymous at Mar 03, 2009 10:48 | Reply To This

But of course 5.1.0 does have an index.cfm in the base of the tree, and so it might be expected the installation instructions will work, however I can say that out of the box, it does not.

I followed the instructions (first removing entirely the 5.0.2 installation and emptying out the database 5.0.2 created for itself.

I clicked on the link found in the Readme.html file to begin the installation. The installer prompted me to create a project and we are way.

However sadly that didn't happen right.
what I found was:
The specified directory attribute value C:\inetpub\wwwroot\/testproject could not be created.
The most likely cause of this error is that C:\inetpub\wwwroot\/testproject already exists on your file system. The exception occurred during a cfdirectory action="create".

Resources:
Enable Robust Exception Information to provide greater detail about the source of errors. In the Administrator, click Debugging & Logging > Debug Output Settings, and select the Robust Exception Information option.
Check the ColdFusion documentation to verify that you are using the correct syntax.
Search the Knowledge Base to find a solution to your problem.

Browser Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 6.0; GTB5; SLCC1; .NET CLR 2.0.50727; Media Center PC 5.0; WWTClient2; .NET CLR 3.5.21022; .NET CLR 3.5.30729; .NET CLR 3.0.30618)
Remote Address ::1
Referrer http://localhost/farcry/core/webtop/install/index.cfm
Date/Time 03-Mar-09 10:34 PM

Possibly talking to myself I feel... :

That remote address looks pretty wierd to me, and of course the folder name is screwed up.
Looks like I'm up for debugging someone elses code (again). Not exactly what I bargained on, as all I wanted to do was explore farcry and take it through the paces and see what it is about...
Talk about bleeding edge...
Seems like I've found why 5.0.2 still remains as the 'stable' release on the community download page. 5.0.2 installation worked, but procedure to do so was not what was/is documented.

So... If I begin again, clean out the farcrytest folder within projects and the webroot and then restart the installation process I find that farcry remembers all of my previous settings (implying that it stashed them somewhere in a file somewhere, because they could not have been in the database).
Now, with the only difference being that the projects subfolder under farcry now exists before starting install, I find that the installer seems to work as designed.

....

Posted by Bryn Parrott at Mar 04, 2009 00:18Updated by Bryn Parrott | Reply To This

Hi everyone,

I hope someone here be able to help me figure out the problem. I installed farcry 5.0.2 on the server by using Webserver Mapping method. After installing, I can login to webtop area on the server machine. But when I tried to login through other machine on the network. It always redirected me into login page. Is there everyone knowing how to fix this problem? Thank you.

Posted by Anonymous at Mar 25, 2009 01:28 | Reply To This

Hi, because there is no project setup yet Farcry automatically redirect to the install directory, just to be sure check the:

farcry\core\webtop\install\Application.cfm file

At the top on line 9 is this code:

<cfset variables.lAllowHosts = "127.0.0.1" />

Add the ip of the comps you want to allow to install farcry projects.

All computers can (once setup) connect and display projects on the server, only the comps that are listed in the lAllowHosts variable can install new projects.

I have been using the following for the Advanced Set up on Windows machines.

Windows Server 2003/XP/7, IIS6/7, CF8 & either MySQL or MS SQL

Farcry code installed to I:\Applications\Farcry5

So core code and projects are in
I:\\Applications\Farcry5\farcry\core
I:\ Applications\Farcry5\farcry\plugins
I:\ Applications\Farcry5\farcry\projects

No CF Mappings required

IIS Settings
1.    I use individual Host names for each site and map these to localhost/127.0.0.1 in the C:\Windows\System32\drivers\etc\hosts file
2.    FarCry Install Site, this will allow new sites to be created
e.g. fcInstall
Home directory I:\\Applications\Farcry5
3.    Each Farcry Site
Home directory I:\\Applications\Farcry5\farcry\projects\projectname\www
Virtual Directory farcry mapped to I:\ Applications\Farcry5\farcry
Virtual Directory webtop mapped to I:\ Applications\Farcry5\farcry\core\webtop

To install a new site,
1.    Create new database
2.    Create CF datasource
3.    in browser go to fcInstall and follow instructions
4.    Create IIS site and virtual directories

Hope this helps.

Powered by a free Atlassian Confluence Open Source Project License granted to FarCry CMS. Evaluate Confluence today.
Powered by Atlassian Confluence 2.7, the Enterprise Wiki. Bug/feature request - Atlassian news - Contact administrators