This should be no issue anymore since v8.3. Anyways this information will stay public until we are sure, no more problems will occur.

When Polls gets updated and needs changed classes while updating a situation may occur which lets the migration fail. This is because Polls relies on its own declarative database definitions. On updates a situation now can occur where changed classes, which are used while updating, get not loaded properly and the old version of these classes are still cached and loaded.

This can lead to two states:

In this situation Nextcloud refuses any further action and stays in maintenance mode. To fix this follow these steps:

• call occ app:disable polls
• call occ maintenance:mode --off
• call occ app:enable polls After that the site should be up again and Polls updated to the latest version. If this actions lead to no success end the site ended in maintenance mode again, keep polls disabled and turn off the maintenance mode. Please report that issue here.

If Polls just did not get enabled and the update terminated with an error message, try to enable it again. After that Polls should be updated to the latest version. If Polls resumed back to disabled state again, keep polls disabled and please report that issue here.

If you want to run the latest development version from git source, you need to clone the repo to your apps folder:

git clone https://github.com/nextcloud/polls.git

• Install runtime environment with make setup-build

• Compile javascript with npm run build

• call occ app:enable polls to enable Polls

• With make appstore You can create a distribution build (Find the output in the build directory)

• Install dev environment with make setup-dev

Got to your apps page (https://nc.foo.com/settings/apps) and search for Polls. Just enable or install the app with the button.

Call occ app:install polls or occ app:enable polls

Depending on the installation variant different steps are executed. (This mainly for self documentation)

On the first time installation of Polls Nextcloud excecutes the following steps

• unexecuted migration classes (not listed in the *_migrations table) and the
• install repair step.

After a version update (changed version attribute in appinfo/info.xml) Nextcloud executes

• pre-migration repair steps,
• unexecuted migration classes (not listed in the *_migrations table) and the
• post-migration repair steps

Note: since v8.3 Polls does not make usage of the repair steps or install script anymore. Anyways in a later version, they may be reintroduced.

On enabling an already installed but disabled Polls without version change Nextcloud executes

• pre-migration repair steps,
• unexecuted migration classes (not listed in the *_migrations table) and the
• post-migration repair steps and the
• install repair step

Download the desired version from the releases page and extract it to your app folder where common apps reside. After extraction there should be a polls folder containing the Polls app.

If updating this way, make sure the Polls folder gets removed or emptied before. Otherwise side effects can occur while migrating or on run time.

Call occ polls:db:purge to remove Polls completely.

• removes all Polls related tables
• removes all Polls related migration records
• removes all Polls related app config records (this also disables Polls)

This does not remove Polls' files (call occ app:remove polls to remove it complete afterwards) but it resets Polls into an 'uninstalled' state. Enabling the app is then equivalent to a first time install and calls the migration and the install repair step (see above).