No description, website, or topics provided.
Shell Python PigLatin
Switch branches/tags
Latest commit 10af51b May 23, 2017 @aman-ebay aman-ebay committed with pmkc Edits to bdutil docs/ page. (#101)
1. sample "hadoop fs -ls ." command produces error output:
   ... "ls: Can not create a Path from an empty string"
  Suggest changing to "hadoop fs -ls /" to obtain valid output:
  Found 2 items
  drwx------   - xxxxx xxxxx          0 2017-05-21 00:36 /hadoop
  drwx------   - xxxxx xxxxx          0 2017-05-21 01:00 /bdutil-staging

2. Fix cd path from:
   /home/hadoop-install/share/hadoop/mapreduce... -> /home/hadoop/hadoop-install/

3. Fix command from hadoop jar share/hadoop/mapreduce/hadoop-*-examples-*.jar wordcount input output ->
     hadoop jar hadoop-examples-*.jar wordcount input output


bdutil is a command-line script used to manage Apache Hadoop and Apache Spark instances on Google Compute Engine. bdutil manages deployment, configuration, and shutdown of your Hadoop instances.


bdutil depends on the Google Cloud SDK. bdutil is supported in any posix-compliant Bash v3 or greater shell.


See the QUICKSTART file in the docs directory to learn how to set up your Hadoop instances using bdutil.

  1. Install and configure the Google Cloud SDK if you have already not done so
  2. Clone this repository with git clone
  3. Modify the following variables in the file:
  4. PROJECT - Set to the project ID for all bdutil commands. The project value will be overridden in the following order (where 1 overrides 2, and 2 overrides 3):
  • -p flag value, or if not specified then
  • PROJECT value in, or if not specified then
  • gcloud default project value
  1. CONFIGBUCKET - Set to a Google Compute Storage bucket that your project has read/write access to.
  2. Run bdutil --help for a list of commands.

The script implements the following commands, which are very similar:

  • bdutil create creates and starts instances, but will not apply most configuration settings. You can call bdutil run_command_steps on instances afterward to apply configuration settings to them. Typically you wouldn't use this, but would use bdutil deploy instead.
  • bdutil deploy creates and starts instances with all the configuration options specified in the command line and any included configuration scripts.

Components installed

The latest release of bdutil is 1.3.5. This bdutil release installs the following versions of open source components:

  • Apache Hadoop - 1.2.1 (2.7.1 if you use the -e argument)
  • Apache Spark - 1.5.0
  • Apache Pig - 0.12
  • Apache Hive - 1.2.1


The following documentation is useful for bdutil.

  • Quickstart - A guide on how to get started with bdutil quickly.
  • Jobs - How to submit jobs (work) to a bdutil cluster.
  • Monitoring - How to monitor bdutil cluster.
  • Shutdown - How shutdown a bdutil cluster.