{"id":644,"date":"2011-05-31T21:21:15","date_gmt":"2011-06-01T01:21:15","guid":{"rendered":"http:\/\/hstore.cs.brown.edu\/?page_id=644"},"modified":"2013-06-03T10:44:33","modified_gmt":"2013-06-03T14:44:33","slug":"quick-start","status":"publish","type":"page","link":"https:\/\/hstore.cs.brown.edu\/documentation\/quick-start\/","title":{"rendered":"Quick Start"},"content":{"rendered":"<p id=\"top\" \/><div class=\"prevpage\"><B>\u00ab<\/B> <a href=\"https:\/\/hstore.cs.brown.edu\/documentation\/\" title=\"Documentation\">Documentation<\/a><\/div> <div class=\"nextpage\"><a href=\"https:\/\/hstore.cs.brown.edu\/documentation\/architecture-overview\/\" title=\"Architecture Overview\">Architecture Overview<\/a> <B>\u00bb<\/B><\/div><div style=\"clear:both;\"><\/div><\/p>\n<style type='text\/css'>\n   #publications-header {\n   border-top: 1px solid #CCC;\n   margin-top: 10px;\n   padding-top: 20px;\n}\n\t\t\t#gallery-1 {\n\t\t\t\tmargin: auto;\nwidth: 100%;\n\t\t\t}\n\t\t\t#gallery-1 .gallery-item {\n\t\t\t\tfloat: left;\n\t\t\t\tmargin-top: 10px;\n\t\t\t\ttext-align: center;\n\t\t\t\twidth: 100%;\t\t\t}\n\t\t\t#gallery-1 img {\n\t\t\t\tborder: 2px solid #cfcfcf;\n\t\t\t}\n\t\t\t#gallery-1 .gallery-caption {\n\t\t\t\tmargin-left: 0;\n\t\t\t}\n\t\t<\/style>\n<h2>Download<\/h2>\n<p>H-Store is open source and the latest version is available for download from the public <a href=\"https:\/\/github.com\/apavlo\/h-store\">Github repository<\/a>:<\/p>\n<pre>\r\ngit clone <strong><a href=\"https:\/\/github.com\/apavlo\/h-store\">git:\/\/github.com\/apavlo\/h-store.git<\/a><\/strong>\r\n<\/pre>\n<h2>Building<\/h2>\n<p>To build the entire H-Store database all at once, just execute the following command:<\/p>\n<pre>\r\nant <tt class=\"ant-target\">build<\/tt>\r\n<\/pre>\n<p>Note that H-Store will only compile on 64-bit platforms.<\/p>\n<h2>Environment Setup<\/h2>\n<p>Every machine in your H-Store cluster needs to have passwordless SSH logins enabled. This will allow the system to deploy the H-Store JVM on each host and execute the benchmark framework.<\/p>\n<pre>\r\nssh-keygen -t dsa # Do not enter in a password\r\ncat ~\/.ssh\/id_dsa.pub >> ~\/.ssh\/authorized_keys\r\n<\/pre>\n<p>See the <a href=\"\/deployment\/environment\">Environment Setup<\/a> documentation page for additional information.<\/p>\n<h2>Configuring H-Store<\/h2>\n<p>H-Store comes with pre-written benchmark applications that can be used for various experiments. The first step is to create a new catalog for the benchmark that you want to execute using the <tt class=\"ant-target\">hstore-prepare<\/tt> command:<\/p>\n<pre>\r\nant <tt class=\"ant-target\">hstore-prepare<\/tt> -Dproject=$BENCHMARK\r\n<\/pre>\n<p>The value of <tt>$BENCHMARK<\/tt> must be one of the <a href=\"\/documentation\/deployment\/benchmarks\">supported benchmark types<\/a> (e.g., <tt class=\"benchmark\">tpcc<\/tt>, <tt  class=\"benchmark\">tm1<\/tt>, <tt class=\"benchmark\">auctionmark<\/tt>, etc). This creates a new JAR file called &#8220;<tt class=\"file\">$BENCHMARK.jar<\/tt>&#8221; in root directory of the H-Store repository. <\/p>\n<p>By default, <tt class=\"ant-target\">hstore-prepare<\/tt> creates a catalog with a cluster of only one host (localhost) two sites, each with two partitions. You can use a <a href=\"\/documentation\/configuration\/cluster-file\">custom specification file<\/a> that defines the host\/site\/partition layout of the target cluster.<\/p>\n<h2>Running Benchmarks<\/h2>\n<p>To run a single node instance of H-Store for testing, you can use <tt class=\"ant-target\">hstore-benchmark<\/tt> command. This will launch an H-Store cluster at the nodes defined in project jar file and then execute the benchmark using a single client process.<\/p>\n<pre>ant <tt class=\"ant-target\">hstore-benchmark<\/tt> -Dproject=$BENCHMARK<\/pre>\n<p>For example, to run the TPC-C benchmark, replace the <tt>$BENCHMARK<\/tt> variable with <tt>tpcc<\/tt> and execute the following command:<\/p>\n<pre>ant <tt class=\"ant-target\">hstore-benchmark<\/tt> -Dproject=tpcc<\/pre>\n<p>If you need to override the <tt>localhost<\/tt> default, you can pass in the <a href=\"\/documentation\/configuration\/properties-file#global.defaulthost\" class=\"property\">global.defaulthost<\/a> parameter to <tt class=\"ant-target\">hstore-prepare<\/tt> when you built the project jar file:<\/p>\n<pre>\r\nant <tt class=\"ant-target\">hstore-prepare<\/tt> <tt class=\"ant-target\">hstore-benchmark<\/tt> \\\r\n    -Dproject=$BENCHMARK \\\r\n    -Dglobal.defaulthost=hostname.mit.edu\r\n<\/pre>\n<p>To run the benchmark client drivers in <tt>BenchmarkController<\/tt> on a different set of hosts, you can use the <a href=\"\/documentation\/configuration\/properties-file#client.host\" class=\"property\">client.host<\/a> parameter. This can be a comma-separated list if you would like to use multiple hosts. Note that it does not require you to re-generate the project jar file.<\/p>\n<pre>\r\nant <tt class=\"ant-target\">hstore-benchmark<\/tt> \\\r\n    -Dproject=$BENCHMARK \\\r\n    -Dclient.host=client0.mit.edu,client1.mit.edu,client2.mit.edu\r\n<\/pre>\n<h2>Additional Information<\/h2>\n<p><BR\/><\/p>\n<table id='gallery-1' class='gallery galleryid-8'>\n<tr>\n<td class='gallery-icon'><a href=\"\/slides\/hstore-introduction-2012.pdf\"><div id=\"attachment_1156\" style=\"width: 260px\" class=\"wp-caption aligncenter\"><img aria-describedby=\"caption-attachment-1156\" src=\"\/wordpress\/wp-content\/uploads\/2011\/05\/slides-hstore-introduction.png\" alt=\"\" title=\"H-Store Introduction\" width=\"200\" class=\"size-medium wp-image-1156\" \/><p id=\"caption-attachment-1156\" class=\"wp-caption-text\">H-Store Introduction<\/p><\/div><\/a><\/td>\n<td class='gallery-icon'><a href=\"\/slides\/hstore-running-2012.pdf\"><div id=\"attachment_1157\" style=\"width: 260px\" class=\"wp-caption aligncenter\"><img aria-describedby=\"caption-attachment-1157\" src=\"\/wordpress\/wp-content\/uploads\/2011\/05\/slides-hstore-running.png\" alt=\"\" title=\"Running H-Store\" width=\"200\" class=\"size-medium wp-image-1116\" \/><p id=\"caption-attachment-1157\" class=\"wp-caption-text\">Running H-Store<\/p><\/div><\/a><\/td>\n<\/tr>\n<\/table>\n<p><div class=\"prevpage\"><B>\u00ab<\/B> <a href=\"https:\/\/hstore.cs.brown.edu\/documentation\/\" title=\"Documentation\">Documentation<\/a><\/div> <div class=\"nextpage\"><a href=\"https:\/\/hstore.cs.brown.edu\/documentation\/architecture-overview\/\" title=\"Architecture Overview\">Architecture Overview<\/a> <B>\u00bb<\/B><\/div><div style=\"clear:both;\"><\/div> <\/p>\n","protected":false},"excerpt":{"rendered":"<p>Download H-Store is open source and the latest version is available for download from the public Github repository: git clone git:\/\/github.com\/apavlo\/h-store.git Building To build the entire H-Store database all at once, just execute the following command: ant build Note that H-Store will only compile on 64-bit platforms. Environment Setup Every machine in your H-Store cluster [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":0,"parent":217,"menu_order":-99,"comment_status":"closed","ping_status":"closed","template":"","meta":[],"_links":{"self":[{"href":"https:\/\/hstore.cs.brown.edu\/wp-json\/wp\/v2\/pages\/644"}],"collection":[{"href":"https:\/\/hstore.cs.brown.edu\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/hstore.cs.brown.edu\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/hstore.cs.brown.edu\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/hstore.cs.brown.edu\/wp-json\/wp\/v2\/comments?post=644"}],"version-history":[{"count":17,"href":"https:\/\/hstore.cs.brown.edu\/wp-json\/wp\/v2\/pages\/644\/revisions"}],"predecessor-version":[{"id":2169,"href":"https:\/\/hstore.cs.brown.edu\/wp-json\/wp\/v2\/pages\/644\/revisions\/2169"}],"up":[{"embeddable":true,"href":"https:\/\/hstore.cs.brown.edu\/wp-json\/wp\/v2\/pages\/217"}],"wp:attachment":[{"href":"https:\/\/hstore.cs.brown.edu\/wp-json\/wp\/v2\/media?parent=644"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}