rc

Installation Required

This guide requires that you have installed VAST on FreeBSD.

FreeBSD uses the rc(8) system of startup scripts during system initialization and for managing services. VAST ships with an rc script (similar to the ones in /etc/rc.d and /usr/local/etc/rc.d) that allows for service(8) to manage a vast process with the start, stop, and restart options. The rc script uses daemon(8) to manage the vast process.

Service Setup

To enable VAST as a service, copy the rc script from scripts/freebsd-rc-vast in the repository to /usr/local/etc/rc.d.

note

This happens automatically when invoking the install target, e.g., via cmake --build build --target install.

To make VAST start at boot time, add the following line to /etc/rc.conf:

vast_enable="YES"

Usage

You can use service(8) to manage VAST like any other service. For example, to start VAST use:

service vast start

During the first start, the rc script checks whether a vast user and group exist already. These are necessary so that daemon(8) can start VAST in an unprivileged context.

To stop VAST, use:

service vast stop