Syncplicity Support

Follow

Enabling Storage Connector support for the Version API call

Enabling support for the /version remote version query utility

To prevent the potential disclosure of this configuration information the default behavior of the /version lookup will be disabled by default. However, there are circumstances when a customer may choose to enable this utility as a way of querying all deployed storage connectors to ensure they are all running a consistent version.  

The goal of this article is to aid the Storage Admin on how to enable and re-disable this /version utility if they choose.

Connect to your Storage Connector and enable the utility

  1. Edit the /etc/syncp-storage/syncp-storage.conf file

sudo vi /etc/syncp-storage/syncp-storage.conf

  1. Insert the following text in the section of the file just below the proxy configuration:

# Syncplicity Web Services
# ~~~~~
syncplicity.ws {
  proxy {
    enable: false
    host: ""
    port: 8080
  }
}
syncplicity.versionPage.enabled = true

  1. Save your changes to the syncp-storage.conf file
  1. Restart the Storage Connector Service:

sudo service syncp-storage restart

Perform the following on each Storage Connector you choose. It is important to note that if the Storage Connectors are behind a load balancer running the /version query will only give you results from whichever Storage Connector in the pool received that inbound request

Executing the query

  1. In any browser, enter the following address:

https://<storagevault URL>/version

The desired response will resemble the following:

{"version":"2.8.0.7","ovaVersion":"0.0.0.0","nodeId":"12345678-f689-451e-bf0d-dfca7d510976","commitId":"f0c87d1fa96618bcc2bfe95dc141c5cbe2a461ea"}

where the values indicate:

  • Version is the Storage Connector Version
  • Ova Version is the version of the .ova (if an .ova was deployed)
  • Node ID is the unique identifier for each Storage Connector
  • CommitID represents specific diagnostic information useful for aiding Syncplicity Support

 

Powered by Zendesk