Getting Started

StackHash is a client/server application that synchronizes products, events, hits and cabs from your WinQual account to a local database and then helps you prioritize, analyze, fix and respond to crash and hang reports for your Windows software.

If you're new to WinQual review our guide to the service: Getting Started With WinQual For Windows Error Reporting (WER). This covers prerequisites for post-mortem crash dump analysis including setting up a symbol server, source indexing, product mapping and debugger configuration. The guide also explains how to obtain and use a WinQual account.

Email and telephone support is available at http://www.stackhash.com/Support.aspx. We're here to help. Please get in touch if you have any questions or problems. To suggest and vote on new features visit our feedback forum at http://feedback.stackhash.com/.

Get product updates, news and tips on StackHash, WinQual and WER by subscribing to our blog, following @StackHash on twitter and becoming a fan on Facebook. Videos demonstrating various capabilities of StackHash are available on our YouTube channel.

If you're connecting to an existing StackHash install skip ahead to StackHash Client below.

StackHash Service

Supported Platforms: Windows Vista SP2, Windows 7, Windows Server 2008 SP2, Windows Server 2008 R2.

To configure StackHash run the StackHash Client on the same computer as the StackHash Service. The first time you run StackHash the Setup Wizard will guide you through creating a Profile. To edit, delete or add a profile use Service Options from the Tools menu.

Before configuring StackHash for the first time we recommend installing the Debugging Tools for Windows as the Scripting feature of StackHash requires cdb.exe (the command line debugger installed with the tools). On a 64-bit OS install both the 32-bit and 64-bit versions of the tools.

StackHash stores WinQual data in a SQL Server 2005 or 2008 database. A folder is used to store downloaded cab files. We recommend running a dedicated StackHash Server on a supported 64-bit OS which includes StackHash, the database and the cab folder. It is also possible for each of these components to be on a different computer and to run the StackHash Service on a 32-bit OS.

The StackHash Service is a Windows service that runs under the NETWORK SERVICE account by default. This means that NETWORK SERVICE must have read/write permission to access the database and cab folder. You can use the Services control panel applet to change the StackHash service account if necessary (this is not recommended, if you do change the account it must have administrator privileges).

There are three database configuration options for the StackHash Service:

  1. During configuration StackHash can download and install SQL Server 2008 R2 Express Edition with the recommended settings. This is the easiest way to get started with StackHash.
  2. You can create a new database for StackHash on an existing local install of SQL Server 2005 or 2008. In this case the StackHash Service account, NETWORK SERVICE by default, must be granted the sysadmin role for the database.
  3. You can create a new database for StackHash on a remote install of SQL Server 2005 or 2008. SQL scripts to create and upgrade the StackHash database are installed with the product.

See StackHash Database Configuration Tool for detailed instructions if you're planning to use an existing local or remote install of SQL Server.

To help you comply with the WinQual terms and conditions the StackHash Service periodically purges old cab files while retaining product, event and hit data. The default retention policy for cab files is 180 days. The WinQual site only stores data for 90 days so over time StackHash will provide a valuable archive of historical crash data that allows you to compare product quality between releases.

The StackHash Service uses the Windows Live Sign-In Assistant to access WinQual. The StackHash installer will prompt you if this component is missing. If you skipped this step synchronization will fail with a message asking you to install it.

StackHash Client

Supported Platforms: Windows XP SP3, Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008.

When you run the StackHash Client for the first time the Setup Wizard will guide you through connecting to the StackHash Service and choosing a Profile to work with. You can change the connection and profile later using Client Options from the Tools menu.

StackHash uses Windows authentication to connect to the StackHash Service. In a workgroup environment you have two authentication options:

  1. Create an account on the computer running the StackHash Service for each computer running the StackHash Client. The username and password for each account must match exactly.
  2. Create one account on the computer running the StackHash Service to use for client connections. Enter the account details in Service Credentials (on the first page of the Setup Wizard or in Client Options) on each StackHash Client.

If you are attempting to connect via a Firewall or NAT note that the port forwarded to the StackHash Service must not be changed. For example a mapping of firewall.mycorp.com:9000 to stackhashhost:9000 will work (assuming that you are using the default StackHash Service port). firewall.mycorp.corp:1234 to stackhashhost:9000 will not work.

StackHash | © Copyright Cucku, Inc and the stackhash.codeplex.com contributors.