Skip to main content

Creating forwarder destination configurations

You can define common destination configurations that can be used by multiple report forwarders. The destination identifies where the reports are to be sent.

Procedure

To create a destination configuration for report forwarders, complete the following steps.

  1. From the XClarity Orchestrator menu bar, click Monitoring (Monitoring icon) > Forwarding, and then click Forwarder Destinations in the left navigation to display the Forwarder Destinations card.
  2. Click the Create icon (Add icon) to display the Create Forwarder Destinations dialog.
  3. Specify the report forwarder name and optional description
  4. Select SMTP as the destination type.
  5. Click Configuration, and fill in the protocol-specific information.
    • Enter the hostname or IP address of the SMTP (email) server.
    • Enter the port to use for the destination. The default is 25.
    • Enter the time-out period (in seconds) for the request. Default is 30 seconds.
    • Enter the email address for each recipient. Separate multiple email addresses by using a comma.
    • Optional: Enter the email address for the sender of the email (for example, john@company.com) and the sender domain.

      If you do not specify an email address, the sender address is LXCO.{source_identifier}@{smtp_host} by default.

      If you specify only the sender domain, the format of the sender address is {LXCO_host_name}@{sender_domain} (for example, XClarity1@company.com).

      Note
      • If you set up your SMTP server to require a hostname to forward email, and you do not set up a hostname for XClarity Orchestrator, it is possible that the SMTP server might reject the email. If XClarity Orchestrator does not have a hostname, the email is forwarded with the IP address. If the IP address cannot be obtained, “localhost” is sent instead, which might cause the SMTP server to reject the email.
      • If you specify the sender domain, the source does not identify in the sender address. Instead, information about the data source is included in the body of the email, including system name, IP address, machine type/model, and serial number.
      • If the SMTP server accepts only emails that are sent by a registered user, the default sender address (LXCO.<source_identifier}@{smtp_host>) is rejected. In this case, you must specify at least a domain name in the From User field.
    • To establish a secure connection to the SMTP server, select one of the following connection types.
      • SSL. Uses the SSL protocol to form a secure communication.
      • STARTTLS. Uses the TLS protocol to form a secure communication over an unsecure channel.

      If one of these connection types is selected, XClarity Orchestrator attempts to download and import the SMTP server’s certificate to the XClarity Orchestrator truststore. You are prompted to accept this certificate.

    • If authentication is required, select one of the following authentication types.
      • Regular. Authenticates to the specified SMTP server using the specified user ID and password.
      • OAUTH2. Uses the Simple Authentication and Security Layer (SASL) protocol to authenticate to the specified SMTP server using the specified username and security token. Typically, the username is your email address.
        Attention
        The security token expires after a short time. It is your responsibility to refresh the security token.
      • None. No authentication is used.
  6. Click Create to create the destination configuration.

After you finish

You can perform the following actions from the Forwarder Destinations card.

  • Modify a selected destination by clicking the Edit icon (Edit icon).
  • Remove a selected destination by clicking the Delete icon (Delete icon).

    You cannot delete a destination that is assigned to a forwarder