...
- go to the Jenkins dashboard (http://georgetown.sagebase.org:8080) and verify that the "rSynapseClient-master" job completed successfully
- In Jenkins, run deploy-rSynapseClient-master, and verify that it completes successfully
How to Black List a Version
If a version of the R Client is problematic or incompatible with a version of the Synapse server, there is a mechanism to disable or "black list" that version of the client.
Log in to the platform account in aws.amazon.com. Download the S3 file called synapseRClient in the bucket called versions.synapse.sagebase.org. The file looks like:
| Code Block |
|---|
{
"client":"synapseRClient",
"latestVersion":"0.19-0",
"releaseNotes":"This version includes new provenance features.",
"message":"On January 1, all clients will be required to upgrade to the latest version.",
"blacklist":[
{"server":"*","client":"0.0.0"},
{"server":"1.15.0-8-ge79db7a","client":"0.10"},
{"server":"1.14.0-1-f84egda0","client":"<0.70"},
{"server":"1.13.0-2-vj474hdh","client":">0.10-0"},
{"server":"1.12.0-7-ch24528f","client":"0.05"},
{"server":"1.12.0-7-ch24528f","client":"0.19-0"}
]
}
|
The "black list" is a list of client/server pairs, where the server may be a specific version or a wildcard ("*") and the client may be a specific version or may be all versions before (inclusive/exclusive) or after (inclusive/exclusive) a given version. To get the version of a server, use the repository services "/version" service e.g:
| Code Block |
|---|
http://repo-prod.sagebase.org/repo/v1/version
{"version":"1.15.0-8-ge79db7a"}
|
Enter a new black list record for the client version (or version range) and server version (or "*"), then upload the file to S3.
Verify that the file has been modified correctly: Run the integration test suite in Jenkins, as described above. This will exercise the black list, ensuring correctness.
References
R documentation
...