Installing and managing CentOS connector

Install the connector to collect logs from CentOS-based applications. CentOS connectors are available in 7 and 8 versions.

The following image shows the list of tasks that you perform with the connector:


Before you begin

  • Ensure that the host computer on which you plan to install the connector has a 2-core CPU and 16 GB RAM.
  • Ensure that you have the sudo permissions to install the connector. Alternatively, use the root user.
  • Confirm that the 24444 port is available on the CentOS server from where logs will be collected.


To download and install the connector

  1. Click the Collection menu and select Connectors.
  2. On the Connectors page, click Create.
  3. Enter a unique name and description.
  4. From the Select Connector Type list, select the appropriate connector based on the version.  
  5. In the Download Connector step, click Download.
  6. In the Tags step, add tags (in the form of key-value pair) to identify the connector; for example, name-windows, location-Pune, and so on.
  7. Click + to add the tag.

    Important

    Even if you are adding only one tag, ensure that you click +.

  8. Download the installation script by clicking Download in the Download Install Script step.

    Important

    Ensure that you do not copy the script to any public domains.

  9. Click Save.
  10. Copy the installation script and tar.gz files to the '/opt' directory on the Linux (CentOS) server from where you want to collect logs.
  11. From the /opt folder (command: cd /opt), extract the tar.gz file and run the following command:
    tar -xvf tdc-connector-centos-<build_id>-<version>.tar.gz
    The connector file is extracted in the bmc-devtools folder.
  12. Grant the execute permission to the downloaded shell script, and then run the script.
    For example, run the following commands:
    chmod +x install-connector-my-bmc.sh
    sudo ./install-connector-my-bmc.sh -u <user name>
    The processes for the connector service (td-agent.service) are run with the user name that you provide. If you do not enter a user name, a user with td-agent user name is created and it is used to run the processes for the connector. If you use the root user, you do not need the keyword sudo in the command.
    After installation, the bmc-devtools folder is deleted and the connector is installed in the td-agent folder.
  13. Start the connector service by running the following command:
    sudo systemctl start td-agent.service


To communicate with the connector through a proxy

  1. Open the /etc/systemd/system/td-agent.service file.
  2. Search for the following line: LimitNOFILE=65536.
  3. After this line, add the following entry:
    Environment=HTTP_PROXY=http://<PROXY_HOST_OR_IP>:<PROXY_PORT>
  4. Save the file.


To verify the connector installation

To verify the connector installation, go to the Collection menu, click Connectors, and look for the installed connector on the page. Connectors will be available in one of the following status:

  • Created: The connector is installed successfully, but has not started sending heartbeats.
  • Active: The connector is sending heartbeats.
  • Suspended: The connector has not sent heartbeats for a preconfigured time. You can only delete a connector in this status.


To start and stop a connector

  • To start a connector, run the following command:
    systemctl start td-agent.service
  • To stop a connector, run the following command:
    systemctl stop td-agent.service


To uninstall a connector

  1. Navigate to the /opt/td-agent/scripts directory and copy the uninstall-<os-type>-connector.sh script.
    os-type is the type of the Linux connector, for example, centos7.
  2. Paste the script in the /opt directory.
  3. Run the uninstall-<os-type>-connector.sh script.
    For example, for the CentOS 7 connector, run the following script:
    uninstall-centos7-connector.sh


To delete a connector

  1. Ensure that the connector is not associated with a collection policy.
  2. Stop the connector and wait for 5 minutes.
    When you stop the connector, its status changes to Suspended.
  3. On the Connectors page, for the required connector, click the Actions menu and select Delete.
  4. Confirm the deletion by clicking Yes


Where to go from here

Creating a parsing rule

Was this page helpful? Yes No Submitting... Thank you

Comments