Creating an Instance

Owned by Boaz Raufman
Feb 26, 2019

Run the command:

JethroAdmin create-instance <instance-name> -storage-path=<storage-path> -cache-path=<cache-path> -cache-size=<cache-size> \[-Dstorage.type=POSIX\]

With the following parameters:

  • instance-name - An instance name of your choice ("demo" in the following examples).
  • storage-path - A path of your choice where the instance will be created and store its data files (An HDFS directory when creating an HDFS instance, a local storage path when creating a local instance, or shared storage).
  • cache-path - Local caching path of your choice, namely: a local root path for the cache directory.
  • cache-size - Maximum size for the cache directory. When using local disk for storage, there is no need for local cache. In this case, set the local cache size to 0G.

By default, Jethro will try to create the instance on HDFS. If you would like to create the instance on POSIX, add the following parameter:

-Dstorage.type=POSIX

The directories mentioned for storage-path and cache-path must be created in advance and owned by user jethro. You can use the following command to change the owner:
 

sudo chown jethro:jethro <directory path>


Example of creating a local instance:

JethroAdmin create-instance demo -storage-path=/user/jethro/instances -cache-path=/mnt/jethro_local_cache -cache-size=0G -Dstorage.type=POSIX

Example of creating an HDFS instance:

JethroAdmin create-instance demo -storage-path=/jethro/instances -cache-path=/mnt/jethro_local_cache -cache-size=80G