<VirtualHost *:80>
# Enter your server name here.
ServerName XXXXXXXXXX
# NB: Some webdav clients expect the server to implement webdav at the root
# location (they execute an OPTIONS request to verify existence of webdav
# protocol support).
<Location />
# Options needed to enable Davrods. {{{
# =================================
# Disable built-in Apache directory listings - Davrods will
# provide this instead.
DirectoryIndex disabled
# Restrict access to authenticated users.
AuthType Basic
Require valid-user
# The realm name that will be shown to clients upon authentication
AuthName DAV
# Use the 'irods' HTTP basic authentication provider, implemented by Davrods.
AuthBasicProvider irods
# The DAV provider for this location.
#
# Davrods implements multiple dav providers, use either:
# - davrods-nolocks: WebDAV class 1 provider, no support for locking
# - davrods-locallock (recommended): WebDAV class 2 provider, uses a DBM lock database local to this webserver
#
# Note that the davrods-locallock provider requires an apache-writable lockdb directory
# (/var/lib/davrods, or a path specified using the DavRodsLockDB directive - see further down this file).
# The RPM/DEB distribution creates this directory for you.
#
Dav davrods-locallock
# }}}
# Davrods configuration directives. {{{
# =================================
# Location of the iRODS environment file that specifies the iRODS
# client configuration used by Davrods.
#
# Note: When options in the iRODS environment file overlap with Davrods
# configuration directives, as with the host, port, and zone of the
# iRODS server, the values specified in the iRODS environment file are
# NOT used.
#
DavRodsEnvFile /etc/httpd/irods/irods_environment.json
# The following options can be used to customize Davrods for your environment.
# These options and their default values are provided below.
# Having these directives commented out has the effect of enabling
# the listed default option.
# Hostname and port of the iRODS server to connect to.
#
DavRodsServer XXXXXXXXXX 1247
# Data grid zone id of the iRODS server.
#
DavRodsZone datalake
# Authentication type to use when connecting to iRODS.
#
# Supported authentication types are 'Native' and 'Pam'.
# ('Native' corresponds to what was formerly called 'Standard' auth in iRODS).
#
DavRodsAuthScheme Native
# Anonymous mode switch.
#
# (default: Off)
# When 'Off', basic authentication is required to log into
# Davrods. AuthType must be set to 'Basic' and AuthBasicProvider
# must be set to 'irods'. There must also be a 'Require valid-user'
# line.
#
# When 'On', Davrods will log into iRODS with a preset
# username and password (See options DavRodsAnonymousLogin and
# DavRodsAuthScheme). AuthType must be unset, or set to None,
# and there should be no 'Require valid-user' line
# (instead: Require all granted).
#
# This allows users to access Davrods without being prompted
# for a login, making public access and embedding in web pages
# easier.
#DavRodsAnonymousMode Off
# iRODS authentication options for Davrods anonymous mode.
#
# This option is used only when DavRodsAnonymousMode is set to
# 'On'.
#
# Specifies the username and password to use for anonymous login.
# The default value is 'anonymous', with an empty password.
# (this user, if created, is treated specially within iRODS)
#
# The special 'anonymous' iRODS user normally requires the
# DavRodsAuthScheme to be set to Native.
#
#DavRodsAnonymousLogin "anonymous" ""
# iRODS default resource to use for file uploads.
#
# Leave this empty to let the server decide.
#
#DavRodsDefaultResource ""
# Exposed top collection of iRODS.
#
# Note that the collection chosen MUST be readable for all users,
# otherwise they will experience problems when mounting the drive.
# For example, if you set it to "Home", then as a rodsadmin user
# execute the icommand: ichmod read public /zone-name/home
#
# Davrods accepts the following values for exposed-root:
# - 'Zone' (collection /zone-name)
# - 'Home' (collection /zone-name/home)
# - 'User' (collection /zone-name/home/logged-in-username)
# - full-path (named collection, must be absolute path, starts with /)
#
DavRodsExposedRoot /datalake/home
# Size of the buffers used for file transfer to/from the iRODS server.
#
# The default values optimize performance for regular configurations.
# The Tx buffer is used for transfer to iRODS (PUT), while the Rx
# buffer is used for transfer from iRODS (GET).
# Buffer sizes lower than 1024K will lead to decreased file transfer performance.
#
# The buffer sizes are specified as a number of kibibytes ('1' means 1024 bytes).
# We use 4 MiB transfer buffers by default.
#
#DavRodsTxBufferKbs 4096
#DavRodsRxBufferKbs 4096
# Optionally Davrods can support rollback for aborted uploads. In this scenario
# a temporary file is created during upload and upon succesful transfer this
# temporary file is renamed to the destination filename.
# NB: Please note that the use of temporary files may conflict with your iRODS
# data policies (e.g. a acPostProcForPut would act upon the temporary filename).
# Valid values for this option are 'On'/'Yes' and 'Off'/'No'.
#
#DavRodsTmpfileRollback Off
# When using the davrods-locallock DAV provider (see the 'Dav'
# directive above), this option can be used to set the location of the
# lock database.
#
#DavRodsLockDB /var/lib/davrods/lockdb_locallock
# Davrods provides read-only HTML directory listings for web browser access.
# The UI is basic and unstyled by default, but can be modified with three
# theming directives.
#
# Each of these directives points to a local HTML file that must be readable
# by the apache user.
#
# The default value for each of these is "", which disables the option.
#
# - DavRodsHtmlHead is inserted in the HEAD tag of the listing.
# - DavRodsHtmlHeader is inserted at the top of the listing's BODY tag.
# - DavRodsHtmlFooter is inserted at the bottom of the listing's BODY tag.
#
# Example HTML files are provided in /etc/httpd/irods. You should edit these
# before enabling them.
#
# To see an example, uncomment the following three lines:
#
#DavRodsHtmlHead "/etc/httpd/irods/head.html"
#DavRodsHtmlHeader "/etc/httpd/irods/header.html"
#DavRodsHtmlFooter "/etc/httpd/irods/footer.html"
# Depending on file type, web browser clients will either display
# files directly or offer a download to the user.
# This behavior can be influenced with the 'Content-Disposition' header.
#
# By default (value 'Off'), no such header is sent by Davrods.
# When DavRodsForceDownload is 'On', Davrods will send
# 'Content-Disposition: attachment' for all data objects, signalling that
# web browsers should not display files inline, but offer a download
# instead.
#
#DavRodsForceDownload Off
# }}}
</Location>
# To avoid cleartext password communication we strongly recommend to
# enable Davrods only over SSL.
# For HTTPS-only access, change the port at the start of the vhost block
# from 80 to 443 and add your SSL options below.
</VirtualHost>