readme: added vc2010 library dependency, updated known issues
removed indications that the x86 build is untested under Installing Binaries, added requirement for visual c++ libraries removed known issue for AUTH_SYS and multiple users Signed-off-by: Casey Bodley <cbodley@citi.umich.edu>
This commit is contained in:
parent
4c52473527
commit
945d94cc4e
1 changed files with 9 additions and 9 deletions
18
README.html
18
README.html
|
|
@ -27,8 +27,8 @@
|
|||
<div id="content">
|
||||
<div id="index">
|
||||
<ol>
|
||||
<li><a href="#build">Building</a></li>
|
||||
<li><a href="#install">Installation</a></li>
|
||||
<li><a href="#build">Building from Source</a></li>
|
||||
<li><a href="#install">Installing Binaries</a></li>
|
||||
<li><a href="#ldap">Ldap Configuration</a></li>
|
||||
<li><a href="#startup">Starting the Client</a></li>
|
||||
<li><a href="#mount">Mounting</a></li>
|
||||
|
|
@ -36,10 +36,10 @@
|
|||
<li><a href="#issues">Known Issues</a></li>
|
||||
</ol>
|
||||
</div>
|
||||
<h2>1. <a name="build">Building</a></h2>
|
||||
<h2>1. <a name="build">Building from Source</a></h2>
|
||||
<h3>Requirements</h3>
|
||||
<ul>
|
||||
<li>Windows Vista x64, Windows Server 2008 R2 x64, or Windows 7 x64. (Windows XP and previous versions are not supported. 32-bit builds have not been tested.)</li>
|
||||
<li>Windows Vista, Windows Server 2008 R2, or Windows 7 (Windows XP and previous versions are not supported)</li>
|
||||
<li>Microsoft Visual Studio 2010</li>
|
||||
<li>Windows Driver Development Kit (WinDDK 6000 or later)</li>
|
||||
<li>ms-nfs41-client source code:
|
||||
|
|
@ -52,24 +52,25 @@
|
|||
<li>Make a copy of <strong>env.props.example</strong>, and rename it to <strong>env.props</strong>.
|
||||
<li>Open <strong>env.props</strong> in a text editor, and verify that the value in <code><WDKPATH>C:\WinDDK\7600.16385.0</WDKPATH></code> points to your WinDDK installation.</li>
|
||||
<li>Open the solution file <strong>ms-nfs41-client.sln</strong> in Visual Studio 2010.</li>
|
||||
<li>Select the Debug configuration and x64 platform (accessible via Build->Configuration Manager).</li>
|
||||
<li>Select the desired configuration and platform (accessible via Build->Configuration Manager).</li>
|
||||
<li>Right-click on the <strong>daemon</strong> project and select Build. The project and its dependencies should build without errors. The resulting binaries, <strong>nfsd.exe</strong> and <strong>libtirpc.dll</strong>, can be found under <strong>ms-nfs41-client\build.vc10\x64\Debug\</strong>.</li>
|
||||
</ol>
|
||||
<h3>Building the driver and utilities</h3>
|
||||
<ol>
|
||||
<li>From the Start menu, open the WinDDK 'x64 Checked Build Environment' for the target platform.</li>
|
||||
<li>From the Start menu, open the WinDDK 'Checked Build Environment' for the target platform.</li>
|
||||
<li>Change directory to <strong>ms-nfs41-client</strong> and type <code>build</code>. All projects should build without errors.</li>
|
||||
</ol>
|
||||
<h2>2. <a name="install">Installation</a></h2>
|
||||
<h2>2. <a name="install">Installing Binaries</a></h2>
|
||||
<h3>Requirements</h3>
|
||||
<ul>
|
||||
<li>ms-nfs41-client binaries: <strong>nfs41_driver.sys</strong>, <strong>nfs41_np.dll</strong>, <strong>libtirpc.dll</strong>, <strong>nfs_install.exe</strong>, <strong>nfsd.exe</strong>, <strong>nfs_mount.exe</strong></li>
|
||||
<li>ms-nfs41-client configuration files: <strong>nfs41rdr.inf</strong>, <strong>install.bat</strong>, <strong>uninstall.bat</strong>, <strong>etc_netconfig</strong>, <strong>ms-nfs41-idmap.conf</strong></li>
|
||||
<li>Microsoft Visual Studio 2010, or Microsoft Visual C++ 2010 Redistributable Libraries (<a href="https://www.microsoft.com/download/en/details.aspx?id=8328">x86</a> or <a href="https://www.microsoft.com/download/en/details.aspx?id=13523">x64</a>). An installer for the redistributable libraries are included with binary releases.</li>
|
||||
</ul>
|
||||
<h3>Instructions</h3>
|
||||
<ol>
|
||||
<li>Copy or extract all ms-nfs41-client binaries and configuration files into a directory that's convenient for testing.</li>
|
||||
<li>Open a WinDDK 'x64 Checked Build Environment' as Administrator in this directory (right click and 'Run as administrator').</li>
|
||||
<li>Open a WinDDK 'Checked Build Environment' as Administrator in this directory (right click and 'Run as administrator').</li>
|
||||
<li>Create a certificate for test-signing the driver (<a href="http://msdn.microsoft.com/en-us/library/ff540213%28VS.85%29.aspx" title="msdn.microsoft.com">Creating Test Certificates</a>):
|
||||
<br/><code>> makecert /pe /ss PrivateCertStore /n CN=nfs41_test nfs41_test.cer</code></li>
|
||||
<li>Use the certificate to sign <strong>nfs41_driver.sys</strong> (<a href="http://msdn.microsoft.com/en-us/library/ff553467%28VS.85%29.aspx" title="msdn.microsoft.com">Test-Signing a Driver File</a>):
|
||||
|
|
@ -141,7 +142,6 @@
|
|||
</ol>
|
||||
<h2>7. <a name="issues">Known Issues</a></h2>
|
||||
<ul>
|
||||
<li>AUTH_SYS does not handle multiple users, so all operations are sent as the user that established the mount.</li>
|
||||
<li>krb5p security has only been tested with DES, as the linux server does not support gss krb5 v2 tokens with rotated data.</li>
|
||||
<li>When recovering opens and locks outside of the server's grace period, client does not check whether the file has been modified by another client.</li>
|
||||
<li>If nfsd.exe is restarted while a drive is mapped, that drive needs to be remounted before further use.</li>
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue