sagcc exec provisioning assets install

Software AG Command Central 10.2 | Command Central Developer Reference | Using the Command Line Interface | Provisioning Assets Commands | 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