GeniSliver.pm.in 29.1 KB
Newer Older
Leigh B. Stoller's avatar
Leigh B. Stoller committed
1
2
#!/usr/bin/perl -wT
#
3
# GENIPUBLIC-COPYRIGHT
4
# Copyright (c) 2008-2009 University of Utah and the Flux Group.
Leigh B. Stoller's avatar
Leigh B. Stoller committed
5
6
7
8
9
10
11
12
13
14
15
16
17
# All rights reserved.
#
package GeniSliver;

#
use strict;
use Exporter;
use vars qw(@ISA @EXPORT);

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

use GeniDB;
Leigh B. Stoller's avatar
Leigh B. Stoller committed
18
use GeniComponent;
Leigh B. Stoller's avatar
Leigh B. Stoller committed
19
use GeniSlice;
Leigh B. Stoller's avatar
Leigh B. Stoller committed
20
use GeniCredential;
21
use GeniCertificate;
Leigh B. Stoller's avatar
Leigh B. Stoller committed
22
use GeniAggregate;
23
use GeniUsage;
24
use GeniHRN;
25
use emutil;
Leigh B. Stoller's avatar
Leigh B. Stoller committed
26
use Experiment;
27
use OSinfo;
28
use Node;
Leigh B. Stoller's avatar
Leigh B. Stoller committed
29
use English;
Leigh B. Stoller's avatar
Leigh B. Stoller committed
30
use XML::Simple;
Leigh B. Stoller's avatar
Leigh B. Stoller committed
31
32
use Data::Dumper;
use File::Temp qw(tempfile);
Leigh B. Stoller's avatar
Leigh B. Stoller committed
33
use overload ('""' => 'Stringify');
Leigh B. Stoller's avatar
Leigh B. Stoller committed
34
35
36
37
38
39
40
41

# Configure variables
my $TB		   = "@prefix@";
my $TBOPS          = "@TBOPSEMAIL@";
my $TBAPPROVAL     = "@TBAPPROVALEMAIL@";
my $TBAUDIT   	   = "@TBAUDITEMAIL@";
my $BOSSNODE       = "@BOSSNODE@";
my $OURDOMAIN      = "@OURDOMAIN@";
42
my $PGENIDOMAIN    = "@PROTOGENI_DOMAIN@";
Leigh B. Stoller's avatar
Leigh B. Stoller committed
43
my $SIGNCRED	   = "$TB/sbin/signgenicred";
Leigh B. Stoller's avatar
Leigh B. Stoller committed
44
45
46
my $AVAIL	   = "$TB/sbin/avail";
my $NALLOC	   = "$TB/bin/nalloc";
my $NFREE	   = "$TB/bin/nfree";
Leigh B. Stoller's avatar
Leigh B. Stoller committed
47
my $NODEREBOOT	   = "$TB/bin/node_reboot";
48
my $NAMEDSETUP     = "$TB/sbin/named_setup";
Leigh B. Stoller's avatar
Leigh B. Stoller committed
49
50
my $PLABNODE       = "$TB/sbin/plabnodewrapper";
my $VNODESETUP     = "$TB/sbin/vnode_setup";
51
my $GENTOPOFILE    = "$TB/libexec/gentopofile";
Leigh B. Stoller's avatar
Leigh B. Stoller committed
52
my $POWER          = "$TB/bin/power";
Leigh B. Stoller's avatar
Leigh B. Stoller committed
53
54
55

# Cache of instances to avoid regenerating them.
my %slivers      = ();
56
BEGIN { use GeniUtil; GeniUtil::AddCache(\%slivers); }
Leigh B. Stoller's avatar
Leigh B. Stoller committed
57
58
59
60
61
62
63
64

#
# Lookup by idx, or uuid.
#
sub Lookup($$)
{
    my ($class, $token) = @_;
    my $query_result;
Leigh B. Stoller's avatar
Leigh B. Stoller committed
65
    my $idx;
Leigh B. Stoller's avatar
Leigh B. Stoller committed
66

67
68
69
70
71
72
73
74
    if (GeniHRN::IsValid($token)) {
	return undef if !GeniHRN::Authoritative($token, "@OURDOMAIN@");

	my ($authority, $type, $id) = GeniHRN::Parse($token);
	return undef if $type ne "sliver";
	$idx = $id;
    }
    elsif ($token =~ /^\d+$/) {
Leigh B. Stoller's avatar
Leigh B. Stoller committed
75
	$idx = $token;
Leigh B. Stoller's avatar
Leigh B. Stoller committed
76
77
78
    }
    elsif ($token =~ /^\w+\-\w+\-\w+\-\w+\-\w+$/) {
	$query_result =
Leigh B. Stoller's avatar
Leigh B. Stoller committed
79
	    DBQueryWarn("select idx from geni_slivers ".
Leigh B. Stoller's avatar
Leigh B. Stoller committed
80
			"where uuid='$token'");
Leigh B. Stoller's avatar
Leigh B. Stoller committed
81
82
83
84
	    return undef
		if (! $query_result || !$query_result->numrows);

	    ($idx) = $query_result->fetchrow_array();
Leigh B. Stoller's avatar
Leigh B. Stoller committed
85
86
87
88
    }
    else {
	return undef;
    }
Leigh B. Stoller's avatar
Leigh B. Stoller committed
89
90
91
92
93
94
95
96

    # Look in cache first
    return $slivers{"$idx"}
        if (exists($slivers{"$idx"}));

    $query_result = DBQueryWarn("select * from geni_slivers ".
				"where idx='$idx'");

Leigh B. Stoller's avatar
Leigh B. Stoller committed
97
98
99
    return undef
	if (!$query_result || !$query_result->numrows);

Leigh B. Stoller's avatar
Leigh B. Stoller committed
100
101
    my $self              = {};
    $self->{'SLIVER'}     = $query_result->fetchrow_hashref();
102
    $self->{'SLICE'}      = undef;	# server
Leigh B. Stoller's avatar
Leigh B. Stoller committed
103
    $self->{'AGGREGATE'}  = undef;	# server
104
    $self->{'RSPEC'}      = undef;	# server
Leigh B. Stoller's avatar
Leigh B. Stoller committed
105
106
107

    my $rspec_string = $self->{'SLIVER'}->{'rspec_string'};
    if (defined($rspec_string) && $rspec_string ne "") {
108
109
110
111
112
113
114
115
116
	my $rspec = 
	    eval { XMLin($rspec_string, KeyAttr => [],
			 ForceArray => ["node", "link", "interface",
					"interface_ref", "linkendpoints"]) };
	if ($@) {
	    print STDERR "XMLin error reading rspec: $@\n";
	    return undef;
	}
	$self->{'RSPEC'} = $rspec;
Leigh B. Stoller's avatar
Leigh B. Stoller committed
117
    }
118
119
120
121
122
123
124
125
126
127
128

    #
    # Grab the certificate, since we will probably want it.
    #
    my $uuid = $self->{'SLIVER'}->{'uuid'};
    my $certificate = GeniCertificate->Lookup($uuid);
    if (!defined($certificate)) {
	print STDERR "Could not find certificate for sliver $idx ($uuid)\n";
	return undef;
    }
    $self->{'CERTIFICATE'} = $certificate;
129
130
131
132

    # Bless into sub package if called for.
    my $resource_type = $self->{'SLIVER'}->{'resource_type'};
    if (defined($resource_type) && $resource_type ne "") {
133
	bless($self, $class . "::" . $resource_type);
134
135
136
137
    }
    else {
	bless($self, $class);
    }
Leigh B. Stoller's avatar
Leigh B. Stoller committed
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
    
    # Add to cache. 
    $slivers{$self->{'SLIVER'}->{'idx'}} = $self;
    
    return $self;
}

