GeniCMV2.pm.in 81.1 KB
Newer Older
1
2
#!/usr/bin/perl -wT
#
3
# Copyright (c) 2008-2013 University of Utah and the Flux Group.
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
# 
# {{{GENIPUBLIC-LICENSE
# 
# GENI Public License
# 
# Permission is hereby granted, free of charge, to any person obtaining
# a copy of this software and/or hardware specification (the "Work") to
# deal in the Work without restriction, including without limitation the
# rights to use, copy, modify, merge, publish, distribute, sublicense,
# and/or sell copies of the Work, and to permit persons to whom the Work
# is furnished to do so, subject to the following conditions:
# 
# The above copyright notice and this permission notice shall be
# included in all copies or substantial portions of the Work.
# 
# THE WORK IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
# OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
# HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
# OUT OF OR IN CONNECTION WITH THE WORK OR THE USE OR OTHER DEALINGS
# IN THE WORK.
# 
# }}}
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
#
package GeniCMV2;

#
# The server side of the CM interface on remote sites. Also communicates
# with the GMC interface at Geni Central as a client.
#
use strict;
use Exporter;
use vars qw(@ISA @EXPORT);

@ISA    = "Exporter";
@EXPORT = qw ( );

# Must come after package declaration!
use GeniDB;
use GeniResponse;
use GeniTicket;
use GeniCredential;
use GeniCertificate;
49
use GeniComponent;
50
51
52
53
use GeniSlice;
use GeniAggregate;
use GeniSliver;
use GeniUtil;
54
use GeniCM;
55
use GeniHRN;
56
use GeniXML;
57
use GeniStitch;
58
use GeniStd;
59
60
61
62
63
64
65
66
use emutil;
use English;
use Data::Dumper;
use XML::Simple;
use Date::Parse;
use POSIX qw(strftime tmpnam);
use Time::Local;
use Compress::Zlib;
67
use File::Temp qw(tempfile);
68
use MIME::Base64;
69
use Errno;
70
71
72
73
74
75
76
77
78

# Configure variables
my $TB		   = "@prefix@";
my $TBOPS          = "@TBOPSEMAIL@";
my $TBAPPROVAL     = "@TBAPPROVALEMAIL@";
my $TBAUDIT   	   = "@TBAUDITEMAIL@";
my $BOSSNODE       = "@BOSSNODE@";
my $OURDOMAIN      = "@OURDOMAIN@";
my $PGENIDOMAIN    = "@PROTOGENI_DOMAIN@";
79
my $ELABINELAB     = "@ELABINELAB@";
80
my $TBBASE         = "@TBBASE@";
81
my $TBDOCBASE      = "@TBDOCBASE@";
82
83
84
85
my $CREATEEXPT     = "$TB/bin/batchexp";
my $ENDEXPT        = "$TB/bin/endexp";
my $NALLOC	   = "$TB/bin/nalloc";
my $NFREE	   = "$TB/bin/nfree";
86
my $TEVC	   = "$TB/bin/tevc";
87
88
89
90
91
92
93
94
95
96
97
98
my $AVAIL	   = "$TB/sbin/avail";
my $PTOPGEN	   = "$TB/libexec/ptopgen";
my $TBSWAP	   = "$TB/bin/tbswap";
my $SWAPEXP	   = "$TB/bin/swapexp";
my $PLABSLICE	   = "$TB/sbin/plabslicewrapper";
my $NAMEDSETUP     = "$TB/sbin/named_setup";
my $VNODESETUP     = "$TB/sbin/vnode_setup";
my $GENTOPOFILE    = "$TB/libexec/gentopofile";
my $TARFILES_SETUP = "$TB/bin/tarfiles_setup";
my $MAPPER         = "$TB/bin/mapper";
my $VTOPGEN        = "$TB/bin/vtopgen";
my $SNMPIT         = "$TB/bin/snmpit";
99
100
my $CLONEIMAGE     = "$TB/sbin/clone_image";
my $CREATEIMAGE    = "$TB/bin/create_image";
101
my $DELETEIMAGE    = "$TB/sbin/delete_image";
102
my $XMLLINT	   = "/usr/local/bin/xmllint";
103
104
my $PRERENDER      = "$TB/libexec/vis/prerender";
my $EMULAB_PEMFILE = "@prefix@/etc/genicm.pem";
105
106
# Just one of these, at Utah.
my $GENICH_PEMFILE = "@prefix@/etc/genich.pem";
107
my $API_VERSION    = 2;
108
109
110
111
112
113
114
115

#
# Tell the client what API revision we support.  The correspondence
# between revision numbers and API features is to be specified elsewhere.
# No credentials are required.
#
sub GetVersion()
{
116
117
    my @input_rspec_versions = ( "0.1", "0.2", "2", "3", "PG 0.1", "PG 0.2", "PG 2" );
    my @ad_rspec_versions = ( "0.1", "0.2", "2", "3", "PG 0.1", "PG 0.2", "PG 2" );
Gary Wong's avatar
Gary Wong committed
118
119
120
    my $blob = {
	"api" => $API_VERSION,
	"level" => 1,
121
	"input_rspec" => \@input_rspec_versions,
122
	"output_rspec" => "2",
123
	"ad_rspec" => \@ad_rspec_versions
Gary Wong's avatar
Gary Wong committed
124
    };
125
    return GeniResponse->Create(GENIRESPONSE_SUCCESS, $blob);
126
127
128
129
130
131
132
133
}

