5,576
edits
Changes
Jump to navigation
Jump to search
Line 29:
Line 29: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
SME Server:Documentation:Administration Manual:Chapter5 (view source)
Revision as of 17:11, 28 August 2014
, 17:11, 28 August 2014→Upgrading From A Previous Version
====Upgrading From A Previous Version====
====Upgrading From A Previous Version====
=====Upgrade from 8.x to 9.x=====
{{Note box|msg=In-place upgrades to SME 9.x using yum or CD are not supported due to design constraints imposed by CentOS.
It is necessary to backup the old server & then restore to the new server. Contribs will need to be reinstalled.}}
The simplest way to do this is via a Console Backup to attached USB disk on the old server. Alternatively use one of the Backup & Restore options available in server manager panel, ie backup to desktop, or backup to workstation (either to attached USB or network share). Other non standard options exist to Backup virtual servers that do not have USB ports etc, & Restore to similar virtual systems, eg using ssh.
{{Tip box|msg=The Restore from USB on first boot function (on a newly installed SME 9 server), will only utilise backups that are saved as smeserver.tgz files, which are the Console backup to USB or the server manager backup to Desktop. The server manager backup to Workstation (either to USB or network share) creates a "backupdate.dar" type filename (or multiple split parts) & cannot be used to restore using the Restore on first boot function, it can only be used for restores from server manager.}}
======Upgrade via Console backup to USB drive======
* Log in as admin & Backup the '''old server''' via a Console Backup to attached USB disk. This may take many hours if you have a lot of data on your server, depending on USB port speed, USB drive speed, & types of files being backed up ie whether already compressed or not etc. Typically for 250Gb of data on your server hard drive, 2 to 4 hours.
* Install the SME 9.x OS from CD on the new hardware (on new server).
* Select to do a Restore on first boot of the newly installed SME Server 9. Only attach USB containing the backup file, when asked on first reboot. Restore may take a few hours depending on data size etc. Make sure you wait for the Restore complete message.
======Upgrade via server manager backup to Desktop or Workstation (USB or network)======
* On the old server in server manager, configure the required backup in the Backup or Restore panel. Schedule the backup to run at a suitable time. This backup can be to a workstation desktop for systems with a smaller amount of data, which creates a smeserver.tgz backup file, or to a locally connected USB drive or to a network share, & creates xx...xx.dar files, split into multiple parts if configured & data size is large. This may take many hours to run depending on data size etc.
* On the new SME9 server, manually configure the '''identical''' backup job in the server manager Backup or Restore panel. The backup job MUST point to the exact same location that the original backup file is saved to.
* Select the Restore function within server manager & select the full backup you want to restore from. This may take many hours to run depending on data size, network speed etc. Make sure you wait for the Restore complete message.
* Basic networking configuration of the new and/or restored SME9 server will be required if different from original server.
======Upgrade using command line restore via ssh or USB======
* It is possible to use the command line to transfer a backup file via ssh (or USB) to the new server & then to run the restore. Standard & non standard backup concepts & procedures are outlined in the Backup server config Howto, http://wiki.contribs.org/Backup_server_config If using any non standard method, then the integrity of your SME server data cannot be guaranteed.
* To do a standard backup & restore using CLI, on the old server log in as admin & perform the Console Backup to USB drive (to a locally connected USB). Alternatively using suitable commands, a smeserver.tgz backup file could be created & saved to / folder, refer Howto.
* Install the SME 9.x OS from CD on the new hardware (on new server).
* Answer No when asked if you want to restore from USB during the first boot.
* If you created or have the backup file on the old server, transfer the smeserver.tgz backup file via ssh from your old server to your new server. Both servers must be connected & remote access enabled
* On the old server do:
scp -P zzzz /smeserver.tgz newserverIP:/
(where zzzz = port number)
* If you saved the backup file to USB, then transfer the smeserver.tgz backup file from USB to your new server
* Log in as root or a root user on the new server & do:
mount /media/usbdisk
cp /media/usbdisk/Backup-date-folder/smeserver.tgz /
(replace usbdisk with actual mount point name & Backup-date-folder with actual folder date name)
* After the backup file has been copied to the new server, on the new server do:
cd /
signal-event pre-restore
tar -C / -xzvf smeserver.tgz
/sbin/e-smith/signal-event post-upgrade
/sbin/e-smith/signal-event reboot
* Before restarting the new server, disconnect old server from network (as you will have clashes due to duplicate IPs)
* On new server do:
cd /
rm smeserver.tgz
*Note the backup & restore may take many hours to complete depending on data size etc.
* After restore, the Configuration of the new server should be identical to the old server.
* Note with two servers connected during ssh copying operations, basic networking configuration of the new unrestored SME9 server will need to be temporarily different to the old server to avoid clashes
======Reinstall Contribs after restore======
Add on contrib rpm packages will need to be re-installed on the new SME 9.x server as these are NOT included in the backup. Contrib data & configuration is included in backups & will be restored, but its usefulness will depend on the contrib design being unchanged between older (SME7/el4 or SME8/el5) & SME9/el6 package versions.
======Delete & Reconfigure Manual tweaks======
Other manual tweaks eg custom templates or scripts, will need to be deleted & recreated in line with SME 9.x template code & base code.
Where extensive modifications have been made to the "old server (eg SME8.1)", it is recommended to carry out a test backup & restore upgrade first, to discover any problems & ascertain suitable fixes & workarounds. Removing contribs & custom templates before upgrading is recommended.
=====Upgrade from 7.x to 8.x=====
If you have previously installed a server and now wish to upgrade to a later version, you can do so while preserving your configuration data. To do so, select Upgrade from the appropriate screen in the installation process as described in section 5.4. Installing the Software.
If you have previously installed a server and now wish to upgrade to a later version, you can do so while preserving your configuration data. To do so, select Upgrade from the appropriate screen in the installation process as described in section 5.4. Installing the Software.