Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
.gif "Hh973135.collapse(en-us,VS.110).gif")
.gif "Hh973135.expand(en-us,VS.110).gif")
.gif "Hh973135.copycode(en-us,VS.110).gif")
.gif "Hh973135.copycodeHighlight(en-us,VS.110).gif")
.gif "Hh973135.drpdown(en-us,VS.110).gif")
.gif "Hh973135.drpdown_orange(en-us,VS.110).gif")
| PreEmptive Analytics for TFS User Guide | |
| Installing the Exception Endpoint Role | |
| www.preemptive.com | |
Glossary Item Box
When installing the Exception Aggregator Role, a new database will be created in an instance of SQL Server to store exception report data and a new website will be created in IIS to contain the PreEmptive Analytics endpoint message & query services (which receive exception report messages from instrumented applications and provide access to stored messages). The installation must be started by a user with administrative access to the target instance of SQL Server so that the new database can be deployed. You will be asked to provide account credentials to be used as the Application Pool identity for the new endpoint services applications created in IIS, and you will choose whether to also use this account for Integrated Security authentication to the target instance of SQL Server, or whether to provide a login and password for use with SQL Authentication.
Exception Endpoint IIS Configuration
On this screen, you must specify the account name and password to be used as the IIS Application Pool identity for the PreEmptive Analytics endpoint services. If you choose to use Integrated Security for communication between the endpoint services and SQL Server, this account will also be granted permissions to log on to the target instance of SQL Server.
Next, you may specify the name of the IIS Application Pool that will be used to host the endpoint services and select the IIS Website into which the PreEmptive Analytics endpoint services will be installed. If the website already exists, the endpoint services applications will be added to the root of the website and its port binding will not be modified. If the website does not exist, it will be created and a binding will be added to listen on the port specified. You may also choose to specify the location on disk into which the PreEmptive Analytics program files will be installed, or you may leave the default selection.
Exception Endpoint SQL Configuration
On this screen, you may specify the hostname of the SQL Server instance in which a new database will be created to store exception report message data. You may also specify the name of the database to be used. Ensure that there is not an existing database with the same name on the selected instance of SQL Server.
Next, decide whether Integrated Security or SQL Authentication should be used for communication between the endpoint services and the SQL Server database. If using Integrated Security, the IIS Application Pool user account specified in the Exception Endpoint IIS Configuration screen will be used. Depending on your choice, the installer will create a new Integrated Security or SQL Authentication login on the target SQL Server instance if one does not exist, and the specified login will be granted permission to use the newly-created database.
Installation Complete
Upon successful installation, the installer will provide you with the URL of your exception message endpoint. You will need to provide this endpoint when using the Runtime Intelligence API or when instrumenting your applications for exception reporting with PreEmptive Dotfuscator or DashO. Instrumented applications must be able to access this endpoint, so you may need to adjust firewall settings to allow your target applications to send data to this endpoint. For more information about instrumenting your applications, see the Adding Exception Reporting to a .NET Application topic.
The installer will also provide you with the URL of your endpoint query service. An Exception Aggregator service running on another machine will communicate with this endpoint query service to retrieve exception data in order to create Incident work items. During the installation of the Exception Aggregator Role on the remote machine, you will be asked to provide this URL. For more information, see the Installing the Exception Aggregator Role topic.
See Also
Installing the Exception Aggregator Role
Adding Exception Reporting to a .NET Application
Adding Exception Reporting to a .NET Application
© 2012 PreEmptive Solutions. All rights reserved.