ibmint create server command

Use the ibmint create server command to create a node-managed integration server.

Usage notes

Your installed version of IBM® App Connect Enterprise must be 12.0.1.0 or later to be able to run the ibmint create server command.
You cannot use the ibmint create server command to create an independent integration server. For more information about creating an independent integration server, see Creating an integration server.

Supported platforms

Windows
Linux®
Linux on POWER®
Linux on Z
AIX®
IBM z/OS® Container Extensions (zCX)

Syntax

Parameters

serverName: The name of the integration server.

You must specify at least one parameter to identify the target integration node in one of the following forms (a), (b), or (c):

(a)

--integration-node nodeName

The name of a locally defined integration node. You cannot use --integration-node and --integration-node-file in the same command.

(b)

--integration-node-file filePath

This parameter identifies the name of a .broker file that contains the connection details for a remote integration node. Include the location (path) and file name when you specify this parameter. You must ensure that the location is accessible when you run this command.

Use this option if multiple users want to connect to the same integration node or integration server, or if you are using advanced connection parameters such as SSL. For more information, see Connecting to an integration node by creating a .broker file.

If you want to run a command that uses SSL to administer a remote integration node or integration server over a secured channel, you must specify the keystore and truststore password for the connection that is using the IBM_JAVA_OPTIONS environment variable. For more information, see Resolving problems when running commands.

You cannot use --integration-node and --integration-node-file in the same command.

(c)

--integration-node nodeName --admin-host host --admin-port port

These parameters identify the nodeName, host, and port of a remote integration node, for connections that do not require advanced connection parameters.

--integration-node nodeName: This parameter is optional for validation. You cannot use --integration-node and --integration-node-file in the same command.
--admin-host: The hostname or IP address of the computer on which the integration node is running.
If you want to connect to a secured integration node as a specific user, provide the security credentials as a URI in the following format: tcp://user:password@hostname. If your password contains URI Reserved characters, you must convert these characters to the percent-encoded format. For more information, see A correct URL and password returns error BIP1939 when you attempt to connect to a remote host name in Resolving problems when running commands.
--admin-port port: The port on which the web user interface HTTP connection listener is listening.

--timeout-seconds seconds

The maximum number of seconds to wait for the integration server to be started (default is 60).

--trace filePath

(Optional) Use this parameter to send verbose internal trace to the specified file.

--help

(Optional) Use this parameter to display help information about the command.

Examples

Create a node-managed integration server on the local machine:

ibmint create server myServer --integration-node INODE

Create an integration server myRemoteServer1 on a remote machine by using a .broker file that contains the connection details for a remote integration node. Specify a timeout of 120 seconds, and send verbose internal trace to the specified file:

ibmint create server myRemoteServer1 --integration-node-file C:\files\myConnectionFile.broker --timeout-seconds 120 --trace C:\files\myTraceFile.txt

Create the integration server myRemoteServer2 that is managed by the integration node myRemoteNode2 on port 1234 on a remote machine with the IP address 9.20.5.10:

ibmint create server myRemoteServer2 --integration-node myRemoteNode2 --admin-host 9.20.5.10 --admin-port 1234