macdevcenter.com
oreilly.comSafari Books Online.Conferences.

advertisement

AddThis Social Bookmark Button WebDAV on OS X

by Rael Dornfest
11/10/2000

Related:

OS X Brings Unix Stability to the Mac

Mac OS X Terms and Definitions

Macintosh News - from Meerkat


Previous Features

WebDAV support in Mac OS X (Public Beta 1) allows for simple remote management of Web content.

WebDAV, or "Web-based Distributed Authoring and Versioning," is a set of extensions to HTTP/1.1 ("HyperText Transfer Protocol," the protocol spoken by Web browsers and servers) allowing you to edit documents on a remote Web server. DAV provides support for:

  • Editing: creating, updating, deleting
  • Properties: title, author, publication date, etc.
  • Collections: analagous to a filesystem's directory or desktop folder
  • Locking: prevents the confusion and data corruption caused by two (or more) people editing the same content at the same time

DAV accomplishes this by adding to HTTP's standard GET and POST request types: DELETE, PROPFIND, PROPPATCH, MKCOL, COPY, MOVE, LOCK, UNLOCK, etc.

WebDAV is platform independent, both in terms of client and server. This means that Macintosh, *nix, and Windows users can collaborate on Web content without all the usual conversion problems. Furthermore, it doesn't matter whether your documents are hosted on an Apache or Microsoft IIS server.

WebDAV is software agnostic. As long as your Web authoring tools are DAV compliant, it makes little difference which particular product you're using. More and more products are either already supporting or planning to support WebDAV. Microsoft's "Web Folders" are folders that for all intents and purposes appear to be on your local machine but are actually network connections to a remote server. Macintosh users have Goliath, an open source Finder-like application. WebDrive, a commercial application for Windows, provides three ways to connect to remote servers, via WebDAV, FTP, and Microsoft FrontPage's extensions.

WebDAV is (at least, should be) seamless. Because DAV is simply a set of extensions to HTTP, it's rather easy for companies to build support into any product that already "understands" the Web. And since DAV rides on top of HTTP, firewalls tend not to get in the way of accessing your Web content remotely. Of course, one should be sure to secure content by way of HTTP's existing authentication and authorization systems.

WebDAV on OS X

Mac OS X has support for WebDAV built right into the operating system and integrated seamlessly into the desktop environment. Simply point to a server, log in, and bingo!, you've a new virtual drive right on your desktop. It's even accessible at the Darwin *nix command prompt as just another directory.

Thankfully, OS X (Public Beta 1) also ships with a DAV-enabled copy of the famous Apache Web server, providing us with a nice simple test environment in which to explore WebDAV. Alright, so perhaps "capable" is more accurate than "enabled." The version of Apache shipping with OS X includes everything you need to use WebDAV; it only needs a little enabling. So let's do that first, shall we...

Enabling and configuring mod_dav

Greg Stein's wonderful mod_dav module is responsible for Apache's understanding of WebDAV. Enabling DAV in Mac OS X's Apache is simply a matter of editing the configuration file, apache.conf (yes, that's httpd.conf to everyone else in the universe ;-)) to activate and take advantage of the mod_dav module's functionality.

The Macintosh News Network has a nice posting by Tom Bednarz on enabling DAV on Mac OS X's Apache. I'll leave you to his instructions, at http://osx.macnn.com/features/webdav.phtml, and meet you at the other end.

