ShareFile

Configure StorageZones Controller with S3 Compatible Storage

October 17, 2024

Contributed by:

ShareFile StorageZones Controller version 3.2 or later supports third-party object storage solutions that are compatible with the Amazon S3 API. To create a StorageZone that uses third-party storage systems that are compatible with the Amazon S3 storage APIs.

A. Add StorageZone Controller Registry Values

In order to use S3 compatible storage provider with ShareFile, take the following steps immediately after the installation of StorageZones Controller 3.2 or later, but before a StorageZone is configured/created:

Open Windows Registry Editor (Run -> regedit.exe).
Find HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\StorageCenter registry key.
Create a new REG_SZ value under this key
- Value name: S3EndpointAddress
- Value type: REG_SZ
- Value data: Enter the HTTPS URL that corresponds to your S3-compatible storage endpoint.
If the storage provider supports only path-style container access, create another value under this key.
- Value name: S3ForcePathStyle
- Value type: REG_SZ
- Value data: true
Restart SZC application pool (StorageCenterAppPool).

B. Create S3 access keys and storage bucket

You will need the following information from your S3-compatible storage system before you continue:

The name of an S3 bucket to use for ShareFile data
Access key ID
Secret access key

C. Configure StorageZone

Follow the documented process for creating a new StorageZone and choose Amazon S3 as the persistent storage location. StorageZone Controller will use the custom endpoint address you entered instead of the actual Amazon S3 service. When configuring the S3 details, choose the bucket name you created in part B.

D. Add StorageZone Controller Registry Values

Create these additional registry entries after the StorageZone is registered:

Open Windows Registry Editor (Run -> regedit.exe).
Find the HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\StorageZone\CloudStorageUploaderConfig registry key.
Create a new REG_SZ value under this key:
- Value name: S3EndpointAddress
- Value type: REG_SZ
- Value data: Enter the HTTPS URL that corresponds to your S3-compatible storage endpoint.
If the storage provider supports only path-style container access, create another value under this key:
- Value name: S3ForcePathStyle
- Value type: REG_SZ
- Value data: true
Restart SZC application pool (StorageCenterAppPool)

The official version of this content is in English. Some of the Cloud Software Group documentation content is machine translated for your convenience only. Cloud Software Group has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Cloud Software Group product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Cloud Software Group, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Cloud Software Group will not be held responsible for any damage or issues that may arise from using machine-translated content.

Was this article helpful

Configure StorageZones Controller with S3 Compatible Storage

October 17, 2024

Contributed by:

October 17, 2024

Contributed by:

Configure StorageZones Controller with S3 Compatible Storage

A. Add StorageZone Controller Registry Values

B. Create S3 access keys and storage bucket

C. Configure StorageZone

D. Add StorageZone Controller Registry Values

In this article