BugNET

<h2>Table Of Contents</h2>
<ul>
<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></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>
<h2>General BugNET Issues</h2>
<ul>
<li><a href="http://~BugNetproject.com/Default.aspx?tabid=57&pageid=2&pagename=">BugNET Frequently Asked Questions</a></li>
<li><a href="http://~BugNetproject.com/Forums/tabid/54/Default.aspx">BugNET Support Forums</a></li>
</ul>
<h2><a name="#prereq"></a>Pre-installation System Requirements</h2>
<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>
<h2><a name="#installing"></a>Installing BugNET</h2>
<ol>
<li>Unzip the latest ~BugNet install pacakge 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 virtual directory 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 target="new" href="http://whoozoo.co.uk/winxpFilePerms.htm">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><br />- the {Server}\ASPNET User Account must have Read, Write, and Change Control of the virtual root of your website<br /><br /><strong>If using Windows 2003 - IIS6</strong><br />- the NT AUTHORITY\NETWORK SERVICE User Account must have Read, Write, and<br /> 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 />
<pre><connectionStrings><br /> <clear /><br /> <add name="~LocalSqlServer" connectionString="server=~MyServer;database=~BugNet;uid=~BugNet;pwd=~BugNet"<br /> providerName="" /><br /> </connectionStrings></pre>
</li>
<li>Edit the <strong>Log4net.config</strong> file in the <strong>Config</strong> folder and set the connection string to the same one that you have used in step 4.</li>
<li>Browse to <a href="http://localhost/~BugNet/Install/Installer.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<br /> 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>
<h2><a name="#upgrade"></a>Upgrading BugNET</h2>
<h3>Upgrading From Version 0.7.X</h3>
<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>Delete the existing files in your current installation with the exception of your backup of the <strong>Web.config</strong> the <strong>Uploads</strong> directory and your <strong>App_Data</strong> folder (if you are using sql express)</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/Installer.aspx">http://localhost/~BugNet/Install/Install.aspx</a> to complete the upgrade.</li>
</ol>
<h3>Upgrading From Version 0.6.7</h3>
<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 />
<pre>UPDATE Users SET Password = `~YourPasswordHere` WHERE ~UserName = `Admin`</pre>
</li>
<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 />
<pre>SELECT email,<br />COUNT(email) AS ~NumOccurrences<br />FROM users<br />GROUP BY email<br />HAVING ( COUNT(email) > 1 )</pre>
</li>
<li>Unzip the latest ~BugNet install pacakge 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 the database you created in step 4.<br />
<pre><connectionStrings><br /> <clear /><br /> <add name="~LocalSqlServer" connectionString="server=~MyServer;database=~BugNet;uid=~BugNet;pwd=~BugNet"<br /> providerName="" /><br /> </connectionStrings></pre>
</li>
<li>Edit the <strong>~Log4Net.config</strong> file in the <strong>Config</strong> folder and set the connection string to the same one that you have used in step 4.</li>
<li>Browse to <a href="http://localhost/~BugNet/Install/Installer.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>
<h2><a name="known_issues"></a>Known Issues</h2>
<p>For a list of known issues please visit <a href="http://support.~BugNetproject.com">http://support.bugnetproject.com</a>.</p>
<h2><a name="version_history"></a>Version History</h2>
<p>For a version history please refer to the <a href="http://support.~BugNetproject.com/Bugs/ChangeLog.aspx?pid=1">change log</a>.</p>
<h2><a name="acknowledgements"></a>Acknowledgements</h2>
<p>Thank you to everyone that has reported issues, submitted patches and your continued support.</p>  

|<< Back |