Changes between Version 17 and Version 18 of OnTime-Installv1


Ignore:
Timestamp:
07/16/10 15:50:15 (9 years ago)
Author:
Prasad Calyam
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • OnTime-Installv1

    v17 v18  
    11= !OnTimeMeasure-GENI Installation Document =
    22'''Prasad Calyam, Kunpeng Zhu'''[[BR]]
    3 '''May 31, 2010'''[[BR]]
     3Original: '''May 31, 2010'''[[BR]]
     4Revised: '''July 16, 2010'''[[BR]]
    45
    56''Software License:'' [http://www.geni.net/wp-content/uploads/2009/02/geniprojlic.pdf ''GENI Project License (GPL)''] [[BR]]
     
    9495-       Create sliver inside slice
    9596{{{
    96 createssliver.py –n <slice name> <rspec file>
    97 }}}
    98 
    99 -       Start sliver
    100 {{{
    101 startsliver –n <slice name>
     97createsliver.py –n <slice name> <rspec file>
    10298}}}
    10399
     
    124120Once you have downloaded the tar file, untar/unzip to see that !OnTimeMeasure-v1.0.tar.gz contains:[[BR]]
    125121
    126  * !NodeBeacon/Centralized.tar.gz
    127  * !NodeBeacon/Distributed.tar.gz
    128  * !RootBeacon/RootBeacon.tar.gz
     122 * !NodeBeacon.tar.gz
     123 * !RootBeacon.tar.gz
    129124 * README.txt
    130125
    131 Next, login using SSH to each of the servers, copy the appropriate tar files over, untar them, and run the following commands to setup the measurement instance environment:
    132 
    133 '''Centralized Case:'''
    134 
    135 ''On the Root Beacon Server:''
    136 
    137 Software installation:
     126Next, login using SSH to each of the servers, copy the appropriate tar files over, and run the following commands to setup the measurement instance environment:
     127
     128'''Centralized/Distributed Case:'''
     129
     130__'''''On the Root Beacon Server:'''''__
     131
     132__Software installation__
    138133{{{
    139134tar xzf RootBeacon.tar.gz
     
    143138}}}
    144139
    145 Perl CPAN Module Installation [[BR]]
     140__Perl CPAN Module Installation__ [[BR]]
    146141
    147142The Comprehensive Perl Archive Network (CPAN) tools is used to install the Perl modules listed in the System Requirement section and is installed by the ontime_software_install.sh script. 
     
    150145
    151146{{{
    152 $ sudo perl -MCPAN -e shell
    153         cpan[1]>  o conf urllist push ftp://cpan.uchicago.edu/pub/CPAN/
    154 cpan[1]>  o conf prerequisites_policy follow
    155 cpan[1]>  o conf commit
    156 cpan[1]>  exit
    157 $ chmod +x ontime_perlmodule_install.sh
    158 $ ./ontime_perlmodule_install.sh
    159 }}}
    160 
    161 MySQL Initialization
    162 
    163 {{{
    164 $ mysqladmin -u root password 'new-password'
    165 }}}
    166 
    167 Graphite and Twisted Installation
    168 
    169 {{{
    170 cd RootBeacon/InstallScript
     147sudo perl -MCPAN -e shell
     148cpan>  o conf urllist push ftp://cpan.uchicago.edu/pub/CPAN/
     149cpan>  o conf prerequisites_policy follow
     150cpan>  o conf commit
     151cpan>  exit
     152chmod +x ontime_perlmodule_install.sh
     153./ontime_perlmodule_install.sh
     154}}}
     155
     156__MySQL Initialization__
     157
     158{{{
     159mysqladmin -u root password '<new-password>'
     160}}}
     161
     162__Graphite and Twisted Installation__
     163
     164{{{
    171165chmod +x ontime_graphite_install.sh
    172166sudo ./ontime_graphite_install.sh
    173167}}}
    174168
    175 ''On a Node Beacon Server:''
    176 
    177 Software installation:
     169__'''''On a Node Beacon Server:'''''__
     170
     171__Software installation__
    178172{{{
    179173tar xzf NodeBeacon.tar.gz
     
    183177}}}
    184178
    185 Perl CPAN Module Installation [[BR]]
     179__Perl CPAN Module Installation__ [[BR]]
    186180
    187181The Comprehensive Perl Archive Network (CPAN) tools is used to install the Perl modules listed in the System Requirement section and is installed by the ontime_software_install.sh script. 
     
    190184
    191185{{{
    192 $ sudo perl -MCPAN -e shell
    193         cpan[1]>  o conf urllist push ftp://cpan.uchicago.edu/pub/CPAN/
    194 cpan[1]>  o conf prerequisites_policy follow
    195 cpan[1]>  o conf commit
    196 cpan[1]>  exit
    197 $ chmod +x ontime_perlmodule_install.sh
    198 $ ./ontime_perlmodule_install.sh
    199 }}}
    200 
    201 '''Distributed Case:'''
    202 
    203 ''On a Node Beacon Server:''
    204 
    205 Software installation:
    206 {{{
    207 tar xzf Distributed.tar.gz
    208 cd Distributed/InstallScript
    209 chmod +x ontime_software_install.sh
    210 ./ontime_software_install.sh
    211 }}}
    212 
    213 Perl CPAN Module Installation [[BR]]
    214 
    215 The Comprehensive Perl Archive Network (CPAN) tools is used to install the Perl modules listed in the System Requirement section and is installed by the ontime_software_install.sh script. 
    216 
    217 '''Note:''' The CPAN configuration must point to Internet2 Perl CPAN repository
    218 
    219 {{{
    220 $ sudo perl -MCPAN -e shell
    221         cpan[1]>  o conf urllist push ftp://cpan.uchicago.edu/pub/CPAN/
    222 cpan[1]>  o conf prerequisites_policy follow
    223 cpan[1]>  o conf commit
    224 cpan[1]>  exit
    225 $ chmod +x ontime_perlmodule_install.sh
    226 $ ./ontime_perlmodule_install.sh
     186sudo perl -MCPAN -e shell
     187cpan>  o conf urllist push ftp://cpan.uchicago.edu/pub/CPAN/
     188cpan>  o conf prerequisites_policy follow
     189cpan>  o conf commit
     190cpan>  exit
     191chmod +x ontime_perlmodule_install.sh
     192./ontime_perlmodule_install.sh
    227193}}}
    228194
     
    231197'''Centralized Case:'''
    232198
    233 ''On the Root Beacon Server:''
    234 
    235 MySQL configuration
     199__'''''On the Root Beacon Server:'''''__
     200
     201__MySQL configuration__
    236202
    237203{{{
     
    246212GRANT ALL PRIVILEGES ON `Measurements` .  * TO 'collector'@'%';
    247213GRANT ALL PRIVILEGES ON `WebServices` .  * TO 'collector'@'%';
    248 }}}
    249 
    250 '''Note:''' If remote access to MySQL on the Root Beacon is disabled, please open the port TCP/3306 and follow the tutorial at http://www.cyberciti.biz/tips/how-do-i-enable-remote-access-to-mysql-database-server.html
    251 
    252 Graphite Configuration
     214exit
     215}}}
     216'''Note 1:''' Please use the <collector password> provided as part of the Slice information at Step 2 in the Researcher Web-portal.
     217
     218'''Note 2:''' If remote access to MySQL on the Root Beacon is disabled, please open the port TCP/3306 and follow the tutorial at http://www.cyberciti.biz/tips/how-do-i-enable-remote-access-to-mysql-database-server.html
     219
     220__Graphite Configuration__
    253221
    254222Initialize the graphite:
     
    263231
    264232{{{
     233screen
    265234cd /opt/graphite/
    266235python bin/carbon-cache.py start
    267 nohup /opt/graphite/bin/run-graphite-devel-server.py /opt/graphite &
    268 }}}
    269 
    270 SCP configuration
    271 
    272 {{{
    273 ssh-keygen -t rsa
    274 cat .ssh/id_rsa.pub | ssh uploader@ontime.oar.net "cat >> .ssh/authorized_keys"
    275 }}}
    276 Use the default settings and the password for user uploader is 'uploader'
    277 
    278 ''On a Node Beacon Server:''
    279 
    280 SCP configuration
    281 
    282 {{{
    283 ssh-keygen -t rsa
    284 cat .ssh/id_rsa.pub | ssh uploader@ontime.oar.net "cat >> .ssh/authorized_keys"
    285 }}}
    286 Use the default settings and the password for user uploader is 'uploader'
     236sudo chmod -R 777 /opt/graphite/storage
     237/opt/graphite/bin/run-graphite-devel-server.py /opt/graphite
     238}}}
     239
     240Then open <root_beacon_ip_address>:8080 in browser. If no error is reported, press '<CTRL>+a, d' sequence in the SSH window to keep the service running in the background.
     241
     242__Root Beacon invocation options configuration__
     243
     244{{{
     245cd RootBeacon/InstallScript
     246perl config_wizard.pl
     247}}}
     248Follow the steps as directed by the wizard script.
     249
     250__'''''On a Node Beacon Server:'''''__
     251
     252__Node Beacon invocation options configuration__
     253
     254{{{
     255cd NodeBeacon/InstallScript
     256perl config_wizard.pl
     257}}}
     258Follow the steps as directed by the wizard script.
    287259
    288260'''Distributed Case:'''
    289261
    290 ''On a Node Beacon Server:''
    291 
    292 NTP Configuration
    293 
    294 Software configuration on
    295 
    296 {{{
    297 $ sudo vim /etc/ntp.conf
     262__'''''On a Node Beacon Server:'''''__
     263
     264__NTP Configuration__
     265
     266{{{
     267sudo vim /etc/ntp.conf
    298268}}}
    299269Edit the last line to:
     
    303273Restart ntpd service
    304274{{{
    305 $ sudo /etc/init.d/ntpd restart
    306 }}}
    307 
    308 BWCTL Configuration
     275sudo /etc/init.d/ntpd restart
     276}}}
     277
     278__BWCTL Configuration__
    309279
    310280Edit the BWCTL config: /etc/bwctld/bwctld.conf
     
    327297}}}
    328298
     299Restart BWCTL:
     300{{{
     301sudo /etc/init.d/bwctld restart
     302}}}
     303
    329304'''Note:''' For more detailed instructions to configure NTP and BWCTL, please refer to the BWCTL Tool website. (http://www.internet2.edu/performance/bwctl/)
    330305
    331 
    332 SCP configuration
    333 
    334 {{{
    335 ssh-keygen -t rsa
    336 cat .ssh/id_rsa.pub | ssh uploader@ontime.oar.net "cat >> .ssh/authorized_keys"
    337 }}}
    338 Use the default settings and the password for user uploader is 'uploader'
     306__Node Beacon invocation options configuration__
     307
     308{{{
     309cd NodeBeacon/InstallScript
     310perl config_wizard.pl
     311}}}
     312Follow the steps as directed by the wizard script.
    339313
    340314=== 2.6 Software Invocation ===
     
    342316'''Centralized Case:'''
    343317
    344 ''On the Root Beacon Server:''
    345 
    346 Edit !RootBeacon/etc/root.conf and measurement.conf as guided by in-file comments, and then go to "Collector/" and run
    347 {{{
    348 nohup perl collector.pl &
    349 }}}
    350 Next, go to "!RootScheduler/"
    351 {{{
    352 nohup perl action_script.pl &
    353 }}}
    354 
    355 ''On a Node Beacon Server:''
    356 
    357 Edit !NodeBeacon/etc/node.conf and runtool.conf as guided by in-file comments, and then go to 'Datagen/certs' run
     318__'''''On the Root Beacon Server:'''''__
     319
     320Go to "Collector/" and run
     321{{{
     322chmod +x ../AnalysisScripts/Plateau/plateau.exe
     323chmod +x ../AnalysisScripts/Forecast/forecaster/add_forecast
     324screen
     325perl collector.pl
     326}}}
     327If no error is reported, press '<CTRL>+a, c' sequence to open a new blank command window.
     328Then, go to "../!RootScheduler/"
     329{{{
     330perl file_server.pl
     331}}}
     332If no error is reported, press '<CTRL>+a, c' sequence to open a new blank command window.
     333{{{
     334perl action_script.pl
     335}}}
     336If no error is reported, press '<CTRL>+a, d' sequence in the SSH window to keep the service running in the background.
     337
     338__'''''On a Node Beacon Server:'''''__
     339
     340Go to 'Datagen/certs' run
    358341
    359342{{{
     
    361344./createSSL.sh
    362345cd ..
    363 nohup perl node_scheduler.pl &
    364 }}}
    365      
     346screen
     347perl file_server.pl
     348}}}
     349If no error is reported, press '<CTRL>+a, c' sequence to open a new blank command window.
     350{{{
     351perl node_scheduler.pl
     352}}}
     353If no error is reported, press '<CTRL>+a, d' sequence in the SSH window to keep the service running in the background.
    366354
    367355'''Distributed Case:'''
    368356
    369 ''On a Node Beacon Server:''
    370 
    371 Edit Distributed/etc/node.conf as guided by in-file comments, and then go to Distributed/Datagen/ and run
    372 {{{
    373 nohup perl node_scheduler.pl &
    374 }}}
     357__'''''On a Node Beacon Server:'''''__
     358
     359Go to 'Datagen/' and run
     360{{{
     361screen
     362perl file_server.pl
     363}}}
     364If no error is reported, press '<CTRL>+a, c' sequence to open a new blank command window.
     365
     366'''Note:'''Centralize and distributed share the same file server script. If you run both centralized and distributed on the same machine, you only need to run the file_server.pl once.
     367{{{
     368perl dist_scheduler.pl
     369}}}
     370If no error is reported, press '<CTRL>+a, d' sequence in the SSH window to keep the service running in the background.
    375371
    376372