#
# Stringify for output.
#
sub Stringify($)
{
    my ($self) = @_;
    
    my $uuid = $self->uuid();
    my $idx  = $self->idx();

    return "[GeniSliver: $uuid, IDX: $idx]";
}

#
Leigh B. Stoller's avatar
Leigh B. Stoller committed
159
# Create a sliver record in the DB. On the client side we save the credential
Leigh B. Stoller's avatar
Leigh B. Stoller committed
160
# that allows control of it, for later operations.
Leigh B. Stoller's avatar
Leigh B. Stoller committed
161
#
162
sub Create($$$$$$$$$)
Leigh B. Stoller's avatar
Leigh B. Stoller committed
163
{
164
165
    my ($class, $slice, $owner, $uuid,
	$resource_uuid, $resource_type, $resource_id,
166
	$hrn, $nickname, $rspec) = @_;
Leigh B. Stoller's avatar
Leigh B. Stoller committed
167
168
169
170
    my @insert_data = ();

    # Every sliver gets a new unique index.
    my $idx = TBGetUniqueIndex('next_sliver', 1);
171
    my $urn = GeniHRN::Generate("@OURDOMAIN@", "sliver", $idx);
Leigh B. Stoller's avatar
Leigh B. Stoller committed
172

173
174
175
176
177
178
    # Sanity check.
    my $certificate = GeniCertificate->Lookup($urn);
    if (defined($certificate)) {
	print STDERR "GeniSliver::Create: ".
	    "Already have a certificate for $hrn/$urn\n";
	return undef;
Leigh B. Stoller's avatar
Leigh B. Stoller committed
179
    }
180
    $certificate = GeniCertificate->Create("sliver", $urn, $hrn, $TBOPS,$uuid);
181
182
    if (!defined($certificate)) {
	print STDERR "GeniSliver::Create: ".
183
	    "Could not generate new certificate for $hrn/$urn\n";
184
	return undef;
Leigh B. Stoller's avatar
Leigh B. Stoller committed
185
    }
Leigh B. Stoller's avatar
Leigh B. Stoller committed
186
    my $slice_uuid     = $slice->uuid();
187
    my $owner_uuid     = $owner->uuid();
Leigh B. Stoller's avatar
Leigh B. Stoller committed
188
189
190
191

    # Now tack on other stuff we need.
    push(@insert_data, "created=now()");
    push(@insert_data, "idx='$idx'");
192
193
194
    push(@insert_data, "hrn=" . DBQuoteSpecial($hrn));
    push(@insert_data, "nickname=" . DBQuoteSpecial($nickname))
	if (defined($nickname));
Leigh B. Stoller's avatar
Leigh B. Stoller committed
195
    push(@insert_data, "uuid='$uuid'");
196
197
    push(@insert_data, "resource_uuid='$resource_uuid'");
    push(@insert_data, "resource_type='$resource_type'");
198
    push(@insert_data, "resource_id='$resource_id'");
Leigh B. Stoller's avatar
Leigh B. Stoller committed
199
200
201
    push(@insert_data, "creator_uuid='$owner_uuid'");
    push(@insert_data, "slice_uuid='$slice_uuid'");

Leigh B. Stoller's avatar
Leigh B. Stoller committed
202
203
204
205
206
207
208
    if (defined($rspec)) {
	my $rspec_string = XMLout($rspec, RootName => "rspec");
	my $safe_rspec   = DBQuoteSpecial($rspec_string);

	push(@insert_data, "rspec_string=$safe_rspec");
    }

Leigh B. Stoller's avatar
Leigh B. Stoller committed
209
    # Insert into DB.
210
211
212
    if (!DBQueryWarn("insert into geni_slivers set " .
		     join(",", @insert_data))) {
	$certificate->Delete();
Leigh B. Stoller's avatar
Leigh B. Stoller committed
213
214
215
	return undef;
    }

Leigh B. Stoller's avatar
Leigh B. Stoller committed
216
217
218
    my $sliver = GeniSliver->Lookup($idx);
    return undef
	if (!defined($sliver));
219
220
221
222
223

    if (GeniUsage->NewSliver($sliver, $slice, $owner)) {
	print STDERR
	    "GeniSliver::Create: GeniUsage->NewSliver($sliver) failed\n";
    }
Leigh B. Stoller's avatar
Leigh B. Stoller committed
224
    $sliver->{'AGGREGATE'} = undef;
Leigh B. Stoller's avatar
Leigh B. Stoller committed
225
    $sliver->{'SLICE'}     = undef;
Leigh B. Stoller's avatar
Leigh B. Stoller committed
226
227

    return $sliver;
Leigh B. Stoller's avatar
Leigh B. Stoller committed
228
229
230
231
232
}
# accessors
sub field($$) { return ((! ref($_[0])) ? -1 : $_[0]->{'SLIVER'}->{$_[1]}); }
sub idx($)		{ return field($_[0], "idx"); }
sub uuid($)		{ return field($_[0], "uuid"); }
233
234
sub hrn($)		{ return field($_[0], "hrn"); }
sub nickname($)		{ return field($_[0], "nickname"); }
Leigh B. Stoller's avatar
Leigh B. Stoller committed
235
236
237
sub slice_uuid($)	{ return field($_[0], "slice_uuid"); }
sub creator_uuid($)	{ return field($_[0], "creator_uuid"); }
sub created($)		{ return field($_[0], "created"); }
Leigh B. Stoller's avatar
Leigh B. Stoller committed
238
sub credential_idx($)	{ return field($_[0], "credential_idx"); }
Leigh B. Stoller's avatar
Leigh B. Stoller committed
239
sub resource_uuid($)	{ return field($_[0], "resource_uuid"); }
240
sub resource_id($)	{ return field($_[0], "resource_id"); }
241
sub resource_type($)	{ return field($_[0], "resource_type"); }
Leigh B. Stoller's avatar
Leigh B. Stoller committed
242
243
244
sub component_uuid($)	{ return field($_[0], "component_uuid"); }
sub aggregate_uuid($)	{ return field($_[0], "aggregate_uuid"); }
sub rspec_string($)     { return field($_[0], "rspec_string"); }
Leigh B. Stoller's avatar
Leigh B. Stoller committed
245
sub status($)		{ return field($_[0], "status"); }
246
sub state($)		{ return field($_[0], "state"); }
247
248
sub cert($)		{ return $_[0]->{'CERTIFICATE'}->cert(); }
sub GetCertificate($)   { return $_[0]->{'CERTIFICATE'}; }
Leigh B. Stoller's avatar
Leigh B. Stoller committed
249
sub rspec($)            { return $_[0]->{'RSPEC'}; }
Leigh B. Stoller's avatar
Leigh B. Stoller committed
250

251
252
253
254
255
256
257
258
# Return the sliver URN. 
sub sliver_urn($)
{
    my ($self)  = @_;

    return GeniHRN::Generate("@OURDOMAIN@", "sliver", $self->idx());
}

Leigh B. Stoller's avatar
Leigh B. Stoller committed
259
260
261
#
# Delete the sliver. The sliver should not be provisioned when this done.
#
262
sub Delete($$)
Leigh B. Stoller's avatar
Leigh B. Stoller committed
263
{
264
    my ($self, $purge) = @_;
Leigh B. Stoller's avatar
Leigh B. Stoller committed
265
266
267
268

    return -1
	if (! ref($self));

269
270
    my $idx  = $self->idx();
    my $uuid = $self->uuid();
Leigh B. Stoller's avatar
Leigh B. Stoller committed
271

272
273
274
275
    if (GeniUsage->DestroySliver($self, $purge)) {
	print STDERR
	    "GeniSliver::Delete: GeniUsage->DestroySliver($self) failed\n";
    }
276
277
    DBQueryWarn("delete from geni_credentials where this_uuid='$uuid'")
	or return -1;
278
279
280
281
    if ($self->resource_type() ne "Node") {
	DBQueryWarn("delete from geni_certificates where uuid='$uuid'")
	    or return -1;
    }
Leigh B. Stoller's avatar
Leigh B. Stoller committed
282
283
    DBQueryWarn("delete from geni_slivers where idx='$idx'")
	or return -1;
284

285
286
287
    # Delete from cache. 
    delete($slivers{$idx});
    
Leigh B. Stoller's avatar
Leigh B. Stoller committed
288
289
290
    return 0;
}

291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
#
# Get the manifest for an aggregate. Returns the XML string.
#
sub GetManifest($$)
{
    my ($self, $asxml) = @_;

    return undef
	if (! ref($self));

    my $manifest = $self->rspec();

    return $manifest
	if (!$asxml);
    
    my $xml =
	eval { XMLout($manifest, "NoAttr" => 1, RootName => "manifest") };
    if ($@) {
	print STDERR "XMLout error on manifest: $@\n";
	return undef;
    }
    return $xml;
}

Leigh B. Stoller's avatar
Leigh B. Stoller committed
315
316
317
318
319
320
321
322
323
324
#
# Set the aggregate for a sliver.
#
sub SetAggregate($$)
{
    my ($self, $aggregate) = @_;

    return -1
	if (! (ref($self) && ref($aggregate)));

Leigh B. Stoller's avatar
Leigh B. Stoller committed
325
326
    my $idx      = $self->idx();
    my $agg_uuid = $aggregate->uuid();
Leigh B. Stoller's avatar
Leigh B. Stoller committed
327
328
329

    return -1
	if (!DBQueryWarn("update geni_slivers set ".
Leigh B. Stoller's avatar
Leigh B. Stoller committed
330
			 "  aggregate_uuid='$agg_uuid' ".
Leigh B. Stoller's avatar
Leigh B. Stoller committed
331
332
			 "where idx='$idx'"));
    
333
334
335
336
337
338
339
    if (!DBQueryWarn("update sliver_history set ".
		     "  aggregate_uuid='$agg_uuid' ".
		     "where idx='$idx'")) {
	print STDERR "GeniSliver::SetAggregate: ".
	    "Failed to update sliver_history for $self\n";
    }

Leigh B. Stoller's avatar
Leigh B. Stoller committed
340
    $self->{'SLIVER'}->{'aggregate_uuid'} = $agg_uuid;
Leigh B. Stoller's avatar
Leigh B. Stoller committed
341
342
343
344
    $self->{'AGGREGATE'} = $aggregate;
    return 0;
}

345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
#
# And clear the aggregate.
#
sub ClearAggregate($$)
{
    my ($self) = @_;

    return -1
	if (! ref($self));

    my $idx      = $self->idx();

    return -1
	if (!DBQueryWarn("update geni_slivers set ".
			 "  aggregate_uuid=NULL ".
			 "where idx='$idx'"));
    
    $self->{'SLIVER'}->{'aggregate_uuid'} = undef;
    $self->{'AGGREGATE'} = undef;
    return 0;
}

Leigh B. Stoller's avatar
Leigh B. Stoller committed
367
368
369
370
371
372
373
374
375
376
377
378
#
# Get the aggregate for a sliver.
#
sub GetAggregate($)
{
    my ($self) = @_;

    return undef
	if (! ref($self));

    return $self->{'AGGREGATE'} if (defined($self->{'AGGREGATE'}));
    return undef
Leigh B. Stoller's avatar
Leigh B. Stoller committed
379
	if (!defined($self->aggregate_uuid()));
Leigh B. Stoller's avatar
Leigh B. Stoller committed
380

Leigh B. Stoller's avatar
Leigh B. Stoller committed
381
    my $aggregate = GeniAggregate->Lookup($self->aggregate_uuid());
Leigh B. Stoller's avatar
Leigh B. Stoller committed
382
383
384
385
386
387
388
389
    if (!defined($aggregate)) {
	print STDERR "Could not get aggregate object associated with $self\n";
	return undef;
    }
    $self->{'AGGREGATE'} = $aggregate;
    return $aggregate;
}

390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
#
# Set the status for the sliver.
#
sub SetStatus($$)
{
    my ($self, $status) = @_;

    return undef
	if (! ref($self));

    my $idx = $self->idx();
    
    return -1
	if (!DBQueryWarn("update geni_slivers set ".
			 "  status='$status' ".
			 "where idx='$idx'"));
    
    $self->{'SLIVER'}->{'status'} = $status;
    return 0;
}

411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
#
# Set the state for the sliver.
#
sub SetState($$)
{
    my ($self, $state) = @_;

    return undef
	if (! ref($self));

    my $idx = $self->idx();
    
    return -1
	if (!DBQueryWarn("update geni_slivers set ".
			 "  state='$state' ".
			 "where idx='$idx'"));
    
    $self->{'SLIVER'}->{'state'} = $state;
    return 0;
}

Leigh B. Stoller's avatar
Leigh B. Stoller committed
432
433
434
435
436
437
438
439
440
441
442
443
444
#
# Get the experiment for the slice this sliver belongs to.
#
sub GetExperiment($)
{
    my ($self) = @_;

    return undef
	if (! ref($self));

    return Experiment->Lookup($self->slice_uuid());
}

Leigh B. Stoller's avatar
Leigh B. Stoller committed
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
#
# Get the slice for the sliver.
#
sub GetSlice($)
{
    my ($self) = @_;

    return undef
	if (! ref($self));

    return $self->{'SLICE'} if (defined($self->{'SLICE'}));

    if (!defined($self->slice_uuid())) {
	print STDERR "No slice associated with $self\n";
	return undef;
    }
    my $slice = GeniSlice->Lookup($self->slice_uuid());
    if (!defined($slice)) {
	print STDERR "Could not get slice object associated with $self\n";
	return undef;
    }
    $self->{'SLICE'} = $slice;
    return $slice;
}

470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
#
# Look up a list of slivers for a locally instantiated slice. 
# Used by the CM.
#
sub SliceSlivers($$$)
{
    my ($class, $slice, $pref) = @_;

    my $slice_uuid = $slice->uuid();
    my @result = ();

    my $query_result =
	DBQueryWarn("select idx from geni_slivers ".
		    "where slice_uuid='$slice_uuid'");
    return -1
	if (!$query_result);

    while (my ($idx) = $query_result->fetchrow_array()) {
	my $sliver = GeniSliver->Lookup($idx);
	return -1
	    if (!defined($sliver));
	push(@result, $sliver);
    }
    @$pref = @result;
    return 0;
}

497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
#
# Find slivers "dependent" on this sliver, as for interfaces on nodes.
#
sub DependentSlivers($$)
{
    my ($self, $pref) = @_;

    return -1
	if (! (ref($self) && ref($pref)));
    @$pref = ();

    my $idx = $self->idx();
    my $resource_uuid = $self->resource_uuid();

    my $query_result =
	DBQueryWarn("select idx from geni_slivers ".
		    "where idx!='$idx' and resource_uuid='$resource_uuid'");
    return -1
	if (!$query_result);

    my @result = ();
    while (my ($idx) = $query_result->fetchrow_array()) {
	my $sliver = GeniSliver->Lookup($idx);
	if (!defined($sliver)) {
	    print STDERR "Could not get sliver object for $idx\n";
	    return -1;
	}
	push(@result, $sliver);
    }
    @$pref = @result;
    return 0;
}

530
#
Leigh B. Stoller's avatar
Leigh B. Stoller committed
531
532
# Create a signed credential for this sliver, issued to the provided user.
# The credential will grant all permissions for now.
533
#
Leigh B. Stoller's avatar
Leigh B. Stoller committed
534
535
536
# Should we store these credentials in the DB, recording what we hand out?
#
sub NewCredential($$)
537
{
Leigh B. Stoller's avatar
Leigh B. Stoller committed
538
    my ($self, $owner) = @_;
539

Leigh B. Stoller's avatar
Leigh B. Stoller committed
540
541
    return undef
	if (! (ref($self) && ref($owner)));
542

Leigh B. Stoller's avatar
Leigh B. Stoller committed
543
544
545
546
547
    my $credential = GeniCredential->Create($self, $owner);
    if (!defined($credential)) {
	print STDERR "Could not create credential for $self, $owner\n";
	return undef;
    }
548
549
550
    if (defined($self->nickname())) {
	$credential->AddExtension("nickname", $self->nickname());
    }
Leigh B. Stoller's avatar
Leigh B. Stoller committed
551
552
553
554
555
556
    if ($credential->Sign($self->GetCertificate()) != 0) {
	print STDERR "Could not sign credential for $self, $owner\n";
	return undef;
    }
    return $credential;
}
557

558
559
560
561
562
563
564
565
566
567
568
569
570
############################################################################
#
# The server side methods are in packages which inherit from above.
#
package GeniSliver::Node;
use vars qw(@ISA);
@ISA = "GeniSliver";

use GeniDB;
use GeniComponent;
use GeniSlice;
use GeniCredential;
use GeniCertificate;
571
use GeniUtil;
Leigh B. Stoller's avatar
Leigh B. Stoller committed
572
use Experiment;
573
use emutil;
Leigh B. Stoller's avatar
Leigh B. Stoller committed
574
use XML::Simple;
575
use libdb qw(TBDB_ALLOCSTATE_RES_INIT_DIRTY TBDB_NODESTATE_SHUTDOWN
Leigh B. Stoller's avatar
Leigh B. Stoller committed
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
	     TBResolveNextOSID TBDB_NODESTATE_ISUP TBDB_NODESTATE_TBFAILED);

# Return the URN.
sub ErrorLog($)
{
    my ($self)  = @_;
    my $bootlog = "";

    my $node = Node->Lookup($self->uuid());
    if (!defined($node)) {
	print STDERR "Could not map node $self to its object\n";
	return "";
    }
    if ($node->GetBootLog(\$bootlog)) {
	print STDERR "Could not get bootlog for $self ($node)\n";
	return "";
    }
    return $bootlog;
}
595

596
597
598
599
600
601
602
603
# Return the component URN. This is how a resource is resolved.
sub component_urn($)
{
    my ($self)  = @_;

    return GeniHRN::Generate("@OURDOMAIN@", "node", $self->resource_id())
}

604
sub Create($$$$$$)
605
{
606
    my ($class, $slice, $user, $resource_uuid, $rspec) = @_;
Leigh B. Stoller's avatar
Leigh B. Stoller committed
607
608
609
610
611
    my $virtualization_type = $rspec->{'virtualization_type'};

    my $experiment = $slice->GetExperiment();
    if (!defined($experiment)) {
	print STDERR "Could not map $slice to its experiment\n";
612
	return undef;
Leigh B. Stoller's avatar
Leigh B. Stoller committed
613
    }
614

Leigh B. Stoller's avatar
Leigh B. Stoller committed
615
616
617
618
619
620
621
622
    #
    # the node is already allocated to the sliver, but still need to enter
    # a virt_nodes entry, and possibly more virt table entries, so that the
    # node will boot properly, and is otherwise controllable.
    #
    my $node = Node->Lookup($resource_uuid);
    if (!defined($node)) {
	print STDERR "Could not map node $resource_uuid to its object\n";
623
	return undef;
Leigh B. Stoller's avatar
Leigh B. Stoller committed
624
    }
625
626
627

    #
    # An artifact of Emulab is that for shared/remote nodes, the physical
628
    # node is already allocated, but not to the current experiment.
629
630
631
    #
    if (! ($node->sharing_mode() ||
	   ($node->isremotenode() && $node->isvirtnode()))) {
632
633
634
635
636
637
	my $reservation = $node->Reservation();
	if (!defined($reservation)) {
	    print STDERR "$node was already released from $slice\n";
	    return undef;
	}
	if (! $reservation->SameExperiment($experiment)) {
638
	    print STDERR "$node is reserved to another, not $experiment\n";
639
640
641
	    # Signal error so we can look at what happened.
	    return undef;
	}
Leigh B. Stoller's avatar
Leigh B. Stoller committed
642
    }
643
    my $nickname = $rspec->{'virtual_id'};
644
645
646
647
648
649
    my $hrn;
    my $sshdport;
    my $hostname;
    my $resource_id;
    my $sliver_uuid;

Leigh B. Stoller's avatar
Leigh B. Stoller committed
650
651
652
653
654
    #
    # The resource UUID refers to the physical node, but the virtualization
    # type might require a vnode.
    # 
    if ($virtualization_type eq "emulab-vnode") {
Leigh B. Stoller's avatar
Leigh B. Stoller committed
655
656
657
	my $vnode = $experiment->VnameToNode($nickname);
	if (!defined($vnode)) {
	    print STDERR "Could not lookup node $nickname in $experiment\n";
658
	    return undef;
Leigh B. Stoller's avatar
Leigh B. Stoller committed
659
	}
Leigh B. Stoller's avatar
Leigh B. Stoller committed
660
661
	$hrn = "${PGENIDOMAIN}." . $vnode->node_id();
	$sliver_uuid = $vnode->uuid();
662
663
664
	$resource_id = $vnode->node_id();
	$hostname = $vnode->node_id() . ".${OURDOMAIN}";
	$sshdport = $vnode->sshdport();
Leigh B. Stoller's avatar
Leigh B. Stoller committed
665
    }
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
    else {
	$hrn = "${PGENIDOMAIN}." . $node->node_id();
	$sliver_uuid = $node->uuid();
	$resource_id = $node->node_id();
	$hostname = $node->node_id() . ".${OURDOMAIN}";
    }
    my $component_urn = GeniHRN::Generate($OURDOMAIN, "node", $resource_id);

    #
    # Add this stuff to the rspec (which becomes the manifest).
    #
    $rspec->{'sliver_uuid'}   = $sliver_uuid;
    $rspec->{'hostname'}      = $hostname;
    $rspec->{'sshdport'}      = $sshdport if (defined($sshdport));
    $rspec->{'component_urn'} = $component_urn;

682
    return GeniSliver->Create($slice, $user, $sliver_uuid, $resource_uuid,
683
			      "Node", $resource_id, $hrn, $nickname, $rspec);
684
685
}

Leigh B. Stoller's avatar
Leigh B. Stoller committed
686
687
#
# Provision a slice. We actually did this when the ticket was requested.
Leigh B. Stoller's avatar
Leigh B. Stoller committed
688
# We fill in some virt table stuff so that tbswap will work.
Leigh B. Stoller's avatar
Leigh B. Stoller committed
689
#
Leigh B. Stoller's avatar
Leigh B. Stoller committed
690
sub Provision($;$)
Leigh B. Stoller's avatar
Leigh B. Stoller committed
691
{
Leigh B. Stoller's avatar
Leigh B. Stoller committed
692
    my ($self, $extraargs) = @_;
Leigh B. Stoller's avatar
Leigh B. Stoller committed
693
694
695
696
697
698
699

    return -1
	if (! ref($self));

    #
    # the node is already allocated to the sliver, but still need to enter
    # a virt_nodes entry, and possibly more virt table entries, so that the
Leigh B. Stoller's avatar
Leigh B. Stoller committed
700
    # node will boot properly, and is otherwise controllable.
Leigh B. Stoller's avatar
Leigh B. Stoller committed
701
702
703
704
705
706
    #
    my $experiment = Experiment->Lookup($self->slice_uuid());
    if (!defined($experiment)) {
	print STDERR "Could not map $self to its experiment\n";
	return -1;
    }
707
    my $uuid = $self->uuid();
Leigh B. Stoller's avatar
Leigh B. Stoller committed
708
    return 0
709
710
	if (!defined($uuid));
    my $node       = Node->Lookup($uuid);
Leigh B. Stoller's avatar
Leigh B. Stoller committed
711
    if (!defined($node)) {
712
	print STDERR "Could not map node $uuid to its object\n";
Leigh B. Stoller's avatar
Leigh B. Stoller committed
713
714
	return -1;
    }
715
    my $node_id     = $node->node_id();
Leigh B. Stoller's avatar
Leigh B. Stoller committed
716
717
    my $reservation = $node->Reservation();
    if (!defined($reservation)) {
718
	print STDERR "$node was already released from slice\n";
Leigh B. Stoller's avatar
Leigh B. Stoller committed
719
720
	return -1;
    }
721
    if (! $reservation->SameExperiment($experiment)) {
722
	print STDERR "$node is reserved to another, not $experiment\n";
723
724
725
726
727
	# Signal error so we can look at what happened.
	return -1;
    }
    my $pid = $experiment->pid();
    my $eid = $experiment->eid();
728

729
730
731
732
733
734
735
    if (!$node->isremotenode() &&
	exists($self->rspec()->{'virtualization_type'}) &&
	$self->rspec()->{'virtualization_type'} eq "emulab-vnode") {
	my $pnode = Node->Lookup($node->phys_nodeid());
	if (!defined($pnode)) {
	    print STDERR "Could not get pnode object for $node\n";
	    return -1;
Leigh B. Stoller's avatar
Leigh B. Stoller committed
736
	}
737

738
739
	# Mark
	$node->ModifyReservation({"genisliver_idx" => $self->idx()});
740

Leigh B. Stoller's avatar
Leigh B. Stoller committed
741
742
743
744
745
746
	if (exists($self->rspec()->{'virtualization_subtype'})) {
	    my $subtype = $self->rspec()->{'virtualization_subtype'};
	    
	    if (!$pnode->sharing_mode()) {
		$pnode->ModifyReservation({"genisliver_idx" => $self->idx()});
	    }
747
	}
Leigh B. Stoller's avatar
Leigh B. Stoller committed
748
749
    }
    else {
750
751
752
753
754
755
756
	#
	# For a "raw" node, there is no vnode, so this is the pnode
	# we need to mark for tmcd.
	#
	if ($node->ModifyReservation({"genisliver_idx" => $self->idx()})) {
	    return -1;
	}
Leigh B. Stoller's avatar
Leigh B. Stoller committed
757
758
759
760
761
762
763
764

	#
	# Terrible place to do this. 
	#
	if ($node->OSSelect("<DEFAULT>", "def_boot_osid", 0) != 0) {
	    print STDERR "Could not os_select $node to default\n";
	    return -1;
	}
765
    }
766
    $self->SetStatus("ready");
Leigh B. Stoller's avatar
Leigh B. Stoller committed
767
768
769
770
771
772
    return 0;
}

#
# Unprovision a sliver. 
#
773
sub UnProvision($;$)
Leigh B. Stoller's avatar
Leigh B. Stoller committed
774
{
775
    my ($self, $nophysfree) = @_;
Leigh B. Stoller's avatar
Leigh B. Stoller committed
776
777
778

    return -1
	if (! ref($self));
779
780
    $nophysfree = 0
	if (!defined($nophysfree));
Leigh B. Stoller's avatar
Leigh B. Stoller committed
781
782

    my $experiment = Experiment->Lookup($self->slice_uuid());
Leigh B. Stoller's avatar
Leigh B. Stoller committed
783
784
785
786
    if (!defined($experiment)) {
	print STDERR "Could not map $self to its experiment\n";
	return -1;
    }
787
    my $uuid = $self->uuid();
Leigh B. Stoller's avatar
Leigh B. Stoller committed
788
    return 0
789
790
	if (!defined($uuid));
    my $node       = Node->Lookup($uuid);
Leigh B. Stoller's avatar
Leigh B. Stoller committed
791
    if (!defined($node)) {
Leigh B. Stoller's avatar
Leigh B. Stoller committed
792
	# Lets call this nonfatal since it might be a virtnode that 
793
	print STDERR "Could not map node $uuid to its object\n";
Leigh B. Stoller's avatar
Leigh B. Stoller committed
794
	return 0;
Leigh B. Stoller's avatar
Leigh B. Stoller committed
795
796
797
798
799
800
801
    }
    my $reservation = $node->Reservation();
    if (!defined($reservation)) {
	print STDERR "$node was already released from $self\n";
	return 0;
    }
    if ($reservation->SameExperiment($experiment)) {
Leigh B. Stoller's avatar
Leigh B. Stoller committed
802
	my $node_id = $node->node_id();
Leigh B. Stoller's avatar
Leigh B. Stoller committed
803
804
	my $pid = $experiment->pid();
	my $eid = $experiment->eid();
Leigh B. Stoller's avatar
Leigh B. Stoller committed
805

806
	if ($node->isremotenode() && $node->isvirtnode()) {
Leigh B. Stoller's avatar
Leigh B. Stoller committed
807
	    system("$VNODESETUP -p -q -m -k $pid $eid $node_id");
808
	    if ($?) {
Leigh B. Stoller's avatar
Leigh B. Stoller committed
809
		print STDERR "$VNODESETUP -k failed on $node_id\n";
810
811
812
		return -1;
	    }
	}
Leigh B. Stoller's avatar
Leigh B. Stoller committed
813
814
815
816
817
818
	elsif ($node->sharing_mode()) {
	    system("$VNODESETUP -j -q -m -k $pid $eid $node_id");
	    if ($?) {
		print STDERR "$VNODESETUP -k failed on $node_id\n";
		return -1;
	    }
819
	}
Leigh B. Stoller's avatar
Leigh B. Stoller committed
820

821
822
	if (!$node->isremotenode() &&
	    $self->rspec()->{'virtualization_type'} eq "emulab-vnode") {
Leigh B. Stoller's avatar
Leigh B. Stoller committed
823
824
825
826
827
828
	    my $pnode_id = $node->phys_nodeid();
	    my $pnode = Node->Lookup($pnode_id);
	    if (!defined($pnode)) {
		print STDERR "Could not get pnode object for $pnode_id\n";
		return -1;
	    }
829
830
831

	    #
	    # If this is the last virtnode on the physnode, release the
Leigh B. Stoller's avatar
Leigh B. Stoller committed
832
833
	    # physnode too. Unless its a shared host, in which case just
	    # deallocate the virtnode.
834
	    #
Leigh B. Stoller's avatar
Leigh B. Stoller committed
835
836
837
838
839
840
	    my @vnodes = ();
	    
	    if ($pnode->sharing_mode()) {
		$nophysfree = 1;
	    }
	    elsif ($pnode->VirtualNodes(\@vnodes) != 0) {
841
		print STDERR "Could not get vnode list for $pnode\n";
Leigh B. Stoller's avatar
Leigh B. Stoller committed
842
843
		return -1;
	    }
844

845
	    if (scalar(@vnodes) > 1 || $nophysfree) {
846
		system("$NFREE -q $pid $eid $node_id");
847
848
849
		# Unincorporate the node. Bogus, needs fixing.
		$pnode->ModifyReservation({"genisliver_idx" => 0})
		    if (! ($pnode->sharing_mode() || scalar(@vnodes) > 1));
850
851
852
853
854
	    }
	    else {
		system("$NFREE -x -q $pid $eid $pnode_id");
		$pnode->Refresh();
	    }
Leigh B. Stoller's avatar
Leigh B. Stoller committed
855
856
	}
	else {
857
858
859
860
861
	    if ($nophysfree) {
		# Unincorporate the node. Bogus, needs fixing.
		$node->ModifyReservation({"genisliver_idx" => 0});
		goto skip;
	    }
862
	    system("$NFREE -q $pid $eid $node_id");
Leigh B. Stoller's avatar
Leigh B. Stoller committed
863
	}
Leigh B. Stoller's avatar
Leigh B. Stoller committed
864
865
	if ($?) {
	    print STDERR "Could not deallocate $node from $self\n";
Leigh B. Stoller's avatar
Leigh B. Stoller committed
866
	    $node->Refresh();
Leigh B. Stoller's avatar
Leigh B. Stoller committed
867
868
	    return -1;
	}
869
      skip:
Leigh B. Stoller's avatar
Leigh B. Stoller committed
870
	$node->Refresh();
Leigh B. Stoller's avatar
Leigh B. Stoller committed
871
872
873
874
875
876
877
878
879
    }
    else {
	print STDERR "$node is reserved to another, not $self\n";
	# Signal error so we can look at what happened.
	return -1;
    }
    return 0;
}

880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
#
# Process a manifest.
#
sub ProcessManifest($$)
{
    my ($self, $manifest) = @_;

    return -1
	if (! ref($self));

    my $experiment = Experiment->Lookup($self->slice_uuid());
    if (!defined($experiment)) {
	print STDERR "Could not map $self to its experiment\n";
	return -1;
    }
    my $pid = $experiment->pid();
    my $eid = $experiment->eid();
    
    my $uuid = $self->uuid();
    return 0
	if (!defined($uuid));
    my $node       = Node->Lookup($uuid);
    if (!defined($node)) {
	print STDERR "Could not map node $uuid to its object\n";
	return -1;
    }
    my $reservation = $node->Reservation();
    if (!defined($reservation)) {
	print STDERR "$node was already released from $self\n";
	return -1;
    }
    if ($reservation->SameExperiment($experiment)) {
	#
	# Find the corresponding node in the manifest.
	#
	foreach my $ref (@{$manifest->{'node'}}) {
	    if ($ref->{'sliver_uuid'} eq $uuid) {
		# startup command.
		if (exists($ref->{'startup_command'})) {
		    my $startupcmd = $ref->{'startup_command'};
	    
		    if (! TBcheck_dbslot($startupcmd, "virt_nodes",
					 "startupcmd",
					 TBDB_CHECKDBSLOT_WARN|
					 TBDB_CHECKDBSLOT_ERROR)) {
			print STDERR "Invalid startup command '$startupcmd'\n";
			return -1;
		    }
		    $node->Update({"startupcmd" => $startupcmd});
		}
		return 0;
	    }
	}
    }
    else {
	print STDERR "$node is reserved to another, not $self\n";
	# Signal error so we can look at what happened.
	return -1;
    }
    return 0;
}

Leigh B. Stoller's avatar
Leigh B. Stoller committed
942
#
Leigh B. Stoller's avatar
Leigh B. Stoller committed
943
# Start (or restart) a node. Basically, a reboot.
Leigh B. Stoller's avatar
Leigh B. Stoller committed
944
#
Leigh B. Stoller's avatar
Leigh B. Stoller committed
945
sub Start($$$)
Leigh B. Stoller's avatar
Leigh B. Stoller committed
946
{
Leigh B. Stoller's avatar
Leigh B. Stoller committed
947
    my ($self, $version, $restart) = @_;
Leigh B. Stoller's avatar
Leigh B. Stoller committed
948
949
950
951
952
953
954
955
956

    return -1
	if (! ref($self));

    my $experiment = Experiment->Lookup($self->slice_uuid());
    if (!defined($experiment)) {
	print STDERR "Could not map $self to its experiment\n";
	return -1;
    }
Leigh B. Stoller's avatar
Leigh B. Stoller committed
957
958
959
    my $pid = $experiment->pid();
    my $eid = $experiment->eid();
    
960
    my $uuid = $self->uuid();
Leigh B. Stoller's avatar
Leigh B. Stoller committed
961
    return 0
962
963
	if (!defined($uuid));
    my $node       = Node->Lookup($uuid);
Leigh B. Stoller's avatar
Leigh B. Stoller committed
964
    if (!defined($node)) {
965
	print STDERR "Could not map node $uuid to its object\n";
Leigh B. Stoller's avatar
Leigh B. Stoller committed
966
967
968
969
970
971
972
973
	return -1;
    }
    my $reservation = $node->Reservation();
    if (!defined($reservation)) {
	print STDERR "$node was already released from $self\n";
	return -1;
    }
    if ($reservation->SameExperiment($experiment)) {
Leigh B. Stoller's avatar
Leigh B. Stoller committed
974
	my $node_id = $node->node_id();
Leigh B. Stoller's avatar
Leigh B. Stoller committed
975

Leigh B. Stoller's avatar
Leigh B. Stoller committed
976
977
978
	#
	# Reboot and wait?
	#
Leigh B. Stoller's avatar
Leigh B. Stoller committed
979
980
981
982
983
984
985
986
	if ($node->isvirtnode() && $node->sharing_mode()) {
	    if ($node->eventstate() eq TBDB_NODESTATE_SHUTDOWN()) {
		system("$VNODESETUP -j -q -m $pid $eid $node_id");
	    }
	}
	else {
	    system("$NODEREBOOT -s $node_id");
	}
Leigh B. Stoller's avatar
Leigh B. Stoller committed
987
988
	return -1
	    if ($?);
Leigh B. Stoller's avatar
Leigh B. Stoller committed
989
990
991
992
993
    }
    else {
	print STDERR "$node is reserved to another, not $self\n";
	# Signal error so we can look at what happened.
	return -1;
Leigh B. Stoller's avatar
Leigh B. Stoller committed
994
    }
Leigh B. Stoller's avatar
Leigh B. Stoller committed
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
    $self->SetState("started");
    return 0;
}
# And stop.
sub Stop($$)
{
    my ($self, $version) = @_;

    return -1
	if (! ref($self));

    my $experiment = Experiment->Lookup($self->slice_uuid());
    if (!defined($experiment)) {
	print STDERR "Could not map $self to its experiment\n";
	return -1;
    }
    my $pid = $experiment->pid();
    my $eid = $experiment->eid();
    
    my $uuid = $self->uuid();
    return 0
	if (!defined($uuid));
    my $node       = Node->Lookup($uuid);
    if (!defined($node)) {
	print STDERR "Could not map node $uuid to its object\n";
	return -1;
    }
    my $reservation = $node->Reservation();
    if (!defined($reservation)) {
	print STDERR "$node was already released from $self\n";
	return -1;
    }
    if ($reservation->SameExperiment($experiment)) {
	my $node_id = $node->node_id();

	#
	# Reboot and wait?
	#
	if ($node->isvirtnode() && $node->sharing_mode()) {
	    if ($node->eventstate() eq TBDB_NODESTATE_SHUTDOWN()) {
		system("$VNODESETUP -j -k -q -m $pid $eid $node_id");
	    }
	}
	else {
	    system("$POWER off $node_id");
	}
	return -1
	    if ($?);
    }
    else {
	print STDERR "$node is reserved to another, not $self\n";
	# Signal error so we can look at what happened.
	return -1;
    }
    $self->SetState("stopped");
    return 0;
}

