sagcc create instances

Edit online

Creates a new instance of an installed product.

Syntax

  • Command Central syntax: 
    sagcc create instances  node_alias product          
[key=value] | [-i file{.xml|.json|.properties}]  [options]
  • Platform Manager syntax: 
    sagcc create instances  product               
[key=value] | [-i file{.xml|.json|.properties}]  [options]

Arguments and Options

Argument or Option Description
node_alias Command Central only.

Required. Specifies the alias name of the installation in which to create the product instance.

You can view a list of installations and their aliases using sagcc list landscape nodes.

product Required. Specifies the product ID of the installed product or run-time component for which you want to create a new instance.

Valid values for this option are only the product IDs included in the list of products returned from the sagcc list instances node_alias supportedproducts command.

[key=value] Optional. A list of properties that describe the elements of the new instance, such as name and port settings. The properties included in this list are product specific.

                              [-i
                               [file{.xml|.json|.properties}]
                          
Optional. Identifies an input file that contains the product instance data. For more information, see input.

For the correct format of an XML properties file, see the Properties class in the Oracle Java Platform Standard Edition API specification.

[options] Optional. The command allows all options supported by the Command Line Interface. For a description of the options, see Common Options.

Usage Notes

  • The command returns job information that you can monitor using the sagcc list job manager commands.
  • When creating instances of Integration Server and IBM My webMethods Server, you can use the fixRepository=repoID argument to ensure that all required fixes are applied on all product instances. For details about the argument, see the topic on creating product instances with the Command Central CLI in the administration guide of the product.

Example When Executing on Command Central

  • To create the new instance for an installed Integration Server with instance name “is-instance2”, diagnostic port “8083”, JMX port “10058”, and primary port “8081” in the installation with alias name “productionNode2”: 

    sagcc create instances productionNode2 integrationServer          
instance.name=is-instance2 diagnostic.port=8083          
jmx.port=10058 primary.port=8081

Examples When Executing on Platform Manager

  • To create the new instance for an installed Integration Server with instance name “is-instance2”, diagnostic port “8083”, JMX port “10058”, and primary port “8081”: 
    sagcc create instances integrationServer instance.name=is-instance2          
diagnostic.port=8083 jmx.port=10058 primary.port=8081
  • To create the new instance for an installed Integration Server using the instance data in the instance-settings.properties file, located it in the current directory: 
    sagcc create instances integrationServer -i instance-settings.properties
  • To create the new instance for an installed Integration Server using the instance data in the instance.settings.xml file, located in the current directory: 
    sagcc create instances integrationServer -i instance-settings.xml