Return-Path: X-Original-To: apmail-accumulo-commits-archive@www.apache.org Delivered-To: apmail-accumulo-commits-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id BFDD21086B for ; Thu, 18 Jul 2013 22:47:55 +0000 (UTC) Received: (qmail 82298 invoked by uid 500); 18 Jul 2013 22:47:55 -0000 Delivered-To: apmail-accumulo-commits-archive@accumulo.apache.org Received: (qmail 82202 invoked by uid 500); 18 Jul 2013 22:47:55 -0000 Mailing-List: contact commits-help@accumulo.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@accumulo.apache.org Delivered-To: mailing list commits@accumulo.apache.org Received: (qmail 82189 invoked by uid 500); 18 Jul 2013 22:47:55 -0000 Delivered-To: apmail-incubator-accumulo-commits@incubator.apache.org Received: (qmail 82181 invoked by uid 99); 18 Jul 2013 22:47:55 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 18 Jul 2013 22:47:55 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=5.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 18 Jul 2013 22:47:50 +0000 Received: from eris.apache.org (localhost [127.0.0.1]) by eris.apache.org (Postfix) with ESMTP id D998E2388C32 for ; Thu, 18 Jul 2013 22:46:44 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r870045 [18/24] - in /websites/staging/accumulo/trunk/content: ./ 1.4/examples/ 1.4/user_manual/ 1.5/examples/ css/ downloads/ example/ governance/ user_manual_1.3-incubating/ user_manual_1.3-incubating/examples/ Date: Thu, 18 Jul 2013 22:46:39 -0000 To: accumulo-commits@incubator.apache.org From: buildbot@apache.org X-Mailer: svnmailer-1.0.9 Message-Id: <20130718224644.D998E2388C32@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Modified: websites/staging/accumulo/trunk/content/user_manual_1.3-incubating/Accumulo_Shell.html ============================================================================== --- websites/staging/accumulo/trunk/content/user_manual_1.3-incubating/Accumulo_Shell.html (original) +++ websites/staging/accumulo/trunk/content/user_manual_1.3-incubating/Accumulo_Shell.html Thu Jul 18 22:46:37 2013 @@ -17,7 +17,7 @@ See the License for the specific language governing permissions and limitations under the License. --> - + Apache Accumulo User Manual: Accumulo Shell @@ -48,30 +48,31 @@

Project

Community

Development

Documentation

ASF links

    @@ -83,13 +84,12 @@
    - ™ +

    Apache Accumulo User Manual: Accumulo Shell

    -

    Next: Writing Accumulo Clients Up: Apache Accumulo User Manual Version 1.3 Previous: Accumulo Design Contents
    -

    +

    Next: Writing Accumulo Clients Up: Apache Accumulo User Manual Version 1.3 Previous: Accumulo Design Contents

    Subsections

    • Basic Administration
    • @@ -100,16 +100,16 @@

      Accumulo Shell

      Accumulo provides a simple shell that can be used to examine the contents and configuration settings of tables, apply individual mutations, and change configuration settings.

      The shell can be started by the following command:

      -
      $ACCUMULO_HOME/bin/accumulo shell -u [username]
      +
      $ACCUMULO_HOME/bin/accumulo shell -u [username]
       

      The shell will prompt for the corresponding password to the username specified and then display the following prompt:

      Shell - Apache Accumulo Interactive Shell
       -
      -- version 1.3
      -- instance name: myinstance
      -- instance id: 00000000-0000-0000-0000-000000000000
      +- version 1.3
      +- instance name: myinstance
      +- instance id: 00000000-0000-0000-0000-000000000000
       -
       - type 'help' for a list of available commands
       -
      @@ -118,80 +118,80 @@
       
       

      Basic Administration

      The Accumulo shell can be used to create and delete tables, as well as to configure table and instance specific options.

      -
      root@myinstance> tables
      -!METADATA
      +
      root@myinstance> tables
      +!METADATA
       
      -root@myinstance> createtable mytable
      +root@myinstance> createtable mytable
       
      -root@myinstance mytable>
      +root@myinstance mytable>
       
      -root@myinstance mytable> tables
      -!METADATA
      +root@myinstance mytable> tables
      +!METADATA
       mytable
       
      -root@myinstance mytable> createtable testtable
      +root@myinstance mytable> createtable testtable
       
      -root@myinstance testtable>
      +root@myinstance testtable>
       
      -root@myinstance junk> deletetable testtable
      +root@myinstance junk> deletetable testtable
       
      -root@myinstance>
      +root@myinstance>
       

      The Shell can also be used to insert updates and scan tables. This is useful for inspecting tables.

      -
      root@myinstance mytable> scan
      +
      root@myinstance mytable> scan
       
      -root@myinstance mytable> insert row1 colf colq value1
      +root@myinstance mytable> insert row1 colf colq value1
       insert successful
       
      -root@myinstance mytable> scan
      -row1 colf:colq [] value1
      +root@myinstance mytable> scan
      +row1 colf:colq [] value1
       

      Table Maintenance

      The compact command instructs Accumulo to schedule a compaction of the table during which files are consolidated and deleted entries are removed.

      -
      root@myinstance mytable> compact -t mytable
      -07 16:13:53,201 [shell.Shell] INFO : Compaction of table mytable
      -scheduled for 20100707161353EDT
      +
      root@myinstance mytable> compact -t mytable
      +07 16:13:53,201 [shell.Shell] INFO : Compaction of table mytable
      +scheduled for 20100707161353EDT
       

      The flush command instructs Accumulo to write all entries currently in memory for a given table to disk.

      -
      root@myinstance mytable> flush -t mytable
      -07 16:14:19,351 [shell.Shell] INFO : Flush of table mytable
      -initiated...
      +
      root@myinstance mytable> flush -t mytable
      +07 16:14:19,351 [shell.Shell] INFO : Flush of table mytable
      +initiated...
       

      User Administration

      The Shell can be used to add, remove, and grant privileges to users.

      -
      root@myinstance mytable> createuser bob
      -Enter new password for 'bob': *********
      -Please confirm new password for 'bob': *********
      +
      root@myinstance mytable> createuser bob
      +Enter new password for 'bob': *********
      +Please confirm new password for 'bob': *********
       
      -root@myinstance mytable> authenticate bob
      +root@myinstance mytable> authenticate bob
       Enter current password for 'bob': *********
       Valid
       
      -root@myinstance mytable> grant System.CREATE_TABLE -s -u bob
      +root@myinstance mytable> grant System.CREATE_TABLE -s -u bob
       
      -root@myinstance mytable> user bob
      +root@myinstance mytable> user bob
       Enter current password for 'bob': *********
       
      -bob@myinstance mytable> userpermissions
      -System permissions: System.CREATE_TABLE
      -Table permissions (!METADATA): Table.READ
      +bob@myinstance mytable> userpermissions
      +System permissions: System.CREATE_TABLE
      +Table permissions (!METADATA): Table.READ
       Table permissions (mytable): NONE
       
      -bob@myinstance mytable> createtable bobstable
      -bob@myinstance bobstable>
      +bob@myinstance mytable> createtable bobstable
      +bob@myinstance bobstable>
       
      -bob@myinstance bobstable> user root
      +bob@myinstance bobstable> user root
       Enter current password for 'root': *********
       
      -root@myinstance bobstable> revoke System.CREATE_TABLE -s -u bob
      +root@myinstance bobstable> revoke System.CREATE_TABLE -s -u bob
       
      @@ -201,7 +201,7 @@