Skip to content

collective/collective.migrationhelpers

master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

collective.migrationhelpers

Some helpers and examples to use during migrations.

They are mostly meant to copy & paste the code from here to your own packages.

This was written for the talk "Migrations! Migrations! Migrations!" at Plone Conference 2019 in Ferrara: https://2019.ploneconf.org/talks/migrations-migrations-migrations

Here is a list of methods this package contains:

statistics.py

Browser-Views to get information about the portal:

migrations_stats
Get info about the content is in the portal.
migrations_contentsize
How many MB of which content is there really?
migrations_obsoleteinfo
Get info about content-types that may needs to be replaced
migrations_localroles
Export info about local roles. A alternative would be zopyx.plone.cassandra

prepare.py

Prepare the portal for a migration

disable_solr
Disable solr
disable_ldap
Disable ldap/ad-plugins
remove_overrides
Remove any portal_skin an portal_view_customization overrides.
release_all_webdav_locks
Release all WebDAV Locks.

cleanup.py

Fremove obsolete content and settings

delete_items_larger_than_1mb
Deletes heavy content
remove_all_revisions
Clear out portal_historiesstorage
disable_theme
Disable diazo theme, enable sunburst (useful for Plone 4)
trim_content
Remove 95% of all content leaving at least one item for each type. Keep all folderish items unless specified.

addons.py

Remove addons

remove_ploneformgen
Example that removes Products.PloneFormGen
remove_plonekeywordmanager
Example that removes Products.PloneKeywordManager
remove_solgema_fullcalendar
Example that removes Solgema.fullcalendar
remove_multiple_addons
Example that removes a cubic ton of addons
cleanup_behaviors
Remove obsolete behaviors
remove_vocabularies
Example that removes p4a.subtyper utilities

persistent.py

Some examples that remove various adapters, subscriber and utilities. For example:

remove_utility:
Remove an interface from all utility registrations. There are several places where an interface like IKSSRegistry can have lodged itself. We need to find them all, otherwise you are not even able to see the ZMI when going to Plone 5.2.
_unregisterUtility
Example that removes p4a.subtyper utilities (used in collective.easyslideshow)
remove_kss
Example that removes portal_kss and removes IKSSRegistry from four places in the site manager.

See also:

import_steps.py

Remove broken and outdated import/export steps

linguaplone.py

Examples that can help migrating from LinguaPlone to plone.app.multilingual

cleanup_content_for_pam
Crazy method that sets languages, adds and links translations so that we can migrate to pam.
install_pam
Install pam and setup site
migrate_to_pam
Migrate LinguaPlone to plone.app.multilingual This mostly uses the migration that is builtin in plone.app.multilingual

dexterity.py

Methods to migrate default content to Dexterity.

custom_dx_migration.py

A example that migrated PloneHelpCenter to default Dexterity content.

migrate_helpcenter_to_dx
Run the whole miration
change_phc_layouts
Remove custom layout.
appending_richtext_migrator
Example custom field-migrator that appends text to a existing richtext-field.
appending_text_migrator
Example custom field-migrator that appends text to a existing text-field.
migrate_helpcenter_xxx
Some Methods that migrate the various types in PHC

archetypes.py

remove_archetypes
Uninstall Archetypes and remove all of its traces.

patches.py

Multiple examples of patches using alias_module to deal with migration-problems.

images.py

fix_at_image_scales
Fix/Migrate custom images/scales and broken links to AT-based images. This only finds content with the rich text behavior, so not all rich text fields.

post_python3_fixes.py

fix_event_indexes
Metadata on brains is still old DateTime
fix_searchable_text
Fix bytes in opkapiindex
fix_portlets
Fix portlets that use a ComputedValue for path-storage instead of a UUID
fix_discussions
Fix conversations that still have the old AT content as __parent__
fix_registry
Remove registry-records where the interface is no longer there.
rebuild_relations
Exports all valid reations from the relation-catalog, purges the relation-catalog (and the intid-catalog) and restores all valid relations. Uses collective.relationhelpers
export_relations
Export all relations as a json file all_relations.json in you buildout directory. Uses collective.relationhelpers
restore_relations
Recreate relations from a annotation on the portal or a list of dicts (e.g. restored from the json-file created by export_relations). This works fine for all kinds of relations, RelationList- or RelationChoice-fields (including the default field "Related Items") as well as for linkintegrity-relations and relations between working-copies. Uses collective.relationhelpers
cleanup_intids
Purge all RelationValues and all references to broken objects from the IntId catalog. Uses collective.relationhelpers

finalize.py

Example method for final touces after migrating to 5.2 with py3

utils.py

disable_subscriber
Disable a subscriber
enable_subscriber
Re-enable a subscriber
disable_content_rules
Disable all content rules
enable_content_rules
Re-enable all content rules
example_with_disabled_subscriber
Example to use the above
rebuild_catalog_without_indexing_blobs
Rebuild the whole catalog but skip reindexing blobs since that takes a long time.
pack_database
Pack the database

profiles/migration

Example of a profile that removes all kinds of stuff that was added with Generic Setup.

Bonus: Fixes modal for login.

profiles/default/registry.xml

Example for some maybe sensible registry-settings for migrated sites.

Installation

This is mostly meant to copy&paste the code from here to your own packages.

Installation is still possible: To install it add it to your buildout:

[buildout]

...

eggs =
    collective.migrationhelpers

and then running bin/buildout

Contribute

License

The project is licensed under the GPLv2.

About

Some helpers and examples to use during migrations

Resources

License

GPL-2.0, Unknown licenses found

Licenses found

GPL-2.0
LICENSE.GPL
Unknown
LICENSE.rst

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published