Migrating Dimensions Live with Pulse

Migrating Dimensions Live with Pulse

Pulse can migrate IBM Planning Analytics (TM1) dimensions using two modes: Live (without restarting the TM1 instance) or Offline (cold-promote). The right approach depends on dimension size and whether element-level changes need to be tracked.

Migrating Dimensions with an Offline Package

When using offline migration, Pulse gathers the dimension file (.dim) along with all related files β€” including attribute cubes and security cubes β€” into a folder. You copy this folder to the target server's data directory and restart the TM1 instance.

The advantage over manual copying is that Pulse automatically includes all dependent files related to the dimension, so nothing is missed.

Migrating Dimensions with a Live Package

By default, Pulse does not track element-level changes in dimensions. To enable live migration of dimension elements, you must turn on Source Level for each dimension you want to track.

Behaviour based on Source Level setting:

Source Level

Behaviour

Source Level

Behaviour

Disabled

Live migration creates an empty dimension with all attributes β€” no elements are migrated

Enabled

Pulse compares elements between source and target and applies only the differences. If there are no changes, nothing is done.

Source Level is configured per dimension in the instance settings.

Migrating Large Dimensions with a Live Package

For dimensions with more than 5,000 elements, the fastest live migration approach is to use a TI process to populate elements rather than relying on Pulse to create them directly.

Configure the migration package to execute a process during the migration. After the dimension structure and attributes are created on the target, Pulse executes the specified process to populate elements and attribute values.

Note: Source Level must be enabled for the dimension on both the source and target instance for live dimension migration to work correctly.