Installing with S3MultipleBuckets subsystem - Installing with S3MultipleBuckets subsystem - Alfresco - Alfresco Content Connector for AWS S3 - Alfresco/Alfresco-Content-Connector-for-AWS-S3/4.0/Alfresco-Content-Connector-for-AWS-S3/Alfresco-Content-Connector-for-AWS-S3/Install-Content-Connector-for-AWS-S3/Installing-with-S3MultipleBuckets-subsystem

These steps describe how to install the S3 Connector to an instance of Alfresco Content Services, and how to enable the S3MultipleBuckets subsystem sample.

The S3 Connector is packaged as an Alfresco Module Package (AMP) file.

Note

Ensure that you don't start Alfresco Content Services before installing the S3 Connector AMP.

Go to Hyland Community.
Download the alfresco-s3-connector-4.0.x.amp file.
Use the Module Management Tool (MMT) to install the AMP into the repository WAR (alfresco.war).

For more information, see Using the Module Management Tool (MMT) and Installing an Alfresco Module Package.
Unzip the alfresco-s3-connector-4.0.x.amp file.
Copy the three sample files and rename them by removing the .sample extension.

The sample files are located under:
```
alfresco-s3-connector-4.0.x.amp/config/alfresco/extension/...
```
They need to be copied to the relevant paths under the following folder:
```
$CATALINA_HOME/shared/classes/alfresco/extension/...
```
1. Copy and rename s3-multiple-buckets-context.xml.sample to:
```
s3-multiple-buckets-context.xml
```
2. Copy and rename subsystems/ContentStore/S3MultipleBuckets/S3MultipleBuckets/s3-mb-contentstore-context.xml.sample to:
```
subsystems/ContentStore/S3MultipleBuckets/S3MultipleBuckets/s3-mb-contentstore-context.xml
```
3. Copy and rename subsystems/ContentStore/S3MultipleBuckets/S3MultipleBuckets/s3-mb-contentstore.properties.sample to:
```
subsystems/ContentStore/S3MultipleBuckets/S3MultipleBuckets/s3-mb-contentstore.properties
```
Check that the configuration is set up correctly for your environment.
1. Check the S3 Connector properties for store 1 (for example, connector.s3.* or s3.*)
  
  See s3-mb-contentstore.properties for the complete list.
  
  The minimum properties required are:
```
-Dconnector.s3.accessKey=${AWS_ACCESS_KEY_ID}
-Dconnector.s3.secretKey=${AWS_SECRET_ACCESS_KEY}
-Dconnector.s3.bucketName=${S3_BUCKET_NAME}
-Dconnector.s3.bucketRegion=${S3_BUCKET_REGION}
```
2. Check the S3 Connector properties for store 2 (for example, connector.s3.store2.* or s3.store2.*)
  
  See s3-mb-contentstore.properties for the complete list..
  
  The minimum properties required are:
```
-Dconnector.s3.store2.bucketName=${S3_BUCKET2_NAME}
-Dconnector.s3.store2.bucketRegion=${S3_BUCKET_REGION}
```
3. Set S3 multiple buckets as the default file content store subsystem:
```
filecontentstore.subsystem.name=S3MultipleBuckets
```
Check that any other configuration is set up correctly for your environment and specifically check the multiple bucket config.
Start Alfresco Content Services.