= perfSONAR Bundle Installation =

=== perfSONAR Installation Options ===
There are five perfSONAR installation options (different packages) in which four of them contains network measurement testing tools and other one contains perfSONAR management tools.

Below graphics shows the relationship between them.

[[Image(https://ws.learn.ac.lk/raw-attachment/wiki/netmon2017perfsonar/ps1.png)]]

{{{
# sudo su
# cd /etc/apt/sources.list.d/
# curl -o perfsonar-release.list http://downloads.perfsonar.net/debian/perfsonar-release.list
# curl http://downloads.perfsonar.net/debian/perfsonar-official.gpg.key | apt-key add -
# add-apt-repository universe
# apt update
}}}

=== Step 2: Install a Bundle ===
perfSONAR Toolkit:
{{{
# apt install perfsonar-toolkit
}}}
''' NOTE: ''' During the installation process, you’ll be asked to choose a password for the pscheduler and the esmond databases. Use ''' '1234' ''' as the password or anything you preferred.

wait for installation to complete.Then reboot the system.
{{{
# reboot now
}}}

=== Step 3: Starting your services (optional) ===
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:

{{{
# service pscheduler-scheduler status
# service pscheduler-runner status
# service pscheduler-archiver status
# service pscheduler-ticker status
# service owamp-server status
# service perfsonar-lsregistrationdaemon status
}}}

If they are not running you may start them with appropriate service commands as a root user. For example :
{{{
# service pscheduler-scheduler start
# service pscheduler-runner start
# service pscheduler-archiver start
# service pscheduler-ticker start
# service owamp-server start
# service perfsonar-lsregistrationdaemon start
}}}

=== Step 4 :Configuring the Toolkit for the First Time  ===
After booting the system, run the following command to configure the perfSonar web users.
{{{
# sudo su
# /usr/lib/perfsonar/scripts/nptoolkit-configure.py
}}}

This will open the ''' perfSONAR Toolkit customization script ''' with a menu as follows;
{{{
perfSONAR Toolkit customization script

1. Change Timezone
2. Manage Web Users
0. exit

Make a selection:

}}}

Enter 2 and proceed

{{{
Welcome to the perfSONAR Toolkit user administration program.
This program will help you administer users.
You may configure any of the options below with this program:
        1. Add a new user
        2. Delete a user
        3. Change a user's password
        0. exit
Make a selection: 1

}}}

Enter 1 and proceed

Use ''' admin ''' as account name and ''' 1234 ''' as password.
{{{
Enter the user whose account you'd like to add. Just hit enter to exit: admin
New password:
Re-type new password:
Adding password for user admin

}}}

Then enter 0 and exit from the customization script.

=== Step 5: Accessing the Web Interface ===
You may access the web interface by typing''' https://<hostname>/toolkit ''' in your web browser.