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="#_windows_auth">Windows Authentication</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 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 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 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><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></clear><br /></connectionstrings></pre> <pre><connectionstrings> <connectionstrings> <clear></clear><br /> <add providername="" connectionstring="server=MyServer;database=BugNet;uid=BugNet;pwd=BugNet" name="LocalSqlServer"></add><br /></connectionstrings></pre> <add name="LocalSqlServer" connectionstring="server=MyServer;database=BugNet;uid=BugNet;pwd=BugNet" providername=""></add><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/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<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> <br /> <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 /> <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 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 the database you created in step 4.<br /> <pre><connectionstrings> <clear></clear> <add name="LocalSqlServer" connectionstring="server=MyServer;database=BugNet;uid=BugNet;pwd=BugNet" providername=""></add> </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="_windows_auth">Windows Authentication</a></h2> <p>To configure windows authentication you will need to follow the steps below:</p> <ol> <li>Log into your BugNET installation as the admin account</li> <li>Add a new user with the domain\username 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</li> <li>In IIS, edit the configuration for the virtual directory uncheck anonymouse access and make sure windows authentication is checked.</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>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.</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 |