Location: PHPKode > projects > XMBForum > XMB-1.9.11.09/documentation/contents/upgrade.html
<html>
<head>
<title>XMB 1.9.11 Forum Software Documentation</title>

	<meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
	<meta name="publisher" content="The XMB Group" />
	<meta name="copyright" content="&copy; The XMB Group" />
	<meta name="author" content="Nick Bradfish (Webster)" />
	
	<link rel="stylesheet" type="text/css" href="./styles/main.css" media="screen" />
</head>

<body>
	<span id="pageTitle">Upgrading to XMB 1.9.11</span>
	
	Upgrading is a one-way process.  To backout you will need to restore your files and database from a backup.
	<br /><br />
	
	<strong>Backup Your Forum</strong>
	<br />
	Please backup both your forums database and files before continuing.  This may seem like common sense but is often forgotten.
	If the upgrade process fails and you do not have a backup, XMB will be unable to help you.  All data could be lost: posts, users,
	etc.  You have been warned!
	<br /><br />

	<strong>Modifications Notice</strong>
	<br />
	This upgrader is designed to work with modifications installed.  However, all modification data, templates and code, will be destroyed during the
	upgrade process.  Please proceed with extreme caution if you wish to keep your modification data intact.
	<br /><br />
	
	<strong>Known Issues</strong>
	<br />
	These are known issues with the upgrader.  However, they will only affect a small percentage of XMB Forum users.

	<ul style="margin-top: 5px;">
		<li>Upgrading can be quite resource intensive, especially with large databases.</li>
		<li>The upgrade script may appear to time out or be inactive.  Do NOT stop it or close your browser window.</li>
		<li>The upgrade script can consume up to two times the amount of disk space you are currently using.
			Make sure your disk space quota is set accordingly.</li>
		<li>The upgrade script occasionally fails to handle out of order columns, particularly in the settings table.
        <li>If the upgrader stops while modifying any table, please contact the support staff at <a href="http://www.xmbforum.com/">XMBForum.com</a>.
            Restore your database and original files from backups if necessary.</li>
	</ul>

	<strong>Normal Upgrade Instructions for Versions 1.9.5 through 1.9.10</strong>

	<ol style="margin-top: 5px;">
        <li>Backup the database and all files.  Remember to keep the config.php settings handy.</li>
		<li>Disable XMB using the Board Status setting of the Administration Panel.</li>
		<li>Upload all 1.9.11 files over the top of your existing files.</li>
		<li>Delete the /install/ directory and all files in it.</li>
		<li>Edit the <i>new</i> config.php file with your details.  It may be helpful to reference your old config.php.</li>
		<li>Upload the /upgrade/ directory to your forum directory.</li>
		<li>Run: http://www.yourdomain.com/path/upgrade/upgrade.php</li>
		<li>Upon completion, verify that the /upgrade/ directory has been removed.</li>
		<li>Enable XMB using the Board Status setting of the Administration Panel.</li>
	</ol>
	
	<strong>Alternative Upgrade Paths</strong>
	<ul style="margin-top: 5px;">
        <li>XMB 1.9.10 - An alternative upgrade script will be provided to anyone who wants to avoid the normal upgrade utility.
            This script is specific to one version can only be used to upgrade that version of XMB.
            This option is preferred for very large boards and for webmasters who need to preserve extra columns of data in the xmb tables.
        <li>XMB 1.9.10 - Complete diff & patch information will be provided to anyone who wants to manually edit their PHP files.
        <li>XMB 1.9.9 - If you are an early adopter of version 1.9.9, then you may migrate to 1.9.11
            using the same alternative upgrade script that works for 1.9.10, because they share the same schema.  
        <li>XMB 1.9.8 SP2/SP3 - These versions have reached their end of support and should be upgraded with 1.9.10 or the Normal Upgrade.
        <li>XMB 1.9.5 - The Normal Upgrade path is recommended for this older version.
        <li>XMB 1.9.x - It has been determined that upgrading to version 1.9.5 is a prerequisite for upgrading to any newer version.
        <li>XMB 1.8 - Upgrading to XMB 1.9.1 is a required step in bringing your board current.
	</ul>

	<strong>Enjoy XMB 1.9.11!</strong>
</body>
</html>
Return current item: XMBForum