# IT:AD:Node.JS:HowTo:Install IISNode Module #



<callout type="Navigation" class="small">

* [[../|(UP)]]
{{indexmenu>.#2|nsort tsort}}

* See also:
    * [[IT/AD/Node.JS/HowTo/Install common Node.JS Tools]]


</callout>


<panel title="Summary">

Use IISNode to install Node.JS in IIS.


</panel>


## Process ##


### Prerequisites
* Ensure Url-Rewrite extension to IIS is installed: [http://www.iis.net/downloads/microsoft/url-rewrite](http://www.iis.net/downloads/microsoft/url-rewrite)

![](https://dl.dropboxusercontent.com/u/11851202/Posted/IT/About/Node.JS:HowTo:Install%20and%20Use%20IISNode%20to%20use%20Node.JS%20within%20IIS/Url%20Rewrite.png)

### IISNode Installer

<WRAP important>
I found the install rather rough. Not exactly sure why it started working ...
</WRAP>

<WRAP important>
THe current IISNode no longer does the mistake that it used to -- namely that the the 64bit installer would look for node.js in the 64 bit path. It's no longer necessary, but know that the fix for that was to copy the whole c:\Program Files\NodeJS folder to the c:\Program Files (x64)\NodeJS folder. Then the installer would work.
</WRAP>

* Download x64 package of IISNode.
    * See: [https://github.com/tjanczuk/iisnode](https://github.com/tjanczuk/iisnode)
    * Package: https://github.com/tjanczuk/iisnode/wiki/iisnode-releases
* Install, but note that 20121022 ran into this error, where it was looking for 32bit version of Node.JS:

![](https://dl.dropbox.com/u/11851202/PUBLIC/SKYS/Posted/IT/About/Node.JS:HowTo:Install%20and%20Use%20IISNode%20to%20use%20Node.JS%20within%20IIS/00.png)


The first part of the work around (discussed in [this thread](https://github.com/tjanczuk/iisnode/issues/178) is to copy the Node.js files to the target dir to fool the installer)

Then have to read [here](https://github.com/tjanczuk/iisnode/blob/master/src/samples/configuration/web.config) regarding setting `nodeProcessCommandLine` to point to real direction.


### IISNode Module 

If you get past that, ensure the Module is installed:

![](https://dl.dropboxusercontent.com/u/11851202/Posted/IT/About/Node.JS:HowTo:Install%20and%20Use%20IISNode%20to%20use%20Node.JS%20within%20IIS/Installed%20IISNode.png)



### IISNode Default Web Site/Node samples website

Proceed with setting up samples, from the command prompt (in admin mode) call `%programfiles%\iisnode\setupsamples.bat`

![](https://dl.dropboxusercontent.com/u/11851202/Posted/IT/About/Node.JS:HowTo:Install%20and%20Use%20IISNode%20to%20use%20Node.JS%20within%20IIS/install%20iisnode%20samples.png)

Check that the website was created:

![](https://dl.dropboxusercontent.com/u/11851202/Posted/IT/About/Node.JS:HowTo:Install%20and%20Use%20IISNode%20to%20use%20Node.JS%20within%20IIS/iisnode%20default%20website.png)


then go check that `http://localhost/node` exists

### Samples

#### TroubleShooting
The first time I navigated to the samples website, from the server itself, I got:

![](https://dl.dropboxusercontent.com/u/11851202/Posted/IT/About/Node.JS:HowTo:Install%20and%20Use%20IISNode%20to%20use%20Node.JS%20within%20IIS/IISNode%20default%20website%20404.png)

Ah. Yes. Newly created sample app in an site I usually shut down. Simple enough to fix:

![](https://dl.dropboxusercontent.com/u/11851202/Posted/IT/About/Node.JS:HowTo:Install%20and%20Use%20IISNode%20to%20use%20Node.JS%20within%20IIS/IISNode%20default%20website%20404%20Fix.png)


#### Samples Index 

![](https://dl.dropboxusercontent.com/u/11851202/Posted/IT/About/Node.JS:HowTo:Install%20and%20Use%20IISNode%20to%20use%20Node.JS%20within%20IIS/iisnode%20samples%20index.png)


#### Hello World

Navigating to the fist sample I got:

![](https://dl.dropboxusercontent.com/u/11851202/Posted/IT/About/Node.JS:HowTo:Install%20and%20Use%20IISNode%20to%20use%20Node.JS%20within%20IIS/iisnode%20samples%20hello%20world.png)

but then I got:

![](https://dl.dropboxusercontent.com/u/11851202/Posted/IT/About/Node.JS:HowTo:Install%20and%20Use%20IISNode%20to%20use%20Node.JS%20within%20IIS/iisnode%20samples%20hello%20world%20handler%20error.png)

The error message simply leads to understanding that the web.config of the application has a web.config section to play with that gives a means to configure the IIS Module to know where to find node.js

![](https://dl.dropboxusercontent.com/u/11851202/Posted/IT/About/Node.JS:HowTo:Install%20and%20Use%20IISNode%20to%20use%20Node.JS%20within%20IIS/iisnode%20samples%20hello%20world%20config%20file%20location.png)


<sxh xml>
<configuration>
  <system.webServer>

    <handlers>
      <add name="iisnode" path="hello.js" verb="*" modules="iisnode" />
    </handlers>

    <iisnode
	  ...
      nodeProcessCommandLine="&quot;%programfiles%\nodejs\node.exe&quot;" 
      interceptor="&quot;%programfiles%\iisnode\interceptor.js&quot;"
	  ...
	/>

  </system.webServer>
</configuration>
</sxh>

But...unfortunately for me, it's right. It's pointing to:

![](https://dl.dropboxusercontent.com/u/11851202/Posted/IT/About/Node.JS:HowTo:Install%20and%20Use%20IISNode%20to%20use%20Node.JS%20within%20IIS/Troubleshooting_check_path.png)



#### Uninstall/Reinstall/Restart Server

Finally, 


![](https://dl.dropboxusercontent.com/u/11851202/Posted/IT/About/Node.JS:HowTo:Install%20and%20Use%20IISNode%20to%20use%20Node.JS%20within%20IIS/iisnode%20samples%20hello%20world%20works.png)

Yay.








## Resources ##
* Good early stuff: [http://weblogs.asp.net/jgalloway/archive/2011/10/26/using-node-js-in-an-asp-net-mvc-application-with-iisnode.aspx](http://weblogs.asp.net/jgalloway/archive/2011/10/26/using-node-js-in-an-asp-net-mvc-application-with-iisnode.aspx)
* [http://www.hanselman.com/blog/InstallingAndRunningNodejsApplicationsWithinIISOnWindowsAreYouMad.aspx](http://www.hanselman.com/blog/InstallingAndRunningNodejsApplicationsWithinIISOnWindowsAreYouMad.aspx)
    * Hum....not so hot at handling requests....(2.5 secs slower than IIS itself...)