#
# Respond to a Resolve request. 
#
sub Resolve($)
{
    my ($argref) = @_;
134
135
    my $credentials = $argref->{'credentials'};
    my $urn         = $argref->{'urn'};
136
    my $admin       = 0;
137
    my $isauth	    = 0;
138

139
140
141
142
143
144
    if (! (defined($credentials) && defined($urn))) {
	return GeniResponse->MalformedArgsResponse("Missing arguments");
    }
    if (! GeniHRN::IsValid($urn)) {
	return GeniResponse->MalformedArgsResponse("Invalid URN");
    }
145
    my ($credential,$speaksfor) = GeniStd::CheckCredentials($credentials);
146
147
148
    return $credential
	if (GeniResponse::IsResponse($credential));

149
150
151
    my ($object, $type) = LookupURN($urn);
    return $object
	if (GeniResponse::IsResponse($object));
152
153
154
155

    #
    # This is a convenience for testing. If a local user and that
    # user is an admin person, then do whatever it says. This is
156
157
    # easier then trying to do this with credential privs. But,
    # watch for credentials from authorities instead of users.
158
    #
159
160
    my (undef,$callertype,$callerid) = GeniHRN::Parse($credential->owner_urn());
    if ($callertype eq "user") {
161
	my $user = GeniCM::CreateUserFromCertificate($credential);
162
163
	if (!GeniResponse::IsResponse($user) &&
	    $user->IsLocal() && $user->admin()) {
164
165
166
	    $admin = 1;
	}
    }
167
168
    elsif ($callertype eq "authority" &&
	   ($callerid eq "cm" || $callerid eq "sa")) {
169
	$isauth = 1;
170
    }
171
172
    
    if ($type eq "node") {
173
	my $node  = $object;
174
175
176
177
178
	# Not sure about this, but I do know that Resolving a virtnode
	# is not useful right now. 
	if ($node->isvirtnode()) {
	    $node = Node->Lookup($node->phys_nodeid());
	}
179
	my $rspec = GeniCM::GetAdvertisement(0, $node->node_id(), "0.1", undef);
180
	if (! defined($rspec)) {
181
	    print STDERR "Could not get advertisement for $node!\n";
182
	    return GeniResponse->Create(GENIRESPONSE_ERROR, undef,
183
					"Error getting advertisement");
184
	}
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
	my $me = GeniAuthority->Lookup($ENV{'MYURN'});
	if (!defined($me)) {
	    print STDERR
		"Could not find local authority object for $ENV{'MYURN'}\n";
	    return GeniResponse->Create(GENIRESPONSE_ERROR, undef,
					"Error getting advertisement");
	}
	my $myurn = GeniHRN::Generate($OURDOMAIN, "node", $node->node_id());
	my $myhrn = "${PGENIDOMAIN}." . $node->node_id();

	#
	# See if the component object exists; if not create it.
	#
	my $component = GeniComponent->Lookup($node->uuid());
	if (!defined($component)) {
	    my $certificate = GeniCertificate->Lookup($node->uuid());
	    if (!defined($certificate)) {
		$certificate =
		    GeniCertificate->Create({'urn'  => $myurn,
					     'hrn'  => $myhrn,
					     'email'=> $TBOPS,
					     'uuid' => $node->uuid(),
					     'url'  => $me->url()});
		if (!defined($certificate)) {
		    print STDERR "Could not generate certificate for $node\n";
		    return GeniResponse->Create(GENIRESPONSE_ERROR, undef,
					    "Error getting advertisement");
		}
	    }
	    $component = GeniComponent->Create($certificate, $me);
	    if (!defined($component)) {
		print STDERR "Could not create component for $node\n";
		return GeniResponse->Create(GENIRESPONSE_ERROR, undef,
					    "Error getting advertisement");
	    }
	}
221
	# Return a blob.
222
	my $blob = { "hrn"          => $myhrn,
223
224
		     "uuid"         => $node->uuid(),
		     "role"	    => $node->role(),
225
226
		     "hostname"     =>
			 GeniUtil::FindHostname($node->node_id()),
227
228
		     "physctrl"     => 
			 Interface->LookupControl($node->phys_nodeid())->IP(),
229
230
231
232
		     "urn"          => $myurn,
		     "rspec"        => $rspec,
		     "url"          => $me->url(),
		     "gid"          => $component->cert(),
233
234
235
236
		   };

	return GeniResponse->Create(GENIRESPONSE_SUCCESS, $blob);
    }
Leigh B. Stoller's avatar
Leigh B. Stoller committed
237
    if ($type eq "slice") {
238
239
	my $slice = $object;

Leigh B. Stoller's avatar
Leigh B. Stoller committed
240
241
242
243
	#
	# In this implementation, the caller must hold a valid slice
	# credential for the slice being looked up. 
	#
244
245
	if (! ($isauth || $admin ||
	       $slice->urn() eq $credential->target_urn())) {
246
247
	    return GeniResponse->Create(GENIRESPONSE_FORBIDDEN(), undef,
					"No permission to resolve $slice\n");
Leigh B. Stoller's avatar
Leigh B. Stoller committed
248
249
250
251
252
253
	}
	# Return a blob.
	my $blob = { "urn"          => $urn };

	my $aggregate = GeniAggregate->SliceAggregate($slice);
	if (defined($aggregate)) {
254
	    $blob->{'sliver_urn'} = $aggregate->urn();
255
256
257
258
	    my $manifest = $aggregate->GetManifest(1);
	    if (defined($manifest)) {
		$blob->{'manifest'}   = $manifest;
	    }
259
260
261
262
263
264
265
266
267
268
269
	    # For key bindings.
	    my $slice_experiment = $slice->GetExperiment();
	    if (!defined($slice_experiment)) {
		print STDERR "*** No Experiment for $slice\n";
	    }
	    else {
		my $bindings;
		if ($slice_experiment->NonLocalUsers(\$bindings)) {
		    print STDERR "*** No bindings for $slice_experiment\n";
		}
		elsif (@{ $bindings }) {
270
		    $blob->{'users'} = $bindings;
271
272
		}
	    }
273
274
275
	    $blob->{'public_url'} =
		"$TBDOCBASE/showslicepub.php?publicid=" . $slice->publicid()
		if (defined($slice->publicid()));
Leigh B. Stoller's avatar
Leigh B. Stoller committed
276
277
278
	}
	my $ticket = GeniTicket->SliceTicket($slice);
	if (defined($ticket)) {
279
	    $blob->{'ticket_urn'} = $ticket->urn();
Leigh B. Stoller's avatar
Leigh B. Stoller committed
280
281
282
283
	}
	return GeniResponse->Create(GENIRESPONSE_SUCCESS, $blob);
    }
    if ($type eq "sliver") {
284
	my $sliver = $object;
285
286
287
	my $slice  = $sliver->GetSlice();
	return GeniResponse->Create(GENIRESPONSE_ERROR)
	    if (!defined($slice));
288

Leigh B. Stoller's avatar
Leigh B. Stoller committed
289
290
291
292
	#
	# In this implementation, the caller must hold a valid slice
	# or sliver credential for the slice being looked up. 
	#
293
	if (! ($admin || $isauth ||
294
	       $sliver->urn() eq $credential->target_urn() ||
295
296
297
298
299
	       $slice->urn() eq $credential->target_urn())) {
	    print STDERR $sliver->urn() . "\n";
	    print STDERR $slice->urn() . "\n";
	    print STDERR $credential->target_urn() . "\n";
	    print STDERR $ENV{'MYURN'} . "\n";
Leigh B. Stoller's avatar
Leigh B. Stoller committed
300
301
	    return GeniResponse->Create(GENIRESPONSE_FORBIDDEN);
	}
302
303
	my $manifest = $sliver->GetManifest(1);
	if (!defined($manifest)) {
Leigh B. Stoller's avatar
Leigh B. Stoller committed
304
305
306
307
308
309
	    return GeniResponse->Create(GENIRESPONSE_ERROR);
	}
	# Return a blob.
	my $blob = { "urn"          => $urn,
		     "manifest"     => $manifest,
		 };
310
311
312
313
	$blob->{'public_url'} =
	    "$TBDOCBASE/showslicepub.php?publicid=" . $slice->publicid()
	    if (defined($slice->publicid()));
	
314
315
316
317
318
319
320
321
322
323
324
	# For key bindings.
	my $slice_experiment = $slice->GetExperiment();
	if (!defined($slice_experiment)) {
	    print STDERR "*** No Experiment for $slice\n";
	}
	else {
	    my $bindings;
	    if ($slice_experiment->NonLocalUsers(\$bindings)) {
		print STDERR "*** No bindings for $slice_experiment\n";
	    }
	    elsif (@{ $bindings }) {
325
		$blob->{'users'} = $bindings;
326
327
	    }
	}
Leigh B. Stoller's avatar
Leigh B. Stoller committed
328
329
330
	return GeniResponse->Create(GENIRESPONSE_SUCCESS, $blob);
    }
    if ($type eq "ticket") {
331
332
	my $ticket = $object;

Leigh B. Stoller's avatar
Leigh B. Stoller committed
333
334
335
336
	#
	# In this implementation, the caller must hold a valid slice
	# or sliver credential to get the ticket.
	#
337
	my $slice = GeniSlice->Lookup($ticket->slice_urn());
Leigh B. Stoller's avatar
Leigh B. Stoller committed
338
339
340
341
	if (!defined($slice)) {
	    print STDERR "Could not find slice for $ticket\n";
	    return GeniResponse->Create(GENIRESPONSE_ERROR);
	}
342
	if (! ($admin || $slice->urn() eq $credential->target_urn())) {
Leigh B. Stoller's avatar
Leigh B. Stoller committed
343
344
345
346
347
	    #
	    # See if its the sliver credential. 
	    #
	    my $aggregate = GeniAggregate->SliceAggregate($slice);
	    if (!defined($aggregate) ||
348
		$aggregate->urn() ne $credential->target_urn()) {
Leigh B. Stoller's avatar
Leigh B. Stoller committed
349
350
351
352
353
		return GeniResponse->Create(GENIRESPONSE_FORBIDDEN());
	    }
	}
	return GeniResponse->Create(GENIRESPONSE_SUCCESS, $ticket->asString());
    }
354
355
    return GeniResponse->Create(GENIRESPONSE_UNSUPPORTED, undef,
				"Cannot resolve $type at this authority");
356
357
358
359
360
361
362
363
}

#
# Discover resources on this component, returning a resource availablity spec
#
sub DiscoverResources($)
{
    my ($argref) = @_;
364
365
366
    my $credentials = $argref->{'credentials'};
    my $available   = $argref->{'available'} || 0;
    my $compress    = $argref->{'compress'} || 0;
367
    my $version     = $argref->{'rspec_version'} || undef;
368
369
370
371

    if (! (defined($credentials))) {
	return GeniResponse->MalformedArgsResponse("Missing arguments");
    }
372
    my ($credential,$speaksfor,@morecreds) = GeniStd::CheckCredentials($credentials);
373
374
    return $credential
	if (GeniResponse::IsResponse($credential));
375

376
    return GeniCM::DiscoverResourcesAux($available, $compress,
377
        $version, [$credential, @morecreds]);
378
379
380
381
382
383
384
385
}

#
# Create a Sliver.
#
sub CreateSliver($)
{
    my ($argref) = @_;
386
387
388
389
390
    my $slice_urn    = $argref->{'slice_urn'};
    my $rspecstr     = $argref->{'rspec'};
    my $credentials  = $argref->{'credentials'};
    my $keys         = $argref->{'keys'};
    my $impotent     = $argref->{'impotent'} || 0;
391
392
    require Node;
    require Experiment;
393
394
    require libtestbed;
    require libaudit;
395

396
    # For now, I am not worrying about the slice_urn argument.
397
398
    if (! (defined($credentials) &&
	   defined($slice_urn) && defined($rspecstr))) {
399
400
	return GeniResponse->MalformedArgsResponse("Missing arguments");
    }
401
402
403
404
405
406
    if (! ($rspecstr =~ /^[\040-\176\012\015\011]+$/)) {
	return GeniResponse->MalformedArgsResponse("Bad characters in rspec");
    }
    if (! GeniHRN::IsValid($slice_urn)) {
	return GeniResponse->MalformedArgsResponse("Bad characters in URN");
    }
407
    my ($credential,$speaksfor) = GeniStd::CheckCredentials($credentials);
408
409
    return $credential
	if (GeniResponse::IsResponse($credential));
410

411
412
    main::AddLogfileMetaData("slice_urn", $slice_urn);
    
413
414
415
416
417
418
419
    #
    # In this implementation, the user must provide a slice credential,
    # so we ignore the slice_urn. For CreateSliver(), the slice must not
    # be instantiated.
    #
    my ($slice,$aggregate) = Credential2SliceAggregate($credential);
    if (defined($slice)) {
420
421
422
	return $slice
	    if (GeniResponse::IsResponse($slice));

423
424
425
426
	if ($slice_urn ne $slice->urn()) {
	    return GeniResponse->Create(GENIRESPONSE_FORBIDDEN(), undef,
					"Credential does not match the URN");
	}
427
	main::AddLogfileMetaDataFromSlice($slice);
428
	
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
	#
	# Watch for a placeholder slice and update it.
	#
	if ($slice->isplaceholder()) {
	    if ($slice->Lock() != 0) {
		return GeniResponse->BusyResponse();
	    }
	    #
	    # Confirm that the slice certificate is the same.
	    #
	    if ($slice->cert() ne $credential->target_cert()->cert()) {
		$slice->UnLock();
		return GeniResponse->Create(GENIRESPONSE_FORBIDDEN, undef,
					    "Slice certificate mismatch");
	    }
	    my $user =
445
		GeniCM::CreateUserFromCertificate($credential);
446
	    if (GeniResponse::IsResponse($user)) {	    
447
		$slice->UnLock();
448
		return $user;
449
450
451
452
453
454
455
456
	    }
	    if ($slice->ConvertPlaceholder($user) != 0) {
		$slice->UnLock();
		return GeniResponse->Create(GENIRESPONSE_ERROR, undef,
					    "Could not convert placeholder");
	    }
	    $slice->UnLock();
	}
457
458
459
460
461
	if (defined($aggregate)) {
	    return GeniResponse->Create(GENIRESPONSE_REFUSED, undef,
					"Must delete existing slice first");
	}
    }
462
463
    my $rspec = GeniCM::GetTicketAux($credential, $rspecstr,
				     0, $impotent, 1, 0, undef, $speaksfor);
464
465
466
    return $rspec
	if (GeniResponse::IsResponse($rspec));

Leigh B Stoller's avatar
Leigh B Stoller committed
467
    $slice = GeniSlice->Lookup($credential->target_urn());
468
469
470
471
    if (!defined($slice)) {
	print STDERR "CreateSliver: Could not find slice for $credential\n";
	return GeniResponse->Create(GENIRESPONSE_ERROR, undef,"Internal Error");
    }
472
    main::AddLogfileMetaDataFromSlice($slice);
473

474
475
476
477
    # Make sure that the next phase sees all changes.
    Experiment->FlushAll();
    Node->FlushAll();

478
479
    my $response = GeniCM::SliverWorkAux($credential, $rspec,
					 $keys, 0, $impotent, 1, 0, $speaksfor);
480

481
482
483
484
485
486
487
    if (GeniResponse::IsError($response)) {
	#
	# We have to make sure there is nothing left over since there
	# is no actual ticket, so the resources will not get cleaned
	# up by the daemon. This is mostly cause I am reaching into
	# the V1 code, and its messy.
	#
488
	$slice = GeniSlice->Lookup($credential->target_urn());
489
	if (defined($slice)) {
490
491
492
493
494
	    if ($slice->Lock() != 0) {
		print STDERR
		    "CreateSliver: Could not lock $slice before delete\n";
		return $response;
	    }
495
496
	    GeniCM::CleanupDeadSlice($slice, 1);
	}
497
	return $response;
498
    }
499
    my ($sliver_credential, $sliver_manifest) = @{ $response->{'value'} };
500

501
502
503
    #
    # Leave the slice intact on error, so we can go look at it. 
    #
504
    if ($slice->WaitForLock(30) != 0) {
505
506
507
508
	print STDERR "CreateSliver: Could not lock $slice before start\n";
	return GeniResponse->Create(GENIRESPONSE_ERROR, undef,
				    "Internal Error");
    }
509
    $aggregate = GeniAggregate->SliceAggregate($slice);
510
511
512
513
514
    if (!defined($aggregate)) {
	print STDERR "CreateSliver: Could not find aggregate for $slice\n";
	return GeniResponse->Create(GENIRESPONSE_ERROR, undef,
				    "Internal Error");
    }
515

516
517
    #
    # At this point we want to return and let the startsliver proceed
518
    # in the background. Parent never returns, just the child.
519
    #
520
    my $mypid = main::WrapperFork();
521
522
523
524
    if ($mypid) {
	return GeniResponse->Create(GENIRESPONSE_SUCCESS,
				    [$sliver_credential, $sliver_manifest]);
    }
525

526
527
528
529
    # Make sure that the next phase sees all changes.
    Experiment->FlushAll();
    Node->FlushAll();

530
531
532
533
534
535
536
    #
    # The callee might also do a wrapper fork, so remember our PID
    # to make sure we unlock properly in only the parent side of the
    # fork. Child runs with slice unlocked for now. 
    #
    $mypid = $PID;
    
Leigh B. Stoller's avatar
Leigh B. Stoller committed
537
    if ($aggregate->Start($API_VERSION, 0) != 0) {
538
539
540
541
542
543
544
	if ($PID == $mypid) {
	    $slice->UnLock();
	    print STDERR "Could not start sliver.\n";
	}
	else {
	    print STDERR "Error waiting for nodes.\n";
	}
545
	return -1;
546
    }
547
548
549
    if ($PID == $mypid) {
	$slice->UnLock();
    }
550
    return 0;
551
552
553
554
555
556
}

#
# Delete a Sliver.
#
sub DeleteSliver($)
557
558
559
560
561
562
563
564
565
566
567
568
{
    my ($argref) = @_;
    my $sliver_urn   = $argref->{'sliver_urn'};
    my $credentials  = $argref->{'credentials'};
    my $impotent     = $argref->{'impotent'} || 0;

    if (! (defined($credentials) && defined($sliver_urn))) {
	return GeniResponse->MalformedArgsResponse("Missing arguments");
    }
    if (! GeniHRN::IsValid($sliver_urn)) {
	return GeniResponse->MalformedArgsResponse("Bad characters in URN");
    }
569
    my ($credential,$speaksfor) = GeniStd::CheckCredentials($credentials);
570
571
572
573
574
575
576
577
    return $credential
	if (GeniResponse::IsResponse($credential));

    #
    # In this implementation, the user must provide a slice or sliver
    # credential
    #
    my ($slice, $aggregate) = Credential2SliceAggregate($credential);
578
579
580
    return $slice
	if (defined($slice) && GeniResponse::IsResponse($slice));
    
581
582
583
584
585
586
587
588
589
    if (! (defined($slice) && defined($aggregate))) {
	return GeniResponse->Create(GENIRESPONSE_SEARCHFAILED, undef,
				    "Sliver does not exist");
    }
    if ($sliver_urn ne $aggregate->urn()) {
	return GeniResponse->Create(GENIRESPONSE_FORBIDDEN(), undef,
				    "Credential does not match the URN");
    }

590
591
592
593
594
595
596
597
    # If a monitor process is running, we are "busy".
    if ($slice->monitor_pid()) {
	return GeniResponse->MonitorResponse();
    }
    
    main::AddLogfileMetaData("sliver_urn", $sliver_urn);
    main::AddLogfileMetaDataFromSlice($slice);
    
598
599
600
601
602
    #
    # We need this below to sign the ticket.
    #
    my $authority = GeniCertificate->LoadFromFile($EMULAB_PEMFILE);
    if (!defined($authority)) {
603
	print STDERR " Could not load $EMULAB_PEMFILE\n";
604
605
606
607
608
609
	return GeniResponse->Create(GENIRESPONSE_ERROR);
	
    }
    #
    # We need the user to sign the new ticket to. 
    #
610
    my $user = GeniCM::CreateUserFromCertificate($credential);
611
612
    return $user
	if (GeniResponse::IsResponse($user));
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
    
    my $response = GeniCM::DeleteSliverAux($credential, $impotent, 1);
    return $response
	if (GeniResponse::IsResponse($response));

    #
    # In the v2 API, return a new ticket for the resources
    # (which were not released). As with all tickets, it will
    # expire very quickly. 
    #
    #
    # Create a new ticket from the manifest.
    #
    my $manifest = $aggregate->GetManifest(0);
    if (!defined($manifest)) {
	print STDERR "No manifest found for $aggregate\n";
	$response = GeniResponse->Create(GENIRESPONSE_ERROR);
	goto bad;
    }
632
633
    my $ticket = GeniTicket->Create($authority, $user,
				    GeniXML::Serialize($manifest));
634
635
636
637
638
    if (!defined($ticket)) {
	print STDERR "Could not create new ticket for $slice\n";
	$response = GeniResponse->Create(GENIRESPONSE_ERROR);
	goto bad;
    }
639
    $ticket->SetSlice($slice);
640
641
    $ticket->SetSpeaksFor($speaksfor)
	if (defined($speaksfor));
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
    
    if ($ticket->Sign()) {
	$ticket->Delete();
	print STDERR "Could not sign new ticket $ticket\n";
	$response = GeniResponse->Create(GENIRESPONSE_ERROR);
	goto bad;
    }
    if ($ticket->Store()) {
	$ticket->Delete();
	print STDERR "Could not store new ticket $ticket\n";
	$response = GeniResponse->Create(GENIRESPONSE_ERROR);
	goto bad;
    }
    my $slice_uuid = $slice->uuid();
    DBQueryWarn("delete from geni_manifests ".
		"where slice_uuid='$slice_uuid'");
    $slice->UnLock();
    return GeniResponse->Create(GENIRESPONSE_SUCCESS, $ticket->asString());

  bad:
    if (GeniCM::CleanupDeadSlice($slice) != 0) {
	print STDERR "Could not cleanup slice\n";
    }
    return $response;
}

#
# Delete a Slice
#
sub DeleteSlice($)
672
673
{
    my ($argref) = @_;
674
675
676
677
    my $slice_urn    = $argref->{'slice_urn'};
    my $credentials  = $argref->{'credentials'};
    my $impotent     = $argref->{'impotent'} || 0;

678
    if (! (defined($credentials) && defined($slice_urn))) {
679
680
	return GeniResponse->MalformedArgsResponse("Missing arguments");
    }
681
682
683
    if (! GeniHRN::IsValid($slice_urn)) {
	return GeniResponse->MalformedArgsResponse("Bad characters in URN");
    }
684
    my ($credential,$speaksfor) = GeniStd::CheckCredentials($credentials);
685
686
    return $credential
	if (GeniResponse::IsResponse($credential));
687

688
689
690
691
    #
    # In this implementation, the user must provide a slice credential.
    #
    my ($slice, $aggregate) = Credential2SliceAggregate($credential);
692
693
694
    return $slice
	if (defined($slice) && GeniResponse::IsResponse($slice));

695
696
697
698
    if (! defined($slice)) {
	return GeniResponse->Create(GENIRESPONSE_SEARCHFAILED, undef,
				    "No such slice here");
    }
699
    main::AddLogfileMetaDataFromSlice($slice);
700
    
701
702
703
704
705
706
707
    if ($slice_urn ne $slice->urn()) {
	return GeniResponse->Create(GENIRESPONSE_FORBIDDEN(), undef,
				    "Credential does not match the URN");
    }
    if ($slice->Lock() != 0) {
	return GeniResponse->BusyResponse();
    }
708
709
710
711
712
713
714
715
716
717
718
719
720
721

    #
    # If a monitor process is running, then cancel it so that
    # we do not leave it behind on a slice/experiment that is
    # now gone.
    #
    if ($slice->monitor_pid()) {
	my $response = GeniCM::KillMonitor($slice);
	if (GeniResponse::IsResponse($response)) {
	    $slice->UnLock();
	    return $response;
	}
    }
    
Leigh B. Stoller's avatar
Leigh B. Stoller committed
722
    if (GeniCM::CleanupDeadSlice($slice, 1) != 0) {
723
724
725
	return GeniResponse->Create(GENIRESPONSE_ERROR, undef,
				    "Could not cleanup slice");
    }
726
  done:
727
    return GeniResponse->Create(GENIRESPONSE_SUCCESS);
728
729
730
731
732
733
734
735
}

#
# Get a Sliver (credential)
#
sub GetSliver($)
{
    my ($argref) = @_;
736
737
    my $slice_urn    = $argref->{'slice_urn'};
    my $credentials  = $argref->{'credentials'};
738

739
    if (! (defined($credentials) && defined($slice_urn))) {
740
741
	return GeniResponse->MalformedArgsResponse("Missing arguments");
    }
742
743
744
    if (! GeniHRN::IsValid($slice_urn)) {
	return GeniResponse->MalformedArgsResponse("Bad characters in URN");
    }
745
    my ($credential,$speaksfor) = GeniStd::CheckCredentials($credentials);
746
747
748
    return $credential
	if (GeniResponse::IsResponse($credential));

749
750
751
752
    #
    # In this implementation, the user must provide a slice credential.
    #
    my ($slice, $aggregate) = Credential2SliceAggregate($credential);
753
754
755
    return $slice
	if (defined($slice) && GeniResponse::IsResponse($slice));

756
    if (! (defined($slice) && defined($aggregate))) {
757
	return GeniResponse->Create(GENIRESPONSE_SEARCHFAILED, undef,
758
759
760
761
762
763
				    "No slice or aggregate here");
    }
    if ($slice_urn ne $slice->urn()) {
	return GeniResponse->Create(GENIRESPONSE_FORBIDDEN(), undef,
				    "Credential does not match the URN");
    }
764
    return GeniCM::GetSliverAux($credential);
765
766
767
}

#
768
# Start a sliver (not sure what this means yet, so reboot for now).
769
#
770
sub StartSliver($)
771
772
{
    my ($argref) = @_;
773
    my $slice_urn    = $argref->{'slice_urn'};
774
    my $sliver_urns  = $argref->{'sliver_urns'} || $argref->{'component_urns'};
775
    my $credentials  = $argref->{'credentials'};
776
    my $manifest     = $argref->{'manifest'};
Leigh B. Stoller's avatar
Leigh B. Stoller committed
777
    
778
779
    return SliverAction("start",
			$slice_urn, $sliver_urns, $credentials, $manifest);
Leigh B. Stoller's avatar
Leigh B. Stoller committed
780
781
782
783
784
785
}

sub StopSliver($)
{
    my ($argref) = @_;
    my $slice_urn    = $argref->{'slice_urn'};
786
    my $sliver_urns  = $argref->{'sliver_urns'} || $argref->{'component_urns'};
Leigh B. Stoller's avatar
Leigh B. Stoller committed
787
788
    my $credentials  = $argref->{'credentials'};

789
790
    return SliverAction("stop",
			$slice_urn, $sliver_urns, $credentials, undef);
Leigh B. Stoller's avatar
Leigh B. Stoller committed
791
792
793
794
795
796
}

sub RestartSliver($)
{
    my ($argref) = @_;
    my $slice_urn    = $argref->{'slice_urn'};
797
    my $sliver_urns  = $argref->{'sliver_urns'} || $argref->{'component_urns'};
Leigh B. Stoller's avatar
Leigh B. Stoller committed
798
    my $credentials  = $argref->{'credentials'};
799
    my $manifest     = $argref->{'manifest'};
Leigh B. Stoller's avatar
Leigh B. Stoller committed
800

801
802
    return SliverAction("restart",
			$slice_urn, $sliver_urns, $credentials, $manifest);
Leigh B. Stoller's avatar
Leigh B. Stoller committed
803
}
804

805
sub SliverAction($$$$$)
Leigh B. Stoller's avatar
Leigh B. Stoller committed
806
{
807
    my ($action, $slice_urn, $sliver_urns, $credentials, $manifest) = @_;
808
    my $response;
809
    my $isasync = 0;
810

811
812
    if (! (defined($credentials) &&
	   (defined($slice_urn) || defined($sliver_urns)))) {
813
814
	return GeniResponse->MalformedArgsResponse("Missing arguments");
    }
815
    my ($credential,$speaksfor) = GeniStd::CheckCredentials($credentials);
816
817
818
819
820
821
822
823
    return $credential
	if (GeniResponse::IsResponse($credential));

    $credential->HasPrivilege( "pi" ) or
	$credential->HasPrivilege( "info" ) or
	return GeniResponse->Create(GENIRESPONSE_FORBIDDEN, undef,
				    "Insufficient privilege");

824
825
826
827
828
829
830
831
832
    if (defined($manifest)) {
	$manifest = GeniXML::Parse($manifest);
	if (!defined($manifest)) {
	    print STDERR "Error reading manifest\n";
	    return GeniResponse->Create(GENIRESPONSE_BADARGS, undef,
					"Bad manifest");
	}
    }
    
833
834
835
    #
    # For now, only allow top level aggregate or the slice
    #
836
    my ($slice, $aggregate) = Credential2SliceAggregate($credential);
837
838
    return $slice
	if (defined($slice) && GeniResponse::IsResponse($slice));
Srikanth's avatar
Srikanth committed
839

840
841
842
843
844
    if ( (!defined($slice)) && 
          ($credential->target_urn() =~ /\+authority\+cm$/)) {
          # administrative credentials are presented.
          my $cm_urn = GeniHRN::Generate($OURDOMAIN, "authority", "cm");
          if ($cm_urn != $credential->target_urn()) {
Srikanth's avatar
Srikanth committed
845
            return GeniResponse->Create(GENIRESPONSE_FORBIDDEN(), undef,
846
847
848
849
                      "Credential target does not match CM URN");
          }

      if (!defined($slice_urn)) {
Srikanth's avatar
Srikanth committed
850
851
          return GeniResponse->MalformedArgsResponse("Missing arguments");
      }       
852
853
854
855
856
857
858
859
      $slice = GeniSlice->Lookup($slice_urn);
      return GeniResponse->Create(GENIRESPONSE_ERROR, undef, 
                "No Slice with urn $slice_urn here")
          if (!defined($slice));
      $aggregate = GeniAggregate->SliceAggregate($slice);
      return GeniResponse->Create(GENIRESPONSE_ERROR, undef, 
                      "No Aggregate here")
          if (!defined($aggregate));
Srikanth's avatar
Srikanth committed
860
    } 
861

862
863
864
865
    if (! (defined($slice) && defined($aggregate))) {
	return GeniResponse->Create(GENIRESPONSE_BADARGS, undef,
				    "No slice or aggregate here");
    }
866
867
868
869
870
871
872
    main::AddLogfileMetaDataFromSlice($slice);

    # If a monitor process is running, we are "busy".
    if ($slice->monitor_pid()) {
	return GeniResponse->MonitorResponse();
    }
    
873
874
    if (defined($slice_urn)) {
	if (! GeniHRN::IsValid($slice_urn)) {
Leigh B. Stoller's avatar
Leigh B. Stoller committed
875
876
	    return
		GeniResponse->MalformedArgsResponse("Bad characters in URN");
877
	}
878
879
880
	if ($slice_urn ne $slice->urn()) {
	    return GeniResponse->Create(GENIRESPONSE_FORBIDDEN(), undef,
					"Credential does not match the URN");
881
	}
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
    }
    if ($slice->Lock() != 0) {
	return GeniResponse->BusyResponse();
    }
    # Shutdown slices get nothing.
    if ($slice->shutdown()) {
	$slice->UnLock();
	return GeniResponse->Create(GENIRESPONSE_FORBIDDEN, undef,
				    "Slice has been shutdown");
    }
    if ($aggregate->ComputeState()) {
	$slice->UnLock();
	print STDERR "Could not determine current state\n";
	return GeniResponse->Create(GENIRESPONSE_ERROR);
    }
    my $CheckState = sub {
	my ($object, $action) = @_;

Leigh B. Stoller's avatar
Leigh B. Stoller committed
900
	if ($action eq "start") {
901
902
	    if ($object->state() ne "stopped" && $object->state() ne "new"
		&& $object->state() ne "mixed") {
Leigh B. Stoller's avatar
Leigh B. Stoller committed
903
904
905
906
907
		return GeniResponse->Create(GENIRESPONSE_REFUSED, undef,
					    "Sliver is not stopped (yet)");
	    }
	}
	elsif ($action eq "stop") {
908
	    if ($object->state() ne "started" && $object->state() ne "mixed") {
Leigh B. Stoller's avatar
Leigh B. Stoller committed
909
910
911
912
913
		return GeniResponse->Create(GENIRESPONSE_REFUSED, undef,
					    "Sliver is not started (yet)");
	    }
	}
	elsif ($action eq "restart") {
914
	    if ($object->state() ne "started" && $object->state() ne "mixed") {
Leigh B. Stoller's avatar
Leigh B. Stoller committed
915
916
917
		return GeniResponse->Create(GENIRESPONSE_REFUSED, undef,
					    "Sliver is not started (yet)");
	    }
918
919
920
921
922
923
	}
	return 0;
    };
    my $PerformAction = sub {
	my ($object, $action) = @_;

924
925
	my $exitval = 0;

926
	if ($action eq "start") {
927
	    $exitval = $object->Start($API_VERSION, 0);
928
	}
929
	elsif ($action eq "stop") {
930
	    $exitval = $object->Stop($API_VERSION);
931
932
	}
	elsif ($action eq "restart") {
933
	    $exitval = $object->Start($API_VERSION, 1);
934
	}
935
936
937
938
	return GeniResponse->Create(GENIRESPONSE_ERROR, 
				    "Could not $action sliver")
	    if ($exitval);
	
939
940
941
	return 0;
    };

942
943
944
945
946
947
948
949
950
951
952
    my $user = GeniCM::CreateUserFromCertificate($credential);
    return $user
	if (GeniResponse::IsResponse($user));

    my $realuser = GeniCM::FlipToUser($slice, $user);
    if (! (defined($realuser) && $realuser)) {
	print STDERR "Error flipping to real user\n";
	return GeniResponse->Create(GENIRESPONSE_ERROR, undef,
				    "FlipToUser Error");
    }

953
954
955
956
957
    if (defined($slice_urn)) {
	$response = &$CheckState($aggregate, $action);
	goto bad
	    if (GeniResponse::IsResponse($response));
	    
958
959
960
	if ($action eq "start" || $action eq "restart") {
	    if (defined($manifest) &&
		$aggregate->ProcessManifest($manifest)) {
961
962
963
964
965
		$response = GeniResponse->Create(GENIRESPONSE_ERROR,
						 undef,
						 "Error processing manifest");
		goto bad;
	    }
966
967
968
969
	    #
	    # At this point we want to return and let the startsliver proceed
	    # in the background
	    #
970
	    my $mypid = main::WrapperFork();
971
972
973
	    if ($mypid) {
		return GeniResponse->Create(GENIRESPONSE_SUCCESS);
	    }
974
975
	    # Remember our pid in case callee wrapper forks again.
	    $isasync = $PID;
976
	}
977
978
979
980
	$response = &$PerformAction($aggregate, $action);
	goto bad
	    if (GeniResponse::IsResponse($response));

981
982
983
	if (!$isasync || $isasync == $PID) {
	    $slice->UnLock();
	}
984
985
	return ($isasync ? GENIRESPONSE_SUCCESS :
		GeniResponse->Create(GENIRESPONSE_SUCCESS));
986
    }
Leigh B. Stoller's avatar
Leigh B. Stoller committed
987
    else {
988
	my @slivers = ();
Leigh B. Stoller's avatar
Leigh B. Stoller committed
989

990
991
992
993
994
	#
	# Sanity check all arguments before doing anything.
	#
	foreach my $urn (@{ $sliver_urns }) {
	    my $sliver = GeniSliver->Lookup($urn);
Leigh B. Stoller's avatar
Leigh B. Stoller committed
995
996
997
998
999
1000
	    if (!defined($sliver)) {
		$response = GeniResponse->Create(GENIRESPONSE_SEARCHFAILED,
						 undef,
						 "Nothing here by that name");
		goto bad;
	    }
1001
1002
1003
1004
1005
1006
1007
1008
	    
	    $response = &$CheckState($sliver, $action);
	    goto bad
		if (GeniResponse::IsResponse($response));

	    push(@slivers, $sliver);
	}
	foreach my $sliver (@slivers) {
1009
1010
1011
1012
1013
1014
1015
1016
	    if ($action eq "start" && defined($manifest)) {
		if ($sliver->ProcessManifest($manifest)) {
		    $response = GeniResponse->Create(GENIRESPONSE_ERROR,
				     undef,
				     "Error processing manifest for $sliver");
		    goto bad;
		}
	    }
1017
1018
1019
1020
1021
1022
	    $response = &$PerformAction($sliver, $action);
	    goto bad
		if (GeniResponse::IsResponse($response));
	}
	$slice->UnLock();
	return GeniResponse->Create(GENIRESPONSE_SUCCESS);
Leigh B. Stoller's avatar
Leigh B. Stoller committed
1023
    }
1024
1025
  bad:
    $slice->UnLock();
1026
    return ($isasync ? $response->{'code'} : $response);
1027
1028
1029
1030
1031
1032
1033
}

