update_swlib_entity

Modifies an entity in the software library. A new revision of the entity is created by default. Changing only the description or attribute values does not create a new revision, and such changes will be visible across all existing revisions of the entity.

Format

emcli update_swlib_entity 
        -entity_rev_id="entity_rev_id" 
        [-desc="entity_desc"] 
        [-attr="<attr_name>:<attr_value>"] 
        [-prop="<prop_name>:<prop_value>"] 
        [-secret_prop="<secret_prop_name>:<secret_prop_value>"] 
        [-note="note_text"] 
        [-use_latest_revision] 

[ ]  indicates that the parameter is optional

Options

• entity_rev_id

  Identifier of the entity revision. The software library home page exposes the identifier for folders and entities as a custom column (Internal ID) and is hidden by default.

• desc

  Description of the entity. The new description is visible to all existing revisions.

• attr

  An attribute and its value, separated by a colon ( : ). To specify values for multiple attributes, repeat this option. The new attribute value is visible to all existing revisions.

• prop

  Configuration property and its value, separated by a colon ( : ). To specify values for multiple attributes, repeat this option.

• secret_prop

  Configuration property and its secret value separated by a colon ( : ). It is recommended that the secret value not be specified on the command line. If omitted from the command line, the value is prompted for. To specify values for multiple properties, repeat this option.

• note

  Note on the entity. For multiple notes, repeat this option.

• use_latest_revision

  Indicates that the the latest revision of the entity should be updated instead of the revision identified by entity_rev_id.

Examples

This example modifies the entity revision identified by entity_rev_id. The entity revision identifier value can be found from the Software Library home page. The software library home page exposes the identifier for folders and entities as a custom column, which is hidden by default.

A new description is specified. Values for the entity attributes (PRODUCT, PRODUCT_VERSION and VENDOR) are specified. The value for the DEFAULT_HOME configuration property is specified. A note on the entity is also specified.

A new revision is created for the modifications, but the specified entity revision (identified by entity_rev_id) remains unchanged. The identifier of the newly created entity is printed on the standard output.

entity_rev_id="oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_Generic:B1B1880C6A8C62AAE040548C4D14:0.1"
       -entity_desc="myAcmeInstall description"
       -attr="PRODUCT:Acme"
       -attr="PRODUCT_VERSION:3.0"
       -attr="VENDOR:Acme Corp"
       -prop="DEFAULT_HOME:/u01/acme3/"
       -note="myAcmeInstall for test servers"