Listing of Important perfSONAR Files

BWCTL

Configuration Files

Main Configuration File

Description:The main configuration file for a BWCTL server
RedHat:/etc/bwctl-server/bwctl-server.conf
Debian:/etc/bwctl-server/bwctl-server.conf
Documentation:BWCTL Server Configuration File

Limits File

Description:The BWCTL limits file that defines authentication and authorization parameters for testing
RedHat:/etc/bwctl-server/bwctl-server.limits
Debian:/etc/bwctl-server/bwctl-server.limits
Documentation:BWCTL Limits File

Important Scripts

Start-up Script

Description:The script used to start/stop/restart a BWCTL server
RedHat 6:/etc/init.d/bwctl-server start|stop|restart
RedHat 7:systemctl start|stop|restart bwctl-server
Debian:service bwctl-server start|stop|restart

Log Files

Primary Log file

Description:BWCTL servers and clients can each write to log files. The location of the log file is dependent on your syslog configuration. The entries in this table assume a default configuration.
RedHat:RPM Only: /var/log/messages Toolkit: /var/log/perfsonar/owamp_bwctl.log
Debian:/var/log/perfsonar/owamp_bwctl.log

esmond

Configuration Files

Main Configuration File

Description:The main configuration file for esmond
RedHat:/etc/esmond/esmond.conf
Debian:/etc/esmond/esmond.conf
Documentation:N/A

Important Scripts

Start-up Script

Description:Esmond is started/stopped/restarted when HTTPD is started/stopped/restarted
RedHat 6:/etc/init.d/httpd24-httpd start|stop|restart
RedHat 7:systemctl httpd start|stop|restart
Debian:service apache2 restart

Data Cleaner

Description:Cleans out old esmond data given a policy file.
RedHat:/usr/lib/esmond/utils/ps_remove_data.py
Debian:/usr/share/esmond/util/ps_remove_data.py
Documentation:Deleting Old Data

Log Files

esmond Log

Description:Primary error log for esmond software.
RedHat:/var/log/esmond/esmond.log
Debian:/var/log/esmond/esmond.log

Django Log

Description:Error log related to Django framework such as processing JSON messages and database interactions
RedHat:/var/log/esmond/django.log
Debian:/var/log/esmond/django.log

LS Registration Daemon

Configuration Files

Main Configuration File

Description:The main configuration file for the LS Registration Daemon that describes what you want registered in the Lookup Service.
RedHat:/etc/perfsonar/lsregistrationdaemon.conf
Debian:/etc/perfsonar/lsregistrationdaemon.conf
Documentation:Lookup Service Registration Daemon Configuration File

Logging Configuration File

Description:Configuration file for setting log location, level of detail and various other log-related settings.
RedHat:/etc/perfsonar/lsregistrationdaemon-logger.conf
Debian:/etc/perfsonar/lsregistrationdaemon-logger.conf
Documentation:Log4perl Reference

Important Scripts

Start-up Script

Description:The script used to start/stop/restart a LS Registration Daemon server
RedHat 6:/etc/init.d/perfsonar-lsregistrationdaemon
RedHat 7:systemctl perfsonar-lsregistrationdaemon start|stop|restart
Debian:service perfsonar-lsregistrationdaemon start|stop|restart

Log Files

Primary Log file

Description:The log file to which the LS Registration daemon writes to as configured in the default logging configuration file
RedHat:/var/log/perfsonar/lsregistrationdaemon.log
Debian:/var/log/perfsonar/lsregistrationdaemon.log

MeshConfig

Configuration Files

Agent Configuration File

Description:The configuration file used by clients to download a mesh and build a local test configuration
RedHat:/etc/perfsonar/meshconfig-agent.conf
Debian:/etc/perfsonar/meshconfig-agent.conf
Documentation:MeshConfig Agent Configuration File

Agent Tasks File

Description:This file contains the tasks to be run by the host as defined manually, via the toolkit web interface and/or any remote mesh configuration files. They are submitted to pScheduler. This file is the successor to the former regulartesting.conf file.
RedHat:/etc/perfsonar/meshconfig-agent-tasks.conf
Debian:/etc/perfsonar/meshconfig-agent-tasks.conf
Documentation:MeshConfig Agent Tasks File

GUI Agent Configuration File

