Configuring an Assets Mirror

Since the point of web services is to recreate a site using the remote data, you need some way to access data for uploaded files (it would be extremely inefficient and difficult to send file data over web services). Therefore, you need to use the Recite asset mirroring functionality in order to send assets to the location of the web services client.

When an asset is created, modified or deleted, each of the asset mirrors are notified accordingly. Currently there is only one mirror type, which is the “File System” mirror.

Tip

Since the web services client will typically not be on the same server as your Recite installation, the File System mirror driver on its own may not be sufficient. If you want to mirror files using SSH/SFTP or FTP then Fuse (or similar) should be used. More details can be found at http://ubuntu.wordpress.com/2005/10/28/how-to-mount-a-remote-ssh-filesystem-using-sshfs/. Alternatively, if the server resides on the same network you may be able to mount a network drive in a similar fashion.

To create an asset mirror, go the Admin tab in the Recite Control Panel. In the left frame under the Configuration heading, select File Mirrors.

Note

If you don't see this heading check your permissions for the File Manager module.

Next, click the Create Mirror tab. You will then prompted to choose a mirror type. From here, select File System and click Create Mirror. You will then be required to enter a title by which to identify this mirror, and also the local file system path where the assets will be mirrored.

When you've entered these options, click Save File Mirror. If the path is valid (and is writable), the new asset mirror will be saved. After the mirror is saved, click the Synchronise With Mirror button to send existing files to the selected path.

Now whenever a new file is uploaded, it will be sent to the asset mirror. If a file is deleted from the File Manager it will also be deleted from the mirror.