A Jethro instance consists an entire database, including all tables, data, indexes, and metadata. The instance is stored on a chosen type of storage, either shared (such as HDFS or EFS) or local (POSIX). An instance can be attached to a server, but can also be detached and reattached later (by the same server or another).
This chapter provides instructions for performing the following operations:
- Creating an Instance
- Attaching and Detaching an Instance
- Deleting an Instance
Creating an Instance
To create a new, empty instance, run the command JethroAdmin create-instance along with the following parameters:
- An instance name of your choice ("demo" in the following example).
- The instance storage path - an HDFS storage path; an HDFS directory owned by user jethro, a Local storage path, or shared storage.
- Local caching parameters – a local root path and 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..
- When using a local storage path, an extra parameter is required: -Dstorage.type=POSIX
The syntax of the basic command is:
Attaching and Detaching an Instance
Instances can be attached/detached from a server. When using a shared storage, they can (and most probably will) be attached to multiple servers.
To attach an existing instance, run:
To detach an instance from a server, run:
Deleting an Instance
To remove an instance and all its data and metadata, run: