Windows perfSONAR folder
In this exercise you will be using a Windows machine, installing the VirtualBox software package and installing the perfSONAR 3.3.2 Toolkit in to a virtual machine running in VirtualBox on top of Windows.
On the Desktop of your Windows machine you should see a perfSONAR folder:
Windows perfSONAR folder
Open the folder and then click on the VirtualBox installer icon:
perfSONAR folder
Follow the on-screen prompts to install the VirtualBox virtual machine software:
VirtualBox installer
When you are done installing VirtualBox you should see a VirtualBox icon on your Windows Deskotp. Now go to the next exercises.
In this exercise we will:
Once you are done with this we will do some initial configuration of the perfSONAR Toolkit server in the next exercise.
Now double-click on the VirtualBox icon on your Windows desktop. Once VirtualBox has started select the Machine menu and "New...":
New VirtualBox VM
Name your machine appropriately, select "Linux" as the machine type and "Other Linux (64-bit)" as the version:
VirtualBox VM type and version
Be sure to provide 2GB of RAM (2048MB) of RAM to the virtual machine:
VirtualBox VM type and version
For the next few steps please follow the screenshots provided below:
VirtualBox VM hard drive
VirtualBox VMDK disk image type
VirtualBox dynamically allocated storage
We provide 20GB of disk for the perfSONAR Toolkit and stored graph data. In real life you would likely want to have much more available disk for a perfSONAR node:
VirtualBox 20GB hard drive size
Before we start our new virtual machine and install the perfSONAR Toolkit we need to define how our networking hardware will be set up on the virtual machine. We are going to bridge our primary network interface to our virtual machine. Once installed we will statically define our virtual machine's network address.
Highlight the perfSONAR 3.3.2 Toolkit VM and then select the Machine menu and then "Settings...":
VirtualBox machine settings
Highlight the "Network" category:
VirtualBox machine settings network
From the "Attached to" drop-down menu select "Bridged Adapter":
VirtualBox machine network bridged adapter
Once you have selected "Bridged Adapter" your screen should look something like this:
VirtualBox machine network bridged adapter selected
Click on "OK" if the named adapter that has been chosen is the one your machine is actively using.
You are now ready to start your new virtual machine. You will point VirtualBox at the perfSONAR 3.3.2 Toolkit installation ISO provided in the perfSONAR folder on your Windows Desktop. Be sure to highlight the perfSONAR VM and then press the Start button as shown below:
VirtualBox initial VM run
One the VM starts it will ask you where the installation media or ISO image is located to install an operating system in to the prepared virtual machine:
VirtualBox instalation media
Select the perfSONAR folder on your Windows desk and highlight the perfSONAR 3.3.2 toolkit ISO image:
VirtualBox perfSONAR Toolkit ISO
Press the "Start" button once the ISO has been selected to start the installation prcoess:
VirtualBox perfSONAR Toolkit install
Now you will see the perfSONAR Toolkit initial CentOS 6.5 installation screen. This is a customized installer for the Linux CentOS version 6.5 64-bit Server that includes all the extra packages required to run the perfSONAR 3.3.2 Toolkit.
Press
perfSONAR Toolkit installation
Press
perfSONAR Toolkit installation welcome
To move around in dialogs use the tab key to go between elements, the arrow keys to scroll in lists and
Select "English' as the language, press tab if necessary to highlight the "OK" box and then press
perfSONAR Toolkit installation select language
For the next few screens please follow the screenshots below to continue:
perfSONAR Toolkit installation select keyboard
Scroll down the list of selections until you find Asia/Bangkok, tab to "OK" and press
perfSONAR Toolkit installation select time zone
We suggest you use the
perfSONAR Toolkit installation root password
Make sure "Replace existing Linux system" is selected, then select "OK" and press
perfSONAR Toolkit installation partition select
You will now see the installation program install many packages. This might take a few minutes:
perfSONAR Toolkit installation install packages
Once the installer completes you will be asked to reboot the virtual machine (not your Windows desktop). Go ahead and press
perfSONAR Toolkit installation install complete, reboot
Now you should remove the perfSONAR Toolkit ISO image from the virtual CD-ROM drive by following selection shown below using the Devices menu. If you do not do this quickly enough the perfSONAR Toolkit installation will start again. That's OK. You can power down the virtual machine by clicking on the close box for the window and then selecting the Devices menu, then starting the machine again.
VirtualBox power down virtual machine
Once you have remove the perfSONAR Toolkit ISO image as the boot disk you will start a CentOS Linux server in its default state and you will see the following. To complete the configuration of your perfSONAR Toolkit 3.3.2 installation please go to the next exercise set.
In this exercise we will do:
Once you have restarted your virtual machine in VirtualBox and remove the perfSONAR 3.3.2 Toolkit ISO image from the virtual CD-ROM drive you should see the following inital login prompt in the VirtualBox machine console window:
perfSONAR Toolkit initial logon
Log in to your perfSONAR Toolkit instance as the user root. Use the password you entered during the perfSONAR Toolkit installation:
perfSONAR Toolkit initial logon as root
And, you should now see:
perfSONAR Toolkit initial logon
As you can see if you wish to run the perfSONAR configuration script you need to type in a long command. Let's make this a bit simpler by creating an alias to this script that we can use. Let's call this alias "perfsonar" - To do this type:
# ln -s /opt/perfsonar_ps/toolkit/scripts/nptoolkit-configure.py /usr/local/bin/perfsonarNow you can just type "perfsonar" on the command line to execute the perfSONAR Toolkit configuration script.
Let's do this now to configure your machine's static, public IP address. For this class we have the block of IP addresses defined by 203.159.61.0/24. We are going to map your perfSONAR Toolkit's public IP address to the pc number you are using in class.
Here is a short table for reference:
Public IP Addresses for perfSONAR Toolkits
Additionally, the remaining network information you will need is:
203.159.61.254255.255.255.010.10.0.241perfsonar1NNws.nsrc.orgReplace "NN" with your class pc number (i.e. 1..36).
You do not need to enter in a Secondary or Tertiary DNS in class. At home we would recommend that you include at least a secondary DNS in your configuration.
Now let's configure your machine's network information. Start the perfSONAR Toolkit configuration script:
# perfsonarYou will see something like this:
perfSONAR Toolkit configuration script
Select option 2 (Configure Networking):
You will see a window like this. Select "Device configuration" and press
perfSONAR configuration select device
Select the "eth0" device:
perfSONAR configuration select eth0
Now configuration your network using the information from above. Replace "NN" with your pc number from class (i.e., 1...36):
perfSONAR network configuration
Be sure to select "Ok" and press
perfSONAR DNS configuration
Now you should see:
perfSONAR DNS configuration details
Fill in the fields as shown, but be sure you replace "NN" in Hostname with the number of your pc in class.
Once you are done select "Ok" and press
perfSONAR Device configuration finish
Be sure you select "Save&Quit" and press
perfSONAR Device configuration screen
Select "0" to "exit" and press
perfSONAR configuration screen reboot
Type in "y" and press
In this exercise we will do:
These steps are done via the perfSONAR Toolkit web interface. To find the perfSONAR Toolkit web interface running on the machine you have just installed you should open a web browser and go to the URL:
http://203.159.61.1NNWhere "1NN" is the number of your pc. For example:
You see an initial screen that looks like:
perfSONAR inital web screen
The first thing we want to do is to register your perfSONAR Toolkit node in the perfSONAR global Lookup Service (LS). To do this you you need to click on the "Administrative Administration" link on the middle-left of the perfSONAR Toolkit web interface:
perfSONAR inital web screen admin login
When you do this you you will need to accept the site certificate for your local server, then you will need to log in as user root with the password you selected during the perfSONAR Toolkit installation:
perfSONAR web certificate
Next log in as user root:
perfSONAR web login
Now you will be presented with the following screen for Host Information. You should fill this out and save the changes to ensure that your perfSONAR Toolkite node registers itself in the perfSONAR Global Lookup service.
perfSONAR Host Information
You may notice the latitude and longitude fields. If you feel these in, then your perfSONAR node can appear in the Lookup Service Directory (http://stats.es.net/ServicesDirectory/) pages at the right physical location:
Fill in the fields with appropriate information. Below is an example you can follow if you wish. Note that the Organization Name field is what is used to search for your node in the perfSONAR Lookup Services:
perfSONAR Host Information sample
One you are finished you must click the "Save" button for your changes to take affect:
perfSONAR Host Information save
The final item we will take care of during our initial configuration of your perfSONAR Toolkit node is to enable SSH on the server. You need to do this via the perfSONAR Toolkit web interface and not at the Linux command line as the perfSONAR processes will just diasable the service once the Toolkit is restarted if SSH is not enabled from within the interface.
To do this click on the "Enabled Services" item under the "Toolkit Administration" category on the left of the web interface:
perfSONAR Enable Services SSH
Note that the SSH service is not enabled by default. Click on the SSH box and press the Save button to enable the SSH service:
perfSONAR Services SSH selected
You will a dialogue about saving configuration and restarting services:
perfSONAR saving changes
NTP Configuration
As a final item you may wish to click on the NTP link under the Toolkit Administration category to the left. From there you can tell perfSONAR to "Select Closest Servers" and then go ahead and choose these as the NTP reference servers your Toolkit installation uses. Remember to click on "Save" if you wish to keep the changes.
Further perfSONAR Toolkit Configuration
Next we will configure some initial tests to run under the "Scheduled Tests" option. We will do this in class.