Creating a New Integration Server Instance

is_instance.bat/sh create
-Dinstance.name=instance_name
-Dprimary.port=primary_port_number
-Ddiagnostic.port=diagnostic_port_number
-Djmx.port=jmx_port_number
-Dlicense.file=license_file_location
-Dinstall.service=install_service
-Ddb.alias=database_alias_name
-Ddb.type=database_type
-Ddb.username=database_username
-Ddb.password=database_password
-Ddb.url=database_URL

Where...

Specify...

instance_name

A unique name for the new instance.

primary_port_number

Optional. A default HTTP port number for the new instance. The port number must be unique for each Integration Server instance. The default value is 5555.

diagnostic_port_number

Optional. A default diagnostic port number for the new instance. The port number must be unique for each Integration Server instance. The default value is 9999.

jmx_port_number

Optional. A default JMX port number for the new instance. The port number must be unique for each Integration Server instance. The default value is 8075.

license_file_location

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 file.

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 (” ”). For example:

-Dlicense.file=”license file location”

install_service

Optional. Whether to register the service for the instance. The default is false.

Note:

This option is valid only for Windows platforms.

db.alias

Optional. The alias name for the database. The default value is JDBC_POOL_ALIAS.

db.type

The type of database used by the new server instance. Specify one of the following databases:

sql - Microsoft SQL Server

oracle - Oracle

db2 - DB2

These values are not case-sensitive. The default is the embedded IS internal database.

db.username

The user name assigned to the Integration Server database.

db.password

The password of the Integration Server database user.

db.url

The connection URL for the database.

Note:

The startup.bat/sh and shutdown.bat/sh scripts contained in the Integration Server_directory \instances\instance_name\bin directory are deprecated. Software AG recommends the use of the scripts contained in the Software AG_directory \profiles\IS_instance_name\bin directory. If you will manage Integration Server through Command Central, you must use the scripts located in the Software AG_directory \profiles\IS_instance_name\bin directory.