Skip to content

Latest commit

 

History

History
62 lines (41 loc) · 3.71 KB

install_quick_start.rst

File metadata and controls

62 lines (41 loc) · 3.71 KB

Toolkit Installation Quick Start

These instructions are for the full Toolkit installation on Alma 9 or Rocky 9. For other perfSONAR installation options, see :doc:`install_options`.

  1. Install Alma or Rocky 9 using your preferred method from https://almalinux.org/ or https://rockylinux.org/

  2. Login to the host and become sudo:

    sudo -s
    
  3. Run the following commands:

    dnf config-manager --set-enabled crb
    dnf install epel-release http://software.internet2.edu/rpms/el9/x86_64/latest/packages/perfsonar-repo-0.11-1.noarch.rpm
    dnf clean all
    dnf install perfsonar-toolkit
    
  4. Exit sudo and become sudo again to trigger login prompt:

    exit
    sudo -s
    
  5. You will be prompted to create a user and password that can be used to administer the host through the web interface. Follow the prompts to complete this step.
    images/install_quick_start-first-login-prompt.png
  6. Open http://<hostname> in a web browser where <hostname> is the name or address of your host

  7. Click on Edit (A) in the host information section of the main page or Configuration (B) button in the right-upper corner and login as the web administrator user created in the previous step

    images/install_quick_start-web-admin-info1.png
  8. On the page that loads, enter the requested information in the provided fields. In order to save Administrative Information you will be required to agree to the perfSONAR Privacy Policy. Tick the Privacy Policy checkbox to accept it. Click Save when you are done.

    images/install_quick_start-web-admin-info2.png
    .. seealso:: For more information on updating administrative information see :doc:`manage_admin_info`
    
  9. You are now ready to add some regular tests. Click on Configure tests in main page.

    images/install_quick_start-main-page.png
  10. On the page that loads click on the +Test button too choose and add the test type you would like.

    images/install_quick_start-add-test.png
  11. A drop-down list shows to choose test type. Click on a selected test type you would like to add.

    images/install_quick_start-add-test-type.png
  12. You will now be prompted for test parameters. Enter a human-readable description of the tests and change any parameters you desire. In general the defaults will be fine for most cases.

    images/install_quick_start-add-test-params.png
  13. You now need to select other test members to test against. Go to section Test members in the same page.

    images/install_quick_start-add-test-members-section.png
  14. You may add test members explicitly adding a host (A) or selecting browse communities and browsing the list (B). When you are done entering host details, hit Add host to add a test member to the list of hosts.

    images/install_quick_start-add-test-members-host.png
  15. Click OK to save test definition and close test configuration window. Then click the Save button at the bottom of the screen to apply your changes.
    .. seealso:: For more information on adding regular tests see :doc:`manage_regular_tests`
    
  16. After some time you may view the results of your tests in section Test Results in the main page.

    images/install_quick_start-test-results.png

    Warning

    It will take time for data to be collected and display on the graphs. For throughput data this may be several hours depending on the test interval. For all other test types, you should see data within 30 minutes.

    .. seealso:: For more information on using the graphs :doc:`using_graphs`