Annotation of loncom/html/adm/help/tex/Authoring_WebDAV.tex, revision 1.1
1.1 ! raeburn 1: \label{Authoring_WebDAV}
! 2: If your domain has Apache with SSL running on your library server,
! 3: (i.e., URLs begin https://) and your Domain Coordinator has enabled webDAV access
! 4: for users with author or co-author roles, then you will be able to connect to an
! 5: Authoring Space using webDAV.
! 6:
! 7: A webDAV connection allows you to mount the Authoring Space directory tree as an
! 8: external volume. You can then use your own laptop/desktop computer's file management
! 9: tools and applications to copy, move, edit and delete files.
! 10:
! 11: The requirement to obsolete published files before moving or deleting them, which applies to
! 12: the regular web browser-based management of Authoring Space, also applies in the webDAV
! 13: environment. Moving and deleting directories in the webDAV environment is prohibited if
! 14: the directory, or any (nested) subdirectory contains a non-obsolete published resource.
! 15:
! 16: Given the ability to easily delete unpublished content in webDAV (without a mechanism to
! 17: reverse the deletion), it is important that you are especially careful when working in the
! 18: webDAV environment with this type of content.
! 19:
! 20: When you display the contents of a directory in Authoring Space using webDAV you may see
! 21: additional files, with extensions .log, .save, .bak etc. for each LON-CAPA .problem
! 22: file. You can view the contents of these files but you will not be able to edit or
! 23: delete them. These files are created by the LON-CAPA when using the web GUI.
! 24: For example, a .log file, which records publication history, is updated whenever you
! 25: use ``Publish'' to copy a file from Authoring Space to Resource Space, and .bak files
! 26: enable use of the LON-CAPA ``Undo'' button in regular web browser-based editing in
! 27: Authoring Space.
! 28:
! 29: \begin{itemize}
! 30:
! 31: \item Mac OS 10.9 (Mavericks) and earlier
! 32:
! 33: \begin{enumerate}
! 34: \item Select the ``Go'' item in the Finder toolbar and select ``Connect to Server''.
! 35: \begin{figure}
! 36: \begin{center}\includegraphics[width=0.30\paperwidth]{webdavmacfinder}\end{center}
! 37: \caption{MacOS ``Connect to Server''}
! 38: \end{figure}
! 39:
! 40: \item Enter a URL for a library server where the Authoring Space is located:
! 41: e.g., https:// $<$ hostname $>$ /webdav/ $<$dom$>$ / $<$ username $>$/
! 42: where dom is the domain, and username is the username of the Authoring Space owner.
! 43:
! 44: \begin{figure}
! 45: \begin{center}\includegraphics[width=0.30\paperwidth]{webdavmacconnect}\end{center}
! 46: \caption{MacOS WebDAV URL}
! 47: \end{figure}
! 48:
! 49: \item You will be prompted to enter a username (this will be the LON-CAPA username
! 50: if the you are the author, or your LON-CAPA username:domain if you are a co-author)
! 51: and your LON-CAPA password.
! 52:
! 53: \begin{figure}
! 54: \begin{center}\includegraphics[width=0.30\paperwidth]{webdavmacauth}\end{center}
! 55: \caption{MacOS WebDAV Authentication}
! 56: \end{figure}
! 57:
! 58: \item In the directory listing, you can use control + click for a particular file to
! 59: choose an application to use to open it (e.g., Text Wrangler for .problem files).
! 60:
! 61: \begin{figure}
! 62: \begin{center}\includegraphics[width=0.30\paperwidth]{webdavmacdirectory}\end{center}
! 63: \caption{MacOS WebDAV Directory Listing}
! 64: \end{figure}
! 65:
! 66: \begin{figure}
! 67: \begin{center}\includegraphics[width=0.30\paperwidth]{webdavmacedit}\end{center}
! 68: \caption{MacOS Editing a file accessed via WebDAV}
! 69: \end{figure}
! 70:
! 71: \end{enumerate}
! 72:
! 73: \item Mac OS 10.10 (Yosemite)
! 74:
! 75: The instructions provided for Mac OS 10.9 and earlier can also be used to mount
! 76: the Authoring Space if you are using 10.10. However, because of a change in the
! 77: mechanism used to save files, the Apple webDAV implementation in 10.10 will not
! 78: allow saving of files in Authoring Space if they have already been published to
! 79: resource space. However, if you purchase the inexpensive ForkLift 2 utility for
! 80: Yosemite, you can continue to use the webDAV to modify and save these types of files,
! 81: when you use ForkLift to set up and manage your webDAV connection.
! 82:
! 83: \begin{enumerate}
! 84: \item Select the ``Go'' item in the ForkLift toolbar and select ``Connect...''.
! 85:
! 86: \begin{figure}
! 87: \begin{center}\includegraphics[width=0.30\paperwidth]{webdavforkliftmenu}\end{center}
! 88: \caption{MacOS 10.10 (Yosemite) ForkLift -- Connect to WebDAV}
! 89: \end{figure}
! 90:
! 91: \item In the ``Connect'' dialog select ``WebDAV (HTTPS)'' as the protocol, and enter the
! 92: hostname of the server in the Server textbox, and your LON-CAPA username and password
! 93: (LON-CAPA username:domain if you are a co-author). Click the ``More options'' arrow to
! 94: display the Remote path textbox, and enter webdav/ $<$dom$>$ / $<$ username $>$/,
! 95: where dom is the domain, and username is the username of the Authoring Space owner.
! 96:
! 97: \begin{figure}
! 98: \begin{center}\includegraphics[width=0.30\paperwidth]{webdavforklifturl}\end{center}
! 99: \caption{MacOS 10.10 (Yosemite) ForkLift -- WebDAV URL}
! 100: \end{figure}
! 101:
! 102: \item In the directory listing,
! 103:
! 104: \begin{figure}
! 105: \begin{center}\includegraphics[width=0.30\paperwidth]{webdavforkliftdirectory}\end{center}
! 106: \caption{MacOS 10.10 (Yosemite) ForkLift WebDAV Directory Listing}
! 107: \end{figure}
! 108:
! 109: you can use control + click for a particular file to choose an application to use to open it
! 110: (e.g., Text Wrangler for .problem files).
! 111:
! 112: \begin{figure}
! 113: \begin{center}\includegraphics[width=0.30\paperwidth]{webdavforkliftedit}\end{center}
! 114: \caption{MacOS 10.10 (Yosemite) ForkLift -- Editing a file accessed via WebDAV}
! 115: \end{figure}
! 116:
! 117: \end{enumerate}
! 118:
! 119: \item Windows 7
! 120: \begin{enumerate}
! 121: \item Select `Computer'' from the Start Menu.
! 122:
! 123: \begin{figure}
! 124: \begin{center}\includegraphics[width=0.30\paperwidth]{webdavwin7menu}\end{center}
! 125: \caption{Windows 7 Start Menu}
! 126: \end{figure}
! 127:
! 128: \item Click on the ``Map network drive'' button in the toolbar.
! 129:
! 130: \begin{figure}
! 131: \begin{center}\includegraphics[width=0.30\paperwidth]{webdavwin7map}\end{center}
! 132: \caption{Windows 7 ``Map network drive''}
! 133: \end{figure}
! 134:
! 135: \item In the pop-up window, enter the following in the Folder textbox:
! 136: https:// $<$ hostname $>$ /webdav/ $<$dom$>$ / $<$ username $>$/ and click the Finish
! 137: button (where dom is the domain, and username is the username of the Authoring Space owner).
! 138:
! 139: \begin{figure}
! 140: \begin{center}\includegraphics[width=0.30\paperwidth]{webdavwin7url}\end{center}
! 141: \caption{Windows 7 WebDAV URL}
! 142: \end{figure}
! 143:
! 144: \item In the ``Windows Security'' screen enter your LON-CAPA username and password
! 145: (or LON-CAPA username:domain and password if you are a co-author in the Authoring Space).
! 146:
! 147: \begin{figure}
! 148: \begin{center}\includegraphics[width=0.30\paperwidth]{webdavwin7auth}\end{center}
! 149: \caption{Windows 7 WebDAV Authentication}
! 150: \end{figure}
! 151:
! 152: \item Display the directory listing to move or copy one or more files or folders, or open a
! 153: single file.
! 154:
! 155: \begin{figure}
! 156: \begin{center}\includegraphics[width=0.30\paperwidth]{webdavwin7directory}\end{center}
! 157: \caption{Windows 7 WebDAV Directory Listing}
! 158: \end{figure}
! 159: \end{enumerate}
! 160:
! 161: \item Linux (e.g., CentOS)
! 162: \begin{enumerate}
! 163: \item From the Places item in the toolbar, select ``Connect to Server ...''.
! 164:
! 165: \begin{figure}
! 166: \begin{center}\includegraphics[width=0.30\paperwidth]{webdavcentosmenu}\end{center}
! 167: \caption{Linux (CentOS) Connect to Server}
! 168: \end{figure}
! 169:
! 170: \item In the dialog, select ``Secure WebDAV (HTTPS)'' as the service type, then enter
! 171: the hostname of the LON-CAPA library server in the Server textbox.
! 172: In the Folder textbox enter: webdav/ $<$dom$>$ / $<$ username $>$/ where dom is the domain,
! 173: and username is the username of the Authoring Space owner. In the User Name textbox enter
! 174: your username and click the ``Connect'' button.
! 175:
! 176: \begin{figure}
! 177: \begin{center}\includegraphics[width=0.30\paperwidth]{webdavcentosurl}\end{center}
! 178: \caption{Linux (CentOS) WebDAV URL}
! 179: \end{figure}
! 180:
! 181: \item You will be prompted to enter a username (this will be the LON-CAPA username
! 182: if the you are the author, or your LON-CAPA username:domain if you are a co-author)
! 183: and your LON-CAPA password.
! 184:
! 185: \begin{figure}
! 186: \begin{center}\includegraphics[width=0.30\paperwidth]{webdavcentosauth}\end{center}
! 187: \caption{Linux (CentOS) WebDAV Authentication}
! 188: \end{figure}
! 189:
! 190: \item Display the directory listing to move or copy one or more files or folders, or open a
! 191: single file.
! 192:
! 193: \begin{figure}
! 194: \begin{center}\includegraphics[width=0.30\paperwidth]{webdavcentosdirectory}\end{center}
! 195: \caption{Linux (CentOS) WebDAV Directory Listing}
! 196: \end{figure}
! 197:
! 198: \end{enumerate}
! 199: \end{itemize}
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>