Description:The configuration file used to download a mesh and build a MaDDash configuration
RedHat:/etc/perfsonar/meshconfig-guiagent.conf
Debian:/etc/perfsonar/meshconfig-guiagent.conf
Documentation:MeshConfig GUI Agent Configuration File

Dynamic Host Lookup Configuration File

Description:The configuration file used to contact the lookup service and build a set of hosts to be used in the mesh
RedHat:/etc/perfsonar/meshconfig-lookuphosts.conf
Debian:/etc/perfsonar/meshconfig-lookuphosts.conf
Documentation:MeshConfig Dynamic Host Lookup Configuration File

Important Scripts

MeshConfig Agent Start-up Script

Description:The script used to start/stop/restart a MeshConfig Agent. This daemon builds meshconfig-agent-tasks.conf from remote meshes and picks up any manual changes and submits the tasks to pScheduler.
RedHat 6:/etc/init.d/perfsonar-meshconfig-agent start|stop|restart
RedHat 7:systemctl perfsonar-meshconfig-agent start|stop|restart
Debian:service perfsonar-meshconfig-agent start|stop|restart

MeshConfig GUI Agent Start-up Script

Description:The script used to start/stop/restart a MeshConfig GUI Agent. This daemon builds MaDDash configuration file from a downloaded central configuration file.
RedHat 6:/etc/init.d/perfsonar-meshconfig-guiagent start|stop|restart
RedHat 7:systemctl perfsonar-meshconfig-guiagent start|stop|restart
Debian:service perfsonar-meshconfig-guiagent start|stop|restart

JSON Builder

Description:The script used to convert a central configuration file to JSON consumable by agents
RedHat:/usr/lib/perfsonar/bin/build_json
Debian:/usr/lib/perfsonar/bin/build_json

Dynamic Host List Generator

Description:The script used to contact the lookup service and build a set of hosts to be used in the mesh
RedHat:/usr/lib/perfsonar/bin/lookup_hosts
Debian:/usr/lib/perfsonar/bin/lookup_hosts

Log Files

MeshConfig Agent Log

Description:The log file written when the MeshConfig agent is run.
RedHat:/var/log/perfsonar/meshconfig-agent.log
Debian:/var/log/perfsonar/meshconfig-agent.log

GUI/Dashboard Configuration Agent Log

Description:The log file written when the MeshConfig GUI agent is run.
RedHat:/var/log/perfsonar/meshconfig-guiagent.log
Debian:/var/log/perfsonar/meshconfig-guiagent.log

OWAMP

Configuration Files

Main Configuration File

Description:The main configuration file for an OWAMP server
RedHat:/etc/owamp-server/owamp-server.conf
Debian:/etc/owamp-server/owamp-server.conf
Documentation:OWAMP Server Configuration File

Limits File

Description:The OWAMP limits file that defines authentication and authorization parameters for testing
RedHat:/etc/owamp-server/owamp-server.limits
Debian:/etc/owamp-server/owamp-server.limits
Documentation:OWAMP Limits Configuration File

Important Scripts

Start-up Script

Description:The script used to start/stop/restart an OWAMP server
RedHat 6:/etc/init.d/owamp-server start|stop|restart
RedHat 7:systemctl owamp-server start|stop|restart
Debian:service owamp-server start|stop|restart

Log Files

Primary Log file

Description:OWAMP servers and clients can each write to log files. The location of the log file is dependent on your syslog configuration. The entries in this table assume a default configuration.
RedHat:RPM Only: /var/log/messages Toolkit: /var/log/perfsonar/owamp_bwctl.log
Debian:/var/log/perfsonar/owamp_bwctl.log

pScheduler

Configuration Files

Limits File

Description:The pScheduler limits file that defines authentication and authorization parameters for testing.
RedHat:/etc/pscheduler/limits.conf
Debian:/etc/pscheduler/limits.conf
Documentation:Configuring pScheduler Limits

Archives Configuration Files

