readme: moved signing instructions to Building from Source
Signed-off-by: Casey Bodley <cbodley@citi.umich.edu>
This commit is contained in:
parent
7acf94dd1b
commit
f8daa3704a
1 changed files with 15 additions and 11 deletions
26
README.html
26
README.html
|
|
@ -49,7 +49,7 @@
|
||||||
<ul><li>WinDDK does not include the ldap library, so we build the rpc library and nfs client daemon with Visual Studio 2010.</li></ul>
|
<ul><li>WinDDK does not include the ldap library, so we build the rpc library and nfs client daemon with Visual Studio 2010.</li></ul>
|
||||||
<ol>
|
<ol>
|
||||||
<li>Open Windows Explorer and navigate to <strong>ms-nfs41-client\build.vc10</strong>.</li>
|
<li>Open Windows Explorer and navigate to <strong>ms-nfs41-client\build.vc10</strong>.</li>
|
||||||
<li>Make a copy of <strong>env.props.example</strong>, and rename it to <strong>env.props</strong>.
|
<li>Make a copy of <strong>env.props.example</strong>, and rename it to <strong>env.props</strong>.</li>
|
||||||
<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 <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>Open the solution file <strong>ms-nfs41-client.sln</strong> in Visual Studio 2010.</li>
|
||||||
<li>Select the desired configuration and platform (accessible via Build->Configuration Manager).</li>
|
<li>Select the desired configuration and platform (accessible via Build->Configuration Manager).</li>
|
||||||
|
|
@ -60,23 +60,27 @@
|
||||||
<li>From the Start menu, open the WinDDK '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>
|
<li>Change directory to <strong>ms-nfs41-client</strong> and type <code>build</code>. All projects should build without errors.</li>
|
||||||
</ol>
|
</ol>
|
||||||
|
<h3>Signing the driver</h3>
|
||||||
|
<ol>
|
||||||
|
<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_driver nfs41_driver.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>):
|
||||||
|
<br/><code>> signtool sign /v /s PrivateCertStore /n nfs41_driver /t http://timestamp.verisign.com/scripts/timestamp.dll path\to\nfs41_driver.sys</code></li>
|
||||||
|
</ol>
|
||||||
<h2>2. <a name="install">Installing Binaries</a></h2>
|
<h2>2. <a name="install">Installing Binaries</a></h2>
|
||||||
<h3>Requirements</h3>
|
<h3>Requirements</h3>
|
||||||
<ul>
|
<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 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>ms-nfs41-client configuration files: <strong>nfs41_driver.cer</strong>, <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>
|
<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>
|
</ul>
|
||||||
<h3>Instructions</h3>
|
<h3>Instructions</h3>
|
||||||
<ol>
|
<ol>
|
||||||
<li>Copy or extract all ms-nfs41-client binaries and configuration files into a directory that's convenient for testing.</li>
|
<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 'Checked Build Environment' as Administrator in this directory (right click and 'Run as administrator').</li>
|
<li>Run <strong>vcredist_x*.exe</strong> to install the Visual C++ Redistributable Libraries.</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>):
|
<li>Double-click on <strong>nfs41_driver.cer</strong> and select 'Install Certificate', then place it in the 'Trusted Root Certificate Authorities' store.</li>
|
||||||
<br/><code>> makecert /pe /ss PrivateCertStore /n CN=nfs41_test nfs41_test.cer</code></li>
|
<li>Open a command prompt as Administrator in this directory.</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>):
|
|
||||||
<br/><code>> signtool sign /v /s PrivateCertStore /n nfs41_test /t http://timestamp.verisign.com/scripts/timestamp.dll nfs41_driver.sys</code></li>
|
|
||||||
<li>Install the certificate to the 'Trusted Root Certificate Authorities' store:
|
|
||||||
<br/><code>> certmgr /add /c nfs41_test.cer /s /r localMachine root</code></li>
|
|
||||||
<li>Install the driver and update the registry:
|
<li>Install the driver and update the registry:
|
||||||
<br/><code>> install.bat</code></li>
|
<br/><code>> install.bat</code></li>
|
||||||
<li>Copy configuration files:
|
<li>Copy configuration files:
|
||||||
|
|
@ -102,11 +106,11 @@
|
||||||
<ol>
|
<ol>
|
||||||
<li>From a Windows command prompt, run <strong>nfsd.exe</strong> to start the nfs client daemon. Leave this running in the background until all mapped drives are unmounted.
|
<li>From a Windows command prompt, run <strong>nfsd.exe</strong> to start the nfs client daemon. Leave this running in the background until all mapped drives are unmounted.
|
||||||
<br/>Usage:
|
<br/>Usage:
|
||||||
<br/><code>> nfsd.exe -d <debug level> [--noldap]</code></li>
|
<br/><code>> nfsd.exe -d <debug level> [--noldap]</code>
|
||||||
<ul>
|
<ul>
|
||||||
<li><code><debug level></code> determines the log verbosity (1, 2, 3 or 0 to disable)</li>
|
<li><code><debug level></code> determines the log verbosity (1, 2, 3 or 0 to disable)</li>
|
||||||
<li><code>--noldap</code> disables id mapping and uses a default uid=666 and gid=777</li>
|
<li><code>--noldap</code> disables id mapping and uses a default uid=666 and gid=777</li>
|
||||||
</ul>
|
</ul></li>
|
||||||
</ol>
|
</ol>
|
||||||
<h2>5. <a name="mount">Mounting</a></h2>
|
<h2>5. <a name="mount">Mounting</a></h2>
|
||||||
<h3>Instructions</h3>
|
<h3>Instructions</h3>
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue