Follow this guide to deploy ActiveReports Web projects to your Web server. For Web projects using the Professional Edition HttpHandlers, see Configure HTTPHandlers in IIS 6 or Configure HTTPHandlers in IIS 7 and IIS 8.
Before you begin
To deploy ActiveReports Web projects, you must have access to the Microsoft .NET Framework version 3.5 SP1 or higher and the coordinating version of ASP.NET. You must also have access to Internet Information Services version 5.1 or higher, and you need administrative access to the server.
It is also good to be sure that all of the references you need for your reports are included. Here is a table listing features and required DLLs.
Features and References
These assemblies are added automatically when you add controls to forms or report controls to code-based section reports, but Visual Studio does not do this with XML-based (RPX and RDLX) reports.
Feature |
Required Assembly |
Export:
Excel, Html, Image/Tiff, Pdf, Word/Rtf, Text/Xml |
GrapeCity.ActiveReports.Export.*.v8.dll
(replace * with Excel, Html, Image, Pdf, Word, or Xml) |
Chart report control |
GrapeCity.ActiveReports.Chart.v8.dll |
Calendar report control |
GrapeCity.ActiveReports.Calendar.v8.dll |
Sparkline or Bullet report control |
GrapeCity.ActiveReports.Dashboard.v8.dll |
WebViewer, HTML5 viewer or HttpHandlers (Pro Edition only) |
GrapeCity.ActiveReports.Web.v8.dll |
To copy referenced DLLs to your project
- In the Visual Studio Solution Explorer, if the References node is not showing, click the Show All Files button.
- Expand the References node, and select one of the ActiveReports references.
- In the Properties window, change the CopyLocal property to True. The corresponding DLL is stored in the Bin folder of your project.
- Set the CopyLocal property to True for each ActiveReports reference used in your project.
To install prerequisites on the server
Follow Microsoft's instructions to install each of the following on your Web server:
- The Microsoft .NET Framework version 3.5 SP1 or higher
- Internet Information Services (IIS) version 5.1 or 6.0
- ASP.NET version 3.5 or higher (must be the same version as the Framework)
To copy your project to the server
- Copy the entire directory containing your project to the server.
- If your project is in a virtual directory on your local machine (i.e. C:\Inetpub\wwwroot\YourProject), you must set up a virtual directory in IIS on the server as well.
To set permissions on the server
Depending on your project, you may need to set permissions to allow ActiveReports access to data or folders.
Some examples of required permissions on the server:
- If you are saving files (e.g. PDF or RDF exports) to a folder on Windows XP or 2000 machines, the ASPNET user ID needs Write access to that folder.
- Windows 2003 is user configurable, so use the name assigned to the ASPNET user instead.
- If your application reads anything from any folder, assign Read access to it.
- If your reports run on any networked data source (e.g. SQL, Access, etc.) assign Read access to it.
- If you use CacheToDisk, assign IsolatedStorageFilePermission to it.
See Also