Set Up ObjectiveFS With Amazon S3 GovCloud

This document covers the steps to set up your ObjectiveFS filesystem with Amazon S3 GovCloud.

What You Need

S3 access and secret keys OR IAM role with S3 permission attached to your EC2 instance
ObjectiveFS license key from the Filesystem section on your profile page
ObjectiveFS software installed on your machine (see Quick Start)

Steps

Configure Objectivefs

a. Using S3 access and secret keys

$ sudo mount.objectivefs config s3://
Creating config for Amazon in /etc/objectivefs.env
Enter ObjectiveFS license: <your ObjectiveFS license>
Enter Access Key Id: <your S3 access key>
Enter Secret Access Key: <your S3 secret key>
Enter Default Region (optional): <your GovCloud region, e.g. us-gov-east-1>

b. Using IAM role attached to the EC2 instance

$ sudo mount.objectivefs config -i s3://
Creating config for Amazon in /etc/objectivefs.env
Enter ObjectiveFS license: <your ObjectiveFS license>
Enter Default Region (optional): <your GovCloud region, e.g. us-gov-west-1>

Note: This will get the IAM role from the AWS metadata host at 169.254.169.254

Create your filesystem (one-time only)
- Choose a unique filesystem name. ObjectiveFS will create a new bucket with this name.
- Choose a strong passphrase, write it down and store it somewhere safe.
  IMPORTANT: Without the passphrase, there is no way to recover any files.
```
$ sudo mount.objectivefs create <your filesystem name>
Passphrase (for <filesystem>): <your passphrase>
Verify passphrase (for <filesystem>): <your passphrase>
```
Mount your filesystem
Mount your filesystem on an existing empty directory, e.g. /ofs. The ObjectiveFS process will run in the background.
```
$ sudo mkdir /ofs
$ sudo mount.objectivefs <your filesystem name> /ofs
Passphrase (for //<filesystem>): <your passphrase>
```
[Optional] ** Multi-server setup**
Mount this filesystem on as many servers as you wish by running steps 1 and 3 on each server after installing ObjectiveFS. Each server can read and write to the same filesystem at the same time.

Useful Links

If you have questions, please email us at support@objectivefs.com.

Last updated by ObjectiveFS staff, October 3, 2022

ObjectiveFS is a shared filesystem for Linux and macOS that automatically scales up and out with high performance. In production use by Fortune 500 companies since 2013.