This topic explains how to install and uninstall VMware GemFire Vector Database.
VMware GemFire Vector Database requires the following:
VMware GemFire v10 or later installed, with cluster configuration enabled. For more information about cluster configuration in GemFire, see Overview of the Cluster Configuration Service in the VMware GemFire product documentation.
Java 11 or Java 17
A Broadcom Customer Support Portal account.
Note: VMware GemFire Vector Database is compatible with GemFire Search v1.1, but not v1.0.
To install VMware GemFire Vector Database on a GemFire server:
.gfm
file.Do one of the following:
Copy the downloaded file to the extensions directory of your GemFire installation. By default, the extensions folder is the vmware-gemfire-XXX/extensions
directory of your GemFire installation.
Set the GEMFIRE_EXTENSIONS_REPOSITORY_PATH
environment variable to the VMware GemFire Vector Database extension path. For example, if your vmware-gemfire-vectordb-VERSION.gfm
file is located in /gemfire-extensions
, run the following command:
export GEMFIRE_EXTENSIONS_REPOSITORY_PATH=/gemfire-extensions
Start the locator:
gfsh>start locator --name locator1
Start the server. When running GemFire locator and server members on the same host, you must specify the http-service-port
that will host REST services. If you do not specify the http-service-port
, the port used defaults to 7070
, which may collide with other locators and servers.
gfsh>start server --name server1 --http-service-port 8080
If you want high availability or to use multiple servers, start additional servers before you create a vector index. If these servers are on the same host as the locator or other servers, use http-service-port
to specify a different port number for each server. The VMware GemFire Vector Database index will be partitioned across all of these servers.
To upgrade VMware GemFire Vector Database from v1.0 to v1.1.0:
Delete the delete the vector index.
curl -X DELETE http://localhost:8080/gemfire-vectordb/v1/indexes/INDEX-NAME
Where INDEX-NAME
is the name of your vector index.1. Log in to Broadcom Customer Support Portal with your customer credentials. For more information, see the Download Broadcom products and software article.
Go to the VMware Tanzu GemFire Vector Database downloads page. Select VMware Tanzu GemFire Vector Database, and select a version.
Click I agree to Terms and Conditions. Click the HTTPS Download icon next to VMware GemFire Vector Database to download the .gfm
file.
Copy the dowloaded file to the extensions directory of your GemFire installation or set the GEMFIRE_EXTENSIONS_REPOSITORY_PATH
environment variable to the VMware GemFire Vector Database extension path as described in Install.
Recreate the vector index using the steps described in Create Index.
If you use GemFire Search, then also create the index for search as described in Creating an Index in VMware GemFire Search Integration with GemFire in the VMware GemFire Search documentation.
To uninstall VMware GemFire Vector Database on a GemFire server:
Delete all vector indexes, their embeddings, and their underlying GemFire regions. For more information, see Delete Index in REST API Endpoints. For example:
curl -X DELETE http://localhost:8080/gemfire-vectordb/v1/indexes/quickstart -H "Content-Type: application/json" -d '{"delete-data: true}'
Stop each server. For example:
gfsh>stop server --name server1
If you copied the .gtm file to the extensions directory of your GemFire installation, remove it from that location.
If you set the GEMFIRE_EXTENSIONS_REPOSITORY_PATH
environment variable to the VMware GemFire Vector Database extension path, unset the environment variable:
export GEMFIRE_EXTENSIONS_REPOSITORY_PATH=
Restart your servers.