hadoop-common-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Apache Wiki <wikidi...@apache.org>
Subject [Hadoop Wiki] Update of "Hbase/Stargate" by AndrewPurtell
Date Sun, 06 Jun 2010 07:19:22 GMT
Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Hadoop Wiki" for change notification.

The "Hbase/Stargate" page has been changed by AndrewPurtell.
http://wiki.apache.org/hadoop/Hbase/Stargate?action=diff&rev1=4&rev2=5

--------------------------------------------------

  <<Anchor(2)>>
  == Deployment ==
  
- === Daemon ===
- 
  Stargate can run as a daemon which starts an embedded Jetty servlet container and deploys
the servlet into it. 
  
  
-  1. Place the Stargate jar in either the HBase installation root directory or lib/ directories.
- 
-  1. Copy the jars from contrib/stargate/lib/ into the lib/ directory of the HBase installation.
- 
-  1. Start the embedded Jetty servlet container: 
+ Start the embedded Jetty servlet container: 
  
-     In the foreground:<<BR>><<BR>>
+ In the foreground:
-     {{{ % ./bin/hbase org.apache.hadoop.hbase.stargate.Main -p <port> }}}<<BR>><<BR>>
+     {{{ % ./bin/hbase org.apache.hadoop.hbase.rest.Main -p <port> }}}<<BR>><<BR>>
-     where <port> is optional, and is the port the connector should listen on. (Default
is 8080.)<<BR>><<BR>>
+     where <port> is optional, and is the port the connector should listen on. (Default
is 8080.)<<BR>>
-     In the background: <<BR>><<BR>>
+ 
+ In the background:
-     {{{ % ./bin/hbase-daemon.sh start org.apache.hadoop.hbase.stargate.Main -p <port>}}}
<<BR>><<BR>>
+     {{{ % ./bin/hbase-daemon.sh start org.apache.hadoop.hbase.rest.Main -p <port>}}}
<<BR>><<BR>>
      where <port> is optional, and is the port the connector should listen on. (Default
is 8080.) 
- 
- === Servlet ===
- 
- Stargate is also packaged as a Java web application (WAR) which can be deployed into any
servlet API compliant container, such as Tomcat, Jetty, Glassfish, etc. 
- 
-  1. Copy the HBase jar from the HBase installation root directory and all jars from the
HBase lib/ and contrib/stargate/lib/ directories to somewhere on the servlet container's classpath,
into a shared deployment lib directory for example.
- 
-  1. Drop the Stargate WAR where container expects it.
- 
-  1. Configure the servlet. An example for Jetty follows: 
- 
- '''web.xml'''
- {{{
- <!DOCTYPE web-app PUBLIC
- "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
- "http://java.sun.com/dtd/web-app_2_3.dtd">
-  
- <web-app>
-     <display-name>
-         HBase Stargate
-     </display-name>
-     
-     <servlet>
-         <servlet-name>api</servlet-name>
-         <servlet-class>org.apache.hadoop.hbase.stargate.RESTServlet</servlet-class>
-         <load-on-startup>1</load-on-startup>
-         
-         <init-param>
-             <param-name>com.sun.jersey.config.property.packages</param-name>
-             <param-value>org.apache.hadoop.hbase.stargate</param-value>
-         </init-param>
-         <init-param>
-             <param-name>com.sun.jersey.config.property.resourceConfigClass</param-name>
-             <param-value>com.sun.jersey.api.core.PackagesResourceConfig</param-value>
-         </init-param>
-     </servlet>
-     
-     <servlet-mapping>
-         <servlet-name>api</servlet-name>
-         <url-pattern>/*</url-pattern>
-     </servlet-mapping>
- </web-app>
- }}}
- 
- 
- '''jetty.xml'''
- {{{
- <!DOCTYPE Configure PUBLIC "-//Mort Bay Consulting//DTD Configure//EN" 
-     "http://jetty.mortbay.org/configure.dtd">
-  
- <Configure id="Server" class="org.mortbay.jetty.Server">
-     <Call name="addConnector">
-         <Arg>
-             <New class="org.mortbay.jetty.nio.SelectChannelConnector">
-                 <Set name="port">
-                     8080
-                 </Set>
-             </New>
-         </Arg>
-     </Call>
-     
-     <Set name="handler">
-         <New id="Handlers" class="org.mortbay.jetty.handler.HandlerCollection">
-             <Array type="org.mortbay.jetty.Handler">
-                 <Set name="handlers">
-                     <Item>
-                         <New id="Contexts" class="org.mortbay.jetty.handler.ContextHandlerCollection"/>
-                     </Item>
-                 </Set>
-             </Array>
-         </New>
-     </Set>
-     
-     <Call name="addLifeCycle">
-         <Arg>
-             <New class="org.mortbay.jetty.deployer.WebAppDeployer">
-                 <Set name="contexts">
-                     <Ref id="Contexts"/>
-                 </Set>
-                 <Set name="webAppDir">
-                     <SystemProperty name="jetty.home" default="."/>/webapps
-                 </Set>
-             </New>
-         </Arg>
-     </Call>
- </Configure>
- }}}
  
  <<Anchor(3)>>
  == Representational State Transfer ==
@@ -147, +55 @@

  
  RFC 3968 defines URL syntax: 
  
- {{{
- scheme://user:pass@example.net:8080/path/to/file;type=foo?name=val#frag
+ {{{scheme://user:pass@example.net:8080/path/to/file;type=foo?name=val#frag }}}<<BR>>
- \_____/  \_______/\___________/\__/\______/\____/\______/\________/\___/
+ {{{\_____/  \_______/\___________/\__/\______/\____/\______/\________/\___/ }}}<<BR>>
-    |         |          |       |     |      |       |       |       |
+ {{{   |         |          |       |     |      |       |       |       | }}}<<BR>>
-  scheme   userinfo  hostname  port  path  filename param   query fragment
+ {{{ scheme   userinfo  hostname  port  path  filename param   query fragment }}}<<BR>>
-          \________________________/
+ {{{         \________________________/ }}}<<BR>>
-                   authority
+ {{{                  authority }}}<<BR>>
- }}}
  
  Stargate exposes HBase tables, rows, cells, and metadata as URL specified resources. 
  
  === Addressing for cell or row query (GET) ===
  
+ {{{path := '/' <table> }}}<<BR>>
+ {{{        '/' <row> }}}<<BR>>
-     {{{
- path := '/' <table>
-         '/' <row>
-         ( '/' ( <column> ( ':' <qualifier> )?
+ {{{        ( '/' ( <column> ( ':' <qualifier> )? }}}<<BR>>
-                 ( ',' <column> ( ':' <qualifier> )? )+ )?
+ {{{                ( ',' <column> ( ':' <qualifier> )? )+ )? }}}<<BR>>
-             ( '/' ( <start-timestamp> ',' )? <end-timestamp> )? )?
+ {{{            ( '/' ( <start-timestamp> ',' )? <end-timestamp> )? )? }}}<<BR>>
- query := ( '?' 'v' '=' <num-versions> )? }}}
+ {{{query := ( '?' 'v' '=' <num-versions> )? }}}<<BR>>
  
  === Addressing for single value store (PUT) ===
  
  Address with table, row, column (and optional qualifier), and optional timestamp. 
  
-     {{{
- path := '/' <table> '/' <row> '/' <column> ( ':' <qualifier> )?
+ {{{path := '/' <table> '/' <row> '/' <column> ( ':' <qualifier>
)? }}}<<BR>>
-           ( '/' <timestamp> )? }}}
+ {{{          ( '/' <timestamp> )? }}}<<BR>>
  
  === Addressing for multiple (batched) value store (PUT) ===
  
-     {{{
- path := '/' <table> '/' <false-row-key> }}}
+ {{{path := '/' <table> '/' <false-row-key> }}}
  
  === Addressing for row, column, or cell DELETE ===
  
-     {{{
- path := '/' <table> 
+ {{{path := '/' <table> }}}<<BR>>
-         '/' <row>
+ {{{        '/' <row> }}}<<BR>>
-         ( '/' <column> ( ':' <qualifier> )?
+ {{{        ( '/' <column> ( ':' <qualifier> )? }}}<<BR>>
-           ( '/' <timestamp> )? )? }}}
+ {{{          ( '/' <timestamp> )? )? }}}<<BR>>
  
  === Addressing for table creation or schema update (PUT or POST), schema query (GET), or
delete (DELETE) ===
  
-     {{{
- path := '/' <table> / 'schema' }}}
+ {{{path := '/' <table> / 'schema' }}}
  
  === Addressing for scanner creation (POST) ===
  
-     {{{
- path := '/' <table> '/' 'scanner' }}}
+ {{{path := '/' <table> '/' 'scanner' }}}
  
  === Addressing for scanner next item (GET) ===
  
-     {{{
- path := '/' <table> '/' 'scanner' '/' <scanner-id> }}}
+ {{{path := '/' <table> '/' 'scanner' '/' <scanner-id> }}}
  
  === Addressing for scanner deletion (DELETE) ===
  
-     {{{
- path := '/' <table> '/' '%scanner' '/' <scanner-id> }}}
+ {{{path := '/' <table> '/' '%scanner' '/' <scanner-id> }}}
  
  
  <<Anchor(5)>>

Mime
View raw message