Description:The configuration files for pScheduler’s archives. Contains individual archive specifications applied to every measurement the system runs.
RedHat:/etc/pscheduler/default-archives/*
Debian:/etc/pscheduler/default-archives/*
Documentation:

Database Configuration Files

Description:The configuration files for pScheduler’s database. Contains files maintained by the system and should not be altered at the risk of breaking pScheduler’s ability to use its database.
RedHat:/etc/pscheduler/database/*
Debian:/etc/pscheduler/database/*
Documentation:

Log Files

Primary Log file

Description:The log file written when the pScheduler daemon is run.
RedHat:/var/log/pscheduler/pscheduler.log
Debian:/var/log/pscheduler/pscheduler.log

Toolkit

Configuration Files

Note

The Toolkit contains other configuration files but in general non-developers should not be changing them. As such they are not listed here.

Measurement Archive Data Retention Policy

Description:The configuration file used by the esmond data cleaner script when running in the cron installed by the Toolkit.
RedHat:/etc/perfsonar/toolkit/clean_esmond_db.conf
Debian:/etc/perfsonar/toolkit/clean_esmond_db.conf
Documentation:Deleting Old Data

Important Scripts

Toolkit Configuration Script

Description:A script to help configure users and other basic features of the Toolkit.
RedHat:/usr/lib/perfsonar/scripts/nptoolkit-configure.py
Debian:/usr/lib/perfsonar/scripts/nptoolkit-configure.py
Documentation:Managing Users

Configuration Daemon Start-up Script

Description:The script used to start/stop/restart the service used by the administrative web interface to configure the host
RedHat 6:/etc/init.d/perfsonar-configdaemon start|stop|restart
RedHat 7:systemctl perfsonar-configdaemon start|stop|restart
Debian:service perfsonar-toolkit-config-daemon start|stop|restart

Network Interface Card Configuration Script

Description:The script detects if the NIC is misconfigured, and makes necessary configuration changes to NIC if they are.
RedHat 6:/etc/init.d/perfsonar-configure_nic_parameters start|stop|restart
RedHat 7:systemctl perfsonar-configure_nic_parameters start|stop|restart
Debian:service perfsonar-configure_nic_parameters start|stop|restart

‘Message of the Day’ Script

Description:Generates the login message on start-up that appears to command-line users
RedHat 6:/etc/init.d/perfsonar-generate_motd start|stop|restart
RedHat 7:systemctl perfsonar-generate_motd start|stop|restart
Debian:service perfsonar-generate_motd start|stop|restart

Measurement Archive Upgrade Script

Description:Upgrades data from a pre-3.4 Toolkit to the current version. If there is no data to upgrade then it exits.
RedHat:/etc/init.d/perfsonar-psb_to_esmond start|stop|restart
Debian:service perfsonar-psb_to_esmond start|stop|restart

Multi-Interface Routing Setup Script

Description:A script to help with the configuration of routing for hosts running tests on multiple interfaces.
RedHat:/usr/lib/perfsonar/scripts/mod_interface_route
Debian:/usr/lib/perfsonar/scripts/mod_interface_route
Documentation:Configuring a Host with Multiple Interfaces

Installed Cron Jobs

Measurement Archive Data Cleaner

Description:Cleans out data in the measurement archive according to retention policy in Measurement Archive Data Retention Policy. Runs at 2:30AM every morning.
RedHat:/etc/cron.d/cron-clean_esmond_db
Debian:/etc/cron.d/cron-clean_esmond_db

Regular Service Restarts and Maintenance

Description:Verifies expected processes are running every hour and performs a regular restart of services that require it every moring at 1:05AM. It also cleans out stale files from OWAMP and Regular Testing at this time.
RedHat:/etc/cron.d/cron-service_watcher
Debian:/etc/cron.d/perfsonar-toolkit-servicewatcher

Log Files

Configuration Daemon Log

Description:The log file for the configuration daemon
RedHat:/var/log/perfsonar/configdaemon.log
Debian:/var/log/perfsonar/configdaemon.log

Measurement Archive Upgrade Log

Description:The log file for the measurement archive upgrade script
RedHat:/var/log/perfsonar/psb_to_esmond.log
Debian:/var/log/perfsonar/psb_to_esmond.log

Service Watcher Log

Description:Logs generated by the cron that verifies services are running and performs regular restarts/maintenance.
RedHat:/var/log/perfsonar/servicewatcher.log and /var/log/perfsonar/servicewatcher_error.log
Debian:/var/log/perfsonar/servicewatcher.log and /var/log/perfsonar/servicewatcher_error.log
Debian:N/A

Web Interface Logs

Description:Log files for the web interface.
RedHat:/var/log/perfsonar/web_admin/web_admin.log
Debian:/var/log/perfsonar/web_admin/web_admin.log