File:  [LON-CAPA] / loncom / html / adm / help / tex / Domain_Configuration_Author_Defaults.tex
Revision 1.3: download - view: text, annotated - select for diffs
Wed Jan 8 23:11:10 2025 UTC (6 weeks, 1 day ago) by raeburn
Branches: MAIN
CVS tags: version_2_12_X, HEAD
- Configuration of domain defaults for webDAV and Authoring Space quotas
  moved from "Blogs, personal pages/timezones, portfolio/quotas" to
  "Authoring Space defaults".

\label{Domain_Configuration_Author_Defaults}
Starting with LON-CAPA 2.12, a Domain Coordinator can configure default
settings for Authoring Spaces in the domain. Defaults are of two types:
\begin{itemize}
\item \textbf{Defaults that can be overridden in an individual Authoring Space by an Author or co-Author}

Currently, there are five domain defaults of this type (which can be overridden
using selections from the Settings dropdown list item in the inline menu).

\begin{itemize}
\item Deactivate CodeMirror for EditXML editor

This sets whether CodeMirror (which provides line numbering, syntax highlighting and auto-insertion of balancing tags etc.) will be activated when using the EditXML editor.  Deactivation can improve performance and accessibility, but provides reduced functionality.

\item Daxe editor: LON-CAPA standard menus start collapsed

This sets whether LON-CAPA's standard menus are collapsed or expanded when the ``Edit with Daxe'' button is pushed when viewing a LON-CAPA problem in Authoring Space. In the Daxe editor page itself an icon is available at top left to expand or collapse the block of menus.

\item Dom. Coords. can enter Authoring Spaces in domain

This sets whether Domain Coordinators may enter Authoring Spaces belonging to other authors in their domain using the Co-Author: Select Author link beneath the Domain Coordinator role selectio item on the Roles page.

\item Default Copyright/Distribution

This sets the default selection in the Copyright/Distribution select box in a new metadata file when first publishing a file in Authoring Space.

\item Source Available selection set in a new metadata file

This sets the default selection in the Source Available select box in a new metadata file when first publishing a file in Authoring Space.

\end{itemize}

\item \textbf{Defaults that can be overridden for an individual Authoring Space by a Domain
Coordinator}

Currently, there are three domain defaults of this type (which can be overridden
via the ``View or modify a course or community'' interface).

\begin{itemize}

\item Available Editors 

Possible editors are: Standard editor (Edit) Text editor (EditXML) and the Daxe editor (Daxe)

\item Authoring Space quota (MB)

This sets the default disk space allocation for Authoring Spaces in the domain.  Different defaults can be set based on institutional user type of the Author.  Institutional types themselves are set via the Domain configuration screen for ``Default authentication/language/timezone/portal/types''. 

\item WebDAV access availability

This sets the default availability of WebDAV access to Authoring Spaces (server must be running https). Different defaults can be set based on institutional user type of the Author.

WebDAV allows a user to connect to an Authoring Space in the same way as removable
media, and to use their own laptop/desktop computer's file management tools and
applications to move, edit and delete files. See: ``WebDAV access to Authoring Space''
section in the Authoring manual for more information.

Note: webDAV usage requires Apache with SSL to be running on the library server.
The user will be prompted to enter his/her username (this will be the LON-CAPA username
or username,domain if the access is for a co-author with a domain different
to that of the author), and the user's LON-CAPA password. webDAV also requires that the
dav and dav\_fs modules are enabled in Apache. The way those are enabled depends on the
Linux distro (command line access required).
the Apache config.

\begin{itemize}

\item CentOS, Red Hat and Scientific Linux (6 and earlier)

The required LoadModule lines are included in the /etc/httpd/conf/httpd.conf
file added by install.pl run to prepare a server for installation of LON-CAPA.

\item CentOS, Red Hat and Scientific Linux 7

The required LoadModule lines are in the default /etc/httpd/conf.modules.d/00-dav.conf
file added when the httpd rpm is installed.

\item Ubuntu and Debian

Use the commands: a2enmod dav and a2enmod dav\_fs to enable the modules.

\item SLES

The APACHE\_MODULES entry in /etc/sysconfig/apache2 contains the list of modules to be
loaded. If dav and dav\_fs are not present they should be added to the list.

\end{itemize}

(Reload Apache after making any changes to the Apache configuration).

If you use Single Sign On to authenticate LON-CAPA users in your domain, then to
support webDAV you also need to support authentication by LON-CAPA for your users.
This can achieved if the authentication type stored internally for each SSO user is
set to either (a) Kerberos 5 (with a parameter --  the appropriate Kerberos realm
set), or (b) Local Authentication, with /home/httpd/lib/perl/localauth.pm
customized to verify username and password (e.g., via LDAP).  If a user can log-in
to LON-CAPA via the URL /adm/login (thereby by-passing SSO), then the same user will
also be able to authenticate using a WebDAV client (assuming other requirements are
met, i.e., SSL, WebDAV access enabled, active author or co-author role).

The requirement to obsolete published files before moving or deleting them, which applies to
the regular web browser-based management of Authoring Space, also applies in the webDAV
environment. Moving and deleting directories in the webDAV environment is prohibited if
the directory, or any (nested) subdirectory contains a non-obsolete published resource.

Given the ability to easily delete unpublished content in webDAV (without the ability to
reverse the deletion), it is important that authors assigned webDAV access are especially
careful when working in the webDAV environment.

\end{itemize}

\end{itemize}

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>