Commit 2fb10e59 authored by Kevin Tew's avatar Kevin Tew

testsuite/testswap doc fixes

parent 39c1659b
REQUIREMENTS
ssh-agent running with SSH emulab keys added
emulab client certificate and key
emulab client certificate and decrypted private key
TBConfig.pm set up correctly
ssh executable in path
INSTALLATION INSTRUCTIONS
perl ./localcpan.pl #this install dependencies in your homdir if you don't have root access to do it yourself
add export PERL5LIB=~/lib/perl5 to your environment
copy TBConfig.pm.in to TBConfig.pm and edit it to point to your client certificate
add your emulab keys to a running ssh-agent
copy TBConfig.pm.in to TBConfig.pm and edit it to point to your emulab SSL client certificate and corresponding decrypted private key.
HOWTO create a cert file and a decrypted private key file from your emulab(cert+key) file.
openssl rsa -in emulab -out decrypted_emulab.pem
openssl x509 -in emulab -out emulab.cert
TO SEE Tests available to run
./tbts
......@@ -24,6 +27,13 @@ EXAMPLE Tests to look at to GET STARTED:
t/topologies/simple_two_node_linktest.t
t/topologies/link_up_link_down.t
Documentation can be found in the doc directory
running pod2text on any pm file will produce API docs.
pod2text lib/TestBed/XMLRPC/Client/Experiment.pm
pod2text lib/TestBed/TestSuite/Experiment.pm
......
......@@ -10,7 +10,7 @@ our $XMLRPC_SERVER = $ENV{'TBTS_XMLRPC_URL'} || "https://boss.emulab.net:3069
our $OPS_SERVER = "users.emulab.net";
our $XMLRPC_VERSION = "0.1";
our $SSL_CLIENT_CERT = glob("~/.ssl/emulab.cert");
our $SSL_CLIENT_KEY = glob("~/.ssl/emulabkeyout.pem");
our $SSL_CLIENT_KEY = glob("~/.ssl/decrypted_emulab.key");
our $EMULAB_USER = get_emulab_user();
our $DEFAULT_PID = $ENV{'TBTS_PROJECT'} || 'tbres';
our $DEFAULT_GID = $ENV{'TBTS_GROUP'} || '';
......
......@@ -98,41 +98,45 @@ TestBed::XMLRPC::Client::Experiment
=over 4
=item C<pid>
=item C<< $e->pid >>
experiment pid
=item C<eid>
=item C<< $e->gid >>
experiment gid
=item C<< $e->eid >>
experiment eid
=item C<batchexp>
=item C<< $e->batchexp >>
calls batchexp xmlrpc function
=item C<swapexp>
=item C<< $e->swapexp >>
calls swapexp xmlrpc function
=item C<endexp>
=item C<< $e->endexp >>
calls endexp xmlrpc function
=item C<waitforactive>
=item C<< $e->waitforactive >>
calls waitforactive xmlrpc function
=item C<getlist>
=item C<< $e->getlist >>
calls getlist xmlrpc function
calls getlist xmlrpc function to get a list of experiments
=item C<expinfo>
=item C<< $e->expinfo >>
calls expinfo xmlrpc cfunction
=item C<args>
B<INTERNAL>: internal method for inserting pid and eid arguments into a xmlrpc call
B<INTERNAL>: internal method for inserting pid, gid, and eid arguments into a xmlrpc call
=item C<< $e->echo($msg) >>
......
......@@ -82,4 +82,5 @@ returns the ssh result code of executing $cmd as $TBConfig::EMULAB_USER and dump
=back
=cut
1;
......@@ -84,4 +84,5 @@ returns the ssh result code of executing $cmd as $TBConfig::EMULAB_USER and dump
=back
=cut
1;
......@@ -46,4 +46,5 @@ returns the ssh result code of executing $cmd as $TBConfig::EMULAB_USER and dump
=back
=cut
1;
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment