UPGRADING

   1 Upgrading
   2 =========
   3
   4 From 1.9.1 to 2.0.0
   5 -------------------
   6
   7 1. Add new "Users" table login date column:
   8
   9 ----
  10 ALTER TABLE Users ADD COLUMN LastLogin BIGINT NOT NULL DEFAULT 0;
  11 ALTER TABLE Users ADD COLUMN PGPKey VARCHAR(40) NULL DEFAULT NULL;
  12 ----
  13
  14 2. Merge "web/lib/config.inc.php.proto" with "web/lib/config.inc.php".
  15
  16 From 1.9.0 to 1.9.1
  17 -------------------
  18
  19 1. Merge "web/lib/config.inc.php.proto" with "web/lib/config.inc.php".
  20
  21 2. Install translations by running `make install` in "po/".
  22
  23 From 1.8.2 to 1.9.0
  24 -------------------
  25
  26 1. Translation files are now gettext compatible and need to be compiled after
  27 each AUR upgrade by running `make install` in the "po/" directory.
  28
  29 2. Remove the "NewPkgNotify" column from the "Users" table:
  30
  31 ALTER TABLE Users DROP COLUMN NewPkgNotify;
  32
  33 3. Fix up issues with depends performance on large dataset.
  34
  35 ALTER TABLE PackageDepends ADD INDEX (DepName);
  36
  37 4. Rename "web/lib/config.inc" to "web/lib/config.inc.php".
  38
  39 5. Merge "web/lib/config.inc.php.proto" with "web/lib/config.inc.php".
  40
  41 6. Run the upload directory transform script ("scripts/uploadbuckets.sh") and
  42 rotate the converted directory structure into place.
  43
  44 7. In order to to provide backward compatible package URLs, enable mod_rewrite
  45 and add the following to your Apache configuration (inside the "VirtualHost"
  46 container or optionally create a ".htaccess" file in the upload directory):
  47
  48 ----
  49 RewriteEngine on
  50 RewriteRule ^/packages/([^/]{1,2})([^/]*/(PKGBUILD|[^/]*\.tar\.gz|))$ /packages/$1/$1$2
  51 ----
  52
  53 The following equivalent rule can be used for lighttpd setups:
  54
  55 ----
  56 url.rewrite-once = ( "^/packages/([^/]{1,2})([^/]*/(PKGBUILD|[^/]*\.tar\.gz|))$" => "/packages/$1/$1$2" )
  57 ----
  58
  59 If you use a non-standard URL_DIR, slight modifications might be necessary.
  60
  61 8. Merge "scripts/aurblup/config.h.proto" with "scripts/aurblup/config.h".
  62
  63 From 1.8.1 to 1.8.2
  64 -------------------
  65
  66 1. Update the modified package timestamp for new packages.
  67
  68 UPDATE Packages SET ModifiedTS = SubmittedTS WHERE ModifiedTS = 0;
  69
  70 2. Move to new method of storing package depends.
  71
  72 ----
  73 ALTER TABLE PackageDepends ADD COLUMN DepName VARCHAR(64) NOT NULL DEFAULT '' AFTER PackageID;
  74 UPDATE PackageDepends SET DepName = (SELECT Name FROM Packages WHERE ID = DepPkgID);
  75 ALTER TABLE PackageDepends MODIFY DepName VARCHAR(64) NOT NULL;
  76 ALTER TABLE PackageDepends DROP FOREIGN KEY `PackageDepends_ibfk_2`;
  77 ALTER TABLE PackageDepends DROP COLUMN DepPkgID;
  78 DELETE FROM Packages WHERE DummyPkg = 1;
  79 ALTER TABLE Packages DROP COLUMN DummyPkg;
  80 ----
  81
  82 3. The File_Find PEAR module is no longer required. You can safely uninstall it
  83 if nothing else depends on it.
  84
  85 From 1.8.0 to 1.8.1
  86 -------------------
  87
  88 1. Drop foreign keys from the "Sessions" table:
  89
  90 `ALTER TABLE Sessions DROP FOREIGN KEY Sessions_ibfk_1;` should work in most
  91 cases. Otherwise, check the output of `SHOW CREATE TABLE Sessions;` and use the
  92 foreign key name shown there.
  93
  94 2. Run the following MySQL statements:
  95
  96 ----
  97 ALTER TABLE Sessions
  98         ADD FOREIGN KEY (UsersID) REFERENCES Users(ID) ON DELETE CASCADE;
  99 ALTER TABLE PackageDepends
 100         ADD FOREIGN KEY (PackageID) REFERENCES Packages(ID) ON DELETE CASCADE,
 101         ADD FOREIGN KEY (DepPkgID) REFERENCES Packages(ID) ON DELETE CASCADE;
 102 ALTER TABLE PackageSources
 103         ADD FOREIGN KEY (PackageID) REFERENCES Packages(ID) ON DELETE CASCADE;
 104 ALTER TABLE TU_VoteInfo
 105         ADD FOREIGN KEY (SubmitterID) REFERENCES Users(ID) ON DELETE CASCADE;
 106 ALTER TABLE TU_Votes
 107         ADD FOREIGN KEY (VoteID) REFERENCES TU_VoteInfo(ID) ON DELETE CASCADE,
 108         ADD FOREIGN KEY (UserID) REFERENCES Users(ID) ON DELETE CASCADE;
 109 ALTER TABLE PackageComments
 110         MODIFY DelUsersID INTEGER UNSIGNED NULL DEFAULT NULL;
 111 UPDATE PackageComments SET DelUsersID = NULL WHERE DelUsersID = 0;
 112 ALTER TABLE Packages
 113         MODIFY SubmitterUID INTEGER UNSIGNED NULL DEFAULT NULL,
 114         MODIFY MaintainerUID INTEGER UNSIGNED NULL DEFAULT NULL;
 115 UPDATE Packages SET SubmitterUID = NULL WHERE SubmitterUID = 0;
 116 UPDATE Packages SET MaintainerUID = NULL WHERE MaintainerUID = 0;
 117 ----
 118
 119 3. (optional) If you converted your database from MyISAM to InnoDB during the
 120 upgrade process from 1.7.0 to 1.8.0 or from 1.8.0 to 1.8.1 without completely
 121 rebuilding the database from the MySQL schema, you should additionally run the
 122 following MySQL statements to add missing foreign keys:
 123
 124 ----
 125 ALTER TABLE Users
 126         ADD FOREIGN KEY (AccountTypeID) REFERENCES AccountTypes(ID) ON DELETE NO ACTION;
 127 ALTER TABLE Packages
 128         ADD FOREIGN KEY (CategoryID) REFERENCES PackageCategories(ID) ON DELETE NO ACTION,
 129         ADD FOREIGN KEY (SubmitterUID) REFERENCES Users(ID) ON DELETE NO ACTION,
 130         ADD FOREIGN KEY (MaintainerUID) REFERENCES Users(ID) ON DELETE NO ACTION;
 131 ALTER TABLE PackageVotes
 132         ADD FOREIGN KEY (UsersID) REFERENCES Users(ID) ON DELETE CASCADE,
 133         ADD FOREIGN KEY (PackageID) REFERENCES Packages(ID) ON DELETE CASCADE;
 134 ALTER TABLE PackageComments
 135         ADD FOREIGN KEY (UsersID) REFERENCES Users(ID) ON DELETE CASCADE,
 136         ADD FOREIGN KEY (DelUsersID) REFERENCES Users(ID) ON DELETE CASCADE,
 137         ADD FOREIGN KEY (PackageID) REFERENCES Packages(ID) ON DELETE CASCADE;
 138 ALTER TABLE CommentNotify
 139         ADD FOREIGN KEY (PkgID) REFERENCES Packages(ID) ON DELETE CASCADE,
 140         ADD FOREIGN KEY (UserID) REFERENCES Users(ID) ON DELETE CASCADE;
 141 ----
 142
 143 4. Merge "web/lib/config.inc.proto" with "web/lib/config.inc".
 144
 145 From 1.7.0 to 1.8.0
 146 -------------------
 147
 148 1. Run the following MySQL statements:
 149
 150 ----
 151 ALTER TABLE Packages ADD OutOfDateTS BIGINT UNSIGNED NULL DEFAULT NULL;
 152 UPDATE Packages SET OutOfDateTS = UNIX_TIMESTAMP() WHERE OutOfDate = 1;
 153 ALTER TABLE Packages DROP OutOfDate, DROP FSPath, DROP URLPath, DROP LocationID;
 154 DROP TABLE PackageLocations, PackageContents;
 155 ALTER TABLE AccountTypes MODIFY AccountType VARCHAR(32) NOT NULL DEFAULT '';
 156 ALTER TABLE Users MODIFY Username VARCHAR(32) NOT NULL,
 157         MODIFY Email VARCHAR(64) NOT NULL,
 158         MODIFY RealName VARCHAR(64) NOT NULL DEFAULT '',
 159         MODIFY LangPreference VARCHAR(5) NOT NULL DEFAULT 'en',
 160         MODIFY IRCNick VARCHAR(32) NOT NULL DEFAULT '';
 161 ALTER TABLE PackageCategories MODIFY Category VARCHAR(32) NOT NULL;
 162 ALTER TABLE Packages MODIFY Name VARCHAR(64) NOT NULL,
 163         MODIFY Version VARCHAR(32) NOT NULL DEFAULT '',
 164         MODIFY Description VARCHAR(255) NOT NULL DEFAULT "An Arch Package",
 165         MODIFY URL VARCHAR(255) NOT NULL DEFAULT "http://www.archlinux.org",
 166         MODIFY License VARCHAR(40) NOT NULL DEFAULT '';
 167 ALTER TABLE PackageSources
 168         MODIFY Source VARCHAR(255) NOT NULL DEFAULT "/dev/null";
 169 ALTER TABLE TU_VoteInfo
 170         MODIFY User VARCHAR(32) collate latin1_general_ci NOT NULL;
 171 CREATE TABLE PackageBlacklist (
 172         ID INTEGER UNSIGNED NOT NULL AUTO_INCREMENT,
 173         Name VARCHAR(64) NOT NULL,
 174         PRIMARY KEY (ID),
 175         UNIQUE (Name)
 176 );
 177 ----
 178
 179 2. Drop all fulltext indexes from the "Packages" table:
 180
 181 Please do this with care. `ALTER TABLE Packages DROP INDEX Name;` will work in
 182 most cases but might remove the wrong index if your indexes have been created
 183 in a non-standard order (e.g. during some update process). You'd better run
 184 `SHOW INDEX FROM Packages;` before to ensure that your setup doesn't use a
 185 different naming.
 186
 187 3. You will need to update all packages which are stored in the incoming dir as
 188 in 1.8.0, source tarballs are no longer extracted automatically and PKGBUILDs
 189 are from now on located in the same subdirectories as the tarballs themselves.
 190 The following script will do the conversion automatically when being run inside
 191 "$INCOMING_DIR":
 192
 193 ----
 194 #!/bin/bash
 195
 196 for pkg in *; do
 197         if [ -d "${pkg}" -a ! -f "${pkg}/PKGBUILD" ]; then
 198                 pkgbuild_file=$(find -P "${pkg}" -name PKGBUILD)
 199                 [ -n "${pkgbuild_file}" ] && \
 200                         cp "${pkgbuild_file}" "${pkg}/PKGBUILD"
 201         fi
 202 done
 203 ----
 204
 205 4. (optional): 1.8.0 includes a helper utility called "aurblup" that can be
 206 used to prevent users from uploading source packages with names identical to
 207 packages in predefined binary repos, e.g. the official repositories of your
 208 distribution. In order to build and install aurblup, enter the following
 209 commands:
 210
 211         cd scripts/aurblup/
 212         make config.h
 213         $EDITOR config.h
 214         make install  # as root
 215
 216 Add something like "0 * * * * /usr/local/bin/aurblup" to root's crontab to make
 217 aurblup update the package blacklist every hour.
 218
 219 NOTE: You can run aurblup as non-privileged user as well. Make sure that the
 220 user has read-write access to "/var/lib/aurblup/" (or whatever you defined with
 221 "ALPM_DBPATH") tho.
 222
 223 5. (optional): As of 1.8.0, all MySQL tables should be InnoDB compatible. To
 224 convert a table, you can use this statement: `ALTER TABLE $foo ENGINE=InnoDB;`.
 225 If you want to stick with MyISAM or another storage engine that doesn't support
 226 transactions, you will need to disable the "MYSQL_USE_TRANSACTIONS" setting in
 227 "config.h" when setting up aurblup.
 228
 229 From 1.6.0 to 1.7.0
 230 -------------------
 231 ALTER TABLE Users ADD Salt CHAR(32) NOT NULL DEFAULT '';
 232 ALTER TABLE Users ADD ResetKey CHAR(32) NOT NULL DEFAULT '';
 233 ALTER TABLE Users MODIFY LangPreference CHAR(5) NOT NULL DEFAULT 'en';
 234
 235
 236 From 1.5.2 to 1.5.3
 237 -------------------
 238 1. Ensure this appears in config.inc:
 239    define("DEFAULT_LANG", "en");
 240
 241
 242 From 1.5.1 to 1.5.2
 243 -------------------
 244 1. Ensure Pear and File/Find.php are in the path. See web/README.txt.
 245
 246 2. Update your running copy of support/scripts/newpackage-notify.
 247
 248 3. Run this in web/lib:
 249 <?php
 250
 251 # Run the script from within lib
 252 include('config.inc');
 253 include('aur.inc');
 254
 255 $query = "UPDATE Packages SET " .
 256          "FSPath = CONCAT('" . INCOMING_DIR . "', Name, '/', Name,
 257 '.tar.gz'), " .
 258          "URLPath = CONCAT('" . URL_DIR . "', Name, '/', Name, '.tar.gz') " .
 259          "WHERE DummyPKG = 0 AND LocationID = 2;";
 260
 261 $dbh = db_connect();
 262 db_query($query, $dbh);
 263
 264 $query = "ALTER TABLE Packages DROP COLUMN AURMaintainerUID;";
 265 db_query($query, $dbh);
 266
 267
 268 1.3.0
 269 -----
 270 ALTER TABLE PackageDepends ADD COLUMN DepCondition VARCHAR(20) AFTER DepPkgID;
 271 ALTER TABLE Packages ADD License CHAR(40) NOT NULL DEFAULT '';
 272
 273
 274 1.2.10
 275 ------
 276 ALTER TABLE Packages MODIFY Description CHAR(255) NOT NULL DEFAULT "An Arch Package";
 277
 278
 279 longerpkgname
 280 -------------
 281 ALTER TABLE Packages MODIFY Name CHAR(64) NOT NULL;
 282