SUNScholar/Upgrading/Hardware

Introduction

This is the very tricky one, if you are running your server on a bare metal machine.

If your server is virtualised then this procedure is not needed.

To avoid bare metal upgrades in the future, it is highly advised that you virtualise your server. Ask central campus IT to help you with this.

If you are presently running bare metal and are going to upgrade to another bare metal server, then read the guidelines below.

Bare metal to bare metal

These guidelines are very brief and require someone with Linux experience to execute correctly.

Prep new machine

1. Install the same version of DSpace and Ubuntu LTS server software on the new machine.
2. Do not create a PostgreSQL DB on the new machine.
3. The new machine hostname should be temporary. For example: http://irx.sun.ac.za

Export and import contents

1. Export the PostrgeSQL DB from the old machine and import it to the new machine using "pgAdmin". See: http://www.pgadmin.org
2. Put the old machine into maintenance mode.
3. Copy the entire /home/dspace folder from the old machine to the new machines /home/dspace folder using "rsync". See: http://en.wikipedia.org/wiki/Rsync

Enable Tomcat webapps on new machine

1. Follow this procedure to enable the java webapps on the new machine: http://wiki.lib.sun.ac.za/index.php/SUNScholar/Install_Dspace/S08
2. Check for correct operation of DSpace on the new machine.

Swap hostnames

1. Rename the old machine. For example: http://irz.sun.ac.za. Then reboot.
2. Rename the new machine so that it has the same hostname as the old machine. Then reboot.
3. Check for correct operation of DSpace on the new machine again.

Precautionary Principle

Keep the old machine running for a while until the new machine is stabilised. This way you have a live backup in case of big problems.

Comparison of bare metal versus virtual machine

ir1.sun.ac.za - Bare metal	ir2.sun.ac.za - Virtual machine
Specifications	Specifications
Load	Load
RAM	RAM

Back to Upgrading