Skip to main content

Site CollectorSite Collector Administration Guide

Set Up Archive Linux Collector

Set up the Archive Linux Collector to collect log events from archived log sources *.7z, *.arj, *.bzip2, *.cab, *.gzip, *.iso, *.lzh, *.rar, *.gz, *.tar, *.tar.gz, *.z, and *.zip. The Archive Linux Collector is a set of Site Collector flows, pre-built processors, groups, custom processors, and other components that pull logs in plain text format and push the logs to Exabeam Security Operations Platform. The collector provides flexible template configuration capabilities to collect Linux events.

Tip

If you configure a Archive Linux Collector instance for a Site Collector instance which was created using a hostname, you may get a 'Request timed out' error while establishing communication with the host VM from a Linux VM. To avoid the 'Request timed out' error and ‘Setup error’, ensure that you complete the following steps on your Linux VM. 

Type ping hostnname_of_site_collector in your Linux command prompt. If this command succeeds, proceed with installing a Linux Collector for this Site Collector instance. If you get a ‘Request timed out’, or ‘Cannot resolve host’ or ‘Unknown host’ error, use the following steps.

  1. Open the hosts file that maintains mapping between hostname and IP_address, located at: /etc/hosts, using Vi.

  2. Add a new entry with your hostname and IP address at the end of the file for example, hostnname_of_site_collector  ip_address

  3. Save the hosts file.

  4. Proceed to install the Archive Linux Collector instance for this Site Collector instance.

To set up the Archive Linux Collector:

  1. Log in to the Exabeam Security Operations Platform with your registered credentials.

  2. Navigate to Collectors > Site Collectors.

  3. Ensure that Site Collector is installed and in running state.

  4. On the Site Collector page, click the Collectors Library tab, then click Archive Linux.

    Archive_Linux_1.png
  5. In the Definition section, enter the required information as follows.

    Archive_Linux_2.png
    • Collector Name – Site Collector generates a name for the Archive Linux collector based on your hostname.

    • Site Collector Instance – Select the site collector instance for which you want to set up the Archive Linux Collector. Only Site Collector instances on Site Collector version 1.17 and above are available.

  6. Click Next.

  7. In the Data section, set up the Linux template while configuring the collector. After you create a template, you can reuse the template for other collector instances or create a new template each time you set up a new Archive Linux Collector.

    Archive_Linux_3.png
    • Archive Linux Template – Select a preconfigured template template to filter logs, or, create a new template. Templates enable you to filter logs by file names.

      Archive_Linux_4.png

      To create a new Archive Linux template:

      1. In the Templates list, click New Linux Template.

      2. In the Template Name field, specify a name for the new Linux template and click Next.

      3. In the Add File Paths section, for filtering logs, enable the log fields that you want to use by entering regex. Supported file extension formats are *.7z, *.arj, *.bzip2, *.cab, *.gzip, *.iso, *.lzh, *.rar, *.gz, *.tar, *.tar.gz, *.z, and *.zip.

        Archive_Linux_5.png
        • Include – Enter regex for the file names or paths to be included in log collection.

        • Exclude – Enter regex for the file names or paths to be rejected while collecting logs. The collector collects all the security events from the specified log name excluding the events or file names listed in this section.

  8. In the Installation section, copy the scripts and download certificates as follows.

    Archive_Linux_6.png
    • Certificate – Click Download Certificates to download the certificates. After you download the certificates, ensure that you save the certificates in the same directory from where you execute the installation command.

    • Install Script – Copy the Install script. Paste the script in the Powershell or cmd command line interface as an administrator where you put downloaded certificates. Then, run the copied command to install the Linux collector.

      Note

      You can use one install script for installing Archive Linux Collector on multiple Linux machines.

    • Uninstall Script – To uninstall the Archive Linux collector, copy and run the script using Powershell or cmd interface as an administrator. You must execute the script on the Linux server.

  9. Verify that the Collector installed. After you run the Install script on your Linux server, you get a confirmation message about successful collector installation and the Collector instance is listed in the Overview section on the user interface.

    The Archive Linux Collector is set up and is ready to pull Linux events from your archived log files, *.7z, *.arj, *.bzip2, *.cab, *.gzip, *.iso, *.lzh, *.rar, *.gz, *.tar, *.tar.gz, *.z, and *.zip.

    After the Linux collector is set up, Site Collector Core starts pulling logs periodically based on your template configuration and uploads logs to Exabeam Security Operations Platform. If the Linux server is not available, Site Collector core resumes pulling logs from the place where it stopped.

    In case of installation failure, the collector is disabled, and the configuration is saved. You can check the status of the collector on the user interface or using the support package.

    Note

    The Archive Linux Collector works on virtual machines that meet the minimum hardware specifications and that have Bash installed. The collector supports the following operating systems.

    • Linux Full Client (LFC) Red Hat Enterprise Linux versions 7, 8, and 9, CentOS versions 7, 8, and 9, and Ubuntu versions 18.04 LTS, 20.04 LTS, 22.04 LTS

    • Linux Application Client (LAC) Red Hat Enterprise Linux versions 7, 8, and 9, CentOS versions 7, 8, and 9, and Ubuntu versions 18.04 LTS, 20.04 LTS, 22.04 LTS