When you change the IP addresses of the primary or secondary syslog server for a cloud, you must also synchronize the syslog server settings for each Edge Gateway or vApp network that includes a FirewallService for which logging is enabled.

If a system administrator changes the SyslogServerSettings for a cloud, all Edge Gateways and vApp networks that are configured with a firewall service whose EnableLogging element has a value of true must be synchronized with the new syslog server settings so that logging to the system syslog server can continue without interruption.
Note: You do not need to synchronize syslog server settings for an Edge Gateway when you change its TenantSyslogServerSettings.

Prerequisites

  • To synchronize syslog server settings for an Edge Gateway, you must be an organization administrator or system administrator.
  • To synchronize syslog server settings for a vApp network, you must be the vApp owner.

Procedure

  1. Retrieve the XML representation of the vApp network or Edge Gateway.
  2. Examine the response to locate the Link element that contains the URL for the syncSyslogServerSettings action.
    This element has a rel attribute value of syncSyslogSettings and a type attribute value of application/vnd.vmware.vcloud.task+xml, as shown in this excerpt:
    <Link
       rel="syncSyslogSettings"
       type="application/vnd.vmware.vcloud.task+xml"
       href="https://vcloud.example.com/api/admin/edgeGateway/2000/action/syncSyslogServerSettings"
  3. Make a POST request to the href value of the link described in Step 2.
    The request does not have a request body. The response is a task.

Example: Synchronize Syslog Server Settings for an Edge Gateway

This request synchronizes the syslog server settings for the Edge Gateway created in Create an Edge Gateway.
POST https://vcloud.example.com/api/admin/edgeGateway/2000/action/syncSyslogServerSettings
Response:
202 Accepted
Content-Type: application/vnd.vmware.vcloud.task+xml
...
<Task ... 
   status="running"
   ...
   operation="Synchronized syslog settings for EdgeGateway theEdge(2000)>
   ...>
</Task>