Changes between Version 21 and Version 22 of GEMINIv1.1Tutorial


Ignore:
Timestamp:
10/22/12 17:07:36 (12 years ago)
Author:
Ahmed El-Hassany
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • GEMINIv1.1Tutorial

    v21 v22  
    399399=== 3) Configure I&M tools and experiment services ===
    400400
    401 3.1)   Configure selected I&M services
     4013.1)   Configuring Active Measuremens
    402402
    403403 - objectives:
     
    407407 
    408408 - at completion:    configured I&M services, ready to run and collect data
     409
     410
     411
     412The GEMINI I&M system in its current version facilitates regular measurements of throughput, one-way delay and round-trip delay. Other metrics like jitter and loss can also be derived from these measurements.
     413
     414The GEMINI services on a given node are configured by the pSConfig service. This service reads configuration stored in UNIS as part of the node's topology information and applies it to local configuration files. pSConfig will also start enabled services or stop disabled services that are running.
     415
     416We will now configure one-way (OWAMP) and round-trip (Ping) latency regular tests according to the following diagram.
     417
     418[[Image(latency-tests.png)]]
     419
     420===== 3.1.1 Accessing pSConfig UI =====
     421
     422To configure active measurements we access the pSConfig Web UI. You can find the URL by clicking on the MC node on the GEMINI portal, or by going to https://<gn node>/psconfig.
     423
     424[[Image(psconfig-portal.png)]]
     425
     426The certificate used by the web server is self-signed, so you will have to add an exception on the browser to proceed.
     427
     428[[Image(psconfig-secexception.png)]]
     429
     430After adding the exception you should see another pop-up for a certificate request. This time you're providing your user certificate to the service. Make sure the user that is shown for the certificate is the one assigned to you for the tutorial. In this example I'm using the user ''gemini20''. In case you did not see this pop-up or cannot see your user, please redo the steps on [wiki:GEMINIGEC14VMInstructions User Workspace - Accessing the portal].
     431
     432[[Image(psconfig-usercert.png)]]
     433
     434The main page of the pSConfig UI shows what services are currently enabled for each node. It also shows the last time we have synchronized with UNIS (remember that configuration information resides in UNIS). There are other agents that could be changing the information on UNIS, and the pSConfig UI will make sure we don't overwrite changes made since the last pull (i.e. a race condition). It is always a good idea to first pull the current configuration from UNIS before making changes.
     435
     436[[Image(psconfig-main.png)]]
     437
     438===== 3.1.2 Enabling Services =====
     439
     440After we've made sure to have a recent copy of the topology information, we can move on to the Manage Services administration page. On this page we will enable the services required to perform on-demand and regularly scheduled tests. We start by enabling the throughput and one-way latency services on PCA. Make sure to save the changes before continuing to the next node.
     441
     442[[Image(psconfig-managepca.png)]]
     443
     444We then proceed to configure the services on nodes PCB and PCC. Since PCB will be the gateway, we will only enable the daemons for the tools used (owamp and bwctl). PCC will have all the latency services and the daemon for throughput measurements. Note that PingER is only enabled on PCC, and we will configure our Ping measurement on that node. (We will use PCA for the scheduled throughput measurements at the end of the tutorial.)
     445
     446[[Image(psconfig-managepcbpcc.png)]]
     447
     448Now that we've enabled the services for our active measurements we will push the configuration to UNIS. To do this we need to go back to the Configuration Status page and then click the Push Configuration to UNIS. You can verify the list of services enabled for each node (i.e. the list in the image should match what you see).
     449
     450[[Image(psconfig-managepush.png)]]
     451
     452If everything goes well we should see a green message "Configuration pushed to UNIS.". However, the page auto reloads after this, so you might miss it if not paying attention. If there is no error message, the push completed successfully and the modification time will be 'never'.
     453
     454Success:
     455
     456[[Image(psconfig-managepushsuccess.png)]]
     457
     458Failure (unfortunately, you will have to redo the steps above in the case of a race condition):
     459
     460[[Image(psconfig-managepushfailure.png)]]
     461
     462===== 3.1.3 Configuring Regular Active Measurements =====
     463
     464Enabling the OWAMP and BWCTL daemons is all we need to perform on-demand active measurements. However, it's usually better to have active measurements running regularly to analyze the performance over time. Throughput and ping tests can be scheduled with a given interval (e.g. every 30 minutes). One-way delay tests are scheduled as a stream (a constant amount of packets is sent per second).
     465
     466To schedule regular tests we go to the Schedule Tests administration page.
     467
     468[[Image(psconfig-schedule.png)]]
     469
     470We will schedule OWAMP tests from PCA to PCB. We could schedule them on either endpoint, as long as both of them are running the appropriate pSBOUY Regular Testing service. In this case we schedule the tests on PCA by selecting it and adding a new OWAMP test. Clicking the Add New One-Way Delay Test button will pop-up the options to configure the test. The description for the test is only important to you, the services don't use it directly. You can change the packet rate and the packet size used for the test, but we will use the default for the tutorial.
     471
     472[[Image(psconfig-schedule-pcacreate.png)]]
     473
     474The test we've added establishes the test parameters for a given "star" mesh configuration. We can add multiple targets for this mesh (for OWAMP tests will run in parallel, for BWCTL measurements will be serialized). In this case we add PCB as a target and save the test.
     475
     476[[Image(psconfig-schedule-pcasave.png)]]
     477
     478Now we do the same thing on node PCC (one-way delay test to PCB).
     479
     480[[Image(psconfig-schedule-pccowd.png)]]
     481
     482We also add a Ping test between nodes PCA and PCC, scheduled at node PCC (this is where we enabled the PingER service).
     483
     484[[Image(psconfig-schedule-pccping-add.png)]]
     485
     486We can configure the standard ping parameters and the description for our test. The default has a relatively large packet size, so keep this in mind when analyzing the latency results (the ideal is to have packets the size of your experiment's packets). After creating the test we need to add our targets (PCA) and save the test. ''NOTE: You could use the 'Add New Host' button to add hosts outside of the slice (e.g. to ping geni.net).''
     487
     488[[Image(psconfig-schedule-pccping-save.png)]]
     489
     490After adding all these tests we go back to the Configuration Status page and push the configuration to UNIS.
     491
     492[[Image(psconfig-schedule-push.png)]]
     493
     494===== 3..14 Applying the Configuration =====
     495
     496pSConfig will pull the node's configuration from UNIS every 30 minutes (from the time it was started, not hh:00 and hh:30). Since we don't want to wait this long to start gathering data, we can restart pSConfig on each node by clicking the Apply Config link. This is achieved by ssh'ing to the node and restarting pSConfig, so errors are usually ssh related.
     497
     498[[Image(psconfig-apply.png)]]
     499
     500Make sure you apply the configuration on all three nodes. We will now run the user experiment to generate some heavier traffic on the slice before looking at the data.
     501
     502
    409503 
    410504