Installation

WARNING: THE DEFAULT CONFIGURATION USED BY THE INSTALL SCRIPT WILL PERFORM ONGOING DATA CAPTURE, WHICH WILL RESTART UPON REBOOT. IT WILL ALSO CREATE A LOCAL joy ACCOUNT ON LINUX AND MAC SYSTEMS THAT WILL OWN ALL DATA FILES.

If you do not want an ongoing capture, we suggest that you do not use the install script.

Before installing the package to your system, you must first build it. Run the script install-sh (as root, or using sudo) to install the package:

[joy]$ sudo ./install/install-sh

If you run the script with no arguments, the default configuration, located at install/options.cfg, will be installed into the /usr/local/etc/joy directory and a joy user will be created that will own all data files. When joy starts as root, it will drop privileges to the joy user.

To have a different configuration file installed, provide the -c option:

[joy]$ sudo ./install/install-sh -c full-path-config-file.cfg

You can also configure anonymization of addresses, which requires a file containing the internal subnets. The default file for those subnets is internal.net; you can change the configuration with the -a option.

Similarly, you can change the watchfile of IP addresses (using the -w option) or the SSH private key used to have files uploaded via scp (using the -k option).

To see the full option description for the installer, run that program with the -h option to see the help or "usage" message.