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