Changes between Version 13 and Version 14 of AaronHelsinger/GAPI_AM_API_DRAFT

Timestamp:

03/22/12 16:34:29 (12 years ago)

Author:

Aaron Helsinger

Comment:

--

AaronHelsinger/GAPI_AM_API_DRAFT

@@ -41 +41 @@
  - [#ChangeSetF2:ActOnSlivers Change Set F2]: Superceded by F3 and F4: Add a new general !ActOnSlivers method allowing AMs to support AM and resource-type specific operations
  - [#ChangeSetF3:SliverAllocationStatesandmethods Change Set F3]: Sliver Allocation States and methods
- - [#ChangeSetF4:SliverOperationalStatesandmethods Change Set F4]: Sliver Operational States and methods
+ - [#ChangeSetF4:SliverOperationsMethod Change Set F4]: Method to perform Sliver Operational actions
+ - [#ChangeSetF5:SliverOperationalStates Change Set F5]: Sliver Operational States
  - ADOPTED: [#Adopted:ChangeSetG:Credentialsaregeneralauthorizationtokens. Change Set G]: Generalize the credentials argument, allowing ABAC support
  - Change Set H: Clarify: A second call to !CreateSlivers without an intervening !DeleteSlivers is an error.
@@ -503 +504 @@
  - What about an !UpdateAllocations method, similar to !UpdateTickets or !UpdateTransactions from other similar proposals, for modifying allocated resources in place, without losing allocated resources?
 
-== Change Set F4: Sliver Operational States and methods ==
+== Change Set F4: Sliver Operations Method ==
 This proposal was discussed on the geni-dev mailing list: http://lists.geni.net/pipermail/dev/2012-March/000743.html
 
@@ -544 +545 @@
 
 This is a fast synchronous operation, and MAY start long-running sliver transitions whose status can be queried using !SliverStatus.
+
+== Change Set F5: Sliver Operational States ==
+Currently, geni_status in SliverStatus can have values `configuring`, `ready`, `failed`, `unknown`.
+
+This proposal expands that list, and renames those to use the standard 'geni_' prefix.
+
+These states would be reported by various AM API methods, specifically !SliverStatus. And would be used in reasoning about valid operations in !PerformOperationalAction
+
+Proposed GENI sliver operational states:
+
+`geni_notready`: IE after the resource has been provisioned, but before doing `geni_start`
+`geni_configuring`: IE after doing `geni_start`, but before it is fully ready.
+`geni_busy`: The sliver is busy changing states. Could be eg after calling `geni_stop`, and before that completes.
+`geni_ready`: the resource is fully ready for experimenter use
+`geni_failed`: Something went wrong with the resource. Like it failed to boot. The sliver is unusable, and an operator must intervene.
+`geni_unknown`: The AM cannot determine the state of the resource. The sliver state may become known, or may require an operator to intervene.
+`geni_mixed`: For use only in reporting operational state of the full slice at an aggregate, when some resources are ready, and some are notready.
+`geni_shutdown`: The sliver has been 'shutdown'. EG it has been brought down to a safe boot mode, where it can be inspected but not used.
 
 = Adopted: Change Set G: Credentials are general authorization tokens. =