NAME
install_boot_scripts - Install turnkey boot scripts to launch amd and rtexec daemons
SYNOPSIS
install_boot_scripts [-ehv] {-a|-p|-r -u real-time-user -d rtexec-directory [-n nickname] [-D Description]}
DESCRIPTION
The
install_boot_scripts program installs operating-system-appropriate turnkey scripts such
that the
amd(1),
ald_proxy(1), and/or
rtexec(1) daemons launch automatically upon system boot.
install_boot_scripts must run as the
root user (e.g. with the sudo(8) command).
OPTIONS
-
-a
Install a boot script to launch the amd(1) program
-
-d rtexec-directory
Directory from which to run real-time system
-
-D Description
Specify optional custom short text description of real-time system
-
-e
Execute launch mechanism to run the boot script(s) after installation
-
-h
Print help menu and exit
-
-n nickname
Specify an optional nickname for the real-time system, to distinguish in cases where there is more than one running. The nickname
must be composed of valid file-naming characters and not contain any spaces.
-
-p
Install a boot script to launch the ald_proxy(1) program
-
-r
Install a boot script to launch the rtexec(1) program. Use of -r also requires the -u and -d options.
-
-v
Be more verbose
-
-u real-time-user
User under which to run real-time system
FILES
The
install_boot_scripts program bases its boot scripts on templates found in
$ANTELOPE/data/system,
currently for Linux:
brtt-amd.service.template
brtt-ald_proxy.service.template
brtt-rtexec.service.template
and for Darwin:
com.brtt.ald_proxy.plist.template
com.brtt.rtexec.plist.template
These scripts are installed to files on the system with the same name but with the
.template suffix removed.
EXAMPLE
% sudo sh -c "$ANTELOPE/bin/install_boot_scripts -v -a -r -u rt -d /home/rt/rtsystems/rtdemo_gsn"
Installing amd(1) boot script for Linux...
Executing: cp /opt/antelope/5.9/data/system/brtt-amd.service.template /usr/lib/systemd/system/brtt-amd.service
Done installing amd(1) boot script for Linux
Installing rtexec(1) boot script for Linux...
Executing: cp /opt/antelope/5.9/data/system/brtt-rtexec.service.template /usr/lib/systemd/system/brtt-rtexec.service
Executing: perl -p -i -e 's^_RTEXEC_USER_^rt^g' /usr/lib/systemd/system/brtt-rtexec.service
Executing: perl -p -i -e 's^_RTEXEC_DIR_^/home/rt/rtsystems/rtdemo_gsn^g' /usr/lib/systemd/system/brtt-rtexec.service
Executing: perl -p -i -e 's^_RTEXEC_DESC_^BRTT Antelope 'rtexec' real-time system executive^g' /usr/lib/systemd/system/brtt-rtexec.service
Done installing rtexec(1) boot script for Linux
%
SEE ALSO
amd(1), ald_proxy(1), rtexec(1)
BUGS AND CAVEATS
Installation of the
amd(1) daemon on
OSX is not currently supported.
If there are previous boot scripts installed,
install_boot_scripts writes over them.
AUTHOR
Kent Lindquist