Skip to content

Commit 452b5d1

Browse files
committed
More file path and name updates
1 parent ef7c95f commit 452b5d1

9 files changed

+17
-23
lines changed

Diff for: config_bwctl.rst

+4-4
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
BWCTL Server Configuration File
33
*********************************
44

5-
By default, the /etc/bwctld/bwctld.conf on the perfSONAR toolkit uses the following ports:
5+
By default, the /etc/bwctl-server/bwctl-server.conf on the perfSONAR toolkit uses the following ports:
66

77
.. code-block:: none
88
@@ -15,8 +15,8 @@ By default, the /etc/bwctld/bwctld.conf on the perfSONAR toolkit uses the follow
1515
You can edit that file if you want to change those port ranges. Note that if you make the port
1616
range too small, tests to/from your host will fail.
1717

18-
You can also control what tests are allowed using bwctld.conf. For example, if want to allow
19-
bwctld to run low bandwidth tools like ping and owping, but not throughput tools, you can use 'disable_[tool name]'.
18+
You can also control what tests are allowed using bwctl-server.conf. For example, if want to allow
19+
bwctl-server to run low bandwidth tools like ping and owping, but not throughput tools, you can use 'disable_[tool name]'.
2020
For example:
2121

2222
.. code-block:: none
@@ -27,6 +27,6 @@ For example:
2727
disable_nuttcp
2828
2929
30-
More information on bwctld.conf is available at:
30+
More information on bwctl-server.conf is available at:
3131
* http://software.internet2.edu/bwctl/bwctld.conf.man.html
3232

Diff for: config_bwctl_limits.rst

+2-2
Original file line numberDiff line numberDiff line change
@@ -2,14 +2,14 @@
22
BWCTL Limits File
33
******************
44

5-
You can control access to the bwctl server via the file /etc/bwctld/bwctld.limits.
5+
You can control access to the bwctl server via the file /etc/bwctl-server/bwctl-server.limits.
66

77
Information on how to use this file can be found at:
88
* http://software.internet2.edu/bwctl/bwctld.limits.man.html
99

1010
By default, the perfSONAR toolkit allows access from anywhere, and limits TCP tests to 30 seconds, and UDP tests to 900Mbps and 30 seconds.
1111

12-
ESnet generates a nighly update of bwctld.limits that allows testing from all Research and Education networks around the world, and nothing else.
12+
ESnet generates a nighly update of bwctl-server.limits that allows testing from all Research and Education networks around the world, and nothing else.
1313

1414
Information on how to use this file is available at:
1515
* http://fasterdata.es.net/performance-testing/perfsonar/esnet-perfsonar-services/esnet-bwctld-limits-file/

Diff for: config_files.rst

+2-2
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ Log Files
5252
Primary Log file
5353
##########################
5454
: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.
55-
:RedHat: **RPM Only**: ``/var/log/messages`` **Toolkit or Complete Install:** ``/var/log/perfsonar/owamp_bwctl.log``
55+
:RedHat: **RPM Only**: ``/var/log/messages`` **Toolkit:** ``/var/log/perfsonar/owamp_bwctl.log``
5656
:Debian: ``/var/log/messages``
5757

5858

@@ -337,7 +337,7 @@ Log Files
337337
Primary Log file
338338
##########################
339339
: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.
340-
:RedHat: **RPM Only**: ``/var/log/messages`` **Toolkit or Complete Install:** ``/var/log/perfsonar/owamp_bwctl.log``
340+
:RedHat: **RPM Only**: ``/var/log/messages`` **Toolkit:** ``/var/log/perfsonar/owamp_bwctl.log``
341341
:Debian: ``/var/log/messages``
342342

343343
Regular Testing

Diff for: config_ls_registration.rst

+3-3
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ Lookup Service Registration Daemon Configuration File
55
Overview
66
========
77

8-
The file *ls_registration_daemon.conf* is used to define what gets registered into the lookup service. The file allows a degree of flexibility in what is manually defined versus what is automatically discovered. In most cases, the defaults of this file will be suitable and you should not need to make any changes. Some situations where you might want to edit this file though are (this is not an exhaustive list):
8+
The file *lsregistrationdaemon.conf* is used to define what gets registered into the lookup service. The file allows a degree of flexibility in what is manually defined versus what is automatically discovered. In most cases, the defaults of this file will be suitable and you should not need to make any changes. Some situations where you might want to edit this file though are (this is not an exhaustive list):
99

1010
* You have a private lookup service and would like to only register to that service. See :ref:`config_ls_registration-ls_instance`
1111
* You have a host with multiple network interfaces and would like to choose the interface on which a particular service or set of services run
@@ -19,9 +19,9 @@ The basic structure of the file is as follows:
1919
* A list of :ref:`host <config_ls_registration-host>` directives within those sites that represent the host to be registered. If the host in question is the host on which the LS Registration Daemon is running, than many of the values can be auto-discovered.
2020
* A list of :ref:`service <config_ls_registration-service>` directives within those hosts that represent the services to be registered.
2121

