Estimated time to read: 3 minutes
This page discusses experimental features. Experimental features are still in progress, and you may encounter bugs or unexpected behavior when using them.
If you experience an issue or want to know more about this feature's status, reach out to us at Era Software.
eractl is a CLI tool for working with the EraSearch API. The tasks you can accomplish with eractl today include:
- Managing EraSearch RBAC entities, including:
- Creating admin, read-only, write-only, and read-write roles and API keys
- Creating role mappings
- Listing roles
- Listing role mappings
- Listing API keys
- Listing indexes
- Performing a system healthcheck
The eractl CLI is available in both a binary as well as container formats. Please reach out to [email protected] for more information.
Linux binaries are available for 64-bit systems and are provided by Era Software support. Please reach out to [email protected] if you would like access to the eractl binaries.
After downloading the binary, install it with the command:
If you don't have root access on your machine, you can still install eractl to
~/.local/bin directory (or run it from wherever you downloaded it to):
To verify eractl is installed correctly, run the command:
Which should print the CLI usage information:
If that command worked, then you're all set!
You will need access to the private Era Software container registry in order to retrieve the eractl container images. If you don't have access, please reach out to [email protected].
The eractl CLI is available from the Era Software container registry and can be retrieved with the command:
eractl frequently writes files locally for safety/backup purposes. When running from a container, be sure to expose a volume to the
/app container directory. For example:
$(pwd):/app argument will ensure that any files written locally (for example, when generating API credentials) are not lost if the container is removed.
When running from container, pass commands as arguments to
docker run. For example, to issue the
eractl list-indices command, use:
To pass environment variables to eractl, use the
-e Docker CLI argument:
eractl list-indices- List available indexes
eractl healthcheck- Perform a quick healthcheck
eractl rbac- Commands for managing RBAC entities
eractl rbac create-admin- Create an administative role and generate an API key for it
eractl rbac create-read- Create a read-only role and generate an API key for it
eractl rbac create-write- Create a read-only role and generate an API key for it
eractl rbac create-read-write- Create a read-only role and generate an API key for it
eractl rbac list-keys- List created API keys
eractl rbac list-roles- List created roles
eractl rbac list-role-mappings- List created role mappings
eractl --help- Print help message and exit
If you run into any problems or have any questions, please don't hesitate to reach out to [email protected].