Bundle Import

Vorbereitung

• Share mit Bundle mounten

  Bsp. /etc/fstab:

  //server/bundles-share /media/import_bundles cifs uid=zope,gid=zope,ro,credentials=/etc/.credentials_cifs2 0 0
  

• Evtl. Pfad- und Gruppenmapping definieren in ~/.opengever/bundle_ingestion/settings.json resp. /apps/.opengever/bundle_ingestion/settings.json

  Bsp.

  {
      "unc_mounts": {
          "files/": "/media/import_bundles/TD/files"
      }
  }
  

• GEVER Mandant herunterfahren und vorhande Daten löschen

  bin/supervisorctl shutdown
  

  Filestorage, Blobstorage und Solr Data löschen

• Mandant in OGDS löschen, falls bereits einer vorhanden war.

  delete from org_units where unit_id='fmh';
  delete from admin_units where unit_id='fmh';
  

Durchführung der Migration

• Evtl. Cronjobs deaktivieren (ogds sync, packen)

• Falls nötig (nur bei grossen Migrationen), ZODB cache size auf 0 setzen um Memory-Verbrauch zu limitieren:

  [instance0]
  zodb-cache-size = 0
  

• Buildouten und Dienste starten:

  bin/buildout
  sudo -u zope bin/supervisord
  

• Mandant neu aufsetzen: Im ZMI "GEVER installieren"

• Bumblebee feature flag deaktivieren (in Portal Registry) opengever.bumblebee.interfaces.IGeverBumblebeeSettings.is_feature_enabled

• Solr deaktivieren (in Portal Registry) opengever.base.interfaces.ISearchSettings.use_solr

• Falls Solr verwendet wird, SearchableText und Description Index löschen. Damit wird eine unnötige Indizierung im Portal Catalog verhindert (portal_catalog/manage_catalogIndexes).

• Bundle (nur .json Files) nach var/bundles kopieren.

• Evtl. Pfad für Dokumente anpassen (Mapping funktioniert nur mit UNC Pfaden)

  vim documents.json
  :%s/files\//\/media\/import_bundles\/TD\/files\//g
  

• Sicherstellen dass ZEO und Tika laufen

• Instanzen, Memmon und HttpOk stoppen

• Falls, deploy User != zope: migration.log anlegen:

  touch migration.log
  sudo chown zope:zope migration.log 
  

• Screen starten: screen -L -S bundle-import

• Import starten, Bumblebee Checksummen berechnen und Solr Indizieren

  sudo -u zope bin/instance0 import var/bundles/TD && \
  sudo -u zope bin/instance0 run src/opengever.maintenance/opengever/maintenance/scripts/bumblebee_installation.py -m index-checksums && \
  sudo -u zope bin/instance0 run src/opengever.maintenance/opengever/maintenance/scripts/activate_solr.py
  

Weiteres Bundle importieren

• Cronjobs deaktivieren (ogds sync, packen)

• Falls nötig (nur bei grossen Migrationen), ZODB cache size von instance0 auf 0 setzen um Memory-Verbrauch zu limitieren:

  vim parts/instance0/etc/zope.conf
  
  <zodb_db main>
    # Main database
    cache-size 0
  

• Bumblebee feature flag deaktivieren (in Portal Registry) opengever.bumblebee.interfaces.IGeverBumblebeeSettings.is_feature_enabled

• Solr deaktivieren (in Portal Registry) opengever.base.interfaces.ISearchSettings.use_solr

• Bundle (nur .json Files) nach var/bundles kopieren.

• Evtl. Pfad für Dokumente anpassen (Mapping funktioniert nur mit UNC Pfaden)

  vim documents.json
  :%s/files\//\/media\/import_bundles\/TD\/files\//g
  

• Sicherstellen dass ZEO und Tika laufen

• Instanzen, Memmon und HttpOk stoppen

• Falls, deploy User != zope: migration.log anlegen:

  touch migration.log
  sudo chown zope:zope migration.log 
  

• Screen starten: screen -L -S bundle-import

• Import starten, Bumblebee Checksummen berechnen und Solr Indizieren

  sudo -u zope bin/instance0 import var/bundles/TD && \
  sudo -u zope bin/instance0 run src/opengever.maintenance/opengever/maintenance/scripts/bumblebee_installation.py -m index-checksums && \
  sudo -u zope bin/instance0 run src/opengever.maintenance/opengever/maintenance/scripts/activate_solr.py
  

Aktivierung Bumblebee

• Bumblebee feature in Registry aktivieren

  sudo -u zope bin/instance0 run src/opengever.maintenance/opengever/maintenance/scripts/bumblebee_installation.py -m activate
  

• Dokumente in Bumblebee registrieren

  screen -S bumblebee-store
  sudo -u zope bin/instance0 run src/opengever.maintenance/opengever/maintenance/scripts/bumblebee_installation.py -m store
  

Abschluss

• Instanzen starten

• LDAP Plugin IPropertiesPlugin an erste Stelle verschieben

• Cron Jobs wieder aktivieren