PageRenderTime 23ms CodeModel.GetById 15ms app.highlight 2ms RepoModel.GetById 2ms app.codeStats 0ms

/wheels/vendor/memcached/Installation.txt

http://cfwheels.googlecode.com/
Plain Text | 69 lines | 61 code | 8 blank | 0 comment | 0 complexity | 3e26a8f4d7d7a2e76a96d36d0e069826 MD5 | raw file
 1
 2****************************
 3Pre-Requisites
 4****************************
 5
 61. cfmx 8
 7	This has been tested with cfmx 8.  I think that the java client libraries are 
 8	put together using java 1.5, so if you aren't running coldfusion on java 1.5, then it's going to fail.
 9	if you try it on cf7 and it works, let me know.  I have been told that it does not work on cf7. if you 
10	are running on cf7, check out the memcached old version, as that one has been tested and works on cf7.
11
122. memcached server
13	You need a running version of memcached server to run this.  that's the storage 
14	vehicle.  if you don't have it, you won't get very far. you can get the memcached
15	server at:  
16		http://www.danga.com/memcached/  - BSD version - and most up to date.
17	You can also run on windows and it will work with that.  the windows port is available here:
18		http://jehiah.cz/projects/memcached-win32/
19	This version client of memcached has been tested with both versions.
203. memcached Java client -
21	You will need to have a java memcached client to be able to run this.  the java client libraries
22	have been included here for ease of use.  the client that is packaged with this library has been
23	tested and was the one that was developed against.  it will be updated as versions become available.
24	This CF client is based off of the client developed by Dustin Sallings located here:
25		http://bleu.west.spy.net/~dustin/projects/memcached/ - Thanks Dustin!
26	this client is the newer of the two clients. some people may prefer it, however if you wish
27	to have the older client, check out the other cfmemcached library - in the memcached directory.
28
29****************************
30Installation
31****************************
32
33you should be able to drop this into your coldfusion server and run it. 
34you will however notice that there are two directories in the root that say memcached and mecachednew.
35These directories contain two different versions of memcached.  the memcached/ directory contains
36the older of the two client libraries.  the memcachednew contains the newer verision.
37they both work well, however, just choose one. :)  There's nothing wrong with the older version, it works
38great.  the newer java client is however more optimized and contains the ability to do asyncronous sets
39and gets which could lead to better performance.  For coldfusion, the asyncronous gets might be of less
40use, but there are definately going to be instances where they will come in handy.
41
421. What you will likely want to do is figure out where in your web root you want put this, 
43	i suggest /memcached. and unzip the files into them.
442. *** if you don't want to use the java loader*** 
45	you might need to take the java jars the lib directory and put them in your coldfusion lib directory
46	<cfmxroot>/lib - the jars just need to be in your java classpath.  if you leave them where they 
47	are, you should be able to get to them.  they might not be in the best location but they will work.
48	I would suggest, leaving them where they are and making sure that the client works before moving 
49	them to a different location.  if you choose not to use the javaloader, using the client will require
50	a server restart.
513. if you haven't started your memcached server, this would be a good time to do it
524. you should be able to pull up the memcachedtest.cfm page which will run through a bunch of tests to 
53	make sure that your memcached server is set up correctly.  you will need to open the page up
54	and edit the ipaddress/url of the memcached server if it is not sitting on your local machine.
55	by default it is set up to look for the memcached server on the localhost:11211 port.  if you are
56	running memcached on a different port, make sure you change this.
575. Once you have made sure that memcached is working correctly, you will want to set it up so that
58	you are storing the memcached factory in the application or server scope and pulling out the memcached
59	client when you need it.  you don't want to have to keep creating the memcached client and the 
60	connection to the server.
61
62***************************
63support
64***************************
65
66if you have any questions, you can reach me at my blog:
67	http://www.flexablecoder.com
68or by email:
69	jon at Wokits dot com