%BOOK_ENTITIES; ]>

This section describes how to use a CAStor cluster as the back-end storage system for a &PRODUCT; S3 front-end. The CAStor back-end storage for &PRODUCT; extends the existing storage classes and allows the storage configuration attribute to point to a CAStor cluster. This feature makes use of the &PRODUCT; server's local disk to spool files before writing them to CAStor when handling the PUT operations. However, a file must be successfully written into the CAStor cluster prior to the return of a success code to the S3 client to ensure that the transaction outcome is correctly reported. The S3 multipart file upload is not supported in this release. You are prompted with proper error message if a multipart upload is attempted. To configure CAStor: Install &PRODUCT; by following the instructions given in the INSTALL.txt file. You can use the S3 storage system in &PRODUCT; without setting up and installing the compute components. Enable the S3 API by setting "enable.s3.api = true" in the Global parameter section in the UI and register a user. For more information, see S3 API in &PRODUCT;. Edit the cloud-bridge.properties file and modify the "storage.root" parameter. Set "storage.root" to the key word "castor". Specify a CAStor tenant domain to which content is written. If the domain is not specified, the CAStor default domain, specified by the "cluster" parameter in CAStor's node.cfg file, will be used. Specify a list of node IP addresses, or set "zeroconf" and the cluster name. When using a static IP list with a large cluster, it is not necessary to include every node, only a few is required to initialize the client software. For example: storage.root=castor domain=cloudstack 10.1.1.51 10.1.1.52 10.1.1.53 In this example, the configuration file directs &PRODUCT; to write the S3 files to CAStor instead of to a file system, where the CAStor domain name is cloudstack, and the CAStor node IP addresses are those listed. (Optional) The last value is a port number on which to communicate with the CAStor cluster. If not specified, the default is 80. #Static IP list with optional port storage.root=castor domain=cloudstack 10.1.1.51 10.1.1.52 10.1.1.53 80 #Zeroconf locator for cluster named "castor.example.com" storage.root=castor domain=cloudstack zeroconf=castor.example.com Create the tenant domain within the CAStor storage cluster. If you omit this step before attempting to store content, you will get HTTP 412 errors in the awsapi.log.