Listing of Important perfSONAR Files¶

esmond¶

Configuration Files¶

Main Configuration File¶

Description:	The main configuration file for esmond
CentOS:	`/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
CentOS:	`systemctl start\|stop\|restart httpd`
Debian:	`service apache2 restart`

Data Cleaner¶

Description:	Cleans out old esmond data given a policy file.
CentOS:	`/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.
CentOS:	`/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
CentOS:	`/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.
CentOS:	`/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.
CentOS:	`/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
CentOS:	`systemctl start\|stop\|restart perfsonar-lsregistrationdaemon`
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
CentOS:	`/var/log/perfsonar/lsregistrationdaemon.log`
Debian:	`/var/log/perfsonar/lsregistrationdaemon.log`

OWAMP¶

Configuration Files¶

Main Configuration File¶

Description:	The main configuration file for an OWAMP server
CentOS:	`/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
CentOS:	`/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
CentOS:	`systemctl start\|stop\|restart owamp-server`
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.
CentOS:	RPM Only: `/var/log/messages` Toolkit: `/var/log/perfsonar/owamp.log`
Debian:	`/var/log/perfsonar/owamp.log`

pScheduler¶

Configuration Files¶

Limits File¶

Description:	The pScheduler limits file that defines authentication and authorization parameters for testing.
CentOS:	`/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.
CentOS:	`/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.
CentOS:	`/etc/pscheduler/database/*`
Debian:	`/etc/pscheduler/database/*`
Documentation:

Log Files¶

Primary Log file¶

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

pSConfig¶

Configuration Files¶

pSConfig pScheduler Agent Configuration File¶

Description:	The pSConfig pScheduler Agent configuration file
CentOS:	`/etc/perfsonar/psconfig/pscheduler-agent.json`
Debian:	`/etc/perfsonar/psconfig/pscheduler-agent.json`
Documentation:	N/A

pSConfig MaDDash Agent Configuration File¶

Description:	The pSConfig MaDDash Agent configuration file
CentOS:	`/etc/perfsonar/psconfig/maddash-agent.json`
Debian:	`/etc/perfsonar/psconfig/maddash-agent.json`
Documentation:	N/A

pSConfig pScheduler Agent Include Directory¶

Description:	Directory for pSConfig templates that automatically get loaded by pScheduler agent
CentOS:	`/etc/perfsonar/psconfig/pscheduler.d`
Debian:	`/etc/perfsonar/psconfig/pscheduler.d`
Documentation:	N/A

pSConfig MaDDash Agent Include Directory¶

Description:	Directory for pSConfig templates that automatically get loaded by MaDDash agent
CentOS:	`/etc/perfsonar/psconfig/maddash.d`
Debian:	`/etc/perfsonar/psconfig/maddash.d`
Documentation:	N/A

pSConfig Archive Include Directory¶

Description:	Directory for archive definitions that automatically get loaded by agent(s)
CentOS:	`/etc/perfsonar/psconfig/archives.d`
Debian:	`/etc/perfsonar/psconfig/archives.d`
Documentation:	N/A

pSConfig Transform Include Directory¶

Description:	Directory for JQ transformations that automatically get applied to all templates downloaded by agent(s)
CentOS:	`/etc/perfsonar/psconfig/transforms.d`
Debian:	`/etc/perfsonar/psconfig/transforms.d`
Documentation:	N/A

Important Scripts¶

pSConfig pScheduler Agent Start-up Script¶

Description:	Scripts used to start\|stop\|restart the pSConfig pScheduler Agent
CentOS:	`systemctl start\|stop\|restart psconfig-pscheduler-agent`
Debian:	`service psconfig-pscheduler-agent start\|stop\|restart`

pSConfig MaDDash Agent Start-up Script¶

Description:	Scripts used to start\|stop\|restart the pSConfig MaDDash Agent
CentOS:	`systemctl start\|stop\|restart psconfig-maddash-agent`
Debian:	`service psconfig-maddash-agent start\|stop\|restart`

psconfig command¶

Description:	Command used to perform numerous tasks related to pSConfig
CentOS:	`psconfig COMMAND [OPTIONS]`
Debian:	`psconfig COMMAND [OPTIONS]`

Log Files¶

pSConfig pScheduler Agent Log¶

Description:	Primary log for pSConfig pScheduler Agent
CentOS:	`/var/log/perfsonar/psconfig-pscheduler-agent.log`
Debian:	`/var/log/perfsonar/psconfig-pscheduler-agent.log`

pSConfig pScheduler Agent Tasks Log¶

Description:	Log of all the pScheduler tasks managed by the agent
CentOS:	`/var/log/perfsonar/psconfig-pscheduler-agent-tasks.log`
Debian:	`/var/log/perfsonar/psconfig-pscheduler-agent-tasks.log`

pSConfig pScheduler Agent Transactions Log¶

Description:	Log of each interaction by agent with pScheduler server(s)
CentOS:	`/var/log/perfsonar/psconfig-pscheduler-agent-transactions.log`
Debian:	`/var/log/perfsonar/psconfig-pscheduler-agent-transactions.log`

pSConfig MaDDash Agent Log¶

Description:	Primary log for pSConfig MaDDash Agent
CentOS:	`/var/log/perfsonar/psconfig-maddash-agent.log`
Debian:	`/var/log/perfsonar/psconfig-maddash-agent.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.
CentOS:	`/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.
CentOS:	`/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
CentOS:	`systemctl start\|stop\|restart perfsonar-configdaemon`
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.
CentOS:	`systemctl start\|stop\|restart perfsonar-configure_nic_parameters`
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
CentOS:	`systemctl start\|stop\|restart perfsonar-generate_motd`
Debian:	`service perfsonar-generate_motd 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.
CentOS:	`/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.
CentOS:	`/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.
CentOS:	`/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
CentOS:	`/var/log/perfsonar/configdaemon.log`
Debian:	`/var/log/perfsonar/configdaemon.log`

Service Watcher Log¶

Description:	Logs generated by the cron that verifies services are running and performs regular restarts/maintenance.
CentOS:	`/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.
CentOS:	`/var/log/perfsonar/web_admin/web_admin.log`
Debian:	`/var/log/perfsonar/web_admin/web_admin.log`