[ISSUE 138] Assembly specification unclear on Contribution vs Deployment -when can errors in artifacts be reported? - Updated Proposal

[Mike Edwards <mike_edwards@uk.ibm.com>]

Here is a proposal based on discussions
that have taken place on the email list and in prevoous TC calls:


Proposal: 

Add a new section to the spec after
line 3649 as follows: 

11.3. States of Artifacts in the Domain


Artifacts in the SCA domain are in one
of 3 states: 

1. Installed 
2. Deployed 
3. Running 

Installed artifacts are artifacts that
are part of a Contribution that is installed into the Domain. 
Installed artifacts are available for
use by other artifacts that are deployed, See "install Contribution"

and "remove Contribution"
to understand how artifacts are installed and uninstalled. 

Deployed artifacts are artifacts that
the SCA runtime is given to execute. Artifacts are deployed 
either through explicit deployment actions
or through the presence of <deployable/> elements 
in sca-contribution.xml files within
a Contribution. If an artifact is deployed which has dependencies 
on other artifacts, then those dependent
artifacts are also deployed. 

When the SCA runtime has one or more
deployable artifacts, the runtime attempts to put those artifacts 
and any artifacts they depend on into
the Running state. This can fail due to errors in one or more of the artifacts

or the process can be delayed until
all dependencies are available. 

11.3.1 

Checking for errors in artifacts MAY
be done for artifacts in the Installed state (ie where the artifacts are

simply part of installed contributions]
[ASM120xx] 

Errors in artifacts MAY be detected
either during the Deployment of the artifacts. [ASM120xx]

Errors in artifacts MUST be detected
no later than the process of putting the 
artifacts into the Running state, [ASM120xx]


Yours,  Mike.

Strategist - Emerging Technologies, SCA & SDO.
Co Chair OASIS SCA Assembly TC.
IBM Hursley Park, Mail Point 146, Winchester, SO21 2JN, Great Britain.
Phone & FAX: +44-1962-818014    Mobile: +44-7802-467431  
Email:  mike_edwards@uk.ibm.com

---

Unless stated otherwise above:
IBM United Kingdom Limited - Registered in England and Wales with number 741598.
Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 3AU