QmailtoasterMain Page | About | Help | FAQ | Special pages | Log in

Printable version | Disclaimers | Privacy policy

Upgrading

From Qmailtoaster

This page is obsolete. Please see QmailToaster-Plus for the current version.


Contents

History

The original upgrade.sh script was written by Jake Vickers.

Erik Espinoza's current-download-script and parts of the current-install-script written by Nick Hemmesch were added to it.

Backup and restore of configuration files was added by Devendra Meena.

Thanks go to Jake, Nick, Erik, and Devendra who contributed to the previous upgrade.sh script. I could not have written the new script without their previous work as a starting point. -ES

On July 13, 2006 Eric 'shubes' announced to the email list the release of new upgrade scripts. The new scripts are a substantial change to the former process, and thus go by new names, qtp-newmodel and various qtp-* sub-scripts. They create a new model of QmailToaster with minimal effort and downtime.

The scripts have undergone substantial testing and use, and are now considered to be Production status. Please report to the list any problems and/or suggestions.


Overview

Here's an overview of what the scripts do (in sequence):

That's it in a nutshell.


Aspects

Some aspects of the script:

        # qtp-newmodel -b >qtp-newmodel.log 2>&1 &

The Sandbox

The sandbox is essentially what is more commonly known as a chroot jail. The term sandbox is used instead of jail because few people are fond of jail, and the purpose of this sandbox is to provide a safe place to play (which a sandbox is for the most part).

The sandbox is basically a copy of a (very) large portion of your system. Hence, it occupies a good deal of disk space, probably 2.4G or better. It also takes quite some time (20 cpu minutes or so on a P-II/266) to build, but this is only a fraction of the time it takes to compile. A good trade, given the savings in down time.

Just before the sandbox is built, you will be asked if you'd like a copied or linked sandbox. A copied sandbox is a normal copy of files on your system.

For a linked sandbox, the script will attempt to use hard links instead of copies for a majority of the files, drastically reducing disk space required (down to as little as 100M). However, this savings can only be achieved when the sandbox and other major system directories are contained on the same partition as the root (/) filesystem, as hard links cannot cross partition boundaries. The script will automatically copy files which are on separate partitions when trying to build a linked sandbox. Any partition scheme should work, although a linked sandbox provides the greatest savings when the system is largely on a single partition.

The sandbox can be placed on any mounted partition. If the sandbox is on a partition other than root (/), the linked option will not be available.

Note regarding reuse: If any substantial packages (i.e. qmailtoaster-plus, OS libs) have been upgraded since the sandbox was built, you should create a new sandbox (the script gives you this option). Otherwise, the sandbox can safely be reused.


Instructions

The scripts are available as part of the QmailToaster-Plus package. They are not supported independently. Please install the QmailToaster-Plus package in order to obtain them.

To run the script(s), at the command prompt simply enter:

# qtp-newmodel

You may also invoke it from qtp-menu, which is part of QmailToaster-Plus too.

Simply answer the questions at the prompts, and that's all there is to it!


Tailoring

qtp-config

There are three variables set by the qtp-config script that you may care to change, although it is strongly recommended that you change them only if you have a good reason to do so and you know what you are doing:

rpmbuild

If you need to tailor the rpmbuild command for a specific package, you can do so by creating a file in the /opt/qmailtoaster-plus/etc/rpmbuild directory containing the command line option(s) to be used for building the package. For example, if you want to use the "--define 'spambox 1'" option for the qmailadmin-toaster package, you simply create a file named qmailadmin-toaster in the rpmbuild directory that contains "--define 'spambox 1'" (without the double quotes). There is a qmailadmin-toaster.sample file included in the QmailToaster-Plus package for reference.

Retrieved from "http://wiki.qmailtoaster.com/index.php/Upgrading"

This page has been accessed 42,847 times. This page was last modified on 4 October 2008, at 18:18. Content is available under GNU Free Documentation License 1.2.


Find

Browse
Main page
Community portal
Current events
Recent changes
Random page
Help
Edit
View source
Editing help
This page
Discuss this page
New section
Printable version
Context
Page history
What links here
Related changes
My pages
Log in / create account
Special pages
New pages
File list
Statistics
More...