|
|
Deployment |
|
To deploy a project using Select.Pdf HtmlToPdf Converter, simply include Select.HtmlToPdf.dll and Select.Html.dep along with your project. There are no additional setups or configurations needed either on your server or your client's machine.
Select.Html.dep needs to be deployed in the same folder with Select.HtmlToPdf.dll. Alternatively, the path to Select.Html.dep can be specified using the HtmlEngineFullPath property of the GlobalProperties class.
If Blink rendering engine is used (only works with the .NET Core version and with .NET Framework 4.6.1 or above), Blink binaries (full Chromium folder) also need to be deployed.
If the Chromium rendering engine is used, the Chromium runtime folder installed by the matching Chromium.Windows Nuget package must also be deployed alongside the application. When the project references the Chromium.Windows package, MSBuild places that folder in the application output directory automatically at build time, so a standard publish operation picks it up. See Chromium Engine for details.
 Important |
|---|
|
Full trust is required on the deployment machine. SelectPdf.Pdf makes numerous native API calls, thus it requires full trust to run. |
GAC Installation
If you plan to install Select.Pdf into GAC, the only dll that needs to be added to GAC is Select.HtmlToPdf.dll. The related file (Select.Html.dep) will be automatically copied to GAC as a linked resource, so no additional action is needed for it.
Deployment to a Shared Hosting Environment
If you plan to deploy Select.Pdf Html To Pdf Converter to a shared hosting environment, please check with your hosting company whether they support full trust. SelectPdf.Pdf makes numerous native API calls, thus it requires full trust to run. If your hosting company cannot grant full trust to your site, you may need to consider moving your site to a dedicated or virtual server.
Deployment to Windows Azure
If you plan to deploy Select.Pdf Html To Pdf Converter to Windows Azure, make sure you deploy to a Cloud Service or a Virtual Machine. Due to some security restrictions, Select.Pdf does not support Windows Azure WebSite execution mode. To resolve the issue, you can either deploy your site to a Cloud Service or a Virtual Machine, or isolate the PDF related feature into a separate Web Service that runs on a different server (either on a Windows Azure Cloud Service/Virtual Machine, or a dedicated server hosted elsewhere), then call the web service from your Windows Azure WebSite.
Update: Starting with version 18.3, SelectPdf supports Microsoft Azure Web Apps (Basic plan or above) with some limitations. More details here: Deployment to Microsoft Azure.
Update: Starting with version 26.2, Select.HtmlToPdf also supports Microsoft Azure Web Apps (Basic plan or above) using the Chromium rendering engine, with the full feature set. See Chromium Engine for how to install and select the Chromium engine, and Deployment to Microsoft Azure for the full Azure deployment discussion.
See Also