= Tutorial of using OnTimeMeasure with Emulab Java UI = '''Yingxiao Xu, Prasad Calyam'''[[BR]] '''January 31, 2012''' ''Software License:'' [http://www.geni.net/wp-content/uploads/2009/02/geniprojlic.pdf ''GENI Project License (GPL)''] This is a step-by-step installation and hands-on tutorial of using OnTimeMeasure with Emulab Java UI == 1. Pre-requisites == You must have an account setup on one of the emulab aggregates. If you have not account, you can access www.emulab.net and clicking on the "Request Account" button to apply for an account. Please note that it may take a while for approval of your account in emulab. You browser must be Java enabled. If not, please download and install it in http://java.com/en/download/index.jsp == 2. Login == Login by visiting - http://www.emulab.net/ with web-browser and click login button. [[Image(image001.png,60%)]] Enter email address and password, then click login. == 3. Create Slice == Click the Experimentation/Begin an Experiment after login, you will get UI below. [[Image(image002.png,60%)]] Click "New GUI editor" link, if the following dialog appears, click "OK" button. [[Image(image003.png)]] you will get UI to create slice. [[Image(image004.png)]] Drag the Node button to the panel. Set Name of the node, Input FEDORA8-STD as OS. [[Image(image005.png,60%)]] Repeat the operation to create at least 3 nodes. Move the mouse beside the node till a wire appears. Drag to other nodes to create links [[Image(image006.png)]] When all nodes and links are created , choose File/Create New Experiment menu. [[Image(image007.png)]] In the dialog, give a name and description of the test slice. Select”Swap in immediately” [[Image(image008.png)]] A summary will appear after the creation finished. [[Image(image009.png,60%)]] Click the link of the Name, you will get status of reserved node. [[Image(image010.png,60%)]] Wait till status of all nodes become "up".(It may needs several minutes to half minutes) [[Image(image011.png,60%)]] == 4. Install !OnTimeMeasure RootBeacon == Select a node as Root Beacon ( i.e. node 0 with domain name pc95.emulab.net) Login to with SSH by enter pc95.emulab.net in the following UI, and click "open" button. [[Image(image013.png)]] When first login, there would be an alert. Click "Yes" button. [[Image(image014.png)]] Enter user name and password if it prompt. [[Image(image015.png)]] Make a temple folder and get into the temp folder. Enter the following command to install the software. {{{ wget http://ontime.oar.net/download/OnTimeMeasure_latest.php tar xzf *.gz tar xzf RootBeacon.tar.gz cd RootBeacon/InstallScript ./ontime_software_install.sh }}} Enter {{{yes}}}, {{{root}}}, email and password when prompt the following: [[Image(image016.png)]] Set slice password for the following. [[Image(image017.png)]] The Root IP address will be displayed when the installation finished. Write down the Root IP address(i.e. 155.98.36.95) [[Image(image018.png)]] == 5. Install OnTimeMeasure !NodeBeacons == Login to with SSH by enter pc142.emulab.net in the following UI, and click "open" button. Get into the {{{demoinstall}}} folder created in the last step. Enter the following command to install !NodeBeacon: {{{ tar xzf NodeBeacon.tar.gz cd NodeBeacon/InstallScript ./ontime_software_install.sh }}} The IP address will be displayed when the installation finished. Write down the Node 1 IP address(i.e. 155.98.36.155) [[Image(image019.png)]] Repeat the installation for each nodes (i.e. pc155.emulab.net) by enter the following command in each Node. {{{ cd NodeBeacon/InstallScript ./ontime_software_install.sh }}} The IP address will be displayed when the installation finished. Write down the IP address of each node(i.e. node2 155.98.36.142) [[Image(image020.png)]] == 6. Configure, Control, Query OnTimeMeasure using Web-portal == Visit - http://ontime.oar.net/ Click Register [[Image(image021.png)]] Input all the information and wait confirm email of administrator. Click login in the portal. Enter the user name and password you registered. [[Image(image022.png)]] Click the Login Button, then click the "Manage measurements" button. [[Image(image023.png)]] Int the Resource SETUP page, enter the information, then click the "Specify Request" button. [[Image(image024.png)]] The page will jump to Measurement Request Specification page. [[Image(image025.png)]] Add the measurement task [[Image(image026.png)]] Click "Review Request" button [[Image(image027.png)]] Click the "Submit Request" button. [[Image(image028.png)]] Click the "Start" Button to start the measurement [[Image(image029.png)]] Click the Query Data button to query data [[Image(image030.png)]] == 7. Configure, Control, Query OnTimeMeasure using OnTimeControl == You can download the tarball from http://ontime.oar.net/download/OnTimeControl_latest.php, and extract the files in the OnTimeControl folder of a machine i.e., root beacon. Please reference "Tutorial on OnTimeMeasure Capabilities for Experimenters" [OnTimeMeasureTutorial#a3.ConfigureControlQueryOnTimeMeasureusingCommand-line section 3 to configure, control, query OnTimeMeasure using command-line tool ] and [OnTimeMeasureTutorial#a5IntegrateCustomMetricofExperimentwithOnTimeMeasure section 4 to integrate custom metric of experiment with OnTimeMeasure ]