5.1 KiB
Upgrade your wallabag installation
You will find here different ways to upgrade your wallabag:
Upgrading from 2.1.x to 2.2.x
Upgrade on a dedicated web server
make update
Explanations about database migrations
During the update, we execute database migrations.
All the database migrations are stored in app/DoctrineMigrations
. You can execute each migration individually: bin/console doctrine:migrations:migrate 20161001072726 --env=prod
.
Here is the migrations list for 2.1.x to 2.2.0 release:
20161001072726
: added foreign keys for account resetting20161022134138
: converted database toutf8mb4
encoding (for MySQL only)20161024212538
: addeduser_id
column onoauth2_clients
to prevent users to delete API clients from other users20161031132655
: added the internal setting to enable/disable downloading pictures20161104073720
: addedcreated_at
index onentry
table20161106113822
: addedaction_mark_as_read
field onconfig
table20161117071626
: added the internal setting to share articles to unmark.it20161118134328
: addedhttp_status
field onentry
table20161122144743
: added the internal setting to enable/disable fetching articles with paywall20161122203647
: droppedexpired
andcredentials_expired
fields onuser
table
Upgrade on a shared hosting
Backup your app/config/parameters.yml
file.
Download the last release of wallabag:
wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package
You will find the md5 hash of the latest package on our website.
Extract the archive in your wallabag folder and replace app/config/parameters.yml
with yours.
Please check that your app/config/parameters.yml
contains all the required parameters. You can find here a documentation about parameters.
If you use SQLite, you must also copy your data/
folder inside the new installation.
Empty var/cache
folder.
You must run some SQL queries to upgrade your database. We assume that the table prefix is wallabag_
and the database server is a MySQL one:
Upgrade from 2.0.x to 2.1.1
Warning
Before this migration, if you configured the Pocket import by adding your consumer key in Internal settings, please do a backup of it: you'll have to add it into the Config page after the upgrade.
Upgrade on a dedicated web server
rm -rf var/cache/*
git fetch origin
git fetch --tags
git checkout 2.1.1 --force
SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist
php bin/console doctrine:migrations:migrate --env=prod
php bin/console cache:clear --env=prod
Upgrade on a shared hosting
Backup your app/config/parameters.yml
file.
Download the 2.1.1 release of wallabag:
wget http://framabag.org/wallabag-release-2.1.1.tar.gz && tar xvf wallabag-release-2.1.1.tar.gz
(md5 hash of the 2.1.1 package: 9584a3b60a2b2a4de87f536548caac93
)
Extract the archive in your wallabag folder and replace app/config/parameters.yml
with yours.
Please check that your app/config/parameters.yml
contains all the required parameters. You can find here a documentation about parameters.
If you use SQLite, you must also copy your data/
folder inside the new installation.
Empty var/cache
folder.
You must run some SQL queries to upgrade your database. We assume that the table prefix is wallabag_
and the database server is a MySQL one:
ALTER TABLE `wallabag_entry` ADD `uuid` LONGTEXT DEFAULT NULL;
INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('share_public', '1', 'entry');
ALTER TABLE `wallabag_oauth2_clients` ADD name longtext COLLATE 'utf8_unicode_ci' DEFAULT NULL;
INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('import_with_redis', '0', 'import');
INSERT INTO `wallabag_craue_config_setting` (`name`, `value`, `section`) VALUES ('import_with_rabbitmq', '0', 'import');
ALTER TABLE `wallabag_config` ADD `pocket_consumer_key` VARCHAR(255) DEFAULT NULL;
DELETE FROM `wallabag_craue_config_setting` WHERE `name` = 'pocket_consumer_key';
From wallabag 1.x
There is no automatic script to update from wallabag 1.x to wallabag 2.x. You need to:
- export your data
- install wallabag 2.x (read the installation documentation )
- import data in this fresh installation (read the import documentation )