How To Use ObjectiveFS With On-Premise Object Stores (4.3.4 and older)

Enterprise Plan Feature

For ObjectiveFS version release 5.0 and newer, please refer to this guide.

ObjectiveFS supports on-premise object stores such as Ceph, Cleversafe, etc. This guide describes how to use ObjectiveFS with on-premise object stores.

What You Need

• ObjectiveFS installed
• An on-premise object store with an S3 compatible interface
• Replace all references of s3://<bucket name> in the user guide and documentation with
  http://<object store domain>/<bucket name>.

Steps

1. Configure your credentials (one-time setup)

# mount.objectivefs config
Enter ObjectiveFS license: <your ObjectiveFS license>
Enter Access Key Id: <your object store access key>
Enter Secret Access Key: <your object store secret key>

1. Create a filesystem for object store domain example.local and bucket myfs

# mount.objectivefs create http://example.local/myfs

1. Mount a filesystem myfs on /mnt in the foreground

# mount.objectivefs mount http://example.local/myfs /mnt

1. Mount a filesystem myfs on /mnt in the background (log output is in syslog)

# mount.objectivefs http://example.local/myfs /mnt

1. List all objectivefs filesystems

# mount.objectivefs list http://example.local

For versions prior to ObjectiveFS v.5.0:
If your DNS does not resolve <object store domain> and <bucket name>.<object store domain> to your S3 compatible interface, please set the http_proxy environment variable to <hostname>:<port> of your object store’s S3 compatible interface.

Steps for Object Stores that only support SSL connections

1. See this guide to set up stunnel.
2. Use the same commands as above with http_proxy pointing to your stunnel connection.

Note

• ObjectiveFS uses virtual hosted-style urls (e.g. <bucket>.<domain>), but not path-style naming.

Reference

• Using ObjectiveFS with Cleversafe/IBM Cloud Object Store

by ObjectiveFS staff, January 7, 2017
ObjectiveFS is a shared file system for OS X and Linux that automatically scales and gives you scalable cloud storage. If you have questions or article idea suggestions, please email us at support@objectivefs.com