Maintainers	No Maintainer
Categories	net
Homepage	https://web.archive.org/web/20090307054951/http://nrg.hep.wisc.edu/
Platforms	darwin
Variants	pingd_server (pingd daemon to graph network latency with NRG) universal (Build for multiple architectures)

"nrg" depends on

lib (3)

build (1)

Ports that depend on "nrg"

No ports

Port notes

#### To complete the NRG installation ####

1) Make an /nrg symlink in your Apache document root pointing to the ../nrg/web NRG data directory:

sudo ln -s ${prefix}/var/nrg/web /my-Apache-document-root/nrg

2) Modify your httpd.conf file for NRG graph pages:

Uncomment lines:

AddHandler cgi-script .cgi
LoadModule expires_module libexec/httpd/mod_expires.so
AddModule mod_expires.c

Add directives:

<Directory /my-Apache-document-root/nrg>
Options ExecCGI
</Directory>

<Files "*.gif">
ExpiresActive On
ExpiresDefault M5
</Files>

Change the Apache user and group to the NRG user and group so Apache will
have permissions to create graphs when you click an RRD file link.

User <nrg-user>
Group <nrg-group>

3) Change the web root variables at the top of files Makefile and Site.mconf
in directory ${prefix}/var/nrg to your Apache document root location.

4) Make NRG files and data owned by the user you'll use to run NRG

su (must be root for this operation)
find ${prefix}/var/nrg -print | xargs chown <nrg-user>:<nrg-group>

#### To use NRG ####

1) Set meta-configuration definitions in the Site.mconf file for each
resource you want to graph by following the example meta-configuration
definitions in ${prefix}/share/doc/nrg/examples.

2) Have NRG generate rrd files and html graph pages (and modify them after
Site.mconf changes):

cd ${prefix}/var/nrg
make rediscover
make notify

3) Schedule the script ${prefix}/var/nrg/run-nrg to run via launchd or cron
every five minutes to poll your data sources and update the rrd files.

Be sure to read the documentation in ${prefix}/share/doc/nrg/html for
creating custom graphs or for more information.