Skip to content

Commit a334dad

Browse files
committed
Some general cleanup for 5.1.0
1 parent 0c4a6cc commit a334dad

9 files changed

+16
-257
lines changed

conf.py

+2-2
Original file line numberDiff line numberDiff line change
@@ -53,9 +53,9 @@
5353
# built documents.
5454
#
5555
# The short X.Y version.
56-
version = '5.0.7'
56+
version = '5.1.0'
5757
# The full version, including alpha/beta/rc tags.
58-
release = '5.0.7'
58+
release = '5.1.0 Beta 1'
5959

6060
# The language for content autogenerated by Sphinx. Refer to documentation
6161
# for a list of supported languages.

images/intro_about-arch.png

12.6 KB
Loading

index.rst

-2
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,6 @@ Installation
3535
install_quick_start
3636
install_config_first_time
3737
install_el
38-
install_centos
3938
install_debian
4039
install_docker
4140
install_ansible
@@ -80,7 +79,6 @@ Running Measurements with pScheduler
8079
pscheduler_ref_tests_tools
8180
pscheduler_ref_archivers
8281
pscheduler_ref_contexts
83-
pscheduler_ref_bwctl
8482
pscheduler_disk_to_disk
8583

8684
Managing Multiple Hosts with pSConfig

install_centos.rst

-195
This file was deleted.

install_config_first_time.rst

+2-3
Original file line numberDiff line numberDiff line change
@@ -72,11 +72,10 @@ perfSONAR hosts are just like any other host and need to be actively managed to
7272
* An important aspect of security is to stay informed. Multiple system administrators from your site should be subscribed to the perfsonar security `announcement list <https://lists.internet2.edu/sympa/subscribe/perfsonar-announce>`_. This mailing list keeps users up-to-date on actions that need to be taken when critical security updates for both perfSONAR and third-party packages are released.
7373
* Always follow best common security practices when it comes to creating user accounts and choosing passwords. Normal precautions should be taken to protect the root password as it can be used to make changes to the system. For example, safe password practices would recommend a password that contains a mixture of letters of different case, numbers, symbols, and a length greater than 8. It is also not recommend to re-use passwords on multiple machines, in the event of a system breach.
7474
* If you have enabled SSH on the system, consider restricting access to specific subnets to the SSH port via IPTables, or implement a *jump host* that allows only logins from one location.
75-
* Consider configuring rsyslog to send logs to other locations for aggregation and analysis
75+
* Consider configuring syslog to send logs to other locations for aggregation and analysis
7676
* If email has been enabled on the host, forward email from root to a central location
7777
* If applicable, use a management network on a spare networking interface to further restrict the access profile for users and system data.
78-
* If your site uses any form of automated management (CFEngine, Puppet, Forman, etc.), integrate the perfSONAR node into this procedure.
79-
* If you run `Nagios <http://www.nagios.org>`_, add your perfSONAR host to your monitoring infrastructure. Consider running some of the nagios `security plugins <http://exchange.nagios.org/directory/Plugins/Security#/>`_ such as `check_yum <http://exchange.nagios.org/directory/Plugins/Operating-Systems/Linux/check_yum/details>`_
78+
* If your site uses any form of automated management (e.g. Ansible), integrate the perfSONAR node into this procedure.
8079
* Automatic updates are enabled by default on all perfSONAR Toolkit hosts. In order to understand how to update your Toolkit and if automatic updates are right for your system, see :doc:`manage_update`
8180
* The perfSONAR Toolkit ships with a default iptables rule-set and intrusion detection system (IDS) software. In order to learn more about these components and how to do things like add custom firewall rules see :doc:`manage_security`
8281

install_el.rst

+7-32
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,14 @@
11
************************************************************
22
Bundle Installation on RedHat Enterprise Linux Variants
33
************************************************************
4-
5-
note:: For older CentOS 7 installation see :doc:`install_centos`
6-
74

85
perfSONAR combines various sets of measurement tools and services bundled in different useful ways. RPMs are available that install the bundles described in :doc:`install_options`. The steps in the remaining sections of this document detail the steps required for installing these bundles.
96

