Important This documentation supports the releases of BMC Helix Intelligent Integrations and BMC Helix Developer Tools 22.2.00 and their patches. To view the documentation for earlier releases, see BMC Helix AIOps.

Downloading and installing Windows connectors

Install the Windows connector to collect data from the Windows-based applications.

Before you begin

  • Ensure that you are downloading and installing the connector on a Windows server, version 2012 or later.
  • Ensure that you have the privileges to execute a batch file and install an application as a service.
  • Ensure that the 24444 port is available on the Windows server from where logs will be collected.

To download and install a Windows connector

  1. On the Integrations page, click the Available Integrations tab.
  2. Click the Download and Install Connector link.
  3. On the Connector Download and Install page, perform the following steps:
    1. From the Select the Connector Type list, select Windows Connector to collect logs from Windows-based applications.

    2. Click the Download link.
      The connector is downloaded in a .zip file with the name tdc-connector-windows-<build_number>.zip.

      Important

      Install only one connector for a Windows server to avoid port conflicts.

    3. To download the .bat file, in the Create Connector field, enter the name of the connector and click Create and Download.
      The format of the .bat file name is install-connector-<connector name>.bat. For example, you entered the connector name as my-bmc, the .bat filename is install-connector-my-bmc.bat.

    4. On the Windows server from where logs will be collected, create a new folder and copy the downloaded .zip and .bat files.

      Important

      Ensure that there are no spaces in the folder name.

  4. Extract the .zip file by using the Extract here option.

    Note

    You get the BMC-DevTools folder after extracting the .zip file. The BMC-DevTools folder and the .bat file must be at the same level in the folder hierarchy. For example, if you extract the downloaded connector file in the C:\Connector folder, ensure that the downloaded .bat file is also present inside the Connector folder.

    Windows_connector_location.png

  5. Open the command prompt with administrative privileges.
  6. Go to the folder where you have extracted the .zip file and copied the .bat file.
  7. Execute the .bat file.
    The connector is installed and starts as a Windows service. Access the connector logs at the following location: <Folder where the zip file is extracted>\BMC-DevTools\opt\td-agent\td-agent.log.


To verify connector installation

  1. Go to the Task Manager.
  2. Click the Services tab.
  3. Search for the connector name that you entered.
    The service is created and started with the name that you enter in the Create Connector field.


To stop a connector service

  • To stop a connector service from the service console:
    1. Go to the Task Manager.
    2. Click the Services tab.
    3. Search and select the connector name that you entered.
    4. Click Stop.
  • To stop a connector service from the command prompt:
    1. Open command prompt. 
    2. Run the following command:
      sc stop <service_name>


To start a connector service

  • To start a connector service from the service console:
    1. Go to the Task Manager.
    2. Click the Services tab.
    3. Search and select the connector name that you entered.
    4. Click Start.
  • To start a connector service from the command prompt:
    1. Open command prompt. 
    2. Run the following command:
      sc start <service_name>


To uninstall a connector service

  1. Delete the integration that you have created by using the connector.
  2. Stop the connector service.
  3. Delete the connector service by running the following command:
    sc delete <service_name>
  4. To verify that  the connector service is deleted:
    sc query <service_name>
  5. Delete the folder where you unzipped the downloaded connector file.