Install a module on a cluster
Redis Enterprise comes packaged with several modules. You can view the installed modules and their versions from settings > redis modules in the Redis Enterprise admin console.
To use other modules or upgrade an existing module to a more recent version, you need to install the new module package on your cluster.
Get packaged modules
To install or upgrade a module on a Redis Enterprise cluster, you need a module package.
- For Redis Enterprise modules, download packages from the Redis download center.
- For custom-packaged modules, either download a custom-packaged module from the developer or package the module yourself.
Add a module to a cluster
Use one of the following methods to add a module to a Redis Enterprise cluster:
-
REST API
POST
request to the/v1/modules
endpoint -
Redis Enterprise admin console
-
For RedisGears, follow these installation instructions
REST API method
To add a module to the cluster using the REST API:
-
Download the module package from the download center.
-
Copy the package to a node in the cluster.
-
Add the module to the cluster with a
POST
request to the/v1/modules
endpoint:POST https://[host][:port]/v1/modules {"module=@/tmp/redisearch.Linux-ubuntu16.04-x86_64.2.2.6.zip"}
Here, the module parameter specifies the full path of the module package and must be submitted as form-data. In addition, the package must be available and accessible to the server processing the request.
-
If the module installation succeeds, the
POST
request returns a JSON object that represents the new module. If it fails, it may return a JSON object with anerror_code
anddescription
with more details.
Admin console method
To add a module to the cluster using the admin console:
-
In the Redis Enterprise admin console, select settings.
-
From redis modules, select the Add module button:
-
Use the file browser to select the packaged module.
-
Verify Selected module shows the correct filename and select the Upload button:
-
The new module version should appear in the list of Redis modules:
Note:If you don’t see the updated module version, refresh the page.
Next steps
- Create a database and enable the new module.
- Upgrade a module to the new version.