Skip to main content

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 --install build.

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