107
System Requirements
118
====================
129
* **Operating System:**
1310

14-
* **Alma 8, Alma 9, Rocky 8 or Rocky 9** x86_64 installations are supported. Other RedHat-based operating systems may work, but are not officially supported at this time.
11+
* **Alma 9 or Rocky 9** x86_64 installations are supported. Other RedHat-based operating systems based on EL9 may work, but are not officially supported at this time.
1512
* See :doc:`install_hardware` for hardware requirements and more.
1613

1714
.. note:: Installing a graphical/desktop environment with perfSONAR is not supported. These environments generally come with a Network Manager that conflicts with the way that perfSONAR is tuning the network interface parameters. We recommend doing only server grade OS installs.
@@ -25,29 +22,19 @@ Installation
2522

2623
Step 1: Configure DNF
2724
----------------------
28-
.. note:: If your system is using dnf/yum priorities make sure that repositories required for perfSONAR are higher priority than anything else to avoid conflicts with older versions. Please note that yum maintainers do not recommend using priorities.
25+
.. note:: If your system is using dnf priorities make sure that repositories required for perfSONAR are higher priority than anything else to avoid conflicts with older versions. Please note that dnf maintainers do not recommend using priorities.
2926

3027
The process configures dnf to point at the necessary repositories to get packages needed for perfSONAR. **You will need to follow the steps below as privileged user**:
3128

32-
.. note:: All commands work on both EL8 and EL9 based operating systems unless otherwise indicated
33-
3429
#. Install the EPEL RPM::
3530

3631
dnf install epel-release
3732

38-
#. **EL8-only** Enable the PowerTools repository on an EL8 system::
39-
40-
dnf config-manager --set-enabled powertools
41-
42-
#. **EL9-only** Enable the CBR repository on an EL9 system::
33+
#. Enable the CBR repository::
4334

4435
dnf config-manager --set-enabled crb
4536

46-
#. **EL8-only** Install the perfsonar-repo RPM for EL8::
47-
48-
dnf install http://software.internet2.edu/rpms/el8/x86_64/latest/packages/perfsonar-repo-0.11-1.noarch.rpm
49-
50-
#. **EL9-only** Install the perfsonar-repo RPM for EL9::
37+
#. Install the perfsonar-repo RPM for EL9::
5138

5239
dnf install http://software.internet2.edu/rpms/el9/x86_64/latest/packages/perfsonar-repo-0.11-1.noarch.rpm
5340

@@ -145,29 +132,17 @@ You can also enable dnf ‘auto updates’ to ensure you always have the most cu
145132

146133
.. _install_el_step6:
147134

148-
Step 6: Service Watcher
149-
------------------------
150-
The ``perfsonar-toolkit-servicewatcher`` installs scripts that check if important processes are running and restarts if they have stopped unexpectedly.
151-
152-
The install automatically configures cron to run the service_watcher regularly.
153-
154-
To run the script manually, run::
155-
156-
/usr/lib/perfsonar/scripts/service_watcher
157-
158-
.. _install_el_step7:
159-
160-
Step 7: Register your services
135+
Step 6: Register your services
161136
-------------------------------
162137

163138
Note: this step can be done through the web interface if the perfsonar-toolkit bundle was installed.
164139
See :doc:`manage_admin_info`.
165140

166141
No actual configuration is required but filling fields such as administrator_email, site_name, city, country, latitude, longitude, etc. are **highly recommended**. You can add these by removing the leading `#` of any property and filling it out with a proper value for your host. Changes will be picked-up automatically without need for any restarts.
167142

168-
.. _install_el_step8:
143+
.. _install_el_step7:
169144

170-
Step 8: Starting your services
145+
Step 7: Starting your services
171146
-------------------------------
172147
All services should be started after install. Additionally, you can start all the services by rebooting the host since all are configured to run by default. In order to check services status issue the following commands::
173148

0 commit comments

Comments
 (0)