Media_volumes.conf

CollectiveAccess stores uploaded media and derivatives in the media directory.

You can change the location where media is stored by editing the media volumes configuration file in app/conf/media_volumes.conf.

Organization

The file includes an entry per volume.

Key

Description

Example

hostname

Hostname

<site_hostname>

protocol

Protocol (ftp, http[s], etc.)

<site_protocol>

urlPath

Base path for exposing the media on this volume

<ca_media_url_root>/images

absolutePath

Absolute filesystem path for the volume

<ca_media_root_dir>/images

writeable

A flag to indicate if the volume is writeable or not

1

description

Description of the volume

Images

accessUsingMirror

Name of mirror to serve media from, when available. If the specified mirror does not yet have the required media, the local copy will be served.

mirrors

An associative array of available mirrors. Content will be copied to each of them

FTP Mirror configuration

The mirror configuration directives are:

Directive

Description

Example

method

How the files are to be mirrored. Only FTP is currently supported. ftp (must be lowercase)

ftp

hostname

The hostname of the server to while the files will be mirrored.

ftp.mymirror.com

username

The username to use when logging into the mirror server. (Ask your server administrator if you are unsure)

user

password

The password to use when logging into the mirror server. (Ask your server administator if you are unsure)

password

directory

The directory into which to upload the mirrored media files. In general this should be an absolute path, but depending upon how your FTP login is setup it may be a relative path. (As your server administrator if you are unsure)

/usr/local/ftp/ca/images

passive

If set to ‘1’ (the number one) then passive FTP connections are used. Passive connections are usually required if you are behind a firewall.

1

accessProtocol

The protocol to use in URLs that reference media on this mirror server. For simple web-served media like images this will usually be http or https. For streaming media this may be http, rtsp or rtmp.

http

accessHostname

The hostname to use in URLs that reference media on this mirror server. This is often, but not necessarily, the same as the hostname directive.

www.mymirror.com

accessUrlPath

The URL path (the part after the hostname) used to reference media on this mirror server. This is often, but not necessarily, the subset of the path set in the directory directive that is relative to a web server root.

/ca/images