启动集成服务器

您可以使用 IBM® App Connect Enterprise 工具包、Web用户界面、命令行 IntegrationServer 或管理REST API来启动集成服务器及其上部署的所有资源。

关于此任务

如果将资源部署到您的集成服务器中,那么下一次启动集成服务器时会保留资源的已启动或已停止状态。

您还可以使用 IBM App Connect Enterprise 工具包创建并启动一个本地独立集成服务器,具体方法请参阅 “使用工具包创建、启动和停止本地独立集成服务器 ”。

使用 IBM App Connect Enterprise 工具包启动由集成节点管理的集成服务器

过程

若要使用 IBM App Connect Enterprise 工具包在集成节点下启动集成服务器,请执行以下步骤。

  1. 打开 IBM App Connect Enterprise 工具包 ,并切换到 “集成开发”视图
  2. 集成资源管理器 视图中,展开集成节点,右键单击集成服务器,然后单击 启动

结果

这将启动所选的集成服务器。 集成资源管理器 视图 已更新,以指示服务器和资源正在运行; 例如:
Integration Explorer 视图,显示已启动的集成服务器及其资源

使用 Web 用户界面启动由集成节点管理的集成服务器

过程

要使用 Web 用户界面来启动集成节点下的集成服务器,请完成以下步骤。

  1. 启动集成节点的 Web 用户界面,如 访问 Web 用户界面中所述。
  2. 查找要启动的集成服务器,选择该集成服务器,然后单击 启动

结果

将启动所选的集成服务器,以及部署到该服务器的资源。 将更新 Web 用户界面以指示服务器和资源正在运行; 例如: Web 用户界面显示服务器和资源正在运行。

使用 IntegrationServer 命令启动独立集成服务器

您可以使用 IntegrationServer 命令来启动独立集成服务器 (不受集成节点管理的集成服务器)。

准备工作

过程

要启动独立的集成服务器,请完成下列步骤:

  1. 运行 IntegrationServer 命令,指定集成服务器工作目录的路径。
    例如:
    IntegrationServer --work-dir c:\mywrk\myaceworkdir 
    c:\mywrk\myaceworkdir 是配置集成服务器时创建的集成工作目录。
    有关创建工作目录的更多信息,请参阅 通过修改 server.conf.yaml 文件来配置集成服务器mqsicreateworkdir 命令
    如果集成服务器包含任何独立资源 (不在应用程序或库中的资源) ,那么首次对此集成服务器运行 IntegrationServer 命令时必须指定 --default-application-name 参数。 此参数可创建新的缺省应用程序,所有与集成服务器关联的独立资源都会移入其中。 例如:
    IntegrationServer --work-dir c:\mywrk\myaceworkdir --default-application-name myDefaultApp 
    有关更多信息,请参阅 IntegrationServer 命令

    如果在工作目录中创建保险库,那么在启动集成服务器时必须提供正确的保险库密钥。 要提供保险库密钥,可以在 IntegrationServer 命令上指定 --vault-key--ext-vault-key--vaultrc-location 参数,也可以设置 MQSI_VAULT_KEY 或 MQSI_VAULTRC_LOCATION 环境变量。 如果未指定任何这些环境变量,那么将在 HOME 目录中查找 .mqsivaultrc 文件。 如果使用 .mqsivaultrc 文件,必须将其配置为包含正确的保险库密钥。 有关使用保险库文件的更多信息,请参阅 配置加密安全凭证

    如果在集成服务器上为流创建集成测试,那么可以使用 IntegrationServer 命令上的 --test-project 参数来运行这些测试,以指定包含这些测试的集成测试项目的名称。 例如:
    IntegrationServer –work-dir c:\tmp\work-dir --test-project MyIntegrationTestProject 
    其中, --work-dir 参数指定运行测试的集成服务器的工作目录, --test-project 指定要运行的测试项目的名称。 当集成服务器启动时,所指定测试项目中的测试将自动运行。 有关更多信息,请参阅 使用命令行来运行测试

    运行 IntegrationServer 命令时,集成服务器将使用其 server.conf.yaml 文件中定义的配置以及由命令设置的任何覆盖来启动。 运行用于修改集成服务器的命令时,将在集成服务器的工作目录下创建 overrides 目录,如 通过修改 server.conf.yaml 文件来配置集成服务器中所述。

  2. 现在,您可以通过 IBM App Connect Enterprise 工具包或Web用户界面与正在运行的集成服务器进行交互。
    您还可以研究 IBM App Connect Enterprise 提供的管理 REST API。 例如,您可能希望通过向端口 7600 发送 REST GET 请求并检查响应来验证集成服务器是否正在运行:
    curl -X GET http://localhost:7600/apiv2
    如果您想使用 curl 工具,除了安装 IBM App Connect Enterprise 之外,可能还需要下载并安装该工具。

    缺省情况下, REST 管理端口 (这是与集成服务器进行通信的主要方法) 设置为 7600 (通过 server.conf.yaml 配置文件中的 adminRestApiPort 属性)。

  3. 可选: 使用 IBM App Connect Enterprise 工具包连接到集成服务器:
    1. 在 " 集成资源管理器 " 视图中,右键单击 集成服务器,然后单击 连接到集成服务器。 在连接详细信息对话框中,输入集成服务器的主机名和端口。 确保端口与 IntegrationServer 命令上指定的 admin-rest-api 属性值或 server.conf.yaml 文件中指定的 RestAdminListener / port 属性值匹配 (在此示例中,端口为 7600,主机名为 localhost)。 如果集成服务器是安全的,还必须指定用户名和密码。
    2. 单击完成
      现在集成服务器的连接显示在工具箱中的集成资源管理器视图中。
    3. 现在可以通过将其从“应用程序开发”视图拖放到“集成资源管理器”视图中的集成服务器来部署 BAR 文件(或应用程序或 REST API)。 有关部署的更多信息,请参阅 在开发期间部署集成解决方案将集成解决方案部署到生产环境
    4. 您可以通过在 "集成资源管理器" 视图中选择集成服务器,然后单击 属性 选项卡来查看该集成服务器的属性。 这将显示在 server.conf.yaml 配置文件中为集成服务器指定的属性,如 通过修改 server.conf.yaml 文件来配置集成服务器中所述。

使用 mqsistartmsgflow 命令启动受管集成服务器

过程

通过完成以下步骤,可以使用 mqsistartmsgflow 命令来启动由集成节点管理的集成服务器:

  1. 针对当前安装打开命令行。
  2. 输入 mqsistartmsgflow 命令,指定要启动的集成服务器的参数。
    • 如果集成节点是本地集成节点,请指定集成节点名称。 例如:
      mqsistartmsgflow INODE -e default
    • 如果集成节点是远程集成节点,那么您可以指定配置文件。 例如:
      mqsistartmsgflow -n INODE.broker -e default
    • 另外,对于远程集成节点,还可以指定连接参数 -i-p。 例如:
      mqsistartmsgflow -i 9.20.193.11 -p 4414 -e default
    • 如果要启动集成节点上的所有集成服务器,请指定 --all-integration-servers 标志而不是 -e。例如:
      mqsistartmsgflow INODE --all-integration-servers
    有关这些选项的更多详细信息,请参阅 mqsistartmsgflow 命令描述。

后续操作

启动或停止已部署在集成服务器上的资源。 有关更多信息,请参阅 启动或停止已部署的资源