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
- Edit the /etc/syncp-storage/syncp-storage.conf file
sudo vi /etc/syncp-storage/syncp-storage.conf
- 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
- Save your changes to the syncp-storage.conf file
- 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
- 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