# PerfSONAR Install Guide (Package Manager)

**URL:** <https://ask.cyberinfrastructure.org/t/perfsonar-install-guide-package-manager/2038>\
**Category:** Kentucky Cyberteam\
**Tags:** network, performance\
**Created:** [September 7, 2021, 2:05pm UTC](https://ask.cyberinfrastructure.org/t/perfsonar-install-guide-package-manager/2038 "2021-09-07T14:05:21Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![tylerbrianburkett](https://ask.cyberinfrastructure.org/user_avatar/ask.cyberinfrastructure.org/tylerbrianburkett/32/732_2.png) [@tylerbrianburkett](https://ask.cyberinfrastructure.org/u/tylerbrianburkett)\
**Post date:** [September 7, 2021, 2:05pm UTC](https://ask.cyberinfrastructure.org/t/perfsonar-install-guide-package-manager/2038/1 "2021-09-07T14:05:21Z")

</div>

Setting up a PerfSONAR Node using the Package Manager

Introduction: This document provides instructions on setting up perfSONAR nodes on an already existing Linux computer using the Linux package manager. Use these instructions if you are using an already existing Linux server.

# Requirements:

- A Linux computer (CentOS 7) with an internet connection and public IP address
- A super-user account on the computer

# CentOS Install

## Installing the Software

1. Start by configuring yum. Run the following commands.

2. Disable Security-Enhanced Linux features (SELinux) using:

3. The above step is important since SELinux can potentially interfere with the installation of the perfSONAR toolkits

4. Install the perfSONAR toolkit bundle.

5. Enter “y” whenever prompted.

## Post-Install Configuration

1. Configure an admin account for the webUI by running the following command

2. When prompted with the screen below, type in “2” and hit “ENTER”

 ![](https://ask.cyberinfrastructure.org/uploads/default/original/1X/2dd1b4c45d2832be5ed977aa6fd1d71ce8537a3a.png)

1. When prompted with the screen below, type in “1” and hit “ENTER”

 ![](https://ask.cyberinfrastructure.org/uploads/default/original/1X/fbe4e6b194755cd016d28b78a2db032516a1de68.png)

1. Enter the username and password for the admin account you want to create. Make sure to pick a strong password.

![](https://ask.cyberinfrastructure.org/uploads/default/original/1X/56adf27a7b4a359726775012e222024db4c24327.png)

1. Enter “0” a couple of times to exit the script and return to the command line

2. (Optional) Check that the following services are running using the following command

## Finalizing perfSONAR Setup (via WebUI)

1. You can now login via the webUI at “https:///toolkit” using the web admin credentials you made in step 4.

 ![|624.1941197307829x351](https://ask.cyberinfrastructure.org/uploads/default/original/1X/a950b5cbb3965fcdaf0a22b12f1b567f1d034616.jpeg)

1. Click the “Configuration” button in the top right-hand corner. You will be prompted to enter in your web administrator username and password you made previously.

2. Here, you can add information about your organization name, administrator name, administrator email, etc.

3. You’ll need to mark the checkbox “I agree to the perfSONAR Privacy Policy” and then click the “Save button” at the bottom of the screen to save these changes.

 ![](https://ask.cyberinfrastructure.org/uploads/default/original/1X/24f334c7a10bf0e618f5b4b86ac1024762bf2aa9.png)

 ![](https://ask.cyberinfrastructure.org/uploads/default/original/1X/d51c7587b1b1b59778d5c5b1008dd2a3cf61dc80.png)

1. After some time (up to 24 hours but usually within an hour or so) you should be able to go to the perfSONAR global registry ([Grafana](http://stats.es.net/ServicesDirectory/)) and search for your node

 ![](https://ask.cyberinfrastructure.org/uploads/default/original/1X/52893adb1338a1f25ff7a3d83351e99167fdf8a4.png)

1. You should now be set up and can begin adding tests to your new perfSONAR node.

# Configuring tests with other hosts (via Web UI)

1. Click the “Configuration” button in the top right-hand corner to configure tests with other hosts. ![](https://ask.cyberinfrastructure.org/uploads/default/original/1X/6538b0225873f07ef6720305043e7a7bd1bf1143.png)
2. Click on “Tests”

 ![](https://ask.cyberinfrastructure.org/uploads/default/original/1X/ec34e73d414c328ed7c1b2f7d34ce6febc2d9f29.png)

1. Click on “+ Test” to add a test.
2. Select the type of test.

 ![](https://ask.cyberinfrastructure.org/uploads/default/original/1X/56e301d885f3318e1f0e1d84db7410ce42f6a95a.png)

1. Enter the test name/description and add Test Members
2. Enter Hostname/IP and Host description (optional) and click add host.

 ![](https://ask.cyberinfrastructure.org/uploads/default/original/1X/c7354bdb320d32acb87c2490384d54fda2a8755e.png)

1. Click OK.

At this point, your PerfSONAR node will start testing with the hosts added and you should be able to see the results in the “Test Results” section of your toolkit homepage.

# Configuring Tests with KYCyberteam

To configure tests, you need to download the configuration file given below.

1. Contact a member on the KYCyberteam to let them know you want to join the KYCyberteam tests

2. On the command line after you receive confirmation from the administrator, run the following commands to add the KYCyberteam test configuration file to your perfSONAR node.

3. Run the following command to restart pScheduler, the service which reads the configuration file and automatically begins running the tests.

4. After a couple of minutes, you should be able to see test results in the “Test Results” section of your perfSONAR web interface.

 ![|624x321.64652381419563](https://ask.cyberinfrastructure.org/uploads/default/original/1X/23fe8f00f9b49a86a44e2ad713fdb2f48c53d6eb.png)

For more information, visit the links below:

- Installing perfSONAR packages on CentOS: [https://docs.perfsonar.net/install\_centos.html](https://docs.perfsonar.net/install_centos.html)

- Configure the ToolKit for the first time: [https://docs.perfsonar.net/install\_config\_first\_time.html](https://docs.perfsonar.net/install_config_first_time.html#your-first-login)

- For updating PerfSONAR: [Updating perfSONAR — perfSONAR Toolkit 5.2.2 documentation](https://docs.perfsonar.net/manage_update.html)

- More of the KYCyberteam Documentation: [https://kycyberteam.ccs.uky.edu/](https://kycyberteam.ccs.uky.edu/)