Bin-deploy an ASP.NET assembly on Cloud Sites
On the ASP.NET platform, it's common to use a third-party assembly to provide access to features from your code that you find useful but that might not be available from the .NET framework. To do this, you deploy the assembly to the Bin directory, which is the reserved location in your application directory for assemblies. Then, you update your web.config file to load this assembly for use on your website. This process is commonly known as bin-deploying an assembly, or binary deployment.
Read the following sections to learn how to bin-deploy an assembly:
- Get started
- Obtain the assembly
- Upload the assembly
- Load the assembly in the web.config file
- Use the assembly
- You must have an existing Cloud Sites website. If you do not have one, see Adding a new website.
- IIS and ASP.NET should be the default technology on the site or should, at a minimum, be enabled on this site.
- The Rackspace cloud uses a modified medium trust configuration. To function correctly, the assembly must allow partially trusted callers. If you do not know whether the assembly will work in medium trust, contact the vendor.
- After confirming that the assembly does work in medium trust, continue to Get started.
- If you have a list of requirements for the assembly, contact Support to confirm whether the requirements are met.
- Any assembly requiring full trust is not supported at this time.
To get started, you must obtain the assembly that you want to bin deploy. As an example, the instructions in this article bin-deploy UrlRewriter.NET, a URL rewriter for ASP.NET applications that do not have the URL Rewrite Module installed.
Obtain the assembly
The following steps use UrlRewriter.NET. Substitute with the assembly that you want to deploy.
- Go to http://www.urlrewriter.net/.
- Click the Download tab, and then click the source code link to download the binaries and source code.
- Select one of the binary files, which is typically the first link under Newest Files.
The most recent binary file at the time this article was written was UrlRewriterNet-1_8.zip.
- If the download doesn't start within a few seconds, click the direct link.
- Save the file to your computer.
- Extract the Intelligencia.UrlRewriter.dll file.
Upload the assembly
To use the assembly from your website code, the module must be located in the Bin directory on your FTP server, which is the standard location for bin-deploying assemblies. Following the example, to bin-deploy Intelligencia.UrlRewriter.dll, connect to your website's FTP server and upload the DLL file to the following directory (www.example.com is your website name):
Load the assembly in the web.config file
Some assemblies require different definitions in the web.config file to work correctly. The best way to learn how to load an assembly is to consult the vendor's website. In this example, we are bin-deploying Intelligencia.UrlRewriter.dll, so we consulted the vendor's website and found a help document that explains the configuration. Using this information, you could load UrlRewriter.NET by using the following example web.config configuration:
<?xml version="1.0" encoding="UTF-8"?> <configuration> <configSections> <section name="rewriter" requirePermission="false" type="Intelligencia.UrlRewriter.Configuration.RewriterConfigurationSectionHandler, Intelligencia.UrlRewriter" /> </configSections> <system.web> <httpModules> <add name="UrlRewriter" type="Intelligencia.UrlRewriter.RewriterHttpModule, Intelligencia.UrlRewriter" /> </httpModules> </system.web> <system.webServer> <modules runAllManagedModulesForAllRequests="true"> <add name="UrlRewriter" type="Intelligencia.UrlRewriter.RewriterHttpModule" /> </modules> <validation validateIntegratedModeConfiguration="false" /> </system.webServer> </configuration>
Use the assembly
Because of the vast amount of assemblies that can be bin-deployed, it's impossible to cover usage of them in this article. As with loading the assembly, the best way to learn how to use an assembly is to consult the vendor's website. To learn how to use the Intelligencia.UrlRewriter.dll used in this example, see the article on URL rewriting in ASP.NET.
© 2015 Rackspace US, Inc.
Except where otherwise noted, content on this site is licensed under a Creative Commons Attribution-NonCommercial-NoDerivs 3.0 Unported License
See license specifics and DISCLAIMER