Scale-out the Enterprise Connector to another host

For availability (fail-over) reasons you can add another host to the Enterprise Connector deployment. In case one of the Enterprise Connector hosts fails, the Enterprise Connector continues to function by running at the remaining host. Ensure the hosts you use can communicate with each other and have TCP/IP access. Enable access to these ports:

  • hostrouter.https.port
  • bootstrap.port
  • hostrouter.port

To scale-out the Enterprise Connector to another host:

  1. Another host must be available that complies with the prerequisites for an Enterprise Connector server.

    Use the same OS type for each Enterprise Connector host, either Linux or Windows.

    Install the same JDK version in the same folder as on the original host.

    If you use a different version, adjust the jdk.path in the properties file.

    For Linux deployments, create the user and group with the same name as on the original host. Otherwise adjust service.group and service.username in the properties file.

  2. Copy these files to the new host:
    • installer-version.jar
    • grid.install.properties

    The files are located in these folders:

    • Windows: c:\ProgramData\Infor\ION Enterprise Connector\<InstallFolder>\Grid Installer
    • Linux: /var/log/infor/ion enterprise connector/<InstallFolder>/GridInstaller
  3. Specify this information in the grid.install.properties file:
    grid.hostname
    The hostname of the new host.
    grid.hostaddress
    The fully qualified domain name of the new host.

    You must select a fully qualified domain name that has a static IP address assigned.

    database.password
    The password of the database user defined in database.username.

    Example properties file for Windows:

    #Thu Oct 27 17:19:09 CEST 2016
						grid.hostname=IONCEHOST
						jdk.path=C\:\\Program Files\\Java\\jdk1.8.0_91
						grid.hostaddress=IONCEHOST.acme.com
						install.path=C\:\\Program Files\\Infor\\IONEC
						database.instanceName=
						database.name=InforIONECGrid
						database.password=******
						database.type=sqlserver
						database.username=ecruntime
						service.userType=virtual
						grid.properties.0=grid.internal.featureFlags\=appendBcByDefault\=false
						
						database.port=1433
						hostrouter.https.port=28090
						bootstrap.port=28089
						database.host=DATABASEHOST
						database.schema=
						hostrouter.port=28091
						sqlserver.datasource.multiSubnetFailover=false
  4. Go to the new host and run the grid installer with this command:
    java -jar installer-version.jar grid.install.properties

    Use the Grid installer that you copied in step 2. Do not use the Enterprise Connector installer.