Documentation

BugNET Documentation

Home

Recent Changes

Index (Show)

History for Installation (history as of 7/3/2009 7:22:53 AM)

<p>In this page you can find all the information about installing and configuring BugNET.</p> <div id="TocContainer"><strong>Table of Contents</strong> <ul class="Toc"> <li><a href="#prereq">Pre-installation System Requirements</a></li> <li><a href="#installing">Installing BugNET</a></li> <li><a href="#upgrade">Upgrading BugNET</a> <ul> <li><a href="#upgrade_07">Upgrading From Version 0.7.X</a></li> <li><a href="#_upgrade_06">Upgrading From Version 0.6.7</a></li> </ul> </li> <li><a href="#_windows_auth">Windows Authentication</a> <ul> <li><a href="#seamless_creation">Seamless Creation of Users</a></li> </ul> </li> <li><a href="#known_issues">Known Issues</a></li> <li><a href="#version_history">Version History</a></li> <li><a href="#acknowledgements">Acknowledgements</a></li> </ul> </div> <p> </p> <h1 class="separator">General BugNET Issues</h1> <ul> <li><a href="http://bugnetproject.com/Documentation/tabid/57/topic/Frequently+Asked+Questions/Default.aspx">BugNET Frequently Asked Questions</a></li> <li><a href="http://~BugNetproject.com/Forums/tabid/54/Default.aspx">BugNET Support Forums</a></li> </ul> <h1 class="separator"><a name="#prereq"></a>Pre-installation System Requirements</h1> <ol> <li>IIS Web Server 5 or later</li> <li><a href="http://www.microsoft.com/downloads/details.aspx?familyid=0856eacb-4362-4b0d-8edd-aab15c5e04f5&displaylang=en">Microsoft .NET Framework v2.0 Redistributable</a></li> <li><a href="http://www.microsoft.com/downloads/details.aspx?familyid=8a166cac-758d-45c8-b637-dd7726e61367&displaylang=en">Microsoft Report Viewer Redistributable 2005</a></li> <li><a href="http://go.microsoft.com/fwlink/?LinkID=77296">Microsoft ASP.NET AJAX 1.0</a></li> <li>Microsoft SQL Server or Microsoft Desktop Engine (MSDE) version 2000 or later</li> </ol> <h1 class="separator"><a name="#installing"></a>Installing BugNET</h1> <ol> <li>Unzip the latest BugNet install package to a folder (e.g c:\BugNet) of your choice. This is the required package to run the BugNet Issue tracker. For the full source code package, visit the <a href="/">BugNET website</a>.</li> <li>Make sure you have created a <a href="http://msdn.microsoft.com/en-us/library/zwk103ab.aspx">virtual directory</a> on your local IIS which points to the folder that you have extracted the files in step 1 (e.g C:\BugNet). (e.g the url should be <a href="http://localhost/~BugNet">http://localhost/BugNet</a>)</li> <li>Using Windows Explorer, browse to the root folder of the website ( C:\BugNet by default ). Right-click the folder and select Sharing and Security from the popup menu ( please note that if you are using Windows XP you may need to <a href="http://whoozoo.co.uk/winxpFilePerms.htm" target="new">Enable Simple File Sharing</a> before these options are displayed ). Select the Security tab. Add the appropriate User Account and set the Permissions. <br /> <br /> <pre><strong>If using Windows 2000 - IIS5</strong> - the {Server}\ASPNET User Account must have Read, Write, and Change Control of the virtual root of your website <strong>If using Windows 2003 - IIS6</strong> - the NT AUTHORITY\NETWORK SERVICE User Account must have Read, Write, and Change Control of the virtual root of your website</pre> </li> <li>Create a blank SQL Database (e.g db name 'BugNet') on your sql server. For the upgrade, before you take any action, please backup your database.</li> <li>Edit the Web.config file with a text editor of your choice. Find the <strong>LocalSqlServer</strong> connection string setting and change the <strong>connectionString</strong> property to match the database you created in step 4. <br /> <div class="code"> <table style="width: 100%;"> <tbody> <tr> <td style="font-weight: bold;" colspan="2">XML</td> </tr> <tr> <td style="text-align: right; vertical-align: top; width: 1%;"> <pre><span style="border-right: 1px solid rgb(0, 0, 0); padding-right: 2px;">1</span> <span style="border-right: 1px solid rgb(0, 0, 0); padding-right: 2px;">2</span> <span style="border-right: 1px solid rgb(0, 0, 0); padding-right: 2px;">3</span> <span style="border-right: 1px solid rgb(0, 0, 0); padding-right: 2px;">4</span> <span style="border-right: 1px solid rgb(0, 0, 0); padding-right: 2px;">5</span> <span style="border-right: 1px solid rgb(0, 0, 0); padding-right: 2px;">6</span></pre> </td> <td style="vertical-align: top; width: 99%;"> <pre><span style="color: rgb(0, 0, 255);"><</span><span style="color: rgb(128, 0, 0);">connectionstrings</span><span style="color: rgb(0, 0, 255);">></span> <span style="color: rgb(0, 0, 255);"></</span><span style="color: rgb(128, 0, 0);">clear</span><span style="color: rgb(0, 0, 255);">></span> <span style="color: rgb(0, 0, 255);"><</span><span style="color: rgb(128, 0, 0);">add</span> <span style="color: rgb(255, 0, 0);">name</span>=<span style="color: rgb(0, 0, 255);">"LocalSqlServer"</span> <span style="color: rgb(255, 0, 0);">connectionstring</span>=<span style="color: rgb(0, 0, 255);">"server=MyServer;database=BugNet;uid=BugNet;pwd=BugNet"</span> <span style="color: rgb(255, 0, 0);">providername</span>=<span style="color: rgb(0, 0, 255);">""</span> <span style="color: rgb(0, 0, 255);">/></span> <span style="color: rgb(0, 0, 255);"></</span><span style="color: rgb(128, 0, 0);">connectionstrings</span><span style="color: rgb(0, 0, 255);">></span></pre> </td> </tr> </tbody> </table> </div> </li> <li>Browse to <a href="http://localhost/BugNet/Install/Install.aspx">http://localhost/BugNet/Install/Install.aspx</a> (or the url of the virtual directory you have created in step 2).</li> <li>The installation process will now start.</li> <li>When completed, you may log in with the admin user account. <br /> <pre> Username: admin Password: password</pre> </li> </ol> <p>That's it, your BugNet Issue tracker installation should be up and running at http://localhost/BugNet. For any installation problems, please visit the <a href="http://bugnetproject.com/Forums/tabid/54/Default.aspx">Support Forums</a>.</p> <h1 class="separator"><a name="#upgrade"></a>Upgrading BugNET</h1> <p>To upgrade your BugNET installation please follow the instructions for the specific version you currently have installed.</p> <h2 class="separator"><a name="upgrade_07"></a>Upgrading From Version 0.7.X</h2> <ol> <li>Backup your existing installation of BugNet, your database and rename your <strong>web.config</strong><em><strong> </strong></em>to <strong>web.config.bak.resources</strong> <br /> <span style="color: red;">**NOTE: Be sure to rename the web.config with the resources extension or someone could potentially download your web.config file.</span></li> <li>Copy your entire BugNet folder to another location.</li> <li>Delete the existing files in your current installation with the exception of:<br /> <ul> <li>Your backup of the <strong>Web.config</strong></li> <li><strong>Uploads</strong> directory and its contents (these are your attatchments!)</li> <li>Your <strong>App_Data</strong> folder (if you are using sql express)</li> </ul> </li> <li>Unzip the latest BugNet install package into your existing install directory.</li> <li>Copy your connection string from your previous <strong>Web.config</strong> to the new one.</li> <li>Copy your machinekey elements from your old <strong>Web.config</strong> to the new one.</li> <li>Copy the installation date appsetting from the old <strong>Web.config</strong><em><strong> </strong></em>to the new one.</li> <li>Browse to <a href="http://localhost/BugNet/Install/Install.aspx">http://localhost/BugNet/Install/Install.aspx</a> to complete the upgrade.</li> </ol> <h2 class="separator"><a name="_upgrade_06"></a>Upgrading From Version 0.6.7</h2> <ol> <li>Backup your existing installation of BugNet and your database.</li> <li>Unzip the latest BugNet install pacakge overtop of your existing install.</li> <li>Make sure that the current Admin account password is at least 7 characters long. If not, run this script replacing <strong>YourPasswordHere</strong> with the password you wish to use.<br /> <div class="code"> <table style="width: 100%;"> <tbody> <tr> <td colspan="2" style="font-weight: bold;">SQL</td> </tr> <tr> <td style="text-align: right; vertical-align: top; width: 1%;"> <pre><span style="border-right: 1px solid rgb(0, 0, 0); padding-right: 2px;">1</span></pre> </td> <td style="vertical-align: top; width: 99%;"> <pre><a href="http://search.microsoft.com/default.asp?so=RECCNT&siteid=us%2Fdev&p=1&nq=NEW&qu=UPDATE&IntlSearch=&boolean=PHRASE&ig=01&i=09&i=99" style="color: rgb(0, 0, 255);">UPDATE</a> Users <a href="http://search.microsoft.com/default.asp?so=RECCNT&siteid=us%2Fdev&p=1&nq=NEW&qu=SET&IntlSearch=&boolean=PHRASE&ig=01&i=09&i=99" style="color: rgb(0, 0, 255);">SET</a> Password = `YourPasswordHere` <a href="http://search.microsoft.com/default.asp?so=RECCNT&siteid=us%2Fdev&p=1&nq=NEW&qu=WHERE&IntlSearch=&boolean=PHRASE&ig=01&i=09&i=99" style="color: rgb(0, 0, 255);">WHERE</a> UserName = `Admin`</pre> </td> </tr> </tbody> </table> </div> </li> <br /> <li>Make sure that all users have a unique email address, otherwise the upgrade will fail. Run this script to determine duplicates and fix them accordingly: <br /> <div class="code"> <table style="width: 100%;"> <tbody> <tr> <td style="font-weight: bold;" colspan="2">SQL</td> </tr> <tr> <td style="text-align: right; vertical-align: top; width: 1%;"> <pre><span style="border-right: 1px solid rgb(0, 0, 0); padding-right: 2px;">1</span> <span style="border-right: 1px solid rgb(0, 0, 0); padding-right: 2px;">2</span></pre> </td> <td style="vertical-align: top; width: 99%;"> <pre><a style="color: rgb(0, 0, 255);" href="http://search.microsoft.com/default.asp?so=RECCNT&siteid=us%2Fdev&p=1&nq=NEW&qu=SELECT&IntlSearch=&boolean=PHRASE&ig=01&i=09&i=99">SELECT</a> email, <a style="color: rgb(0, 0, 255);" href="http://search.microsoft.com/default.asp?so=RECCNT&siteid=us%2Fdev&p=1&nq=NEW&qu=COUNT&IntlSearch=&boolean=PHRASE&ig=01&i=09&i=99">COUNT</a>(email) <a style="color: rgb(0, 0, 255);" href="http://search.microsoft.com/default.asp?so=RECCNT&siteid=us%2Fdev&p=1&nq=NEW&qu=AS&IntlSearch=&boolean=PHRASE&ig=01&i=09&i=99">AS</a> NumOccurrences <a style="color: rgb(0, 0, 255);" href="http://search.microsoft.com/default.asp?so=RECCNT&siteid=us%2Fdev&p=1&nq=NEW&qu=FROM&IntlSearch=&boolean=PHRASE&ig=01&i=09&i=99">FROM</a> users <a style="color: rgb(0, 0, 255);" href="http://search.microsoft.com/default.asp?so=RECCNT&siteid=us%2Fdev&p=1&nq=NEW&qu=GROUP&IntlSearch=&boolean=PHRASE&ig=01&i=09&i=99">GROUP</a> <a style="color: rgb(0, 0, 255);" href="http://search.microsoft.com/default.asp?so=RECCNT&siteid=us%2Fdev&p=1&nq=NEW&qu=BY&IntlSearch=&boolean=PHRASE&ig=01&i=09&i=99">BY</a> email <a style="color: rgb(0, 0, 255);" href="http://search.microsoft.com/default.asp?so=RECCNT&siteid=us%2Fdev&p=1&nq=NEW&qu=HAVING&IntlSearch=&boolean=PHRASE&ig=01&i=09&i=99">HAVING</a> ( <a style="color: rgb(0, 0, 255);" href="http://search.microsoft.com/default.asp?so=RECCNT&siteid=us%2Fdev&p=1&nq=NEW&qu=COUNT&IntlSearch=&boolean=PHRASE&ig=01&i=09&i=99">COUNT</a>(email) > 1 )</pre> </td> </tr> </tbody> </table> </div> </li> <li>Unzip the latest BugNet install package to a folder (e.g c:\BugNet) of your choice. This is the required package to run the BugNet Issue tracker. For the full source code package, visit the <a href="/">BugNet website</a>.</li> <li>Edit the <strong>Web.config</strong> file with a text editor of your choice. Find the <strong>LocalSqlServer</strong> connection string setting and change the <strong>connectionString</strong> property to match your database.<br /> <div class="code"> <table style="width: 100%;"> <tbody> <tr> <td colspan="2" style="font-weight: bold;">XML</td> </tr> <tr> <td style="text-align: right; vertical-align: top; width: 1%;"> <pre><span style="border-right: 1px solid rgb(0, 0, 0); padding-right: 2px;">1</span> <span style="border-right: 1px solid rgb(0, 0, 0); padding-right: 2px;">2</span> <span style="border-right: 1px solid rgb(0, 0, 0); padding-right: 2px;">3</span> <span style="border-right: 1px solid rgb(0, 0, 0); padding-right: 2px;">4</span> <span style="border-right: 1px solid rgb(0, 0, 0); padding-right: 2px;">5</span> <span style="border-right: 1px solid rgb(0, 0, 0); padding-right: 2px;">6</span></pre> </td> <td style="vertical-align: top; width: 99%;"> <pre><span style="color: rgb(0, 0, 255);"><</span><span style="color: rgb(128, 0, 0);">connectionstrings</span><span style="color: rgb(0, 0, 255);">></span> <span style="color: rgb(0, 0, 255);"><span style="color: rgb(128, 0, 0);">clear</span><span style="color: rgb(0, 0, 255);">></span><br /> <span style="color: rgb(0, 0, 255);"><</span><span style="color: rgb(128, 0, 0);">add</span> <span style="color: rgb(255, 0, 0);">name</span>=<span style="color: rgb(0, 0, 255);">"LocalSqlServer"</span> <br /> <span style="color: rgb(255, 0, 0);">connectionstring</span>=<span style="color: rgb(0, 0, 255);">"server=MyServer;database=BugNet;uid=BugNet;pwd=BugNet"</span> <br /> <span style="color: rgb(255, 0, 0);">providername</span>=<span style="color: rgb(0, 0, 255);">""</span> <span style="color: rgb(0, 0, 255);">/></span><br /><span style="color: rgb(0, 0, 255);"><span style="color: rgb(128, 0, 0);">connectionstrings</span><span style="color: rgb(0, 0, 255);">></span></span></span></pre> </td> </tr> </tbody> </table> </div> </li> <li>Browse to <a href="http://localhost/BugNet/Install/Install.aspx">http://localhost/BugNet/Install/Install.aspx</a> (or the url of the virtual directory you have created in step 2).</li> <li>The upgrade process will now start.</li> <li>When completed you may log in as normal.</li> </ol> <h1 class="separator"><a name="_windows_auth">Windows Authentication</a></h1> <p>To configure windows authentication you will need to perform the following steps:</p> <ol> <li>Log into your BugNET installation as the admin account</li> <li>Add a new user in the format <strong>DOMAIN\username</strong> that you wish to be the admin and add them to the super users role.</li> <li>Change the authentication in the web.config to windows authentication<br /> <div class="code"> <table style="width: 100%;"> <tbody> <tr> <td style="font-weight: bold;" colspan="2">XML</td> </tr> <tr> <td style="text-align: right; vertical-align: top; width: 1%;"> <pre><span style="border-right: 1px solid rgb(0, 0, 0); padding-right: 2px;">1</span></pre> </td> <td style="vertical-align: top; width: 99%;"> <pre><span style="color: rgb(0, 0, 255);"><</span><span style="color: rgb(128, 0, 0);">authentication</span> <span style="color: rgb(255, 0, 0);">mode</span>=<span style="color: rgb(0, 0, 255);">"Windows"</span><span style="color: rgb(0, 0, 255);">/></span></pre> </td> </tr> </tbody> </table> </div> </li> <li>In IIS 6.0 (Windows Server 2003 & XP): <ol> <li>Edit the configuration for the virtual directory uncheck <strong>anonymous access</strong> and make sure <strong>windows authentication</strong> is checked.<br /> <img width="371" height="429" src="/Portals/0/Images/Wiki/AuthenticationMethods1.gif" alt="" /></li> </ol> </li> <li>In IIS7 (Vista and Windows Server 2008): <ol> <li>Make sure that anonymous authentication is set to <strong>disbled </strong>and windows authentication is set to <strong>enabled</strong>.<br /> <img width="487" height="393" src="/Portals/0/Images/Wiki/Vista-VDIR-AuthSettings.png" alt="" /></li> </ol> </li> <li>Visit the application with the logged on domain user that you created earlier and you should have admin access now.</li> </ol> <p> </p> <h2 class="separator"><a name="seamless_creation"></a>Seamless Creation of Users</h2> <p>To enable seamless creation of users from Active Directory or Windows SAM when they visit the application then you will need to perform these additional steps.</p> <ol> <li>Log into the BugNET issue tracker as admin</li> <li>Goto the <strong>Administration </strong>-> <strong>Application Configuration</strong> -> <strong>Authentication Settings</strong> section.</li> <li>Set your <strong>User Account Source</strong>, Active Directory or Windows SAM</li> <li>Enter your domain in the <strong>Domain</strong> field. i.e MyDomain.</li> <li>If your domain needs authentication to lookup users enter the username and password in the proper fields.</li> <li>Locate the <strong>AuthenticationModule</strong> http module tag in the web.config and uncomment it.<br /> <div class="code"> <table style="width: 100%;"> <tbody> <tr> <td style="font-weight: bold;" colspan="2">XML</td> </tr> <tr> <td style="text-align: right; vertical-align: top; width: 1%;"> <pre><span style="border-right: 1px solid rgb(0, 0, 0); padding-right: 2px;">1</span> <span style="border-right: 1px solid rgb(0, 0, 0); padding-right: 2px;">2</span> <span style="border-right: 1px solid rgb(0, 0, 0); padding-right: 2px;">3</span> <span style="border-right: 1px solid rgb(0, 0, 0); padding-right: 2px;">4</span> <span style="border-right: 1px solid rgb(0, 0, 0); padding-right: 2px;">5</span> <span style="border-right: 1px solid rgb(0, 0, 0); padding-right: 2px;">6</span> <span style="border-right: 1px solid rgb(0, 0, 0); padding-right: 2px;">7</span></pre> </td> <td style="vertical-align: top; width: 99%;"> <pre><span style="color: rgb(0, 0, 255);"><</span><span style="color: rgb(128, 0, 0);">httpModules</span><span style="color: rgb(0, 0, 255);">></span> <span style="color: rgb(0, 128, 0);"></span> <span style="color: rgb(0, 0, 255);"><</span><span style="color: rgb(128, 0, 0);">add</span> <span style="color: rgb(255, 0, 0);">name</span>=<span style="color: rgb(0, 0, 255);">"AuthenticationModule"</span> <span style="color: rgb(255, 0, 0);">type</span>=<span style="color: rgb(0, 0, 255);">"BugNET.HttpModules.AuthenticationModule, BugNET.HttpModules.Authentication"</span> <span style="color: rgb(0, 0, 255);">/></span> <span style="color: rgb(0, 128, 0);"></span> <span style="color: rgb(0, 0, 255);"></</span><span style="color: rgb(128, 0, 0);">httpModules</span><span style="color: rgb(0, 0, 255);">></span></pre> </td> </tr> </tbody> </table> </div> </li> </ol> <h1 class="separator"><a name="known_issues"></a>Known Issues</h1> <p>For a list of known issues please visit <a href="http://support.bugnetproject.com">http://support.bugnetproject.com</a>.</p> <h1 class="separator"><a name="version_history"></a>Version History</h1> <p>For a version history please refer to the <a href="http://support.bugnetproject.com/Bugs/ChangeLog.aspx?pid=1">change log</a>.</p> <h1 class="separator"><a name="acknowledgements"></a>Acknowledgements</h1> <p>Thank you to everyone that has reported issues, submitted patches and your continued support and interest in BugNET.</p>

|<< Back |