YetAnotherForum.NET
Directory actions
More options
Directory actions
More options
YetAnotherForum.NET
Folders and files
| Name | Name | Last commit date | ||
|---|---|---|---|---|
parent directory.. | ||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>YetAnotherForum.NET Installation and Upgrading</title> <style type="text/css"> * {margin: 0;padding: 0;} body{color:#333;font:83%/1.5 arial,tahoma,verdana,sans-serif;padding:0 0 20px;} a,a:link,a:link,a:link,a:hover{background:transparent;text-decoration:underline;cursor:pointer;} a:link{color:#c00;} a:hover,a:active{color:#069;} input{font-family:arial,tahoma,verdana,sans-serif;margin:2px 0;} label{display:block;padding:5px 0;} label br{clear:left;} h1,h2,h3,h4,h5,h6{letter-spacing:-1px;font-family:arial,verdana,sans-serif;color:#337;border-bottom:1px solid #eee;padding-bottom:.1em;margin:1.2em 0 .3em;} h1{font-size:196%;margin-top:.6em;} h2{font-size:136%;} h3{font-size:126%;} h4{font-size:116%;} h5{font-size:106%;} h6{font-size:96%;} .highlight{color:#E17000;} .error{color:#c00;font-weight:700;} .success{color:#390;font-weight:700;} .caption{color:#999;font-size:11px;} .date{font:bold 82% arial;color:#bbb;display:block;letter-spacing:1px;} small{font-size:11px;} .content{border:1px solid #ccc;margin-top:10px;padding:5px;} ul{list-style-type:none;margin:.3em 0 1.5em;} ul.related{margin-top:-1em;} ol{margin:.5em .5em 1.5em;} ol li{margin-left:1.4em;padding-left:0;background:none;list-style-type:decimal;} li{line-height:1.4em;padding-left:25px;background:transparent url(images/sprites.gif) no-repeat 0 0;} li.doc{background-position:3px -500px;} ul.nomarker li{background:none;padding-left:0;} dl{margin:0 0 1em;} dt{font-weight:700;margin-top:1.3em;} dl dl{margin:0 0 1.5em 30px;} hr{background:#f2f2f2;height:1px;color:#f2f2f2;border:none;clear:both;margin:1em 0;} .clear{clear:both;position:relative;font-size:0;height:0;line-height:0;} #wrap{width:90%;margin:20px auto;} .style1{color:#C00;} #content-wrap .content div p code.remove{color:red;} #content-wrap .content div p code.add{color:green;} #footer hr{height:1px;border:solid 1px gray;border-bottom:none;margin:10px 0 15px;} #footer p{float:left;margin:0 10px 10px;} #footer #copy{float:right;} a:visited,.subdued{color:#999;} form,p,ul,ol{margin:0 0 1.5em;} fieldset,img{border:none;} </style> </head> <body> <div id="wrap"> <div id="header"> <a href="proxy.php?url=https%3A%2F%2Fgithub.com%2Farrayka%2FYAFNET%2Ftree%2Fbootstrap%2Fyafsrc%2F%3Ca+href%3D"http://www.yetanotherforum.net" rel="nofollow">http://www.yetanotherforum.net"> <img src="proxy.php?url=https%3A%2F%2Fgithub.com%2Farrayka%2FYAFNET%2Ftree%2Fbootstrap%2Fyafsrc%2Fimages%2FYAFLogo.png" alt="YAF logo" style="border: 0" /></a> <div class="content"> <h1> YetAnotherForum.NET Installation & Upgrading Instructions</h1> <p> Thank you for downloading <strong>Yet Another Forum.NET</strong> ASP.NET Open Source Forum solution. The <strong>Yet Another Forum</strong> (<strong>YAF</strong>) project is an international collaboration of like-minded, skilled, and creative individuals who are striving to make <strong>YAF</strong> the most robust and malleable forum solutions available. </p> <p> If you have any thoughts or would like to contribute, please see the contact information at the bottom of this document. </p> <h2> Index</h2> <ol> <li><a href="proxy.php?url=https%3A%2F%2Fgithub.com%2Farrayka%2FYAFNET%2Ftree%2Fbootstrap%2Fyafsrc%2FYetAnotherForum.NET%23Require">Requirements</a></li> <li><a href="proxy.php?url=https%3A%2F%2Fgithub.com%2Farrayka%2FYAFNET%2Ftree%2Fbootstrap%2Fyafsrc%2FYetAnotherForum.NET%23NewInstall">New Installation</a></li> <li><a href="proxy.php?url=https%3A%2F%2Fgithub.com%2Farrayka%2FYAFNET%2Ftree%2Fbootstrap%2Fyafsrc%2FYetAnotherForum.NET%23Upgrade">Upgrade</a></li> <li><a href="proxy.php?url=https%3A%2F%2Fgithub.com%2Farrayka%2FYAFNET%2Ftree%2Fbootstrap%2Fyafsrc%2FYetAnotherForum.NET%23Support">Support</a></li></ol> </div> </div> <div id="content-wrap"> <div class="content"> <h2> <a name="Require" id="Require"></a>Installation Requirements</h2> <p> Make sure your server / Host has the following requirements:</p> <ol> <li>Microsoft .NET Framework 4.0 (Use version 1.9.5.5 or earlier for .NET Framework 3.5)</li> <li>Microsoft SQL Server 2005 or above. SQL Server 2000 works, but requires removal of some SQL forum database optimizations.</li> </ol> </div> <div class="content"> <h2> <a name="NewInstall" id="NewInstall"></a>New Installation</h2> <h3> STEP 1. UNZIP</h3> <ol> <li>The first step is to unzip yaf to the physical location where the Application (YAF) will be run from. By default in IIS (Internet Information Server) expects the sites to be located at "c:\Inetpub\wwwroot\..." </li> </ol> <h3>STEP 2. Configuring the Appication in IIS (Internet Information Server) </h3> <ol> <li>In IIS you need to create a new Virtual Directory, if you want to run YAF as application, that points to the physical directory where you extracted YAF in to. </li> <li>How to: <a href="proxy.php?url=https%3A%2F%2Fgithub.com%2Farrayka%2FYAFNET%2Ftree%2Fbootstrap%2Fyafsrc%2F%3Ca+href%3D"http://msdn.microsoft.com/en-us/library/bb763173.aspx">Create" rel="nofollow">http://msdn.microsoft.com/en-us/library/bb763173.aspx">Create and Configure Virtual Directories in IIS</a></li> <li>Make sure that the Application Pool for YAF is set to .NET 4</li> </ol> <h3>STEP 3. SETUP DATABASE</h3> <ol> <li>A valid database needs to exist on your SQL Server with proper permissions set so that YAF can access it. When you run YAF for the first time it will detect that the database is empty (or needs upgrading) and will automatically run you through the process required to create the SQL database structures needed. </li> </ol> <h3> STEP 4. COPY WEB.CONFIG FILE</h3> <ol> <li>Rename "recommended.web.config" in the yaf root Folder to web.config. Warning: DO NOT edit the web.config unless you know what you're doing.</li> </ol> <h3>STEP 4a. (OPTIONAL) Generate a Machine Key for your installation.</h3> <ol> <li>Open the file <yaf.approot> web.config and visit the a site that allows generation of a unique machine key for your forum. Such as this site: <a href="proxy.php?url=https%3A%2F%2Fgithub.com%2Farrayka%2FYAFNET%2Ftree%2Fbootstrap%2Fyafsrc%2F%3Ca+href%3D"http://aspnetresources.com/tools/machineKey">AspNet" rel="nofollow">http://aspnetresources.com/tools/machineKey">AspNet Resources Machine Key Generator</a>. Copy and paste the generated machine key to your web.config in the <system.web> section.</li> </ol> <h3> STEP 4b. (OPTIONAL) MODIFY "app.config" FILE:</h3> <ol> <li>By default YAF is designed to be installed at the root application on any IIS web server. If you want YAF to be installed off of the main root in a sub folder, you need to modify the root key. Make sure the files in the /bin directory of the YAF zip file are copied to /bin directory on the root of your web server. Then open up "app.config" and un comment the "<strong>YAF.AppRoot</strong>" key. Enter the value as the  directory to your forum.  Example: If you have install the forum in the directory "/forum/yaf/" you will need to un comment/add key with name "<strong>YAF.AppRoot</strong>" and value "/forum/yaf/" to app.config. </li> </ol> <h3> STEP 4c.(OPTIONAL) MODIFY "mail.config" FILE:</h3> <ol> <li>Modify the SMTP settings by entering your mail server information. If you SMTP server requires SSL, you must add: <br /> <strong><add key="YAF.UseSMTPSSL" value="false" /></strong> to your app.config or appSettings.</li> </ol> <h3> STEP 6. Run The Install Wizard</h3> <ol> <li>Open the file <yaf.approot> install/default.aspx on your web site. If you are testing on your local computer, under a directory called YetAnotherForum.Net, the address should be: http://localhost/yetanotherforum.net/install/</li> <li>The wizard will guide you through the Install Process.</li> </ol> </div> <div class="content"> <h2> Upgrade Installation</h2> <h3> <a name="Upgrade" id="Upgrade"></a>STEP 1. BACKUP & REMOVE</h3> <ol> <li>Backup all your existing installation YAF files remove the following directories from your forum root directory: <ul> <li><em>\bin</em></li> <li><em>\classes</em></li> <li><em>\controls</em></li> <li><em>\defs</em></li> <li><em>\editors</em></li> <li><em>\install</em></li> <li><em>\language</em></li> <li><em>\pages</em></li> <li><em>\template</em></li> <li><em>\themes</em></li> <li><em>\Web References</em></li> </ul> </li> <li>Be careful not to delete the /images or /upload directory.</li> <li><span class="style1"><strong>BACKUP YOUR DATABASE</strong></span></li> </ol> <h3> STEP 2. UNZIP</h3> <ol> <li>Unzip the file structure YAF-BIN ZIP archive to the folder you want to run YAF to run inside. The YAF \Bin directory <strong>must</strong> be in your application root.</li> </ol> <h3> STEP 3. Upgrade - The WEB.CONFIG FILE</h3> <p> Please follow these important directions:</p> <p> You need to MERGE the changes for the recommended.web.config or the v1.9.1.upgrade.web.config depending on the original web config you used.</p> <hr /> <p> <span class="error"><strong>IMPORTANT</strong>:</span> Remove the Lines if you Upgrade to YAF Version >= 1.9.5.5</p> <div style="margin-left: 30px; border: 1px dotted black; padding: 5px"> <p> <code class="remove"><add tagPrefix="DotNetAge" namespace="DNA.UI.JQuery" assembly="DNA.UI.JQuery"/><br /> <add tagPrefix="DotNetAge" namespace="DNA.UI" assembly="DNA"/></code><br /> <hr /> <p> <code class="remove"><add tagPrefix="YAF" namespace="YAF.Classes.UI" assembly="YAF.Classes.UI"/> </code> </p> <hr /> <p> <code class="remove"><add tagPrefix="YAF" namespace="YAF.Classes.Utils" assembly="YAF.Classes.Utils"/><br /> <add tagPrefix="YAF" namespace="YAF.Classes.Core" assembly="YAF.Classes.Core"/><br /> <add tagPrefix="YAF" namespace="YAF.Classes.Data" assembly="YAF.Classes.Data"/> </code> </p> <hr /> <p> <code class="remove"><add namespace="YAF"/><br /> <add namespace="YAF.Classes.Utils"/><br /> <add namespace="YAF.Classes.Core"/><br /> <add namespace="YAF.Controls"/><br /> <add namespace="YAF.Classes.Data"/></code></p> <hr /> <p> <code class="remove"><add namespace="YAF.Classes.UI"/></code></p> </div> <br /> <p> <span class="error"><strong>IMPORTANT</strong>:</span> Update this following lines if you Upgrade to YAF Version >= 1.9.5.5</p> <div style="margin-left: 30px; border: 1px dotted black; padding: 5px"> <p> Change the Line from....</p> <p> <code class="remove"><add name="YafTaskModule" type="YAF.Classes.Core.YafTaskModule, YAF.Classes.Core"/></code></p> <p> to</p> <p> <code><add name="YafTaskModule" type="YAF.Core.YafTaskModule, YAF.Core"/></code></p> <p> Change the Line from....</p> <p> <code class="remove"><add name="YafTaskModule" type="YAF.Classes.Core.YafTaskModule, YAF.Classes.Core" preCondition="managedHandler"/></code></p> <p> to</p> <p> <code class="add"><add name="YafTaskModule" type="YAF.Core.YafTaskModule, YAF.Core" preCondition="managedHandler"/></code></p> <p> Change the Line from....</p> <p> <code class="remove"><profile enabled="true" defaultProvider="YafProfileProvider" inherits="YAF.Classes.Utils.YafUserProfile"></code></p> <p> to</p> <p> <code class="add"><profile enabled="true" defaultProvider="YafProfileProvider" inherits="YAF.Utils.YafUserProfile"></code></p> <p> Change the Line from....</p> <p> <code class="remove"><add verb="POST,GET,HEAD" path="ajaxpro/*.ashx" type="AjaxPro.AjaxHandlerFactory, AjaxPro.2"/></code></p> <p> to</p> <p> <code class="add"><add verb="GET" path="Resource.ashx" type="YAF.YafResourceHandler, YAF" /></code></p> <p> Change the Line from....</p> <p> <code class="remove"><add name="AjaxPro" preCondition="integratedMode" verb="POST,GET,HEAD" path="ajaxpro/*.ashx" type="AjaxPro.AjaxHandlerFactory, AjaxPro.2" /></code></p> <p> to</p> <p> <code class="add"><add name="YafHandler" preCondition="integratedMode" verb="GET" path="Resource.ashx" type="YAF.YafResourceHandler, YAF" /></code></p> </div> <hr /> <p> <strong>How to merging Web.Config Files:</strong> </p> <ol> <li>A tip to merge web.config files is to download both of them, then use a merge program to combine. WinMerge is a free and excellent merge program which you can download here: <a href="proxy.php?url=https%3A%2F%2Fgithub.com%2Farrayka%2FYAFNET%2Ftree%2Fbootstrap%2Fyafsrc%2F%3Ca+href%3D"http://www.winmerge.org/">http://www.winmerge.org/</a" rel="nofollow">http://www.winmerge.org/">http://www.winmerge.org/</a> </a> </li> </ol> <h3> STEP 4. UPGRADE Wizard:</h3> <ol> <li>Open the file <YAF.AppRoot>install/default.aspx on your web site. If you are testing on your local computer, under a directory called YetAnotherForum.Net, the address should be: <a href="proxy.php?url=http%3A%2F%2Flocalhost%2Fyetanotherforum.net%2Finstall%2F">http://localhost/yetanotherforum.net/install/</a></li> <li>The wizard will guide you through the upgrade process.</li> </ol> </div> <div class="content"> <h2> <a name="Support" id="Support"></a>Yet Another Forum Community Support</h2> <p> If you have any questions, please visit the YAF Community Support forum: <a href="proxy.php?url=https%3A%2F%2Fgithub.com%2Farrayka%2FYAFNET%2Ftree%2Fbootstrap%2Fyafsrc%2F%3Ca+href%3D"http://forum.yetanotherforum.net" rel="nofollow">http://forum.yetanotherforum.net"> http://forum.yetanotherforum.net</a>, or visit the Wiki for More Informations.</p> <h3> Yet Another Forum Priority Support and Consulting</h3> <p> Please visit <a href="proxy.php?url=https%3A%2F%2Fgithub.com%2Farrayka%2FYAFNET%2Ftree%2Fbootstrap%2Fyafsrc%2F%3Ca+href%3D"http://yetanotherforum.net/services.aspx">YAF" rel="nofollow">http://yetanotherforum.net/services.aspx">YAF Services Page</a> for more information on Priority Support, Integration and commercial business options.</p> <h3> Contact Us</h3> <p> Thanks for trying YAF! If you have any suggestions or comments please post them on the support forum!</p> </div> </div> <div id="footer"> <hr /> <p> YetAnotherForum.NET (YAF) the Open Source Discussion Forum for ASP.NET - <a href="proxy.php?url=https%3A%2F%2Fgithub.com%2Farrayka%2FYAFNET%2Ftree%2Fbootstrap%2Fyafsrc%2F%3Ca+href%3D"http://yetanotherforum.net/">http://YetAnotherForum.NET</a" rel="nofollow">http://yetanotherforum.net/">http://YetAnotherForum.NET</a> </p> <p id="copy"> YetAnotherForum.NET Copyright © 2012 <a href="proxy.php?url=https%3A%2F%2Fgithub.com%2Farrayka%2FYAFNET%2Ftree%2Fbootstrap%2Fyafsrc%2F%3Ca+href%3D"http://www.tinygecko.com/">Tiny" rel="nofollow">http://www.tinygecko.com/">Tiny Gecko</a>. </p> </div> </body> </html>