Installing BugNET

Requirements
Downloading
Installing Using SQL Server Express
Installing Using SQL Server
Install using the Web Deployment Package
Upgrading
Alternate Installation Tutorial

There are three ways you can install BugNET. You can:
  • Install it using the Web Deployment Package.
  • Download the BugNET .zip file and install it as described in Manually Installing BugNET Using a zip file.
  • Download the BugNET source code and build BugNET from the command line or in Visual Studio.

This topic shows how to install BugNET using the Install and Web Deploy packages.

Requirements

The minimum requirements for running BugNET are the following:
  • ASP.NET 4
  • A web server such as IIS Express 8, 7.5 or IIS 7.x.
  • Microsoft SQL Server 2008 Express or greater.

When installing IIS, make sure you enable the ASP.NET IIS modules. Also make sure that you run BugNET in an integrated pipeline ASP.NET 4 application pool.

Downloading the .zip File

Download the BugNET .zip file from CodePlex. Select the X.X.XXX Install.zip file for the latest build of BugNET as shown in the following illustration:

Install_downloadzip.png

Installing Using SQL Server Express

  1. Extract the contents of the install package to a folder on your computer.
  2. Create a directory in the c:\inetpub\wwwroot\ folder called bugnet (c:\inetpub\wwwroot\bugnet)
  3. Copy the contents of the BugNET folder in the install package to the c:\inetpub\wwwroot\bugnet\ folder
  4. Go to the properties of the following folders / files and click on the Security tab, be sure to add the permissions for the appropriate user (WinXp/2000 uses the local ASPNET account, Win2003/Vista/2008/7 use the local Network Service account). Give this account modify permissions of the following folders (if necessary):
    • Uploads - if using file system based uploads
    • App_Data - This folder is where BugNET stores its database.
  5. Create a virtual directory in IIS for the bugnet folder.
  6. Open up the the web server IIS Console, Start-> Run-> INETMGR
  7. Expand the websites node
  8. Expand the default websites node
  9. Right click on the BugNET folder under the default website, click on Convert to Application, if you don't have that option, choose properties and then add the application.
  10. If you are using IIS 7, configure it to run in integrated mode, and configure the application pool to run the .NET Framework version 4.
  11. Browse to the website using http://localhost/BugNet/Install/Install.aspx. The installation process will now start.

When the installation is complete, you may log in with the admin user account.

Username: admin
Password: password

Installing Using SQL Server

  1. Extract the contents of the install package to a folder on your computer.
  2. Create a directory in the c:\inetpub\wwwroot\ folder called bugnet (c:\inetpub\wwwroot\bugnet)
  3. Copy the contents of the BugNET folder in the install package to the c:\inetpub\wwwroot\bugnet\ folder
  4. Go to the properties of the c:\inetpub\wwwroot\bugnet\ folder, click on the Security tab, be sure to add the permissions for the appropriate user (WinXp/2000 uses the local ASPNET account, Win2003/Vista/2008/7 use the local Network Service account). Give this account modify permissions on (if necessary):
    • Uploads - if using file system based uploads
  5. Create a virtual directory in IIS for the bugnet folder.
  6. Open up the the web server IIS Console, start-> run-> INETMGR
  7. Expand the websites node
  8. Expand the default websites node
  9. Right click on the BugNET folder under the default website, click on Convert to Application, if you don't have that option, choose properties and then add the application.
  10. Configure the database server.
    1. Load the SQL Server Management tool
    2. Expand the Server/Security node
    3. Create a blank SQL Database (e.g db name 'BugNet') on your sql server using a case insensitive collation.
    4. Configure the SQL User Security/Account to allow IIS and ASP.NET access to the database in SQL.

To Use Integrated Security - Windows Authentication (Recommended)

  1. Verify that NT Authority\Network Service is listed, if not add a new account and search for the local NETWORK SERVICE user (if using Windows XP/2000 use the local ASPNET account)
  2. Right click on the NT Authority\Network Service account and choose properties.
  3. Choose the User Mapping section on the left. Select your database on the right, and then down below choose the db_owner option, click OK
  4. Edit the Web.config file with a text editor of your choice. Find the BugNET connection string setting and change the connectionString.
<connectionStrings>
     <clear/>
     <add name="BugNET" connectionString="server=MyServer;database=BugNet;Trusted_Connection=True" providerName="System.Data.SqlClient" />
</connectionStrings>

To Use SQL User Security (requires mixed mode authentication to be enabled in SQL Server)

  1. Right click on Server/Security and choose New Login
  2. Define new SQL Server authentication login information, username/password.
  3. From the User Mapping section choose the new BugNET database and configure the db_owner role membership. Click OK.
  4. Edit the Web.config file with a text editor of your choice. Find the BugNET connection string setting and change the connectionString.
<connectionStrings>
<clear/>
<add name="BugNET" connectionString="server=MyServer;database=BugNet;uid=BugNet;pwd=BugNet" providerName="System.Data.SqlClient" />
</connectionStrings>

Browse to the website using http://localhost/BugNet/Install/Install.aspx. The installation process will now start.

InstallationComplete.png

When completed, you may log in with the admin user account.

Username: admin
Password: password

Install using the Web Deployment Package

To install BugNET via the web deployment package please refer to the following instructions on how to Import a Package through IIS Manager

Upgrading

Verify that your application pool in IIS is running under .NET 4.5.
  1. Backup live database & files
  2. Put AppOffline.htm in live BugNET directory. (optional) See http://stackoverflow.com/a/1153545 for more information on using the AppOffline.htm feature of asp.net
  3. Download new distribution to local machine
  4. Use WinMerge or equivalent to compare new and old web.configs. Copy across the connection string to the new one.
  5. Start BugNET, hit the home page to verify that it compiles

The database is automatically upgraded when you hit the home page. You should see a log of what's been done plus a "success" message after a few minutes.

Alternate Installation Tutorial

http://www.dotnetcamp.com/post/2012/10/20/How-to-install-BugNet.aspx

Last edited Sep 2 at 3:24 PM by dubeaud, version 27