[+] expand all

Build / install Vespa

To develop with Vespa, follow the guide to setup a development environment on CentOS Stream 8 using Docker.

Build Vespa Java artifacts with Java 17 and Maven 3.6+. Once built, Vespa Java artifacts are ready to be used and one can build a Vespa application using the bundle plugin.

$ export MAVEN_OPTS="-Xms128m -Xmx1024m"
$ ./bootstrap.sh java && mvn install

See vespa.ai releases.

Container images

Image	Description
docker.io/vespaengine/vespa ghcr.io/vespa-engine/vespa	Container image for running Vespa.
docker.io/vespaengine/vespa-build-centos-stream8	Container image for building Vespa on CentOS Stream 8.
docker.io/vespaengine/vespa-dev-centos-stream8	Container image for development of Vespa on CentOS Stream 8. Used for incremental building and system testing.

RPMs

Dependency graph:

Installing Vespa on CentOS Stream 8:

$ dnf config-manager \
  --add-repo https://raw.githubusercontent.com/vespa-engine/vespa/master/dist/vespa-engine.repo
$ dnf config-manager --enable powertools
$ dnf install -y epel-release
$ dnf install -y vespa

Important: Please note that these rpms are not retained, only the latest Vespa release is available. Use the Docker images (above) for installations of specific versions. Any problems with released rpm packages will be fixed in subsequent releases, please report any issues - troubleshoot using the install example.

Refer to vespa.spec. Build RPMs for a given Vespa version X.Y.Z:

$ git clone https://github.com/vespa-engine/vespa
$ cd vespa
$ git checkout vX.Y.Z
$ docker run --rm -ti -v $(pwd):/wd:Z -w /wd  \
         docker.io/vespaengine/vespa-build-centos-stream8:latest \
         make -f .copr/Makefile rpms outdir=/wd
$ ls *.rpm | grep -v debug
vespa-8.91.2-1.el8.src.rpm
vespa-8.91.2-1.el8.x86_64.rpm
vespa-ann-benchmark-8.91.2-1.el8.x86_64.rpm
vespa-base-8.91.2-1.el8.x86_64.rpm
vespa-base-libs-8.91.2-1.el8.x86_64.rpm
vespa-clients-8.91.2-1.el8.x86_64.rpm
vespa-config-model-fat-8.91.2-1.el8.x86_64.rpm
vespa-jars-8.91.2-1.el8.x86_64.rpm
vespa-libs-8.91.2.el8.x86_64.rpm
vespa-malloc-8.91.2-1.el8.x86_64.rpm
vespa-node-admin-8.91.2-1.el8.x86_64.rpm
vespa-tools-8.91.2-1.el8.x86_64.rpm

Find most utilities in the vespa-x.y.z*.rpm - other RPMs:

RPM	Description
vespa-tools	Tools accessing Vespa endpoints for query or document operations: vespa-destination vespa-fbench vespa-feeder vespa-get vespa-query-profile-dump-tool vespa-stat vespa-summary-benchmark vespa-visit vespa-visit-target
vespa-malloc	Vespa has its own memory allocator, vespa-malloc - refer to /opt/vespa/etc/vespamalloc.conf
vespa-clients	vespa-feed-client.jar - see vespa-feed-client