Note: In Step 2 of his instructions, Tom doesn't mention that you'll need to become the superuser ("root") in order to be able to edit the apache.conf configuration file. The easiest way I found to accomplish this without making you use one of the sometimes confusing terminal-based text editors is as follows:

  1. Open the Terminal application to gain access to Mac OS X's command-line.

    Screen shot of terminal application.

    Screen shot of terminal application.


    1. Click on the smiley-mac Desktop icon at the left of the Dock at the bottom of your desktop. The Finder window should appear.

    2. Click the Apps button at the top of the Finder window. If the toolbar isn't there, turn it on by holding down the Apple/Command key and hitting b on your keyboard.

    3. Double-click Utilities.

    4. Double-click Terminal. The dreaded command-line window appears :-\.

  2. Become the root user by typing su and hitting the return key on your keyboard, followed by (unless you've changed it) the password you used to log into Mac OS X, and hit the return key again. You'll notice the prompt change from % to #.

    [darwin:~] charles% su
    Password:
    [darwin:/Users/charles] root#
  3. Edit the apache.conf using the handy GUI TextEdit application by typing:

    /Applications/TextEdit.app/Contents/MacOS/TextEdit
    /Library/WebServer/Configuration/apache.conf

    at the command prompt. (This should all be on one line, not split as shown above for presentation purposes)

  4. TextEdit appears with the contents of apache.conf in the editing window. Edit as advised by http://osx.macnn.com/features/webdav.phtml, save your changes with Apple/Command-s and close TextEdit with Apple/Command-q when finished.

  5. Be sure to un-root yourself by typing exit at the command line prompt. To close the Terminal window, type exit again (this time as yourself), and Apple/Command-q to close the application.

You're back! You should now have a Web server running on your desktop/laptop with WebDAV support. The bits in your apache.conf file should look like:

LoadModule dav_module /System/Library/Apache/Modules/libdav.so
...
AddModule mod_dav.c
...
DAVLockDB /Library/WebServer/davlocks/DAVLockDB
<Directory "/Library/WebServer/Documents">
DAV on

A note on security

Of course, since we've not taken any security measures in our configuration file, your Documents directory is open for all to manipulate. You can limit access to your choice of a set of DAV functions by user, group, host, etc. Some common authentication and authorization methods are presented by Greg Stein at http://www.webdav.org/mod_dav/install.html#apache.

Also, in order for you to be able to write to the local server, you'll have to make sure that your Documents directory is writeable by the Web server user, www. Without access restrictions in place, this is not advisable -- you'll therefore not be able to make any changes to your content as we have things currently configured.

Connecting to a WebDAV server

Now for the fun bit! Although it doesn't seem all that dramatic since we're only connecting to our local machine, just imagine that the server you're connecting to is halfway 'round the world from you -- the concept and method is the same.

  1. Click anywhere on your desktop to bring up the Desktop context menubar at the top of the screen.

  2. From the Go menu, select Connect to Server.... Surprisingly enough, the Connect to Server window appears.

  3. Select Web Servers from the pull-down menu at the top-left of the window.

  4. In the URL box, type http://localhost/ and click the Connect button.

    Screenshot of connect dialog box

    The connect dialog box.

    Note: Had you limited access by user or group, you'd have been presented with a login dialog box, shown below.

    Screenshot of login dialog box.

    The login dialog box appears if you limited access by user or group.

After a second or three, a Finder window will appear with a view on "localhost," your new networked drive. An icon for same will also appear on the desktop.

Screenshot of Finder window.

Finder window with view on localhost.

You can browse around, add, update, and delete anything for which you have permission to do so, just as on any local drive. For a tad more fun, use the Terminal application to meander about "localhost."

Screen shot of listing localhost in Terminal.

You can use Terminal to view "localhost."

Disconnecting from a WebDAV server

It was immediately apparent to me how to unmount a networked disk. Logging out and back in again, and dragging the "localhost" icon to the wastepaper basket in the Dock did the trick -- albeit a little silly. Mac Help ... didn't!

Worms in OS X's DAV

There are still a few wobbly bits in Mac OS X's WebDAV support (as with the rest of the OS), but these are mostly on the annoying rather than BAD side.

Resources

The following is a list of starting points from which to explore further some of the topics covered (or not) in this article.

WebDAV.org

Test/Free WebDAV Servers

DAV Specifications

"HTTP Extensions for Distributed Authoring -- WEBDAV", IETF RFC 2518, Standards Track, Proposed Standard. February, 1999.

Apache mod_dav Module

  • Limiting access by user or group on the local Apache WebDAV server seems to send the Connect to Server... functionality into a spin. I actually had to reboot my laptop with a paperclip since everything came to a standstill.

  • Disconnecting, as I mentioned above, is not particularly obvious. Dragging "localhost" to the trash produced a "The operation could not be completed because the disk is in use" warning despite the fact that it wasn't (in use, I mean). Donning my *nix hat and unmounting the drive from the command-line produced the same error. Using -f to force an unmount did the trick from the command-line, but left an unusable drive icon on the desktop.

Rael Dornfest is Founder and CEO of Portland, Oregon-based Values of n. Rael leads the Values of n charge with passion, unearthly creativity, and a repertoire of puns and jokes — some of which are actually good. Prior to founding Values of n, he was O'Reilly's Chief Technical Officer, program chair for the O'Reilly Emerging Technology Conference (which he continues to chair), series editor of the bestselling Hacks book series, and instigator of O'Reilly's Rough Cuts early access program. He built Meerkat, the first web-based feed aggregator, was champion and co-author of the RSS 1.0 specification, and has written and contributed to six O'Reilly books. Rael's programmatic pride and joy is the nimble, open source blogging application Blosxom, the principles of which you'll find in the Values of n philosophy and embodied in Stikkit: Little yellow notes that think.


Related:

OS X Brings Unix Stability to the Mac

Mac OS X Terms and Definitions

Macintosh News - from Meerkat


Discuss this article in the O'Reilly Network Forum.

Return to the O'Reilly Network..