From 2c4f68e1472a8bf788bcdd8dc17dd739a1efaa15 Mon Sep 17 00:00:00 2001 From: DennisDawson Date: Mon, 23 Feb 2015 13:51:46 -0800 Subject: [PATCH 1/5] Per CDK-886, add instructions for replacing kite-dataset in /usr/bin --- Install-Kite.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/Install-Kite.md b/Install-Kite.md index 12c00b9..69a9f64 100644 --- a/Install-Kite.md +++ b/Install-Kite.md @@ -11,3 +11,19 @@ chmod +x {{site.dataset-command}} ``` 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 the Cloudera QuickStart VM comes with Kite installed. However, it might not be the latest version. To check the version, from a terminal window, enter the following command. + +``` +kite-dataset --version +``` + +If the version number doesn't match the version you downloaded, you have two options. + +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`. + a. Download `kite-dataset.jar` to the home directory. + b. In a terminal window on the VM, navigate to `/usr/bin`. + c. Enter the command `sudo cp ~/kite-dataset ./kite-dataset` + d. To verify that the correct version is in use, enter the command `kite-dataset --version`. \ No newline at end of file From 9784cd00bd165befc66ba7d5a3a01be1fc5122f5 Mon Sep 17 00:00:00 2001 From: DennisDawson Date: Mon, 23 Feb 2015 16:31:07 -0800 Subject: [PATCH 2/5] Updates based on comments 2/23. --- Install-Kite.md | 20 +++++++++++--------- 1 file changed, 11 insertions(+), 9 deletions(-) diff --git a/Install-Kite.md b/Install-Kite.md index 69a9f64..75bd15a 100644 --- a/Install-Kite.md +++ b/Install-Kite.md @@ -10,20 +10,22 @@ curl http://central.maven.org/maven2/org/kitesdk/kite-tools/{{site.version}}/kit chmod +x {{site.dataset-command}} ``` -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 the Cloudera QuickStart VM comes with Kite installed. However, it might not be the latest version. To check the version, from a terminal window, enter the following command. +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. ``` -kite-dataset --version +{{site.dataset-command}} --version ``` If the version number doesn't match the version you downloaded, you have two options. -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. Include the path to `{{site.dataset-command}}` when you invoke commands. For example, if the JAR file is in the current directory, use `./{{site.dataset-command}}`. -1. Replace the installed version of `kite-dataset.jar`. - a. Download `kite-dataset.jar` to the home directory. - b. In a terminal window on the VM, navigate to `/usr/bin`. - c. Enter the command `sudo cp ~/kite-dataset ./kite-dataset` - d. To verify that the correct version is in use, enter the command `kite-dataset --version`. \ No newline at end of file +1. Replace the installed version of `{{site.dataset-command}}`. + a. Download `{{site.dataset-command}}` (in this example, it is downloaded to the `~/` directory). + b. Replace the old version of `{{site.dataset-command}}` in the existing location. + 1. For packages, use `sudo cp ~/{{site.dataset-command}} /usr/bin/{{site.dataset-command}}`. + 1. For parcels, use `sudo cp ~/{{site.dataset-command}} /opt/cloudera/parcels//lib/kite/bin/{{site.dataset-command}}`. + + c. To verify that the correct version is in use, enter the command `{{site.dataset-command}} --version`. \ No newline at end of file From d84b15c0476918db7c34e2bae7f6a18df809e8cf Mon Sep 17 00:00:00 2001 From: DennisDawson Date: Thu, 5 Mar 2015 15:42:32 -0800 Subject: [PATCH 3/5] Updates based on feedback 3/5/2015. --- Install-Kite.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/Install-Kite.md b/Install-Kite.md index 75bd15a..11d0f11 100644 --- a/Install-Kite.md +++ b/Install-Kite.md @@ -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). + To download Kite with `curl`, run the following commands from a terminal window: ``` @@ -12,6 +14,8 @@ chmod +x {{site.dataset-command}} 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. +## Verifying the Version In Use + 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. ``` @@ -26,6 +30,6 @@ If the version number doesn't match the version you downloaded, you have two opt a. Download `{{site.dataset-command}}` (in this example, it is downloaded to the `~/` directory). b. Replace the old version of `{{site.dataset-command}}` in the existing location. 1. For packages, use `sudo cp ~/{{site.dataset-command}} /usr/bin/{{site.dataset-command}}`. - 1. For parcels, use `sudo cp ~/{{site.dataset-command}} /opt/cloudera/parcels//lib/kite/bin/{{site.dataset-command}}`. + 1. For parcels, use `sudo cp ~/{{site.dataset-command}} /opt/cloudera/parcels/lib/kite/bin/{{site.dataset-command}}`. c. To verify that the correct version is in use, enter the command `{{site.dataset-command}} --version`. \ No newline at end of file From 264c770f0e6a54e64320b329ba45e4be98c6b5f5 Mon Sep 17 00:00:00 2001 From: DennisDawson Date: Thu, 5 Mar 2015 15:57:45 -0800 Subject: [PATCH 4/5] Changed path to /usr/lib/kite/bin/ for packages. --- Install-Kite.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Install-Kite.md b/Install-Kite.md index 11d0f11..146775b 100644 --- a/Install-Kite.md +++ b/Install-Kite.md @@ -29,7 +29,7 @@ If the version number doesn't match the version you downloaded, you have two opt 1. Replace the installed version of `{{site.dataset-command}}`. a. Download `{{site.dataset-command}}` (in this example, it is downloaded to the `~/` directory). b. Replace the old version of `{{site.dataset-command}}` in the existing location. - 1. For packages, use `sudo cp ~/{{site.dataset-command}} /usr/bin/{{site.dataset-command}}`. - 1. For parcels, use `sudo cp ~/{{site.dataset-command}} /opt/cloudera/parcels/lib/kite/bin/{{site.dataset-command}}`. + 1. For packages, use `sudo cp ~/{{site.dataset-command}}/usr/lib/kite/bin/{{site.dataset-command}}`. + 1. For parcels, use `sudo cp ~/{{site.dataset-command}}/opt/cloudera/parcels/lib/kite/bin/{{site.dataset-command}}`. c. To verify that the correct version is in use, enter the command `{{site.dataset-command}} --version`. \ No newline at end of file From 3009b080f2626e182486a16249376446dc08656b Mon Sep 17 00:00:00 2001 From: Dennis Dawson Date: Fri, 27 Mar 2015 17:03:28 -0700 Subject: [PATCH 5/5] Update Install-Kite.md --- Install-Kite.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Install-Kite.md b/Install-Kite.md index 146775b..4c8cbd5 100644 --- a/Install-Kite.md +++ b/Install-Kite.md @@ -29,7 +29,7 @@ If the version number doesn't match the version you downloaded, you have two opt 1. Replace the installed version of `{{site.dataset-command}}`. a. Download `{{site.dataset-command}}` (in this example, it is downloaded to the `~/` directory). b. Replace the old version of `{{site.dataset-command}}` in the existing location. - 1. For packages, use `sudo cp ~/{{site.dataset-command}}/usr/lib/kite/bin/{{site.dataset-command}}`. - 1. For parcels, use `sudo cp ~/{{site.dataset-command}}/opt/cloudera/parcels/lib/kite/bin/{{site.dataset-command}}`. + 1. For packages, use `sudo cp ~/{{site.dataset-command}} /usr/lib/kite/bin/{{site.dataset-command}}`. + 1. For parcels, use `sudo cp ~/{{site.dataset-command}} /opt/cloudera/parcels/lib/kite/bin/{{site.dataset-command}}`. - c. To verify that the correct version is in use, enter the command `{{site.dataset-command}} --version`. \ No newline at end of file + c. To verify that the correct version is in use, enter the command `{{site.dataset-command}} --version`.