I was wondering if you had a step-by-step setup guide for installing Kiln 1.0, 1.1, or 1.2 on my own server.
See "How Do I install Kiln 2.x?" for Kiln 2 installation.
Every licensed Kiln customer can download an installer which has a wizard to help guide you through the various steps needed to get Kiln running on your server. For the vast majority of customers, the defaults we've selected will be your best bet for a successful installation.
This document has a few sections:
1. System Requirements
Kiln supports a narrow range of systems at the moment. Make sure you're installing on a system that meets these requirements because we can't support anything else right now (sorry!).
Windows 2003 and 2008 server
Microsoft SQL Server 2005, MSSQL 2008, and SQL Server Express 2008
2. Before You Begin
Just a few things that we wanted to let you know before you begin the installation process:
3. Installer Walk-through
The easy one. Just click
Kiln uses parts of FogBugz, specifically the authentication bits. This step either links the Kiln installation to an existing FogBugz installation on this machine, or allows you to install the core FogBugz components needed to get Kiln running. If you want fully integrated Kiln and FogBugz, they must be installed on the same server.
Kiln Storage Service
The Kiln storage service manages the Mercurial repositories that you create while using Kiln. We strongly recommend that you install the Storage Service on the same machine as the Kiln front end. It is slightly more secure, and it reduces complexity which makes managing your Kiln installation easier.
Kiln uses SQL server to store meta data about your code and code reviews. Basically, it's what we use to make the Kiln web front end work. Your code isn't stored here. You can choose any SQL Server 2005/2008 or SQL Express 2008 instance. If you don't have one available, Kiln can install and configure a SQL Express instance for you.
The Web Platform Installer
You'll see some instructions in the installer about this, but it worth breaking them out here. Once the initial configuration is complete, the web platform installer will:
Kiln & Prereqs
The defaults here are all correct, so all you need to do is click
The FogBugz Installer
If you've ever installed FogBugz, you will recognize the installer and probably realize that it is seriously shortened. The only critical thing here is setting up the FogBugz user. The web components and system services for both Kiln and FogBugz will run as this user. It is also used to connect to the SQL database. If SQL Server is on a different machine, you will want to make this a domain user.
Kiln Storage Service Installer
This installer asks for some very basic information about where you want to install it, and where you want it to store your Mercurial repositories. Mercurial is very efficient about how it uses storage, but you will want to make sure you put your repository directory in a place with plenty of available disk space (10GB minimum, likely more).
Login to Kiln, and enter your licenses
For the duration of the beta, a 100 user license will come pre-installed with Kiln. After that, this step will take you through the normal licenses installation procedure. If you already had FogBugz, you will need to log on to Kiln with a FogBugz administrator account and enter your Kiln licences on the
4. Advanced Instructions
If you've gotten this far you've already mastered Windows permissions entanglement theory. That's not advanced enough for you?
Using Mixed-Mode authentication to connect to the Kiln database. You needed to run the installer as a user with administrator permissions on the database. After Kiln is installed, you can change the connection string in the web.config file to use a specific database user, rather than a Windows user. The database user will need to be an administrator for the Kiln database. Just replace
This section will continue to be filled out as people try, and we work to support, more complex environments for Kiln.
I was wrong, Jason wrote that the Kiln-Database needs the FogBugz-User not the FogBugz-Database. Sorry.
You mention in this answer that one can download an installer, however the Kiln site says:
During the beta, Kiln is only available via On Demand. Once the beta is complete, we will be working on a licensed version of Kiln that will run on your servers.
Does that mean I can download a trial hosted version? We are currently FogBugz customers, and I am "licenced" on Kiln-on-demand
Purchased Fogbugz with Kiln, got an installer called: "Kiln-Setup-1.2.138.exe"
When installing, i come to the point where to: "Enter Database Instance", so I enter the name of our DB Server, and gets this:
The database is not accessible or does not exist. Please enter an existing database that you can access with this account.