Command Central 10.15 | Using the Command Line Interface | Provisioning Products Commands | sagcc exec provisioning products install
 
sagcc exec provisioning products install
Installs products from a product repository. The Platform Manager on which you install the products must have access to a product repository.
Before installing products using this command, see Before Installing Products.
Syntax
*Command Central syntax:
sagcc exec provisioning products node_alias repo_name install   
[artifacts=productId1[_version],productId2[_version]]
[administratorCredentials=credentialsAlias] [administratorCredentialsChangeOnFirstLogin={true|false}][options]
*Not supported on Platform Manager.
Arguments and Options
Argument or Option
Description
node_alias
Required. The alias of the target node on which to install products.
repo_name
Required. The name of the product repository from which to install products.
[artifacts=productId1[_version],productId2[_version]]
The names of the products to install.
*Required for a master repository. You must specify at least one product with version.
*Optional for image repositories. If you do not specify any artifacts, Command Central installs all products in the image archive.
When you specify more than one product, specifying the version is optional.
Note:
To find the product IDs, use the sagcc list repository products content command.
[administratorCredentials=credentialsAlias]
Optional. Use only when installing products of version 10.11 or higher. The credentials alias to use for the product administrator user. If you omit this argument, the command uses the ADMINISTRATOR credentials alias. See the usage notes for more details about this argument.
[administratorCredentialsChangeOnFirstLogin={true|false}]
Optional. Use only when installing products in installations of version 10.11 or higher. Indicates whether the product requires changing the password of the product administrator user on the initial login. Valid values:
*true - password change required.
*false (default) - no password change required.
[options]
Optional. The command allows all options supported by the Command Line Interface. For a description of the options, see Common Options.
Usage Note
*You cannot install all products available in a master repository. You must specify at least one product with version in the artifacts argument.
*When installing products on nodes version 9.12 or lower from a mirror repository, if you change the credentials of the Platform Manager on which the mirror repository is stored, you must also update the mirror repository credentials. Use the sagcc update repository products command to update the mirror repository credentials.
*When listing a product in the artifacts argument, you must enclose the product Id in single quotes ('') if the ID includes underscore (_), followed by a number. The single quotes ensure that Command Central does not interpret the (_) character in the product Id as the version delimiter in [artifacts=productId[_version]. For example, to list the product with ID "WmPSFT_E1_898" and version 8.98.6282010.0.0, enter artifacts='WmPSFT_E1_898' (without the optional version) or artifacts='WmPSFT_E1_898'_8.98.6282010.0.0 (with the version).
*When installing products with version 10.11 and higher, by default the command uses the ADMINISTRATOR credentials alias. Note that the ADMINISTRATOR credentials alias does not have a default password value and you must specify a strong administrator password by navigating to Environments > ALL > Instances > CCE > Command Central Server > Configuration > Credentials in the Command Central web user interface and editing the ADMINISTRATOR credentials. Optionally, you can use [administratorCredentials=credentialsAlias] to specify a custom credentials alias that you defined for the product administrator user. For information about adding credentials aliases, see Create Credentials Aliases.
Important:
If you specify a custom credentials alias, Command Central will set the provided password for the default administrator user of the product and ignore the username value of the credentials alias. For example, if you specify a credentials alias that has a username value "my-user" and a password value "my-admin-password" and the default administrator user for the product you are installing is "sysadmin", then Command Central will set the password "my-admin-password" to the "sysadmin" user when installing the product.
*When installing products with version 10.7 and lower, the command does not provide credentials for the product administrator user. Command Central installs each product with the default administrator user and password for the product.
Examples When Executing on Command Central
*To install all products with version 10.11 from a mirror repository with name “MyProducts-1011” on a target node with alias “sag01” using the ADMINISTRATOR credentials alias:
sagcc exec provisioning products sag01 MyProducts-1011 install
*To install the products with product IDs “integrationServer” and “MwsProgramFiles” and their dependencies from a master repository with name “webMethods-EUR” on a remote node with alias “sag01”:
sagcc exec provisioning products sag01 webMethods-EUR install
artifacts=integrationServer_10.7,MwsProgramFiles