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 is disabled by default. However, there are circumstances when an admin may choose to enable this utility as a way to query all deployed storage connectors to ensure they are all running a consistent version.

The following information describes how a Storage Admin can enable and re-disable this /version utility.

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

2. 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

3. Save your changes to the syncp-storage.conf file

4. Restart the Storage Connector Service:

   sudo service syncp-storage restart

Perform the following procedures on each Storage Connector.

NOTE: If the Storage Connectors are behind a load balancer running the /version query, only the results from whichever Storage Connector in the pool received that inbound request are displayed.

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

   • OvaVersion is the version of the .ova (if an .ova was deployed)

   • NodeID is the unique identifier for each Storage Connector

   • CommitID represents specific diagnostic information useful for aiding Syncplicity Support