#
# Get sliver status
#
sub SliverStatus($)
{
1034
    my ($argref)     = @_;
1035
1036
1037
1038
1039
1040
1041
1042
1043
    my $slice_urn    = $argref->{'slice_urn'};
    my $credentials  = $argref->{'credentials'};

    if (! (defined($credentials) && defined($slice_urn))) {
	return GeniResponse->MalformedArgsResponse("Missing arguments");
    }
    if (! GeniHRN::IsValid($slice_urn)) {
	return GeniResponse->MalformedArgsResponse("Bad characters in URN");
    }
1044
    my ($credential,$speaksfor) = GeniStd::CheckCredentials($credentials);
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
    return $credential
	if (GeniResponse::IsResponse($credential));

    $credential->HasPrivilege( "pi" ) or
	$credential->HasPrivilege( "info" ) or
	return GeniResponse->Create(GENIRESPONSE_FORBIDDEN, undef,
				    "Insufficient privilege");

    #
    # For now, only allow top level aggregate or the slice
    #
    my ($slice, $aggregate) = Credential2SliceAggregate($credential);
1057
1058
1059
    return $slice
	if (defined($slice) && GeniResponse::IsResponse($slice));

1060
    if (! (defined($slice) && defined($aggregate))) {
1061
	return GeniResponse->Create(GENIRESPONSE_SEARCHFAILED, undef,
1062
1063
				    "No slice or aggregate here");
    }
1064
    main::AddLogfileMetaDataFromSlice($slice);
1065
    
1066
1067
1068
    if ($slice_urn ne $slice->urn()) {
	return GeniResponse->Create(GENIRESPONSE_FORBIDDEN(), undef,
				    "Credential does not match the URN");
1069
1070
1071
1072
    }
    if ($slice->Lock() != 0) {
	return GeniResponse->BusyResponse();
    }
Leigh B. Stoller's avatar
Leigh B. Stoller committed
1073
1074
1075
1076
1077
    if ($aggregate->ComputeState()) {
	print STDERR "SliverStatus: Could not compute state for $aggregate\n";
	$slice->UnLock();
	return GeniResponse->Create(GENIRESPONSE_ERROR);
    }
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088

    #
    # Grab all the slivers for this slice, and then
    # look for just the nodes.
    #
    my @slivers    = ();
    if ($aggregate->SliverList(\@slivers) != 0) {
	print STDERR "SliverStatus: Could not get slivers for $aggregate\n";
	$slice->UnLock();
	return GeniResponse->Create(GENIRESPONSE_ERROR);
    }
Leigh B. Stoller's avatar
Leigh B. Stoller committed
1089
1090
1091

    my $blob = {
	"state"   => $aggregate->state(),
Leigh B. Stoller's avatar
Leigh B. Stoller committed
1092
	"status"  => $aggregate->status(),
1093
	"error"   => $aggregate->ErrorLog(),
Leigh B. Stoller's avatar
Leigh B. Stoller committed
1094
1095
	"details" => {},
    };
1096
1097
1098
1099
    $blob->{'public_url'} =
	"$TBBASE/showslicepub.php?publicid=" .	$slice->publicid()
	if (defined($slice->publicid()));
    
1100
    foreach my $sliver (@slivers) {
1101
1102
1103
1104
1105
1106
1107
1108
	if ($sliver->isa("GeniAggregate")) {
	    next
		if (! (ref($sliver) eq "GeniAggregate::Link" ||
		       ref($sliver) eq "GeniAggregate::Tunnel"));
	}
	elsif ($sliver->resource_type() ne "Node") {
	    next;
	}
1109

1110
	my $sliver_urn    = $sliver->sliver_urn();
1111
	my $resource_id   = $sliver->resource_id();
Leigh B. Stoller's avatar
Leigh B. Stoller committed
1112
1113
1114
	my $state         = $sliver->state();
	my $status        = $sliver->status();
	my $error         = "";
1115

1116
1117
1118
1119
	# New is the same as stopped. Separate state is handy.
	$state = "stopped"
	    if ($state eq "new");

Leigh B. Stoller's avatar
Leigh B. Stoller committed
1120
1121
	if ($status eq "failed") {
	    $error = $sliver->ErrorLog();
1122
	}
1123
	$blob->{'details'}->{$sliver_urn} = {
1124
	    "component_urn" => $resource_id,
1125
1126
1127
1128
1129
1130
1131
	    "state"  => $state,
	    "status" => $status,
	    "error"  => $error,
	};
    }
    $slice->UnLock();
    return GeniResponse->Create(GENIRESPONSE_SUCCESS, $blob);
1132
1133
1134
1135
1136
1137
1138
1139
}

#
# Shutdown sliver
#
sub Shutdown($)
{
    my ($argref) = @_;
1140
1141
1142
    my $slice_urn    = $argref->{'slice_urn'};
    my $clear        = $argref->{'clear'} || 0;
    my $credentials  = $argref->{'credentials'};
1143
    require libtestbed;
1144

1145
    if (! (defined($credentials) && defined($slice_urn))) {
1146
1147
	return GeniResponse->MalformedArgsResponse("Missing arguments");
    }
1148
    my ($credential,$speaksfor) = GeniStd::CheckCredentials($credentials);
1149
1150
    return $credential
	if (GeniResponse::IsResponse($credential));
1151

1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
    $credential->HasPrivilege( "pi" ) or
	$credential->HasPrivilege( "instantiate" ) or
	$credential->HasPrivilege( "control" ) or
	return GeniResponse->Create( GENIRESPONSE_FORBIDDEN, undef,
				     "Insufficient privilege" );

    #
    # The clearinghouse generates a different credential to do this.
    #
    if ($slice_urn ne $credential->target_urn()) {
	my $certificate = GeniCertificate->LoadFromFile($GENICH_PEMFILE);
	if (!defined($certificate)) {
	    print STDERR "Could not load certificate from $GENICH_PEMFILE\n";
	    return GeniResponse->Create(GENIRESPONSE_ERROR);
	}

	# The caller has to match the clearinghouse.
	if ($credential->owner_urn() ne $certificate->urn()) {
	    return GeniResponse->Create(GENIRESPONSE_FORBIDDEN, undef,
					"Insufficient