ctubbsii commented on a change in pull request #274:
URL: https://github.com/apache/accumulo-website/pull/274#discussion_r623999866
##########
File path: _posts/blog/2021-04-21-jshell-accumulo-feature.md
##########
@@ -0,0 +1,144 @@
+---
+Title: JShell Accumulo Feature
+
+---
+
+## Overview
+First introduced in Java 9, [JShell][jshell-doc] is an interactive
Read-Evaluate-Print-Loop (REPL)
+Java tool that interprets user's input and outputs the results. This tool
provides a convenient way
+to test out and execute quick tasks with Accumulo in the terminal. This
feature is apart of the
+upcoming Accumulo 2.1 release. If you're a developer and want to get involved
in testing,
+[contact us][contact] or review our [contributing guide][guide]
+
+## Major Features
+* Default JShell script provides initial imports for interacting with
Accumulo's API and
+provided in Accumulo's binary distribution tarball
+
+
+* On startup, JShell Accumulo will automatically import the `CLASSPATH`, load
in a configured
+environment from user's `conf/accumulo-env.sh`, and invoke
`conf/jshell-init.jsh` to
+allow rapid Accumulo task executions
+
+
+* JShell Accumulo can startup using default/custom JShell script and users can
append any JShell
+command-line [options][jshell-option] to the startup command
+
+## Booting Up JShell Accumulo
+1) Open up a terminal and navigate to Accumulo's installation directory
+
+2) To startup JShell with **default script** use this command:
+
+```bash
+$ bin/accumulo jshell
+```
+3) To startup JShell with **custom script** use this command:
+
+```bash
+$ bin/accumulo jshell --startup (file/path/to/custom_script.jsh)
+```
+**Note:** Executing this specific command _"$jshell"_ will startup JShell,
however you will be required to manually import the `CLASSPATH` and the
configured environment from `conf/accumulo-env.sh`. In addition, you will need
to provide the file directory path to `conf/jshell-init.jsh` before any
Accumulo tasks can be performed. Using one of the startup commands above will
automate
+the setup process.
+
+## JShell Accumulo Default Script
+The auto-generated `jshell-init.jsh` is a customizable file located in
Accumulo's installation `conf/` directory. Inside `jshell-init.jsh` contains
[Accumulo Java APIs][public APIs] formatted as import statements and
[AccumuloClient][client] build implementation. On startup the script
automatically loads in the APIs and attempts to construct a client. Should
additional APIs and/or code implementations be needed, simply append them to
`jshell-init.jsh`. Alternatively you can create a separate JShell script and
specify the custom script's file path on startup.
Review comment:
It's fine. Use whatever you prefer. I don't know if Eclipse will
automatically wrap/format Markdown content or plain text files, but I know it's
possible to configure it to show a vertical line at a specific line length, so
if you exceed it, you can wrap manually.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
[email protected]
