Listing of Important perfSONAR Files¶

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 Grafana Agent Configuration File¶

Description: The pSConfig Grafana Agent configuration file
CentOS: /etc/perfsonar/psconfig/grafana-agent.json
Debian: /etc/perfsonar/psconfig/grafana-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 Grafana Agent Include Directory¶

Description: Directory for pSConfig templates that automatically get loaded by Grafana agent
CentOS: /etc/perfsonar/psconfig/grafana.d
Debian: /etc/perfsonar/psconfig/grafana.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 Grafana Agent Start-up Script¶

Description: Scripts used to start|stop|restart the pSConfig Grafana Agent
CentOS: systemctl start|stop|restart psconfig-grafana-agent
Debian: service psconfig-grafana-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 Grafana Agent Log¶

Description: Primary log for pSConfig Grafana Agent
CentOS: /var/log/perfsonar/psconfig-grafana-agent.log
Debian: /var/log/perfsonar/psconfig-grafana-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.

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

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