diff options
Diffstat (limited to 'src/ceph/doc/dev/dev_cluster_deployement.rst')
| -rw-r--r-- | src/ceph/doc/dev/dev_cluster_deployement.rst | 121 |
1 files changed, 0 insertions, 121 deletions
diff --git a/src/ceph/doc/dev/dev_cluster_deployement.rst b/src/ceph/doc/dev/dev_cluster_deployement.rst deleted file mode 100644 index 0e6244e..0000000 --- a/src/ceph/doc/dev/dev_cluster_deployement.rst +++ /dev/null @@ -1,121 +0,0 @@ -================================= - Deploying a development cluster -================================= - -In order to develop on ceph, a Ceph utility, -*vstart.sh*, allows you to deploy fake local cluster for development purpose. - -Usage -===== - -It allows to deploy a fake local cluster on your machine for development purpose. It starts rgw, mon, osd and/or mds, or all of them if not specified. - -To start your development cluster, type the following:: - - vstart.sh [OPTIONS]... - -In order to stop the cluster, you can type:: - - ./stop.sh - -Options -======= - -.. option:: -i ip_address - - Bind to the specified *ip_address* instead of guessing and resolve from hostname. - -.. option:: -k - - Keep old configuration files instead of overwritting theses. - -.. option:: -l, --localhost - - Use localhost instead of hostanme. - -.. option:: -m ip[:port] - - Specifies monitor *ip* address and *port*. - -.. option:: -n, --new - - Create a new cluster. - -.. option:: -o config - - Add *config* to all sections in the ceph configuration. - -.. option:: --nodaemon - - Use ceph-run as wrapper for mon/osd/mds. - -.. option:: --smallmds - - Configure mds with small limit cache size. - -.. option:: -x - - Enable Cephx (on by default). - -.. option:: -X - - Disable Cephx. - -.. option:: -d, --debug - - Launch in debug mode - -.. option:: --valgrind[_{osd,mds,mon}] 'valgrind_toolname [args...]' - - Launch the osd/mds/mon/all the ceph binaries using valgrind with the specified tool and arguments. - -.. option:: --bluestore - - Use bluestore as the objectstore backend for osds - -.. option:: --memstore - - Use memstore as the objectstore backend for osds - -.. option:: --cache <pool> - - Set a cache-tier for the specified pool - - -Environment variables -===================== - -{OSD,MDS,MON,RGW} - -Theses environment variables will contains the number of instances of the desired ceph process you want to start. - -Example: :: - - OSD=3 MON=3 RGW=1 vstart.sh - - -============================================================ - Deploying multiple development clusters on the same machine -============================================================ - -In order to bring up multiple ceph clusters on the same machine, *mstart.sh* a -small wrapper around the above *vstart* can help. - -Usage -===== - -To start multiple clusters, you would run mstart for each cluster you would want -to deploy, and it will start monitors, rgws for each cluster on different ports -allowing you to run multiple mons, rgws etc. on the same cluster. Invoke it in -the following way:: - - mstart.sh <cluster-name> <vstart options> - -For eg:: - - ./mstart.sh cluster1 -n -r - - -For stopping the cluster, you do:: - - ./mstop.sh <cluster-name> |