<?xml version="1.0" encoding="ISO-8859-1"?>

<document>

  <properties>
        <author email="cstaylor@nanshu.com">Christopher Taylor</author>
        <title>Connecting with Windows XP</title>
    </properties>
  
  <body>
    
  <section name="Connecting to Windows XP using My Network Places">
    
    <p>
      Microsoft Windows XP supports mounting WebDAV folders through it's <b>My Network Places</b> applet.  This HOWTO will walk you through connecting to a Slide share from Windows XP.
    </p>
    
    <p>
      First, click the <b>Start</b> button on the Windows Taskbar, then select the <b>My Network Places</b> item:
    </p>
    <p><img src="images/start-menu.png" />
    </p>
    <p>
      A new window should appear.  Select the <b>Add a network place</b> from the <b>Network Tasks</b> area on the left-hand side of the window:
    </p>
    <p>
        <img src="images/my-network-places.png" />
    </p>
    <p>
      The <b>Add Network Place Wizard</b> screen should appear.  Press the <b>Next</b> button:
    </p>
    <p>
        <img src="images/add-network-place-wizard-start.png" />
    </p>
    <p>
      From this new list pick <b>Choose another network location</b> and press the <b>Next</b> button:
    </p>
    <p>
        <img src="images/add-network-place-wizard-choose.png" />
    </p>
    <p>
      Now you'll input the URL to your Slide server.  On my machine, the Tomcat Context path is <code>/Test Slide</code>, but it may be different on your machine.  Press <b>Next</b>:
    </p>
    <p>
        <img src="images/add-network-place-wizard-url.png" />
    </p>
    <p>
      Finally, you'll need to authenticate yourself to the Slide server.  The default username and password for administrative access is <code>root/root</code>.  If you select <b>Remember my password</b>,
      you'll never have to enter it again when connecting to the server.
    </p>
    <p>
        <img src="images/add-network-place-wizard-auth.png" />
    </p>
    <p>
      If you cannot authenticate, there's an issue with the default <code>web.xml</code> file that comes with Slide version 1.0.16.  In that file, there is an <code>auth constraint</code> for three roles:
      <br />
      <code>&lt;auth-constraint&gt;<br />
      &lt;role-name&gt;root&lt;/role-name&gt;<br />
      &lt;role-name&gt;guest&lt;/role-name&gt;<br />
      <b>&lt;role-name&gt;user&lt;/role-name&gt;<br /></b>
      &lt;/auth-constraint&gt;<br /></code>
      The <code>user</code> role is not defined by default in the <code>TOMCAT_HOME/conf/tomcat-users.xml</code> file.  While a regular web browser will authenticate without any trouble, Microsoft Web Folders fails to
      login for some reason (I haven't looked at that code in great detail, so it may be a bug in Slide).  There are two solutions:
      <ol>
      <li>Add a new role to the <code>tomcat-users.xml</code> file</li>
      <li>Remove the <code>role-name</code> element for the <code>user</code> role from the <code>web.xml</code> file</li>
      </ol>
      I chose the second option.
    </p>
    <p>
        After you successfully authenticate yourself to the Slide server, a new window should appear:
    </p>
    <p>
        <img src="images/add-network-place-wizard-finish.png" />
    </p>
    <p>
        This name is simply for your convenience, so you can label it whatever you like.  The default name is fine for me.  Press <b>Next</b> to return to the <b>My Network Places</b> window:
    </p>
    <p>
        <img src="images/my-network-places-finished.png" />
    </p>
    <p>
        To start viewing files provided by Slide, double-click on the new Network Place.  You should see the following window appear:
    </p>
    <p>
        <img src="images/navigating.png" />
    </p>
    <p>
        The area marked <b>1</b> is the current URL.  As you navigate the site, this value will update to the matching node in the Slide structure you are viewing.  The area marked <b>2</b> shows the
        current child nodes of the parent node named in <b>1</b>.  You can select these child nodes and navigate through them just like you would with a regular disk.
    </p>
</section>
</body>
</document>
