PerfSONAR Install Guide (Package Manager)

Cyberteams Kentucky Cyberteam
,
1

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.

    sudo yum install epel-release
sudo yum install http://software.internet2.edu/rpms/el7/x86_64/latest/packages/perfSONAR-repo-0.10-1.noarch.rpm
sudo yum clean all

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

    sudo setenforce 0

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

  4. Install the perfSONAR toolkit bundle.

    sudo yum install perfsonar-toolkit

  5. Enter “y” whenever prompted.

Post-Install Configuration

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

    sudo /usr/lib/perfsonar/scripts/nptoolkit-configure.py

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

717×129 2.5 KB

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

698×144 3.71 KB

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

692×72 2.21 KB

  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

    systemctl status SERVICE-NAME

    a. The following are service names you can use in the above command to ensure the node is up and running

    • pscheduler-scheduler
    • pscheduler-runner
    • pscheduler-archiver
    • pscheduler-ticker
    • psconfig-pscheduler-agent
    • owamp-server
    • twamp-server
    • perfsonar-lsregistrationdaemon

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
|624.1941197307829x3511675×941 129 KB

  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.

1680×943 65 KB

966×734 38.6 KB

  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 (Lookup Service Directory) and search for your node

    a. You can either use the search bar to find you node or scroll on the online map to where you node is physically located to find kit

1679×944 241 KB

  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.
    2048×1000 236 KB
  2. Click on “Tests”

2048×1000 158 KB

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

2048×1000 93.3 KB

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

2048×1000 140 KB

  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

    a. Current contacts for the team

    b. Make sure to include the IP address and hostname of the perfSONAR node you want to use

  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.

    a. Substitute the URL in the command with the one provided by the administrator.

    sudo psconfig remote add --configure-archives "https://maddash.ccs.uky.edu/psconfig/kycyberteam-config.json"

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

    sudo systemctl restart psconfig-pscheduler-agent

  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
|624x321.64652381419563719×371 80.7 KB

For more information, visit the links below: