Command Central 10.3 | Command Central Developer Reference | Using the Command Line Interface | Provisioning Assets Commands | sagcc exec provisioning assets install
 
sagcc exec provisioning assets install
Installs assets from an asset repository.
Important:
The assets provisioning commands are a preview feature that is subject to change in the future. This preview has limited functions and is not intended for use in a production environment. If you want to provide feedback for this preview feature, go to the Command Central area in the Software AG TechCommunity.
Syntax
*Command Central syntax:
sagcc exec provisioning assets nodeAlias repoName install
runtimeComponentId=id artifacts=[AssetId1,
AssetId2|ALL][options]
*Not supported on Platform Manager.
Arguments and Options
Argument or Option
Description
nodeAlias
Required. The alias of the target node on which to install assets.
repoName
Required. The name of the asset repository from which to install assets.
runtimeComponentId=id
Required. The ID of the run-time component for which you want to install assets.
artifacts=[AssetId1, AssetId2|ALL]
A comma-separated list of the IDs of the assets you want to install.
When you set artifacts=ALL or omit the artifacts argument altogether, the command installs all assets that belong to the run-time component you specify in the runtimeComponent argument.
[options]
Optional. The command allows all options supported by the Command Line Interface. For a description of the options, see Common Options.
Usage Notes
*Command Central supports installing only composite assets.
*You can install assets for some run-time components in installations with release versions lower than 10.1. To check which products in an installation support installing assets, run:
sagcc list provisioning assets nodeAlias supportedcomponents
and replace nodeAlias with the alias name of the installation. For details about the command, see sagcc list provisioning assets supportedcomponents.
*Command Central identifies each runtime, for which to install assets, by host, port, and runtime type. The host is resolved from the values of the nodeAlias and runtimeComponentId arguments. The type of the runtime is obtained by mapping the runtimeComponentID to a run-time type as described in sagcc list provisioning assets supportedcomponents.
*Command Central identifies the endpoint port for a runtime using the following criteria, ordered in descending priority:
1. Is "primary" property set to true
2. Is "protocol" property set to HTTP
3. Is "protocol" property set to HTTPS
4. Port number: the lower port number is selected first
For example, if a run-time component has the following set of ports: (isPrimary, http, 5555) and (!isPrimary, http, 8072), Command Central selects port 5555, because "isPrimary" is the criteria with the highest priority.
*When installing assets, you can check the progress of the install operation and troubleshoot issues using the CLI jobsmanager jobs commands or in the Command Central web user interface, go to Stacks > Jobs.
Examples
To install all composite assets for the run-time component with ID "MwsProgramFiles-default", which are available in the asset repository with name "repo1", on the target installation with alias name "sag01":
sagcc exec provisioning assets sag01 repo1 install
runtimeComponentId=MwsProgramFiles-default