Installing the Syslog Forwarding Tool

TMWS supports the following environments for the syslog forwarding tool: VMware ESXi 6.5 and 6.7.

Before you begin installing the tool, make sure your device meets the minimum system requirements:

  • CPU: 2 cores, 2 threads

  • RAM: 4 GB

  • Disk size: 50 GB (for installation)

The steps outlined below detail how to install the syslog forwarding tool on a Virtual Machine (VM) of an ESXi server with version 6.7.

  1. Download the installation ISO file from the TMWS management console, and then upload it to the ESXi server that you use to create a VM for the installation.
  2. Perform the following to create a VM.
    1. Log on to the vCenter or ESXi console.
    2. Select an ESXi server or a resource pool on an ESXi server, and then right-click on it.
    3. Select New Virtual Machine.

      The New Virtual Machine screen appears.

    4. On the Select a creation type tab, select Create a new virtual machine and click NEXT.
    5. On the Select a name and folder tab, specify a unique name for the VM, select a location for the VM, and then click NEXT.
    6. On the Select a computer resource tab, select the destination computer resource and click NEXT.
    7. On the Select storage tab, select the storage for the configuration and disk files, and click NEXT.
    8. On the Select compatibility tab, select the current version and later, and click NEXT.
    9. On the Select a guest OS tab, select Linux from the Guest OS Family drop-down list and CentOS 7 (64-bit) from the Guest OS Version drop-down list, and click NEXT.

      If CentOS 7 (64-bit) is not available, select CentOS 4/5 or Later (64-bit).

    10. On the Customize hardware tab, configure the following and click NEXT.

      • Specify New hard disk to no less than 50 GB.

      • Set New CD/DVD Drive to Datastore ISO File.

      • Select Connect At Power On.

      • Click BROWSE... and select the uploaded ISO file in CD/DVD Media.

      • Configure the other options as necessary.

    11. On the Ready to complete tab, check your settings and click FINISH.
    12. Wait until the VM is successfully created, and right-click on the VM.
    13. Select Power > Power On.
    14. Open the console of the VM.

      The TMWS syslog forwarding tool installation wizard appears.

  3. On the TMWS Syslog Tool Installation Menu screen, select Install TMWS Syslog Forwarding Tool (EN).
  4. View the disk information to use for the installation and click Continue.
  5. On the Hardware Profile screen that appears, view the hardware settings for the syslog forwarding tool and click Continue.
  6. On the Repartition Disks warning screen that appears, click Continue.
  7. Wait a few minutes until the installation is completed.

    The system will reboot automatically.

  8. Log in to the machine as the root user through the command console, and then press Enter to set a password.

    The password must contain at least 8 characters, including uppercase characters, lowercase characters, numbers, and special characters.

  9. Run the following command after you first log in:

    clish

  10. Run the following command to enter the privileged mode:

    enable

  11. Run the following command to configure basic network settings:

    configure network basic

  12. Specify a value for each of the following fields and press Enter.

    • Host name: The host name of the VM

    • Data interface: The NIC used by the syslog forwarding tool to transmit data

      The default value is eth0.

    • method: Whether to use static or dynamic IP address assignment

      Continue to configure the following based on the method you select.

      • static: IPv4 address, IPv4 subnet mask, IPv4 gateway, preferred DNS, and alternate DNS (optional)

      • dhcp: Preferred DNS and alternate DNS (optional)

  13. Type Y or y to confirm the settings and restart the machine.

    The system will reboot automatically.

  14. Log in to the machine through the command console as the root user.
  15. Run the following command: /usr/logsvc/logoffloadClient/switch.py –t <token>

    <token> is the registration token that you can get on the management console.

    Important:

    If you generate a new registration token on the management console, make sure to use the new token to run the command again.

  16. (Optional) If you use a proxy server to connect the tool to the Internet, run the following command to configure the proxy: /usr/logsvc/logoffloadClient/switch.py -p <proxy> [-u <username> -pw <password>]
    Note:

    The syslog forwarding tool supports using proxy without authentication or with HTTP basic authentication (a username and password). To use this function, make sure that you have installed version 3.5.1.5570 or later.

    If -u and -pw are required, specify proxy in the following schema: http[s]://<IP/FQDN>:<port>.

    If only -p is required, specify proxy in the following schema: http[s]://<IP/FQDN>:<port> or <IP/FQDN>:<port>.

    If the password contains at least one blank space or single quote ('), enclose the password in double quotes (""); if the password contains at least one double quote ("), add the backslash escape character \ in front of each double quote, that is, (\").

    To delete the proxy setting, run the following command: /usr/logsvc/logoffloadClient/switch.py -d

Parent topic: Cloud Syslog Forwarding