[LON-CAPA-cvs] cvs: doc /loncapafiles loncapafiles.lpml loncom/html/adm/help/tex Authoring_WebDAV.tex
raeburn
raeburn at source.lon-capa.org
Wed May 27 07:29:55 EDT 2015
raeburn Wed May 27 11:29:55 2015 EDT
Added files:
/loncom/html/adm/help/tex Authoring_WebDAV.tex
Modified files:
/doc/loncapafiles loncapafiles.lpml
Log:
- Help file for WebDAV access to Authoring Space.
-------------- next part --------------
Index: doc/loncapafiles/loncapafiles.lpml
diff -u doc/loncapafiles/loncapafiles.lpml:1.916 doc/loncapafiles/loncapafiles.lpml:1.917
--- doc/loncapafiles/loncapafiles.lpml:1.916 Sat Apr 4 23:21:59 2015
+++ doc/loncapafiles/loncapafiles.lpml Wed May 27 11:29:55 2015
@@ -2,7 +2,7 @@
"http://lpml.sourceforge.net/DTD/lpml.dtd">
<!-- loncapafiles.lpml -->
-<!-- $Id: loncapafiles.lpml,v 1.916 2015/04/04 23:21:59 raeburn Exp $ -->
+<!-- $Id: loncapafiles.lpml,v 1.917 2015/05/27 11:29:55 raeburn Exp $ -->
<!--
@@ -3025,6 +3025,23 @@
uploadscores.gif;
uplusr.gif;
verify.gif;
+webdavcentosauth.gif;
+webdavcentosdirectory.gif;
+webdavcentosmenu.gif;
+webdavcentosurl.gif;
+webdavforkliftdirectory.gif;
+webdavforkliftedit.gif;
+webdavforkliftmenu.gif;
+webdavforklifturl.gif;
+webdavmacauth.gif;
+webdavmacconnect.gif;
+webdavmacdirectory.gif;
+webdavmacedit.gif;
+webdavmacfinder.gif;
+webdavwin7directory.gif;
+webdavwin7map.gif;
+webdavwin7menu.gif;
+webdavwin7url.gif;
webpage.gif;
wishlist.gif;
wishlist-link.gif;
@@ -3192,6 +3209,23 @@
uploadscores.eps;
uplusr.eps;
verify.eps;
+webdavcentosauth.eps;
+webdavcentosdirectory.eps;
+webdavcentosmenu.eps;
+webdavcentosurl.eps;
+webdavforkliftdirectory.eps;
+webdavforkliftedit.eps;
+webdavforkliftmenu.eps;
+webdavforklifturl.eps;
+webdavmacauth.eps;
+webdavmacconnect.eps;
+webdavmacdirectory.eps;
+webdavmacedit.eps;
+webdavmacfinder.eps;
+webdavwin7directory.eps;
+webdavwin7map.eps;
+webdavwin7menu.eps;
+webdavwin7url.eps;
webpage.eps;
wishlist.eps;
wishlist-link.eps;
@@ -3268,6 +3302,7 @@
Authoring_Spreadsheet.tex;
Authoring_Structure_Tags.tex;
Authoring_Surveys.tex;
+Authoring_WebDAV.tex;
Authoring_XML_Intro.tex;
Author_LON-CAPA_Introduction.tex;
Author_Manual_Title_Page.tex;
Index: loncom/html/adm/help/tex/Authoring_WebDAV.tex
+++ loncom/html/adm/help/tex/Authoring_WebDAV.tex
\label{Authoring_WebDAV}
If your domain has Apache with SSL running on your library server,
(i.e., URLs begin https://) and your Domain Coordinator has enabled webDAV access
for users with author or co-author roles, then you will be able to connect to an
Authoring Space using webDAV.
A webDAV connection allows you to mount the Authoring Space directory tree as an
external volume. You can then use your own laptop/desktop computer's file management
tools and applications to copy, move, edit and delete files.
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 a mechanism to
reverse the deletion), it is important that you are especially careful when working in the
webDAV environment with this type of content.
When you display the contents of a directory in Authoring Space using webDAV you may see
additional files, with extensions .log, .save, .bak etc. for each LON-CAPA .problem
file. You can view the contents of these files but you will not be able to edit or
delete them. These files are created by the LON-CAPA when using the web GUI.
For example, a .log file, which records publication history, is updated whenever you
use ``Publish'' to copy a file from Authoring Space to Resource Space, and .bak files
enable use of the LON-CAPA ``Undo'' button in regular web browser-based editing in
Authoring Space.
\begin{itemize}
\item Mac OS 10.9 (Mavericks) and earlier
\begin{enumerate}
\item Select the ``Go'' item in the Finder toolbar and select ``Connect to Server''.
\begin{figure}
\begin{center}\includegraphics[width=0.30\paperwidth]{webdavmacfinder}\end{center}
\caption{MacOS ``Connect to Server''}
\end{figure}
\item Enter a URL for a library server where the Authoring Space is located:
e.g., https:// $<$ hostname $>$ /webdav/ $<$dom$>$ / $<$ username $>$/
where dom is the domain, and username is the username of the Authoring Space owner.
\begin{figure}
\begin{center}\includegraphics[width=0.30\paperwidth]{webdavmacconnect}\end{center}
\caption{MacOS WebDAV URL}
\end{figure}
\item You will be prompted to enter a username (this will be the LON-CAPA username
if the you are the author, or your LON-CAPA username:domain if you are a co-author)
and your LON-CAPA password.
\begin{figure}
\begin{center}\includegraphics[width=0.30\paperwidth]{webdavmacauth}\end{center}
\caption{MacOS WebDAV Authentication}
\end{figure}
\item In the directory listing, you can use control + click for a particular file to
choose an application to use to open it (e.g., Text Wrangler for .problem files).
\begin{figure}
\begin{center}\includegraphics[width=0.30\paperwidth]{webdavmacdirectory}\end{center}
\caption{MacOS WebDAV Directory Listing}
\end{figure}
\begin{figure}
\begin{center}\includegraphics[width=0.30\paperwidth]{webdavmacedit}\end{center}
\caption{MacOS Editing a file accessed via WebDAV}
\end{figure}
\end{enumerate}
\item Mac OS 10.10 (Yosemite)
The instructions provided for Mac OS 10.9 and earlier can also be used to mount
the Authoring Space if you are using 10.10. However, because of a change in the
mechanism used to save files, the Apple webDAV implementation in 10.10 will not
allow saving of files in Authoring Space if they have already been published to
resource space. However, if you purchase the inexpensive ForkLift 2 utility for
Yosemite, you can continue to use the webDAV to modify and save these types of files,
when you use ForkLift to set up and manage your webDAV connection.
\begin{enumerate}
\item Select the ``Go'' item in the ForkLift toolbar and select ``Connect...''.
\begin{figure}
\begin{center}\includegraphics[width=0.30\paperwidth]{webdavforkliftmenu}\end{center}
\caption{MacOS 10.10 (Yosemite) ForkLift -- Connect to WebDAV}
\end{figure}
\item In the ``Connect'' dialog select ``WebDAV (HTTPS)'' as the protocol, and enter the
hostname of the server in the Server textbox, and your LON-CAPA username and password
(LON-CAPA username:domain if you are a co-author). Click the ``More options'' arrow to
display the Remote path textbox, and enter webdav/ $<$dom$>$ / $<$ username $>$/,
where dom is the domain, and username is the username of the Authoring Space owner.
\begin{figure}
\begin{center}\includegraphics[width=0.30\paperwidth]{webdavforklifturl}\end{center}
\caption{MacOS 10.10 (Yosemite) ForkLift -- WebDAV URL}
\end{figure}
\item In the directory listing,
\begin{figure}
\begin{center}\includegraphics[width=0.30\paperwidth]{webdavforkliftdirectory}\end{center}
\caption{MacOS 10.10 (Yosemite) ForkLift WebDAV Directory Listing}
\end{figure}
you can use control + click for a particular file to choose an application to use to open it
(e.g., Text Wrangler for .problem files).
\begin{figure}
\begin{center}\includegraphics[width=0.30\paperwidth]{webdavforkliftedit}\end{center}
\caption{MacOS 10.10 (Yosemite) ForkLift -- Editing a file accessed via WebDAV}
\end{figure}
\end{enumerate}
\item Windows 7
\begin{enumerate}
\item Select `Computer'' from the Start Menu.
\begin{figure}
\begin{center}\includegraphics[width=0.30\paperwidth]{webdavwin7menu}\end{center}
\caption{Windows 7 Start Menu}
\end{figure}
\item Click on the ``Map network drive'' button in the toolbar.
\begin{figure}
\begin{center}\includegraphics[width=0.30\paperwidth]{webdavwin7map}\end{center}
\caption{Windows 7 ``Map network drive''}
\end{figure}
\item In the pop-up window, enter the following in the Folder textbox:
https:// $<$ hostname $>$ /webdav/ $<$dom$>$ / $<$ username $>$/ and click the Finish
button (where dom is the domain, and username is the username of the Authoring Space owner).
\begin{figure}
\begin{center}\includegraphics[width=0.30\paperwidth]{webdavwin7url}\end{center}
\caption{Windows 7 WebDAV URL}
\end{figure}
\item In the ``Windows Security'' screen enter your LON-CAPA username and password
(or LON-CAPA username:domain and password if you are a co-author in the Authoring Space).
\begin{figure}
\begin{center}\includegraphics[width=0.30\paperwidth]{webdavwin7auth}\end{center}
\caption{Windows 7 WebDAV Authentication}
\end{figure}
\item Display the directory listing to move or copy one or more files or folders, or open a
single file.
\begin{figure}
\begin{center}\includegraphics[width=0.30\paperwidth]{webdavwin7directory}\end{center}
\caption{Windows 7 WebDAV Directory Listing}
\end{figure}
\end{enumerate}
\item Linux (e.g., CentOS)
\begin{enumerate}
\item From the Places item in the toolbar, select ``Connect to Server ...''.
\begin{figure}
\begin{center}\includegraphics[width=0.30\paperwidth]{webdavcentosmenu}\end{center}
\caption{Linux (CentOS) Connect to Server}
\end{figure}
\item In the dialog, select ``Secure WebDAV (HTTPS)'' as the service type, then enter
the hostname of the LON-CAPA library server in the Server textbox.
In the Folder textbox enter: webdav/ $<$dom$>$ / $<$ username $>$/ where dom is the domain,
and username is the username of the Authoring Space owner. In the User Name textbox enter
your username and click the ``Connect'' button.
\begin{figure}
\begin{center}\includegraphics[width=0.30\paperwidth]{webdavcentosurl}\end{center}
\caption{Linux (CentOS) WebDAV URL}
\end{figure}
\item You will be prompted to enter a username (this will be the LON-CAPA username
if the you are the author, or your LON-CAPA username:domain if you are a co-author)
and your LON-CAPA password.
\begin{figure}
\begin{center}\includegraphics[width=0.30\paperwidth]{webdavcentosauth}\end{center}
\caption{Linux (CentOS) WebDAV Authentication}
\end{figure}
\item Display the directory listing to move or copy one or more files or folders, or open a
single file.
\begin{figure}
\begin{center}\includegraphics[width=0.30\paperwidth]{webdavcentosdirectory}\end{center}
\caption{Linux (CentOS) WebDAV Directory Listing}
\end{figure}
\end{enumerate}
\end{itemize}
More information about the LON-CAPA-cvs
mailing list