2
0

readme_update.html 18 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  2. <html xmlns="http://www.w3.org/1999/xhtml">
  3. <head>
  4. <title>SMF 2.0 Update Guide</title>
  5. <link rel="stylesheet" type="text/css" href="Themes/default/css/index.css?fin20" />
  6. <style type="text/css">
  7. h1.forumtitle
  8. {
  9. color: #346;
  10. }
  11. #upper_section .user
  12. {
  13. height: 4em;
  14. }
  15. #upper_section .news
  16. {
  17. height: 80px;
  18. }
  19. #main_screen
  20. {
  21. padding: 0 40px;
  22. }
  23. #main_screen h2
  24. {
  25. font-size: 2em;
  26. border-bottom: solid 1px #d05800;
  27. line-height: 2em;
  28. margin: 0 0 0.5em 0;
  29. color: #d05800;
  30. }
  31. h3
  32. {
  33. color: #d05800;
  34. }
  35. #content_section
  36. {
  37. position: relative;
  38. top: -20px;
  39. }
  40. #main_content_section .panel
  41. {
  42. padding: 1em 2em 1em 1em;
  43. line-height: 1.6em;
  44. }
  45. #main_content_section h2
  46. {
  47. font-size: 1.5em;
  48. border-bottom: solid 1px #d05800;
  49. line-height: 1.5em;
  50. margin: 0 2em 0.5em 0;
  51. color: #d05800;
  52. }
  53. #main_content_section li
  54. {
  55. line-height: 1.6em;
  56. font-weight: bold;
  57. color: #555;
  58. }
  59. #main_content_section li ul
  60. {
  61. padding-bottom: 0.7em;
  62. }
  63. #main_content_section li li
  64. {
  65. font-weight: normal;
  66. line-height: 1.6em;
  67. }
  68. #liftup
  69. {
  70. position: relative;
  71. top: -70px;
  72. }
  73. #footer_section
  74. {
  75. position: relative;
  76. top: -60px;
  77. }
  78. tt
  79. {
  80. font-family: verdana, sans-serif;
  81. letter-spacing: 1px;
  82. font-weight: bold;
  83. font-size: 90%;
  84. font-style: italic;
  85. }
  86. dt
  87. {
  88. font-weight: bold;
  89. color: #555;
  90. margin-bottom: .1em;
  91. }
  92. dl
  93. {
  94. margin-top: .2em;
  95. margin-left: 2em;
  96. margin-bottom: .5em;
  97. }
  98. dd
  99. {
  100. line-height: 1.5em;
  101. margin-left: 2em;
  102. margin-bottom: .1em;
  103. }
  104. #header, #content_section, #footer_section
  105. {
  106. width: 90%;
  107. margin: 0 auto;
  108. }
  109. a:link, a:visited
  110. {
  111. color: #3E5D8F;
  112. }
  113. a:hover
  114. {
  115. color: #346;
  116. }
  117. </style>
  118. </head>
  119. <body>
  120. <div id="header"><div class="frame">
  121. <div id="top_section">
  122. <h1 class="forumtitle">SMF 2.0 Update Guide</h1>
  123. <img id="smflogo" src="Themes/default/images/smflogo.png" alt="Simple Machines Forum" title="Simple Machines Forum" />
  124. </div>
  125. <div id="upper_section" class="middletext" style="overflow: hidden;">
  126. <div class="user"></div>
  127. <div class="news normaltext">
  128. </div>
  129. </div>
  130. </div></div>
  131. <div id="content_section"><div class="frame">
  132. <div id="main_content_section">
  133. <div id="liftup">
  134. <div class="panel">
  135. <h2 id="contents">Updating your forum</h2>
  136. <p>Thank you for deciding to update your installation of <a href="http://www.simplemachines.org/smf/">SMF</a>. Before you get started, please remember that there is <a href="http://www.simplemachines.org/community/index.php">a place for help at www.simplemachines.org</a> if you run into any problems at all.</p>
  137. <p>If you are looking to convert from YaBB SE or a version of SMF older than the previous release, you may have downloaded the wrong package. Please check <a href="http://download.simplemachines.org/">the downloads page</a> for more information.</p>
  138. <p>You can find the following information in this file:</p>
  139. <ul style="list-style-type: none;">
  140. <li>&raquo; <a href="#requirements">Minimum installation requirements</a></li>
  141. <li>&raquo; <a href="#recommendations">Recommendations for best performance</a></li>
  142. <li>&raquo; <a href="#backups">Backing up data</a></li>
  143. <li>&raquo; <a href="#uploadingftp">Upload files method 1: using FTP</a></li>
  144. <li>&raquo; <a href="#Set_File_Permissions">Set file permissions</a></li>
  145. <li>&raquo; <a href="#Run_the_upgrading_tool">Run the upgrading tool</a></li>
  146. <li>&raquo; <a href="#webinstall">Upload files method 2: using webinstall.php</a></li>
  147. <li>&raquo; <a href="#finishing">Finishing the update and cleaning up</a></li>
  148. </ul>
  149. </div>
  150. <div class="panel">
  151. <h2 id="requirements">Minimum installation requirements</h2>
  152. <p>Your server must meet a few requirements to be able to run SMF. If you are unsure as to whether your webserver meets these, please try to update anyway - it should detect any problems.</p>
  153. <ul>
  154. <li>Any webserver that properly supports PHP, such as <a href="http://httpd.apache.org/" target="_blank">Apache</a> or <a href="http://www.microsoft.com/iis" target="_blank">Internet Information Services (IIS)</a>.</li>
  155. <li>
  156. <a href="http://www.php.net" target="_blank">PHP</a> 4.1.0 or higher. The following directives are required to be set correctly in php.ini:
  157. <ul>
  158. <li>the engine directive must be On.</li>
  159. <li>the <a href="http://www.php.net/sybase#ini.magic-quotes-sybase" target="_blank">magic_quotes_sybase</a> directive must be set to Off.</li>
  160. <li>the <a href="http://www.php.net/session#ini.session.save-path" target="_blank">session.save_path</a> directive must be set to a valid directory.</li>
  161. <li>the <a href="http://www.php.net/manual/en/ini.core.php#ini.file-uploads" target="_blank">file_uploads</a> directive must be On.</li>
  162. <li>the <a href="http://www.php.net/manual/en/ini.core.php#ini.upload-tmp-dir" target="_blank">upload_tmp_dir</a> must be set to a valid directory.</li>
  163. </ul>
  164. </li>
  165. <li>Any of the following database systems
  166. <ul>
  167. <li><a href="http://www.mysql.com/" target="_blank">MySQL</a> 4.0.18 or higher.</li>
  168. <li><a href="http://www.postgresql.org/" target="_blank">PostgreSQL</a> 8.0 or higher.</li>
  169. <li><a href="http://www.sqlite.org/" target="_blank">SQLite</a> 1.x - 2.x.</li>
  170. </ul>
  171. </li>
  172. <li>at least 2 megabytes of storage space in the database, although more is highly recommended.</li>
  173. <li>The database user must have at least the following privileges: SELECT, INSERT, UPDATE, DELETE, ALTER, and INDEX.</li>
  174. <li>about 20 megabytes of storage space on the web server, although more is recommended.</li>
  175. </ul><br />
  176. <h2 id="recommendations">Recommendations for best performance</h2>
  177. <ul>
  178. <li>Windows, <a href="http://www.linux.org/" target="_blank">Linux</a> or another Unix based operating system.</li>
  179. <li>the <a href="http://aspell.sf.net/" target="_blank">GNU Aspell</a> 0.50 or higher and <a href="http://ftp.gnu.org/gnu/aspell/dict/" target="_blank">its dictionaries</a> for spell checking functionality.</li>
  180. <li><a href="http://httpd.apache.org/" target="_blank">Apache</a> 2.0.0 or higher with <a href="http://httpd.apache.org/docs-2.0/mod/core.html#acceptpathinfo" target="_blank">AcceptPathInfo</a> set to On (Apache 2 and later only) for queryless URL support.</li>
  181. <li>
  182. <a href="http://www.php.net" target="_blank">PHP</a> 5.2.0 or higher, with the following set in php.ini:
  183. <ul>
  184. <li>the <a href="http://www.php.net/manual/en/info.configuration.php#ini.max-input-time" target="_blank">max_input_time</a> directive is set to a value of at least 30.</li>
  185. <li>the <a href="http://www.php.net/manual/en/ini.core.php#ini.post-max-size" target="_blank">post_max_size</a> and <a href="http://www.php.net/configuration.directives#ini.upload-max-filesize" target="_blank">upload_max_filesize</a> directives set to the size of the largest attachments you wish to be able to upload.</li>
  186. <li>the <a href="http://www.php.net/session#ini.session.use-trans-sid" target="_blank">session.use_trans_sid</a> directive set to Off.</li>
  187. <li>the <a href="http://www.php.net/manual/en/ini.core.php#ini.memory-limit" target="_blank">memory_limit</a> directive is set to at least 8M.</li>
  188. <li>the <a href="http://www.php.net/manual/en/info.configuration.php#ini.max-execution-time" target="_blank">max_execution_time</a> directive is set to at least 15.</li>
  189. <li>the <a href="http://www.php.net/manual/en/ini.core.php#ini.register-globals" target="_blank">register_globals</a> directive is set to Off.</li>
  190. <li>the <a href="http://www.php.net/manual/en/features.safe-mode.php" target="_blank">safe mode</a> disabled or <a href="http://httpd.apache.org/docs/2.0/suexec.html" target="_blank">suEXEC</a> enabled.</li>
  191. <li>the <a href="http://www.php.net/manual/en/book.bc.php" target="_blank">BCMath</a> library enabled for using the <a href="/smf/Registration#Settings" title="Registration">OpenID</a> registration method.</li>
  192. </ul>
  193. </li>
  194. <li>Any of the following database systems
  195. <ul>
  196. <li><a href="http://www.mysql.com/" target="_blank">MySQL</a> 5.0 or higher.</li>
  197. <li><a href="http://www.postgresql.org/" target="_blank">PostgreSQL</a> 8.3.3 or higher.</li>
  198. <li><a href="http://www.sqlite.org/" target="_blank">SQLite</a> 2.8.</li>
  199. </ul>
  200. </li>
  201. <li><a href="http://www.boutell.com/gd/" target="_blank">GD Graphics Library</a> 2.0 or higher.</li>
  202. </ul>
  203. <p>If your server does not meet these requirements, SMF may not work properly.</p>
  204. </div>
  205. <div class="panel">
  206. <h2 id="backups">Backing up data</h2>
  207. <p>Before starting the update process, a backup of the live database should be taken. This protects the forum from accidental damage and any issues from updating. Although all steps are taken, and extensive testing carried out, sometimes issues develop. Therefore, having a backup is crucial. The upgrading tool can backup all database tables before it runs, however the best practice is to have a full backup available. </p>
  208. <h3>Back up a database using SMF</h3>
  209. <p>From SMF, navigate to Forum Maintenance. (Administration Center -&gt; Maintenance -&gt; Forum Maintenance) On the database section, save the data and the structure. Then, compress the file. Select &quot;Download&quot; and wait for the database to complete the download completely. It is recommended if you use this method to verify that the backup is complete by opening the file and checking the last line. If the file is not complete and has an error please try one of the other methods to backup your database.</p>
  210. <h3>Back up a database using PHPMyAdmin</h3>
  211. <p>PHPMyAdmin gives the option to export a database, from the initial page, select the &quot;Export&quot; option and follow the instructions. Select your SMF database. These are different based on host. </p>
  212. <h3>Back up a database using a control panel</h3>
  213. <p>If your hosting service provides a control panel interface, this can be used to back up a database. Selecting the &quot;Backups&quot; or &quot;Backups Wizard&quot; options should take you to a page, prompting you to back up your database. With different hosts, these options may have different titles. </p>
  214. </div>
  215. <div class="panel">
  216. <h2 id="uploadingftp">Upload files method 1: manually uploading files</h2>
  217. <p>If your server doesn't support webinstall.php than you can use an FTP client and an FTP access to upload the files to your server.</p>
  218. <p>All you need to do is upload all of the files in this package, excluding this file itself, to your server. You should upload it to the same directory as your previous installation of SMF. If you are given the option to &quot;resume&quot; uploads, make sure you do not do that - you must upload all of the files. You may wish to make sure that all of the files were uploaded, such as those in <tt>Themes/default/languages</tt>, because some FTP clients have been known to drop files.</p>
  219. </div>
  220. <div class="panel">
  221. <h2 id="Set_File_Permissions">Set file permissions</h2>
  222. <p>After the upgrade archive has been uploaded and extracted, you need to set the files' permissions. This is commonly done by use of the Unix utility <b>CHMOD</b>. The correct CHMOD value for SMF files is either 777, 775 or 755, depending on your hosting service. There are two methods for this step, the method used depends on the hosting service that you use.</p>
  223. <h3>Setting File Permissions With the Upgrader</h3>
  224. <p>The SMF upgrader can set file permissions simply and easily. Navigating to the directory where SMF is located should redirect you to the upgrade.php file and prompt the upgrader. For example: www.yourdomain.com/forum/upgrade.php. If the upgrader detects files that need their permissions adjusted it will prompt for FTP details so it can <b>CHMOD</b> the files it requires for the upgrade. This may not work on some servers.
  225. </p>
  226. <h3>Setting File Permissions With FTP</h3>
  227. <p>Using a control panel or FTP client, file permissions can be changed quickly and easily. Usually, FTP programs will allow permissions to be changed by right-clicking files/directories and selecting &quot;Properties&quot;, &quot;Attributes&quot; or &quot;Permissions&quot;. The desired numerical value can be entered, or if provided, check boxes can be changed.</p>
  228. <p>The following files and directories must be writable. Depending on how your server is set up, this could mean that they must have <b>CHMOD</b> values of 644, 664 or 666 for files, and 755, 775 or 777 for folders:</p>
  229. <ul><li>/attachments
  230. </li><li>/avatars
  231. </li><li>/Packages
  232. </li><li>/Packages/installed.list
  233. </li><li>/Smileys
  234. </li><li>/Themes
  235. </li><li>agreement.txt
  236. </li><li>Settings.php
  237. </li><li>Settings_bak.php
  238. </li><li>upgrade.php
  239. </li></ul>
  240. <p>If the permission on your files or folders does not make them writable, the SMF upgrader will report the problem. In that case, use your FTP client or host panel to reset the permissions for the files or folders the upgrader reports.</p>
  241. </div>
  242. <div class="panel">
  243. <h2 id="Run_the_upgrading_tool">Run the upgrading tool</h2>
  244. <p>The final step in updating SMF, is to run the upgrading tool. Navigate to the directory where SMF is located. It should redirect you to the upgrade.php file and prompt you to run the upgrade. In example: www.yourdomain.com/forum/upgrade.php. </p>
  245. <p>The first page you see may request your FTP information. If you see this screen, it is because the installer found some files or folders with inadequate permissions for SMF to run properly. If you enter your FTP information here, the installer can automatically fix these permissions for you. Please note that the path should be the same path you see in your FTP client. For example, it might be &quot;public_html/forum&quot;. And remember, the installer will not save your FTP password anywhere.</p>
  246. <h3>Upgrade settings</h3>
  247. <dl>
  248. <dt>Backup database with the prefix "backup_"</dt>
  249. <dd>Selecting this option will get the upgrade tool to copy all data in the database before upgrading within the original database.</dd>
  250. <dt>Maintenance Mode</dt>
  251. <dd>Selecting this option will place the forum into maintenance mode while upgrading rather than showing errors, this is highly recommended.</dd>
  252. <dt>Output extra debugging information.</dt>
  253. <dd>The upgrade tool can give detailed information while performing an upgrade by selecting this option, it will aid the support team to solve any errors if they occur while upgrading.</dd>
  254. </dl>
  255. </div>
  256. <div class="panel">
  257. <h2 id="webinstall">Upload files method 2: using webinstall.php</h2>
  258. <p>Your server may support webinstall.php. This script will automatically download SMF to your server. This may not work on all servers and also may require providing it with FTP details.</p>
  259. <p>The first thing you need to do is upload webinstall.php to the location of where SMF is to exist on your server.</p>
  260. <p>After you have finished uploading the file, point your browser to http://www.yourdomain.tld/forum/webinstall.php - where www.yourdomain.tld/forum is the URL to where you uploaded it. You should then see the webinstall interface.</p>
  261. <p>The first page you see may request your FTP information. If you see this screen, it is because the webinstaller found some files or folders with inadequate permissions for SMF to run properly. If you enter your FTP information here, the webinstaller can automatically fix these permissions for you. Please note that the path should be the same path you see in your FTP client. For example, it might be &quot;public_html/forum&quot;. And remember, the webinstaller will not save your FTP password anywhere.</p>
  262. <p>On the webinstall interface you have an option to login, this is useful for charter members to easily download early releases. You may have an option to select multiple versions of SMF to download. It is up to you to decide which version of SMF you wish to install. Additionally you may have options of additional languages to download.</p>
  263. <p>After specifying these options and agreeing to the agreement, webinstall will attempt to download al SMF files and decompress them in the same folder as webinstall.php. If successful you will be prompted to the SMF upgrade screen. If this fails you will need to follow the process below to upload files.</p>
  264. <p>In most cases, you'll want to have &quot;Put the forum into maintenance mode during upgrade.&quot; checked, because it will ensure that nothing is messed with while the upgrader is working. You may also wish to check &quot;Backup tables in your database...&quot;, which will make a backup of your old information and tables before making any changes in the database.</p>
  265. </div>
  266. <div class="panel">
  267. <h2 id="finishing">Finishing the update and cleaning up</h2>
  268. <p>Once all parts of the update have completed, check the box to remove the upgrade files from the server. If this does not work, they will need to be deleted via FTP. All upgrade files should be removed from the server once the update process is complete. These files are upgrade.php and the .sql files whose name starts with 'upgrade'. They are a major security risk if they are left on a server unattended. Once SMF has been updated, they are no longer needed.</p>
  269. <p>Good luck!<br />
  270. Simple Machines</p>
  271. </div>
  272. </div>
  273. </div>
  274. </div></div>
  275. <div id="footer_section"><div class="frame">
  276. <div class="smalltext padding"><a rel="license" href="http://creativecommons.org/licenses/by-sa/3.0/"><img alt="Creative Commons License" style="border-width:0; margin-bottom: 0.7em;" src="http://i.creativecommons.org/l/by-sa/3.0/80x15.png" /></a><br />This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by-sa/3.0/">Creative Commons Attribution-ShareAlike 3.0 Unported License</a>.</div>
  277. <div class="smalltext"><a href="http://www.simplemachines.org">Simple Machines Forum</a></div>
  278. </div></div>
  279. </body>
  280. </html>