PageRenderTime 29ms CodeModel.GetById 12ms RepoModel.GetById 0ms app.codeStats 1ms

/installation/moving.html

https://bitbucket.org/ellislab/expressionengine-user-guide/
HTML | 162 lines | 120 code | 41 blank | 1 comment | 0 complexity | e72a5200138dfdb79afd312cba0dd748 MD5 | raw file
    

  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
    2. 

  2. 

  3. <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
    4. 

  4. <head>
    5. 

  5.   <meta http-equiv="content-type" content="text/html; charset=utf-8" />
    6. 

  6. 

  7.   <title>Moving ExpressionEngine to Another Server&#8211; ExpressionEngine Documentation</title>
    8. 

  8. 

  9.   <meta name="MSSmartTagsPreventParsing" content="TRUE" />
    10. 

  10.   <link rel="contents" href="../index.html" />
    11. 

  11.   <style type="text/css" media="screen,print">@import url(../docs.css);</style>
    12. 

  12. </head>
    13. 

  13. 

  14. <body>
    15. 

  15. <div><a name="top"></a></div>
    16. 

  16. 

  17. <div id="header">
    18. 

  18. <table cellpadding="0" cellspacing="0" border="0" style="width:100%;"><tr>
    19. 

  19. <td class="docheading" style="width:300px;"><a href="../index.html"><img src="../images/user_guide.gif" width="231" height="24" alt="ExpressionEngine User Guide" /></a></td>
    20. 

  20. <td class="searchbox"><form method="get" action="http://www.google.com/search" class="searchbox"><div>Search&nbsp;&nbsp;<input type="text" class="input" name="q" id="q" size="31" maxlength="255" value="" /><input type="hidden" name="as_sitesearch" id="as_sitesearch" value="expressionengine.com/docs/" />&nbsp;<input type="submit" class="submit" name="sa" value="Search" /></div></form></td>
    21. 

  21. </tr>
    22. 

  22. </table>
    23. 

  23. </div>
    24. 

  24. 

  25. 

  26. <div id="navlinks">
    27. 

  27. <a href="../index.html">Table of Contents</a> &gt;
    28. 

  28. <a href="../index.html#install_docs">Installation and Update Instructions</a> &gt;
    29. 

  29. <strong>Moving ExpressionEngine to Another Server</strong>
    30. 

  30. </div>
    31. 

  31. 

  32. 

  33. <div id="content">
    34. 

  34. 

  35. 	<h1>Moving ExpressionEngine to Another Server</h1>
    36. 

  36. 

  37. 	<p>
    38. 

  38. 		The following steps outline the general procedure for moving ExpressionEngine to another server. Please note that 
    39. 

  39. 		you may need to perform additional steps if you are using any third-party add-ons that store their own path configurations.
    40. 

  40. 	</p>
    41. 

  41. 

  42. 	<h2>1. Verify Server Compatibility</h2>
    43. 

  43. 

  44. 	<p>Upload the <a href="../requirements.html">ExpressionEngine Server Wizard</a> to the new server and run it to verify 
    45. 

  45. 		basic compatibility with ExpressionEngine.
    46. 

  46. 	</p>
    47. 

  47. 

  48. 

  49. 	<h2>2. Synchronize Templates</h2>
    50. 

  50. 	<p class="tip">You can skip this step if you are not saving templates as files.</p>
    51. 

  51. 	<p>
    52. 

  52. 		From the Control Panel, go to <var>Design &gt; Templates &gt; Synchronize Templates</var>, select all templates
    53. 

  53. 		and click Submit.
    54. 

  54. 	</p>
    55. 

  55. 

  56. 

  57. 	<h2>3. Back-up Database and Files</h2>
    58. 

  58. 	<ul>
    59. 

  59. 		<li>Back-up your existing ExpressionEngine database.</li>
    60. 

  60. 		<li>Back-up all existing ExpressionEngine files and folders.</li>
    61. 

  61. 	</ul>
    62. 

  62. 	
    63. 

  63. 	
    64. 

  64. 	<h2>4. Prepare the New Database</h2>
    65. 

  65. 	<p>
    66. 

  66. 		Create a new, empty database on the new server and import the back-up file you created in Step 3 into it.
    67. 

  67. 		Typically this will be a SQL file (or a ZIP file containing the SQL file).
    68. 

  68. 	</p>
    69. 

  69. 

  70. 

  71. 	<h2>5. Copy Files and Folders</h2>
    72. 

  72. 	<p>Copy all ExpressionEngine files and folders from the old server to the new server. At a minimum, this will typically include:</p>
    73. 

  73. 	<ul>
    74. 

  74. 		<li><dfn>admin.php</dfn></li>
    75. 

  75. 		<li><dfn>index.php</dfn></li>
    76. 

  76. 		<li><kbd>images/</kbd></li>
    77. 

  77. 		<li><kbd>system/</kbd></li>
    78. 

  78. 		<li><kbd>themes/</kbd></li>
    79. 

  79. 	</ul>
    80. 

  80. 

  81. 

  82. 	<h2>6. Verify File Permissions</h2>
    83. 

  83. 

  84. 	<p class="important">If you are moving to <a href="http://enginehosting.com">EngineHosting</a> you can skip this step.
    85. 

  85. 	For other Unix hosts the following is typical, but you may check with your host to see if more restrictive permissions can be used to allow PHP to write to files (666) and folders (777).
    86. 

  86. 	On Windows servers the following will not apply, but you will need to ensure that the files and folders are writable by ExpressionEngine. You may need to contact your host for this.</p>
    87. 

  87. 	<ul>
    88. 

  88. 		<li>Ensure the following files are set to <samp>666</samp>:
    89. 

  89. 			<ul>
    90. 

  90. 				<li><var>system/expressionengine/config/</var><kbd>config.php</kbd></li>
    91. 

  91. 				<li><var>system/expressionengine/config/</var><kbd>database.php</kbd></li>
    92. 

  92. 			</ul>
    93. 

  93. 		</li>		
    94. 

  94. 		<li>Ensure the following folders are set to <samp>777</samp>:
    95. 

  95. 			<ul>
    96. 

  96. 				<li><var>/system/expressionengine/cache/</var></li>
    97. 

  97. 				<li><var>/images/avatars/uploads/</var></li>
    98. 

  98. 				<li><var>/images/captchas/</var></li>
    99. 

  99. 				<li><var>/images/member_photos/</var></li>
    100. 

  100. 				<li><var>/images/pm_attachments/</var></li>
    101. 

  101. 				<li><var>/images/signature_attachments/</var></li>
    102. 

  102. 				<li><var>/images/uploads/</var></li>
    103. 

  103. 			</ul>
    104. 

  104. 		</li>
    105. 

  105. 	</ul>
    106. 

  106. 

  107. 

  108. 	<h2>7. Update database.php</h2>
    109. 

  109. 	<p>
    110. 

  110. 		Open <var>system/expressionengine/config/</var><kbd>database.php</kbd> and update the settings to
    111. 

  111. 		match those of the new server.
    112. 

  112. 	</p>
    113. 

  113. 

  114. 

  115. 	<h2>8. Verify index.php and admin.php</h2>
    116. 

  116. 	<p>
    117. 

  117. 		Verify that your site's root <kbd>index.php</kbd> and <kbd>admin.php</kbd> files have the correct settings for the new server.
    118. 

  118. 	</p>
    119. 

  119. 

  120. 

  121. 	<h2>9. Log In and Update Paths</h2>
    122. 

  122. 	<p>
    123. 

  123. 		At this point, you should be able to log in to the Control Panel using <kbd>admin.php</kbd>. If not, please verify that
    124. 

  124. 		the settings made in Steps 7 and 8 are correct.
    125. 

  125. 	</p>
    126. 

  126. 

  127. 	<p>There are typically several areas of the Control Panel in which paths may need to be updated, including:</p>
    128. 

  128. 

  129. 	<ul>
    130. 

  130. 		<li><var>Admin &gt; General Configuration</var></li>
    131. 

  131. 		<li><var>Admin &gt; Channel Administration &gt; Channels</var></li> 
    132. 

  132. 		<li><var>Admin &gt; Security and Privacy &gt; Captcha Preferences</var></li> 
    133. 

  133. 		<li><var>Admin &gt; System Administration &gt; Emoticon Preferences</var></li> 
    134. 

  134. 		<li><var>Content &gt; Files &gt; File Upload Preferences</var></li>
    135. 

  135. 		<li><var>Members &gt;  Preferences</var></li> 
    136. 

  136. 		<li><var>Design &gt; Templates &gt; Global Preferences</var></li>
    137. 

  137. 	</ul>
    138. 

  138. 

  139. 

  140. 	<h2>10. Clear Caches</h2>
    141. 

  141. 	<p>Go to <dfn>Tools &gt; Data &gt; Clear Caching</dfn>.  Select <strong>All Caches</strong> and click Submit.</p>
    142. 

  142. 

  143. 

  144. 	<h2>You're Done!</h2>
    145. 

  145. 	<p>
    146. 

  146. 		At this point, your site should be fully functional. Check to make sure that there are no links still
    147. 

  147. 		pointing to the previous server. It is recommended that links be generated using the <a href="../templates/globals/path.html">{path}</a>
    148. 

  148. 		or <a href="../templates/globals/single_variables.html#var_site_url">{site_url}</a> variables for maximum portability.
    149. 

  149. 	</p>
    150. 

  150. </div>
    151. 

  151. 

  152. 

  153. <p class="center"><a href="#top">Top of Page</a></p>
    154. 

  154. 

  155. <!-- {user_guide_comments} -->
    156. 

  156. 

  157. <div id="footer">
    158. 

  158.   <address><a href="http://expressionengine.com/">ExpressionEngine</a> &#8211; Copyright &#169; 2002-2011 &#8211; <a href="http://ellislab.com/">EllisLab, Inc.</a></address>
    159. 

  159. </div>
    160. 

  160. 

  161. </body>
    162. 

  162. </html>
    163.