/usr/lib/cyrus/bin/upgrade-db is in cyrus-common 2.4.18-3.
This file is owned by root:root, with mode 0o755.
The actual contents of the file can be viewed below.
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 | #!/bin/sh
# Cyrus database backends upgrade script
# (C) 2001 Ondřej Surý <ondrej@sury.org>
# distributed under the same licence as Cyrus IMAPd
#
# Run this script as root.  Ordinarily it will be run automatically in
# post-install.
set -e
export PATH=/sbin:/usr/sbin:/bin:/usr/bin
CONFIG_DIR=$(LC_ALL=C gawk '/^configdirectory:[[:blank:]]/ { print $2 }' < /etc/imapd.conf)
BACKUP_DIR=/var/backup/cyrus-imapd/$(date +%Y%m%d-%H%M%S)
mkdir -p $BACKUP_DIR
backupdb() {
    case "$2" in
	skiplist|flat|berkeley*)
	    cp -a $CONFIG_DIR/$1 $BACKUP_DIR
	    ;;
	quotalegacy)
	    echo "$0: Cannot backup $2 format" 1>&2
	    ;;
	*)
	    echo "$0: Unknown database format" 1>&2;
	    return 1
	    ;;
    esac
}
backupbdb() {
    mkdir -p $BACKUP_DIR/db
    su cyrus -c "db$1_recover -h $CONFIG_DIR/db"
    su cyrus -c "db$1_archive -h $CONFIG_DIR/db -l" | \
	while read log_file; do
	    cp -a $CONFIG_DIR/db/$log_file $BACKUP_DIR/db
	done
}
upgradebdb() {
    su cyrus -c "db$2_upgrade -h $CONFIG_DIR/db $CONFIG_DIR/$1"
}
checkpointbdb() {
    su cyrus -c "db$1_checkpoint -h $CONFIG_DIR/db -1"
    su cyrus -c "db$1_archive -h $CONFIG_DIR/db -d"
}
upgradedb() {
    TMPFILE=$(mktemp /tmp/$1.XXXXXXXX)
     /usr/lib/cyrus/cvt_cyrusdb $CONFIG_DIR/$1 $2 $TMPFILE $3
    rm -f $CONFIG_DIR/$1
    mv $TMPFILE $CONFIG_DIR/$1
    chown cyrus:mail $CONFIG_DIR/$1
}
removedb() {
    rm -f $CONFIG_DIR/$1
}
upgradealldb() {
    OLD_LIST=$2
    NEW_LIST=$1
    OLD_DBVERSION=$(LC_ALL=C gawk '/^DBENGINE[[:blank:]]/ { print $2 }' $OLD_LIST | sed -e "s/BerkeleyDB//")
    NEW_DBVERSION=$(LC_ALL=C gawk '/^DBENGINE[[:blank:]]/ { print $2 }' $NEW_LIST | sed -e "s/BerkeleyDB//")
   
    if [ "${OLD_DBVERSION}" != "${NEW_DBVERSION}" ]; then
	DB_UTIL_NOT_FOUND=
    
	if [ ! -x "/usr/bin/db${OLD_DBVERSION}_recover" ]; then
	    echo "$0: db${OLD_DBVERSION}-util not installed" 1>&2
	    echo "$0: please do: [sudo] apt-get install db${OLD_DBVERSION}-util" 1>&2
	    echo "$0: and rerun the upgrade again" 1>&2
	    DB_UTIL_NOT_FOUND=yes
	fi
	if [ ! -x "/usr/bin/db${NEW_DBVERSION}_upgrade" ]; then
	    echo "$0: db${NEW_DBVERSION}-util not installed" 1>&2
	    echo "$0: please do: [sudo] apt-get install db${NEW_DBVERSION}-util" 1>&2
	    echo "$0: and rerun the upgrade again" 1>&2
	    DB_UTIL_NOT_FOUND=yes
	fi
	if [ -n "${DB_UTIL_NOT_FOUND}" ]; then
	    return 2
	fi
	backupbdb ${OLD_DBVERSION}
    fi
    
    while read -r OLD_DBKEY OLD_DBVALUE ; do
	NEW_DBVALUE=$(LC_ALL=C gawk "/^${OLD_DBKEY}[[:blank:]]/ { print \$2 }" $NEW_LIST)
	if [ -z "${NEW_DBVALUE}" ]; then
	    echo "$0: WARNING: Cannot upgrade $OLD_DBKEY from $OLD_DBVALUE to empty" 1>&2
	    continue
	fi
	DO_UPGRADE_DB=
	if [ "${NEW_DBVALUE}" != "${OLD_DBVALUE}" ] ; then
	    DO_UPGRADE_DB=yes
	fi
	
	DBFILE=
	case "$OLD_DBKEY" in
	    DBENGINE|ZONEINFO)
		continue
		;;
	    ANNOTATION)
		DBFILE=annotations.db
		;;
	    DUPLICATE)
		DBFILE=deliver.db
		;;
	    MBOX)
		DBFILE=mailboxes.db
		;;
	    QUOTA|SEEN|SUBS)
		if [ -n "${DO_UPGRADE_DB}" ]; then
		    echo "$0: Cannot upgrade ${OLD_DBKEY} database from ${OLD_DBVALUE} to ${NEW_DBVALUE} yet" 1>&2
		    return 1
		fi
		;;
	    PTS|STATUSCACHE|TLS)
		;;
	    USERDENY)
		DBFILE=user_deny.db
		;;
	    *)
		echo "$0: Unknown type of DB: $OLD_DBKEY" 1>&2
		return 1
		;;
	esac
	# Just remove PTS, TLS and STATUSCACHE databases
	if [ -n "${DO_UPGRADE_DB}" ]; then
	    case "$OLD_DBKEY" in
		PTS)
		    removedb ptscache.db
		    continue
		    ;;
		TLS)
		    removedb tls_sessions.db
		    continue
		    ;;
		STATUSCACHE)
		    removedb statuscache.db
		    continue
		    ;;
	    esac
	fi
	# Operate only if the database exists
	if [ -f $CONFIG_DIR/$DBFILE ]; then
	    if [ -n "${DO_UPGRADE_DB}" -o "${OLD_DBVERSION}" != "${NEW_DBVERSION}" ]; then
		# Backup cyrus database file
		backupdb $DBFILE $OLD_DBVALUE;
		case "${OLD_DBVALUE}" in
		    berkeley*)
			upgradebdb $DBFILE ${NEW_DBVERSION}
			;;
		esac
	    fi
	    if [ -n "${DO_UPGRADE_DB}" ]; then
		# Upgrade cyrus database format
		upgradedb $DBFILE $OLD_DBVALUE $NEW_DBVALUE
	    fi
	fi
    done < $OLD_LIST
    if [ "${OLD_DBVERSION}" != "${NEW_DBVERSION}" ]; then
	# Create new checkpoint
	checkpointbdb ${NEW_DBVERSION}
    fi
    return 0
}
upgradealldb /usr/lib/cyrus/cyrus-db-types.txt /usr/lib/cyrus/cyrus-db-types.active
RET="$?"
# Now set active db types to the current package
[ "$RET" -eq "0" ] && \
    cp -p /usr/lib/cyrus/cyrus-db-types.txt  /usr/lib/cyrus/cyrus-db-types.active
exit $RET
 |