CDK-886: Add instructions for replacing kite-dataset in /usr/bin #76
Conversation
DennisDawson
changed the title
|
|
||
| 1. Include the path to `kite-dataset` when you invoke commands. For example, if the JAR file is in the current directory, use `./kite-dataset`. | ||
|
|
||
| 1. Replace the installed version of `kite-dataset.jar`. |
There was a problem hiding this comment.
No need to use the jar file extension, this is usually called kite-dataset. Also, this is {{site.dataset-command}} above, should that be used here as well?
There was a problem hiding this comment.
Replaced all occurrences with {{site.dataset-command}}
There was a problem hiding this comment.
Line 15 - Some versions of the Cloudera QuickStart VM [come] with Kite installed. Changing this to "Some versions of CDH come with Kite installed."
| The first command downloads the Kite tools JAR to a local file named _{{site.dataset-command}}_. The second changes the access rights on the JAR so that the classes in the JAR are executable. | ||
| The first command downloads the Kite tools JAR to a local file named `{{site.dataset-command}}`. The second changes the access rights on the JAR so that the classes in the JAR are executable. | ||
|
|
||
| Some versions of CDH come with `{{site.dataset-command}}` installed. However, it might not be the latest version. To check the version, from a terminal window, enter the following command. |
There was a problem hiding this comment.
I think this should start a new section so readers have an obvious choice between installing or replacing an existing command.
There was a problem hiding this comment.
Yeah, okay. The reason I hesitate to do that is that I'm pretty sure everyone will always need to do something in order to use the latest version of the software. I'll add the heading "Verifying the Version In Use," which will hopefully get them to keep reading.
| @@ -3,6 +3,8 @@ layout: page | |||
| title: Install the Kite Command Line Interface | |||
| --- | |||
|
|
|||
| These are the instructions for downloading the Kite command line interface. The most up-to-date instructions for downloading the current version of the software are always available at [http://kitesdk.org/docs/current/Install-Kite.html](http://kitesdk.org/docs/current/Install-Kite.html). | |||
There was a problem hiding this comment.
I think this should include the version that will be installed so that the "current" link makes a bit more sense.
There was a problem hiding this comment.
The reason for these revisions is that the version of kite-dataset shipped with CDH is almost always going to be an older version of the kite-dataset command than one you install. These are the instructions for installing and verifying that the latest version is in use.
I discovered this issue when I ran kite-dataset from the ~/ directory, with a new kite-dataset JAR in the ~/ directory, but when I invoked commands, they ran from an old version of the command from /usr/lib/kite/bin/ .
I added the "current" link up here in response to an earlier comment.
I'm don't refer to any specific version, because that would have to be updated with each release.
Instructions for replacing the installed version of kite-dataset with the latest version.