This page contains instructions on how to set up and access [[Arbutus object storage]] with WinSCP, one of the [[Arbutus_object_storage_clients | object storage clients ]] available for this storage type.
== Installing WinSCP ==
WinSCP can be installed from https://winscp.net/.
== Configuring WinSCP ==
Under "New Session", make the following configurations:
- File protocol: Amazon S3
- Host name: object-arbutus.cloud.computecanada.ca
- Port number: 443
- Access key ID: 20_DIGIT_ACCESS_KEY
and "Save" these settings as shown below
[[File:WinSCP Configuration.png|600px|thumb|center|WinSCP configuration screen]]
Next, click on the "Edit" button and then click on "Advanced..." and navigate to "Environment" to "S3" to "Protocol options" to "URL style:" which must changed from "Virtual Host" to "Path" as shown below:
[[File:WinSCP Path Configuration.png|600px|thumb|center|WinSCP Path Configuration]]
This "Path" setting is important, otherwise WinSCP will not work and you will see hostname resolution errors, like this:
[[File:WinSCP resolve error.png|400px|thumb|center|WinSCP resolve error]]
== Using WinSCP ==
Click on the "Login" button and use the WinSCP GUI to create buckets and to transfer files:
[[File:WinSCP transfers.png|800px|thumb|center|WinSCP file transfer screen]]
== Access Control Lists (ACLs) and Policies ==
Right-clicking on a file will allow you to set a file's ACL, like this:
[[File:WinSCP ACL.png|400px|thumb|center|WinSCP ACL screen]]
[[Category:Cloud]]