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 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.

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