stage_swlib_entity_files

Stages one or more files associated with an entity revision available in the Software Library to a file system location on a host target.

Format

emcli stage_swlib_entity_files
      -entity_rev_id="entity_rev_id"
      -host="hostname"
      -file="<file name as specified during upload>"]
       [-credential_set_name="setname"] | [-credential_name="name" -credential_      owner="owner"]
      [-stage_path="<path on host to stage file(s)>"]
      [-use_latest_revision]
      [-overwrite_files]

[ ] indicates that the parameter is optional.

Parameters

  • entity_rev_id

    Identifier of the entity revision. You can view the entity ID by logging in to the Enterprise Manager console. The Software Library Home page exposes the identifier for folders and entities as a custom column called Internal ID. By default, this column is hidden.

  • host

    Target name of the host where the files are staged.

  • file

    Name of the file associated with the entity revision.

  • credential_set_name

    The name given to a set of preferred credential stored in the Management Repository for the host target.

    HostCredsNormal - default unprivileged credential set

    HostCredsPriv - privileged credential set

  • credential_name

    Named credential stored in the Management Repository. This option

    must be specified along with the -credential_owner option.

  • credential_owner

    Owner of a named credential stored in the Management Repository. This option must be specified along with the -credential_name option.

  • stage_path

    Location on the host where the files are copied.

  • use_latest_revision

    This is an option to indicate whether staging should be carried out for the latest revision of the entity or the revision identified by entity_rev_id.

  • overwrite_files

    This is an option to indicate whether the file should be overwritten in the stage location or not. By default, the files will not be overwritten. Ensure that the file is overwritten in the stage location.

Example

The following example copies the file 'myfile.zip' associated with the specified entity revision to '/u01/stage_loc' on host 'fs1.example.com' using the named credential "MyAcmeCreds" owned by "ACME_USER". 

emcli stage_swlib_entity_files
     -entity_rev_id="oracle:defaultService:em:provisioning:1:cmp:COMP_ Component:SUB_Generic:B1B1880C6A8C62AAE040548C42832D14:0.1"Generic:B1B1880C6A8C62AAE040548C42832D14:0.1"  Generic:B1B1880C6A8C62AAE040548C42832D14:0.1"
    -file="myfile.zip"
    -stage_path="/u01/stage_loc"
    -host="fs1.example.com"
    -credential_name="MyAcmeCreds" 
    -credential_owner="ACME_USER"