Add a Software Upgrade Work Order

1. Expand the Device Manager slider and select Software upgrade, Work order administration.
2. In the Work orders table, click Add.
3. In the Settings tab, configure the following parameters:

   Name	The work order name, which is an alphanumeric value from 1 to 24 characters in length with no spaces.
   Scheduled check box	Check the check box to enable the Start date and time field to schedule when the software upgrade work order starts.
   Start date and time field	Select a start date by clicking the calendar icon and specify time entries in the Time fields by selecting the hour, minute and second respectively by typing the numbers in the text box or using the arrows.
   Run device tasks concurrently check box	Check the check box to run the software upgrade work order device tasks at the same time. If you select this check box the Error policy and Behavior fields cannot be configured.
   Error policy drop-down list	Error policies that determine how errors are handled when they occur during the execution of your software upgrade work order. Select from the following error policies you want to apply to this software upgrade work order: Log and proceed—(Default) The targeted device that experiences the error is rolled back to its original configuration state and the work order proceeds to the next targeted device in the work order list. Stop—The targeted device that experienced the error are rolled back to its original configuration state and the work order will stop. You must manually resume, or abort, the work order. Stop and rollback—All targeted devices are processed until the error is rolled back, devices are returned to their original configuration state, and the software upgrade work order stops.
   Behavior drop-down list	Select from the following behaviors that apply to this software upgrade work order: Never pause—(Default) The software upgrade proceeds on each targeted device without requiring intervention. Pause after every device—The software upgrade pauses after each targeted device finishes updating. You must manually continue to the next targeted device listed in the work order. Note: If an error occurs during the work order execution, the behavior is controlled by the error policy. Pause after the first device—The software upgrade work order changes pause after the first targeted device finishes updating. You must manually continue the operation. After that, the next targeted devices listed in the work order proceed without requiring intervention. Note: If an error occurs during the work order execution, the behavior is controlled by the error policy.
   Device operation timeout (minutes)	The timeout in minutes after which the software upgrade work order operation ceases on a device.
   Auto commit check box	When a software upgrade work order completes, but is not committed, it retains a lock on all its targeted devices so that no other operations can be performed on them until the work order is successfully committed and its devices are unlocked. The check box is disabled by default, which means the work order must be manually committed from the work order. Check the check box to automatically commit the global work order after the execution of the upgrade software work order.

4. Click the Devices tab and click Add.
5. In the Select Device dialog box, expand a device folder in the Managed devices table, select a device row, and click Add.
6. The device, its network function and folder structure moves to the Targeted devices table and the folder structure is collapsed.

   Note:

   A work order has the following limitations:

   • A work order is limited to one platform and software version at a time.
   • In the case of an high-availability (HA) device pair, the work order is applied to both devices.
   • All devices must have the same platform, software version, and same redundancy type (HA or standalone).

   to one Work orders are moved to the targeted devices.
7. Repeat the previous steps to add additional targeted devices.
8. Click OK.
   The devices appear in the device table.
9. Click the Workflows tab, and complete the following required and optional fields:

   Targeted software image field	Click the ellipse (...) icon to select the targeted software image that you are upgrading from the Select node software image dialog box and click OK.
   HA Health score threshold (%) field	(Optional) The high availability (HA) health score percentage from 1 to 100 percent that is applicable to HA pairs only. During the software upgrade process, Oracle Communications Session Element Manager checks the health score to determine if the devices are in a stable condition. If the health score value is set, and the device health is not above the health score value, the software upgrade does not proceed.
   Restore original redundancy states after upgrade check box	(Optional) Check the check box to restore the original HA setup after the software upgrade is complete.
   Reject new call check box	(Optional) Check the check box to enable call shedding on a standalone device. The device re-boots when the active-call threshold reaches its limit during the software upgrade process. See the device performance management MIB to view the current call-shedding count. The default is disabled.
   Active call threshold field	(Optional) The threshold number of active calls below which the upgrade or downgrade reboot proceeds automatically.
   Pause and unlock after loading software image check box	(Optional) Check the check box to intentionally pause the software upgrade work order after the software image is delivered to all targeted devices. Targeted devices are unlocked once the software is successfully delivered.
   Remove old image from device on commit	(Optional) Check the check box to remove the old device software image on the devices after the execution and commit of the software work order.

10. Select the Pause after checkbox next to any work flow step of the processing of the software upgrade work order to pause it. When a break point is inserted, the work order is stopped after the step before the work flow step completes successfully. You must manually resume the work order so that the devices can re-boot with the new software upgrade images.
    The following Work flow table columns are described below:

    • Step—The number of this task in the work flow order.
    • Description—The description of the task associated with this step.
    • Pause after— When checked, enables a break point after this step has successfully completed. The default is disabled.
11. Click Apply. The software upgrade work order appears in the Work orders table.