Cloud Application Integration (On-Premises) : Administering Integration Server : Running Multiple Integration Server Instances : Creating a New Integration Server Instance
Creating a New Integration Server Instance
Use the create command to create a new Integration Server instance.
Before creating a new instance, review the information in Guidelines for Running Multiple Integration Server Instances on the Same Machine and About Creating a New Integration Server Instance.
To create a new Integration Server instance
1. Navigate to the following directory:
Integration Server_directory \instances
2. Run the instance script as follows:
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.
3. Optionally, add packages to the server instance. For instructions, see Installing and Updating Packages on a Server Instance.
4. Start the Integration Server instance by running the startup.bat/sh file located in the Software AG_directory \profiles\IS_instance_name\bin directory.
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.
Copyright © 2015- 2016 Software AG, Darmstadt, Germany.

Product LogoContact Support   |   Community   |   Feedback