22-
The *ls_registration_daemon.conf* has the feature that almost any directive can be defined at a higher level in the configuration hierarchy and be inherited by all the descendents. For example, one can define the :ref:`latitude <config_ls_registration-latitude>` and :ref:`longitude <config_ls_registration-longitude>` directives at the top-level of the file. All registered hosts and services will in turn inherit these properties. In contrast, you can define them directly in each host directive if you want each individual host to have different values. You can even define both and have the more specific values in the host directive override the ones defined at a higher level in the hierarchy.
22+
The *lsregistrationdaemon.conf* has the feature that almost any directive can be defined at a higher level in the configuration hierarchy and be inherited by all the descendents. For example, one can define the :ref:`latitude <config_ls_registration-latitude>` and :ref:`longitude <config_ls_registration-longitude>` directives at the top-level of the file. All registered hosts and services will in turn inherit these properties. In contrast, you can define them directly in each host directive if you want each individual host to have different values. You can even define both and have the more specific values in the host directive override the ones defined at a higher level in the hierarchy.
2323

24-
With these items in mind the remainder of this section contains a full reference of the options available in the *ls_registration_daemon.conf* file.
24+
With these items in mind the remainder of this section contains a full reference of the options available in the *lsregistrationdaemon.conf* file.
2525

2626

2727

Diff for: config_mesh.rst

+1-1
Original file line numberDiff line numberDiff line change
@@ -204,7 +204,7 @@ write_url Directive
204204
:Occurrences: Exactly one
205205
:Compatibility: 3.3, ignored in 3.4, supported again in 3.5 or later
206206

207-
This is the URL where tools, such as regular_testing on the perfSONAR Toolkit, should send results. This value is only useful if your measurement archive is using IP authentication. if using API key authentication, you will need to define the measurement archive in your local regular_testing.conf file. This is because it is not safe for the MeshConfig to share login credentials in it's current form and would be difficult to manage in a large mesh.
207+
This is the URL where tools, such as regular-testing on the perfSONAR Toolkit, should send results. This value is only useful if your measurement archive is using IP authentication. if using API key authentication, you will need to define the measurement archive in your local regulartesting.conf file. This is because it is not safe for the MeshConfig to share login credentials in it's current form and would be difficult to manage in a large mesh.
208208

209209
Defining Test Parameters
210210
========================

Diff for: config_owamp.rst

+2-2
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
OWAMP Server Configuration File
33
*************************************
44

5-
By default, the /etc/owampd/owampd.conf on the perfSONAR toolkit uses the following ports:
5+
By default, the /etc/owamp-server/owamp-server.conf on the perfSONAR toolkit uses the following ports:
66

77
.. code-block:: none
88
@@ -11,6 +11,6 @@ By default, the /etc/owampd/owampd.conf on the perfSONAR toolkit uses the follow
1111
You can edit that file if you want to change those port ranges. Note that if you make the port
1212
range too small, tests to/from your host will fail.
1313

14-
More information on owampd.conf is available at:
14+
More information on owamp-server.conf is available at:
1515
* http://software.internet2.edu/owamp/owampd.conf.man.html
1616

Diff for: config_owamp_limits.rst

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
OWAMP Limits Configuration File
33
**************************************
44

5-
You can control the total traffic load to the owamp server via the file /etc/owampd/owampd.limits.
5+
You can control the total traffic load to the owamp server via the file /etc/owamp-server/owamp-server.limits.
66

77
By default, the perfSONAR Toolkit allows up to 10Mbps of owamp traffic.
88

Diff for: multi_ma_install.rst

+1-7
Original file line numberDiff line numberDiff line change
@@ -208,15 +208,9 @@ Given all the information above, lets look at an example where we want to regist
208208

209209
After adding the above to you configuration you will need to restart your regular testing:
210210

211-
**RedHat/CentOS**::
212-
213-
/sbin/service regular_testing restart
214-
215-
**Debian**::
216-
217211
/etc/init.d/perfsonar-regulartesting restart
218212

219-
.. note:: If you central measurement archive goes down for any reason, the regular_testing daemon will queue results on the local disk under the :ref:`test results directory <config_regular_testing-test_result_directory>` as specified in your :ref:`regular_testing.conf <config_files-regtesting-conf-main>` file. It will try to register any results on disk when your measurement archive returns. Since accumulating too many files can cause trouble for disk space and/or the regular_testing daemon's ability to keep up with registering data, these files are cleaned nightly on toolkit installations.
213+
.. note:: If you central measurement archive goes down for any reason, the regular_testing daemon will queue results on the local disk under the :ref:`test results directory <config_regular_testing-test_result_directory>` as specified in your :ref:`regulartesting.conf <config_files-regtesting-conf-main>` file. It will try to register any results on disk when your measurement archive returns. Since accumulating too many files can cause trouble for disk space and/or the regular_testing daemon's ability to keep up with registering data, these files are cleaned nightly on toolkit installations.
220214

221215
Registering to Multiple Measurement Archives
222216
--------------------------------------------

Diff for: multi_mesh_autoconfig.rst

+1-1
Original file line numberDiff line numberDiff line change
@@ -273,7 +273,7 @@ You'll also want to make sure the following is set if you would like to use the
273273

274274
.. note:: This *configure_archives* option assumes the measurement archive provided by the mesh configuration file has :ref:`IP authentication <multi_ma_install-auth_ip>` setup for this host. This is because the mesh configuration cannot securely distribute usernames and API keys. See the :ref:`measurement archive documentation <multi_ma_install-auth_ip>` for information on how to configure IP authentication on your archive server.
275275

276-
You'll also want to set the following if you are NOT using a Toolkit deployment or the perfSONAR-Complete bundle::
276+
You'll also want to set the following if you are NOT using a Toolkit deployment::
277277

278278
use_toolkit 0
279279

0 commit comments

Comments
 (0)