Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info

To use this feature, the user logged into the source Controller must have the ops_promotion_admin role, or be granted permission to the Promote command and execute permission to one or more promotion targets.

The Promotion Read Permission Required Universal Controller system property specifies whether or not the ops_promotion_admin role additionally requires Read permission, on the source Universal Controller, for any record type being promoted.

Also, the user ID and password specified for the Promotion Target must be for a valid user on the target Controller with the ops_promotion_admin or ops_promotion_accept_bundle role.

The Promotion Accept Bundle Create/Update Permission Required Universal Controller system property specifies whether the ops_promotion_admin role additionally requires Create (or Update) permission, on the target Universal Controller, for any record type being promoted.

...

  • If you promote a workflow, all of the tasks in the workflow are also promoted.
  • If you promote a task (including a workflow), all variables, virtual resource dependencies, actions, notes, etc. are included in the promotion.
  • If you promote an application, its associated start, stop, and query tasks are included in the promotion.
  • If you promote a calendar, its associated custom days are included in the promotion.
     
Note
titleNote

If you promote a trigger whose Forecast field has been checked so that the Controller calculates the date and time when this trigger will be satisfied for the next number of days, the Forecast field will not be checked for that trigger on the target system.

Anchor
Promoting a Bundle
Promoting a Bundle
Promoting a Bundle

Step 1

From the Bundles & Promotion navigation pane, select Bundles. The Bundles list displays.
 

Step 2

Locate the Bundle that you want to promote and either:

  • Right-click the Bundle on the list to display an Action menu and click Promote Bundle....
  • Open the Bundle record and either click the Promote Bundle... button or access the Action menu and click Promote Bundle....

The Promote Bundle pop-up dialog displays.
 

Anchor
Promote Bundle
Promote Bundle

Step 3

If the selected Bundle record specifies a Default Promotion Target, the name of that Target displays in the Promotion Target field.

You can change, or select, the Promotion Target by selecting any Target from the drop-down list.

Step 4

The default login User and Password are provided from the selected Promotion Target record. If you want to override the defaults, click Override User/Password and type in the new information.

Step 5

If the promotion contains new or modified Universal Templates, click Allow Universal Template Changes; otherwise, the promotion will not succeed. See Diagnosing Promotion Failures for details.

Step 6

If you want to schedule the promotion of the bundle at a later time, click Schedule.

Step 7

Click Submit.
 
The Controller logs in to the target machine specified in the URI field of the Promotion Target record and copies the bundled records to the target Controller. Based on the specified Agent mapping, the target Agent replaces the source Agent where required.
 
If you scheduled the promotion to be run at a later time, a record of the promotion is created in the Promotion Schedules list.
 

Note
titleNote

The promotion process creates audit records on the source and target machine. On the target machine, the Controller also creates a Promotion History record. For details, see Promotion History and the Restore Option.


...

You can create a promotion schedule for a Bundle so that it will automatically be promoted at a specified date and time.
 

Step 1

From the Bundles & Promotion navigation pane, select Bundles. The Bundles list displays.
 

Step 2

Locate the Bundle that you want to promote and either:

  • Right-click the Bundle on the list to display an Action menu and click Promote Bundle....
  • Open the Bundle record and either click the Promote Bundle... button or access the Action menu and click Promote Bundle....

The Promote Bundle pop-up dialog displays.
 

Step 3

The default login ID and password are provided from the Promotion Target record, if specified. If you want to override the default, click Override User/Password and type in the new information.

Step 4

If the promotion contains new or modified Universal Templates, click Allow Universal Template Changes; otherwise, the promotion will not succeed. See Diagnosing Promotion Failures for details.

Step 5

Click Schedule. Additional fields display on the Promote Bundle pop-up dialog that let you create a promotion schedule.
 

Step 6

Select a Date and Time when you want the bundle to be promoted.

Anchor
Create Snapshot
Create Snapshot
Step 7

If you want to schedule the promotion using the current Bundle records, select Create Snapshot. When you submit the schedule, the current Bundle records are collected immediately and promoted at the scheduled time. Any changes to Bundle records between the time that the promotion was scheduled and the time that the promotion was performed are not promoted.
 
If you want to schedule the promotion using the Bundle records collected dynamically at the time of the scheduled promotion, do not select Create Snapshot.

Step 8

If you want to send a System Notification on the success and/or failure of the promotion, select one of the following from the System Notification drop-down list:

  • Operation Failure (default)
  • Operation Success/Failure
  • Operation Success

If you do not want to send a System Notification, select – None --.
 

Note
titleNote

Promotions without a specified Schedule will run immediately. Real-time notifications will be displayed in the Universal Automation Center Console, rather than through System Notifications.


Step 9

Click Submit. A record of the promotion schedule is listed in the Promotion Schedules list.
 
After a scheduled promotion has completed, it will remain on the list (where it can be rescheduled to run again) for the number of days specified by the Promotion Schedule Retention Period In Days Universal Controller system property.

...

Step 1

Display the records list for the type of record that you want to promote.

Step 2

Select the record(s) that you want to promote.
 
To promote a single record, either:

  • Right-click the record to display an Action menu, and then click Promote.
  • Display the record Details, right-click the Details to display an Action menu, and then click Promote.

The Promote dialog displays, prompting you to select the Promotion Target from a drop-down list. Select the target.
 

 
To promote multiple records, either:
 
Ctrl-click the records you want to promote, right-click any of the selected records to display an Action menu, and then click Promote. The Promote dialog displays, prompting you to select the Promotion Target from a drop-down list. Select the target.
 

 
OR
 
From any tasks list, right-click any column header for the list, display the Action menu, and select Run Command On Filtered > Promote.... The Promote dialog displays, prompting you to select the Promotion Target from a drop-down list. Select the target.
 

Step 4

The default login ID and password will be provided from the Promotion Target record. If you want to override the default, click Override User/Password and type in the new information.

Step 5

Select Exclude on Existence if you want to specify record types in the promotion payload that will not be updated if they exist on the target payload. You can:

  • Select one or more record types from the drop-down list.
  • Click Check All above the list to select all record types.
  • Click Uncheck All above the list to de-select all record types.

The Bundle Exclude On Existence Picker Default Universal Controller system property specifies which record types, if any, will be selected by default in the drop-down list.

Step 6

Select Follow References if you want to dynamically include records that are referenced by these records. (See Records Promoted When Follow References is Selected or Not Selected.)

Step 7

If the promotion contains new or modified Universal Templates, click Allow Universal Template Changes; otherwise, the promotion will not succeed. See Diagnosing Promotion Failures for details.

Step 8

Click Submit. The Controller logs in to the target machine specified in the URI field of the Promotion Target Record and copies the selected records to the target machine.

...

Anchor
Diagnosing Promotion Failures
Diagnosing Promotion Failures
Diagnosing Promotion Failures

Include Page
UC721x:Diagnosing Promotion Failures - 7.2.0.0UC721x:
Diagnosing Promotion Failures - 7.2.0.0

...