Any Cloud

By Jared Howland Omeka S module for storing items in the cloud storage of your choice.
Download 0.3.2

Scrutinizer Code Quality Build Status Maintainability StyleCI

Any Cloud Storage (Omeka S Module)

This module allows you to store your Omeka S files on one of the following external cloud platforms rather than the local server disk:

It uses a filesystem abstraction system called Flysystem. You can build your own adapters to use with the system if there is a cloud storage system you would like to use but is not currently available via this module.

It is recommended that once you pick an external storage service you continue using it as migrating to a different external file system is not currently supported.

Installation and Configuration

  1. Install the plugin by downloading and unzipping the latest module and loading it into the modules directory of your Omeka S instance.
  2. Enable the plugin from the Admin side of your installation under “Modules”.
  3. Configure the module from the Admin side to include credentials for the cloud storage system you would like to use.

After that, when you upload media for an item, it will upload to your selected cloud service rather than to your server's local storage.

Known Issues

  1. No migration from one cloud/filesystem to another. Pick one or manually transfer things if you decide to change services.
  2. The Rackspace Files adapter currently relies on an outdated version of the Guzzle package which causes problems authenticating to the service. See this forum posting for the solution which involves downloading an updated security certificate and placing it in the correct directory in the vendor directory. There are several issues requesting a fix but I don't know when those will be resolved. Until then, the instructions in that forum work well:
  3. Download the updated certificate authority file here: https://curl.haxx.se/ca/cacert.pem
  4. Replace Guzzle's certificate authority file with the updated one. It is located at: /path/to/omeka/modules/AnyCloud/vendor/guzzle/guzzle/src/Guzzle/Http/Resources/cacert.pem
  5. There is also an authentication issue with Rackspace Files if you use Multi-Factor Authentication (MFA). MFA must be disabled on your account for this adapter to work. Hopefully both of these issues are addressed soon.

Warning

Use this module at your own risk.

It’s always recommended to backup your files and databases and to check your archives regularly so you can roll back if needed.

Troubleshooting

See online issues on the module issues page on GitHub.

TODO

    • [X] Remove need for users to manually change the alias in config/local.config.php (v0.2.0)
    • [X] Move all config data to a form so users can use the admin module system to enter their credentials without the need to access server files (v0.2.0)
    • [X] Make config forms prettier and easier to use (v0.3.0)
    • [ ] Provide more detailed instructions on setting up each cloud storage system (possibly using the GitHub wiki)

Possible Enhancements

    • [ ] Add more cloud adapters (OneDrive, Box.com)
    • [ ] Allow migration between different cloud platforms
    • [ ] Support module translation
Version Released Minimum Omeka version
0.3.2February 07, 2019 [info]
0.3.1February 05, 2019 [info]
0.3.0February 03, 2019 [info]