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
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 jobmanager 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