sub ComputeStatus($$)
{
    my ($self, $pref) = @_;
    my $status = undef;

    return -1
	if (! ref($self));

    my $uuid = $self->uuid();
    return -1
	if (!defined($uuid));
    my $node       = Node->Lookup($uuid);
    if (!defined($node)) {
	print STDERR "Could not map node $uuid to its object\n";
	return -1;
    }
    my $reservation = $node->Reservation();
    if (!defined($reservation)) {
	print STDERR "$node was already released from $self\n";
	return -1;
    }
    my $eventstate = $node->eventstate();
    if ($eventstate eq TBDB_NODESTATE_ISUP()) {
	$status = "ready";
    }
    elsif ($eventstate eq TBDB_NODESTATE_TBFAILED()) {
	$status = "failed";
    }
    else {
	$status = "notready";
    }
    $self->SetStatus($status);
    $$pref = $status;
Leigh B. Stoller's avatar
Leigh B. Stoller committed
1086
1087
    return 0;
}
Leigh B. Stoller's avatar
Leigh B. Stoller committed
1088

1089
##########################################################################
1090
#
1091
1092
1093
1094
1095
1096
1097
1098
1099
package GeniSliver::Interface;
use vars qw(@ISA);
@ISA = "GeniSliver";

use GeniDB;
use GeniComponent;
use GeniSlice;
use GeniCredential;
use GeniCertificate;
1100
use GeniUtil;
1101

1102
1103
1104
1105
1106
1107
1108
1109
1110
# Return the component URN. This is how a resource is resolved.
# Return the component URN. This is how a resource is resolved.
sub component_urn($)
{
    my ($self)  = @_;

    return GeniHRN::Generate("@OURDOMAIN@", "interface", $self->resource_id())
}

1111
1112
sub Create()
{
1113
    my ($class, $slice, $user, $nodeid, $iface, $linkname, $rspec) = @_;
1114

1115
1116
1117
1118
1119
1120
1121
    # These are silly; uuids should go away for interfaces. 
    my $interface_uuid = GeniUtil::NewUUID();
    my $component_urn  = GeniHRN::GenerateInterface($OURDOMAIN,
						    $nodeid, $iface);
    my $nickname       = "$linkname.$nodeid.$iface";
    my $hrn            = "${PGENIDOMAIN}.$nodeid.$iface";
    my $resource_id    = "$nodeid//$iface";
1122

1123
1124
1125
1126
1127
    #
    # Add this stuff to the rspec (which becomes the manifest).
    #
    $rspec->{'sliver_uuid'}   = $interface_uuid;
    $rspec->{'component_urn'} = $component_urn;
1128

1129
    return GeniSliver->Create($slice, $user, $interface_uuid,
1130
			      $interface_uuid, "Interface", $resource_id,
1131
			      $hrn, $nickname, $rspec);
1132
1133
1134
1135
1136
1137
}

sub Provision($)
{
    my ($self) = @_;

1138
1139
1140
1141
    #
    # This is actually implemented in GeniAggregate since currently "link"
    # is the smallest entity; you cannot operate on an individual interface.
    #
1142
1143
1144
1145
1146
1147
1148
    return -1
	if (! ref($self));

    return 0;
}

#
1149
# Unprovision a single interface from a link/lan. 
1150
1151
1152
1153
1154
1155
1156
1157
#
sub UnProvision($)
{
    my ($self) = @_;

    return -1
	if (! ref($self));

1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
    my $aggregate = $self->GetAggregate();
    if (!defined($aggregate)) {
	print STDERR "Could not find aggregate for $self\n";
	return -1;
    }

    #
    # This is terrible; we need an interface to remove ports form vlans,
    # so that we do not have to tear down the entire vlan and recreate.
    #
    if ($aggregate->UnProvision() != 0) {
	print STDERR "Could not unprovision $aggregate\n";
	return -1;
    }
    $self->ClearAggregate();
    if ($aggregate->Provision() != 0) {
	print STDERR "Could not provision $aggregate\n";
	return -1;
    }
1177
1178
1179
1180
    return 0;
}

#
1181
# Start a sliver.
1182
#
Leigh B. Stoller's avatar
Leigh B. Stoller committed
1183
sub Start($$)
1184
1185
1186
{
    my ($self) = @_;

1187
1188
1189
1190
    #
    # This is actually implemented in GeniAggregate since currently "link"
    # is the smallest entity; you cannot operate on an individual interface.
    #
1191
1192
1193
1194
1195
    return -1
	if (! ref($self));

    return 0;
}
Leigh B. Stoller's avatar
Leigh B. Stoller committed
1196

Leigh B. Stoller's avatar
Leigh B. Stoller committed
1197
1198
# _Always_ make sure that this 1 is at the end of the file...
1;