Configure an alias for High Availability

  • Two or more Snaplexes deployed in separate regions or availability zones.

  • A pipeline that you want to run as a Low-latency Ultra Task.

    Important: The alias feature is supported for Low-latency Ultra Tasks only. Headless Ultra Tasks do not support aliases.

  • Write permissions for the project space.

You can configure an alias to enable high availability and disaster recovery for Ultra Tasks running across multiple regions. When two or more Ultra Tasks share the same alias, a Snaplex in a secondary region can automatically take over processing if the primary Ultra Task fails. All Ultra Tasks that share an alias must run the same pipeline, reside in the same project folder, and each be deployed to a different Snaplex instance.

Important: Use the Alias field only in high availability and disaster recovery configurations. Headless Ultra does not support the Alias feature.
  1. Create the primary Ultra Task and assign an alias:
    1. Open the Create Task dialog from Designer or Manager. See Create an Ultra Task for details.
    2. Complete the required fields: enter a task name, select the pipeline, and select the primary Snaplex.
    3. In the Alias field, enter a name for the alias.

      Choose an alias name that is meaningful and consistent. You will use this exact value in all Ultra Tasks that share the alias.

    4. Click Save.
  2. Create a secondary Ultra Task in the same project folder using the same alias:
    1. Open the Create Task dialog again from the same project folder.
    2. Select the same pipeline that the primary Ultra Task uses.
    3. Select a different Snaplex from the primary Ultra Task — one that is deployed in a separate region or availability zone.
    4. In the Alias field, enter the same alias value that you used for the primary Ultra Task.
    5. Click Save.
  3. Repeat step 2 for each additional region that you want to include in the high availability configuration.

    Each additional Ultra Task must:

    • Run the same pipeline as the primary Ultra Task.
    • Reside in the same project folder.
    • Be deployed to a Snaplex in a different region or availability zone.
    • Use the same alias value.
  4. Verify the configuration by checking that all Ultra Tasks sharing the alias appear in the project folder and are in an active state.

You have configured an alias for high availability. When an Ultra Task in one region fails, a Snaplex in another region can continue processing by invoking the Ultra Task that shares the same alias.

For deployment architecture guidance, including load balancer configuration for alias-based routing, refer to Deployment architecture.