sagcc exec provisioning assets install
Installs assets with their dependencies from an asset repository into a target node.
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
runtimeComponentId install [assets=AssetId1,AssetId2,...]
[ignoreDependency={true|false}] [varSubFile=path/to/varSubFile] [options]
![*](chapterTOC_bullet.png)
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. |
[assets=AssetId1,AssetId2,...] | Optional. A comma-separated list of the IDs of the assets you want to install. When you omit this argument the command installs all assets that belong to the run-time component you specify in the runtimeComponent argument. |
[ignoreDependency={true|false}] | Optional. Specifies whether to install asset dependencies. Valid values: true - do not install dependencies false (default) - install dependencies If you omit this argument, by default Command Central installs the asset dependencies. |
[varSubFile=path/to/varSubFile] | Optional. Specifies the location of a plain text file that you can use to specify environment configuration properties specific to the target node, on which you install the assets. For details about the file contents and syntax, see the Usage Notes. |
[options] | Optional. The command allows all options supported by the Command Line Interface. For a description of the options, see
Common Options. |
Usage Notes
![*](chapterTOC_bullet.png)
Command Central supports installing only composite assets created with the Asset Build Environment and stored in an asset repository registered in Command Central.
![*](chapterTOC_bullet.png)
When installing assets, you can check the progress of the install operation and troubleshoot issues using the CLI jobsmanager jobs commands or the Jobs view of the Command Central web user interface.
![*](chapterTOC_bullet.png)
You can create a plain text file, in which to specify environment configuration properties specific to the target node, on which you install the assets. The file includes data about the composite asset and properties of the composite asset (such as ports or database pool settings), for which you want to substitute values for different target nodes. In the file, include one or more lines in the following format:
namespace/compositeAssetName/[assetName]
propertyName propertyValue
Where:
namespace is the namespace of the asset as defined in the ACDL.
compositeAssetName is the name of the composite asset as defined in the ACDL. You can replace the name with the (*) wildcard character.
[assetName] - Optional. The name of an asset included in the specified composite asset. You can replace the name with the (*) wildcard character. Include <asssetName> when you want to update the property value only for the specified asset of the composite asset. If you do not include
assetName the command updates the property value for all assets included in the specified composite asset.
propertyName is the name of the property to update for the target node.
propertyValue is the property value to use for the target node.
For example, to set the value of property1 to newValue1 for the composite assets (and the assets they contain) in the "IS" namespace:
IS/*/* property1 newValue1
When you use the (*) wildcard character, the value you set for a property will be applied only if the composite assets (or the assets they contain) in the specified namespace have the specified property.
Each propertyName in a namespace/compositeAssetName must have a unique value. For example, you cannot specify the following lines in a variable substitution file:
IS/*/* property1 newValue
IS/*/* property1 newValue1
Because the same property (property1) in the same namespace/composite/asset (IS/*/* ) has been assigned two different values.
Command Central validates if each property for a namespace/composite/asset has a unique value when applying the properties specified in the variable substitution file on the target node.
Example
The asset repository with name "repo1" contains only assets for the run-time component with ID "MwsProgramFiles-default". To install the composite assets from "repo1" for the "MwsProgramFiles-default" run-time component, on the target installation with alias name "sag01":
sagcc exec provisioning assets sag01 repo1 install
runtimeComponentId=MwsProgramFiles-default