Dear Wiki user, You have subscribed to a wiki page or wiki category on "Cassandra Wiki" for change notification.
The "GettingStarted" page has been changed by johanoskarsson. http://wiki.apache.org/cassandra/GettingStarted?action=diff&rev1=25&rev2=26 -------------------------------------------------- Cassandra is an advanced topic, and while work is always underway to make things easier, it can still be daunting to get up and running for the first time. This document aims to provide a few easy to follow steps to take the first-time user from installation, to an operational Cassandra cluster. <<Anchor(picking_a_version)>> + == Step 1: Picking a version == At any given time, there are a number of different versions available for install: === Stable releases === - Cassandra stable releases are well tested and reasonably free of serious problems, (or at least the problems are known and well documented). If you are setting up a production environment, a stable release is what you want. + Cassandra stable releases are well tested and reasonably free of serious problems, (or at least the problems are known and well documented). If you are setting up a production environment, a stable release is what you want. Download links for the latest stable release can always be found on the [[http://incubator.apache.org/cassandra/#download|website]]. @@ -20, +21 @@ ## * [[http://www.apache.org/dyn/closer.cgi?path=/incubator/cassandra/0.5.0/apache-cassandra-incubating-0.5.0-rc3-bin.tar.gz|apache-cassandra-incubating-0.5.0-rc3-bin.tar.gz]] [ [[http://www.apache.org/dist/incubator/cassandra/0.5.0/apache-cassandra-incubating-0.5.0-rc3-bin.tar.gz.asc|PGP]] ] [ [[http://www.apache.org/dist/incubator/cassandra/0.5.0/apache-cassandra-incubating-0.5.0-rc3-bin.tar.gz.md5|MD5]] ] [ [[http://www.apache.org/dist/incubator/cassandra/0.5.0/apache-cassandra-incubating-0.5.0-rc3-bin.tar.gz.sha|SHA]] ] ## * [[http://www.apache.org/dyn/closer.cgi?path=/incubator/cassandra/0.5.0/apache-cassandra-incubating-0.5.0-rc3-src.tar.gz|apache-cassandra-incubating-0.5.0-rc3-src.tar.gz]] [ [[http://www.apache.org/dist/incubator/cassandra/0.5.0/apache-cassandra-incubating-0.5.0-rc3-src.tar.gz.asc|PGP]] ] [ [[http://www.apache.org/dist/incubator/cassandra/0.5.0/apache-cassandra-incubating-0.5.0-rc3-src.tar.gz.md5|MD5]] ] [ [[http://www.apache.org/dist/incubator/cassandra/0.5.0/apache-cassandra-incubating-0.5.0-rc3-src.tar.gz.sha|SHA]] ] ## - ##When downloading from a mirror, please be sure to verify the checksums and OpenPGP compatible signature (see the MD5, SHA1, and PGP links above). The [[http://www.apache.org/dist/incubator/cassandra/KEYS|KEYS]] file contains the public key(s) used for signing releases. + ##When downloading from a mirror, please be sure to verify the checksums and OpenPGP compatible signature (see the MD5, SHA1, and PGP links above). The [[http://www.apache.org/dist/incubator/cassandra/KEYS|KEYS]] file contains the public key(s) used for signing releases. - === Nightly builds === - Nightly builds represent the current state of development as of the time of the build. They contain all of the previous days new features, fixes, and newly introduced bugs. The only guarantee they come with is that they successfully build and the unit tests pass. Nightly builds are a handy way of testing recent changes, or accessing the latest features and fixes not found in beta or release candidates, but there is some risk of them being buggy. + Nightly builds represent the current state of development as of the time of the build. They contain all of the previous days new features, fixes, and newly introduced bugs. The only guarantee they come with is that they successfully build and the unit tests pass. Nightly builds are a handy way of testing recent changes, or accessing the latest features and fixes not found in beta or release candidates, but there is some risk of them being buggy. The most recent nightly build can be downloaded [[http://hudson.zones.apache.org/hudson/job/Cassandra/lastSuccessfulBuild/artifact/cassandra/build/|here]]. @@ -33, +33 @@ Instructions for checking out the source code can always be found on the [[http://incubator.apache.org/cassandra/#download|website]]. <<Anchor(running_a_single_node)>> + == Step 2: Running a single node == Cassandra is meant to run on a cluster of nodes, but will run equally well on a single machine. This is a handy way of getting familiar with the software while avoiding the complexities of a larger system. @@ -56, +57 @@ {{{ eev...@achilles:~$ bin/nodetool -host 98.139.220.175 ring Address Status Load Range Ring - 169048975998562660269742699624378098572 + 169048975998562660269742699624378098572 98.139.220.175 Up 0.02 GB 14183696824377310051808173385764689249 |<--| 98.139.169.152 Up 0.4 GB 28356863910078205288614550619314017621 | ^ 98.139.220.176 Up 0.13 GB 42530828068625072228863933889289238187 |-->| }}} + Advanced cluster management is described in [[Operations]]. - Advanced cluster management is described in [[Operations]]. + If you don't yet have access to hardware for a Cassandra cluster you can try it out on EC2 with [[Cassandra EC2]]. == Step 4: Write your application == Cassandra uses [[http://incubator.apache.org/thrift/|Thrift]] for it's external client facing API. Thrift supports a [[http://svn.apache.org/viewvc/incubator/thrift/trunk/lib/|wide variety of languages]] so you can code your application to use Thrift directly, or use a [[http://wiki.apache.org/cassandra/ClientExamples|high-level client]] where available. Be sure to read the documentation on the [[http://wiki.apache.org/thrift|Thrift wiki]], and checkout the Cassandra-specific examples in ClientExamples before getting started. <<Anchor(if_something_goes_wrong)>> + == If Something Goes Wrong == If you followed the steps in this guide and failed to get up and running, we'd love to help. Here's what we need. @@ -79, +82 @@ Finally, post a message with all relevant details to the list ([[mailto:[email protected]|subscription required]]), or hop onto [[http://webchat.freenode.net/?channels=#cassandra|IRC]] (network irc.freenode.net, channel #cassandra) and let us know. + <<BR>> <<BR>> - <<BR>> - <<BR>> ---- '''Footnotes:'''
