Define the assets of a marine observatory and their related policies.
|Actors||Marine Observatory Manager (Observatory Manager)|
|References||R2-R3 Architectural Composition-Principals to Services
UC.R2.10 Manage Marine Platform
UC.R2.35 Share Affiliated Orgs' Resources-Deprecated
UC.R2.36 Create an Org
UC.R2.37 Control Service Interactions
UC.R2.40 Monitor ION Resources
|Uses||UC.R2.42 Define Resource Policy|
|Is Used By|
|Is Extended By|
|In Acceptance Scenarios||AS.R2.01A Operate Marine Observatory, AS.R2.01B Define Marine Observatory Policies, AS.R2.02C Instrument Life Cycle Support|
|Technical Notes||This activity is implemented in R2 to satisfy initial OOI marine deployments; it will be extended in R3.|
|Primary Service||Marine Observatory Facility Services|
|UC Status||Mapped + Ready|
Define resources of a marine observatory, such as instruments, platforms and deployments. Define policy for these resources and for the observatory.
- A person with the appropriate role is responsible for defining policies for the observatory's resources.
- The Integrated Observatory Manager has set up the available actions, conditions, and roles that can be applied; a Marine Observatory Manager may extend the list of roles.
- Those that define policy may select from the pre-configured options. (A user interface may be provided to simplify this process.)
The relevant marine observatory is registered in the system.
- Marine Observatory Manager defines resources to be deployed in a marine observatory offline for scripted ingest.
- The definitions are entered into a commonly shared document like a Google spreadsheet.
- This is the option likely to be used for most resources, especially when the system is brought up, to submit large collections of resources at one time via a command script.
- Definitions include metadata and can be changed before the resource is read in, or using the user interface of the Integrated Observatory after the resource is in the system.
- At a mutually agreed time, Integrated Observatory Operator executes the necessary commands to read in the offline definitions.
- While this capability will likely exist in some form after the observatories are operated, support for it is not guaranteed.
- In some cases it may be possible to delete and re-read the resources, but this is not guaranteed.
- Marine Observatory Manager uses a user interface to define resources to be deployed in a marine observatory.
- (via a user interface).
- Definitions include metadata and can be changed any time.
- User interface provides means to add or edit metadata for a resource.
- Operational resource interactions, e.g. commanding them and changing their life-cycle states, are different proceses, with separate use cases.
- <3> Marine Observatory Manager defines policy for the observatory
- Policy rules are defined in OOI policy specification language; user interfaces may help select appropriate (basic) policies
- The rules that are created scope the interaction of the observatory's members and enforces the observatory's policy in administration of the group.
- Ideally any newly created conflicts (existing operations or plans that are no longer supported) would be highlighted when a policy is created.
- <3> Marine Observatory Manager defines policies for individual resources, such as instruments, platforms, or sites.
- Policy rules are defined in OOI policy specification language, with respect to user roles.
- <3> Policies that apply to specific resources may be viewed in the page for that resource.
- In operation, a role may be scoped to a particular resource, and possibly within a period of time.
- Policies that apply by composition or inference to a resource (i.e., because the resource is related to another primary resource which has the policy applied) may not be visible in the page for the non-primary resource, though this would be desirable.
Observatory resources are defined, along with their attributes and metadata.
These comments provide additional context (usually quite technical) for editors of the use case.
The availability of policy allows observatory managers to operate and govern a marine observatory facility independently from the Integrated Observatory, applying marine IOs' resource use policies. It enables each observatory to define its own resource use policies, and to assign resource attribute values (e.g., life cycle state) that engage the appropriate policies given the roles of the principals.
Policy is strongly considered by the COI federated facility, SA marine facility and the Org affiliation and resource sharing use cases. Policies can control resource access or use, based initially on resource state.
The types of marine assets for which policies can be constructed include whole observatories (possibly composed of observatories), platforms (possibly composed of platforms), and instruments (possibly composed of instruments). Resources like data products can also have policies applied. Policies applied to an aggregating resource like a platform or observatory are expected to flow down to contained resources, unless otherwise specified.
In this Release policy options are relatively few, and their setup is changed relatively rarely. The Release 3 observatory will support more flexible policy capabilities to control observatory operations.