Managing Instances Using the Command Central Instance Management Commands
The following table lists the required parameters that you must include when managing Integration Server instances using the Command Central instance management commands:
Command | Parameter | Description |
sagcc create instances | instance.name=name | Required. A name for the new Integration Server instance. |
primary.port=port | Required. The main listening port for the new Integration Server instance. |
diagnostic.port=port | Required. The diagnostic port for the new Integration Server instance. |
jmx.port=port | Optional. The JMX port for the new Integration Server instance. |
| install.service=false|true | Optional. Specifies whether to install Integration Server as an application or a service. Valid values:  true - install as a service false - install as an application (default) |
| license.file=location_of_license_file | Optional. The location of your Integration Server license file. The script copies the license file from the specified location to IntegrationServer/instances/
instance_name/config/
licenseKey.xml This parameter is optional; however, if a license file location is not specified, the Integration Server instance will shut down after 30 minutes. Note:
If the location name contains spaces, you must surround the name of the location with quotation marks (“ “). |
| db.alias=
database_ alias_name
| Optional. The alias name for the database. The default value is JDBC_POOL_ALIAS. |
|
db.type=database_type
| Required. The type of database used by the new server instance. Specify one of the following databases: sqlserver - Microsoft SQL Server oracle - Oracle db2 - DB2 These values are not case-sensitive. The default is the embedded IS internal database. |
|
db.username=database_ username
| Required. The user name assigned to the Integration Server database. |
|
db.password=database_ password
| Required. The password of the Integration Server database. |
| db.url=database_URL | Required. The connection URL for the database. |
Example When Executing on Command Central
To create the new instance for an installed
Integration Server with instance name “is-instance2”, diagnostic port “8083”, and primary port “8081” in the installation with alias name “productionNode2”:
sagcc create instances productionNode2 integrationServer
instance.name=is-instance2 diagnostic.port=8083
primary.port=8081
db.alias=sql_server db.type=sqlserver
db.username=sa db.password=password@1234
db.url="jdbc:wm:sqlserver://10.60.72.87:1433;databaseName=SQL_DB"
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
db.alias=sql_server db.type=sqlserver
db.username=sa db.password=password@1234
db.url="jdbc:wm:sqlserver://10.60.72.87:1433;databaseName=SQL_DB"
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
For more information about Software AG Command Central, see Command Central documentation.