Skip to content

Installation of TeskaLabs LogMan.io Collector

This short tutorial explains how to connect a new log collector running as a virtual machine.

Tip

If you are using a hardware TeskaLabs LogMan.io Collector, connect the monitor via HDMI and go straight to step 5.

  1. Download the virtual machine disk image.

    VMDK ~800 MB

  2. Import the downloaded disk image to your virtualization platform.

  3. Create a new virtual machine

    • Name: LogMan.io Collector VM (or name it according your naming conventions)
    • Type: Linux 64bit
    • CPU: 2 cores (or more)
    • RAM: 2GB
    • OS HDD: Use lmio-collector.vmdk that you downloaded in the previous step
    • Data HDD: Create a second disk, 50GB mininum, this provisioning is possible

  4. Configure network settings of a new virtual machine

    Requirements:

    • The virtual machine must be able to reach the TeskaLabs LogMan.io installation.
    • The virtual machine must be reachable from devices that will ship logs into TeskaLabs LogMan.io.

  5. Launch the virtual machine.

    Start virtual machine

  6. Configure the OS layer of the collector

    • Press Alt-F2 to get to the OS console
    • Login as root
    • Type passwd and set the root password
    • Type passwd tladmin and set the administrator password
    • Optionally enable SSH server:
      • service sshd start
      • rc-update add sshd
    • Set a correct LogMan.io URL:
      • vi /conf/lmio-collector.yaml
      • Edit url: https://app.logman.io/lmio-receiver line
      • Save by :wq
    • reboot to apply

  7. Determine the identity of TeskaLabs LogMan.io Collector.

    The identity consists of 16 letters and digits. Please save this for the following steps.

    Identity of the new log collector

  8. Open the LogMan.io web application in your browser.

    Follow this link or navigate to "Collectors" and click on the "Provisioning" button.

  9. Enter the collector identity from step 4 in the box.

    Then, click Provision to connect the collector and start collecting logs.

    Connecting a new collector

  10. TeskaLabs LogMan.io Collector is successfully connected and collects logs.

    New collector

    Tip

    The green circle on the left indicates that the log collector is online. The blue line indicates how many logs the collector has received in the last 24 hours.

Administration inside the VM

Administrative actions in the Virtual Machine of TeskaLabs LogMan.io Collector are available in the menu. Press "M" to access it. Use arrow keys and Enter to navigate and select actions.

Available options are:

  • Power down
  • Reboot
  • Network configuration

Collector's Virtual Machine Administration

Tip

We recommend to use Power down feature to safely turn off the collector's virtual machine.

Recommended virtualization drivers
  • SCSI Controller should is VirtIO
  • Network device is VirtIO

Additional notes

You can connect unlimited amount of log collectors, e.g. to collect from different sources or to collect different types of logs.

Supported virtualization technologies

The TeskaLabs LogMan.io Collector supports the following virtualization technologies: