Add a Software Upgrade Work Order

Expand the Device Manager slider and select Software upgrade, Work order administration.

In the Work orders table, click Add.

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 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 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 upgrade work order. Select from the following error policies you want to apply to this 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 upgrade work order stops.

Behavior drop-down list

Select from the following behaviors that apply to this upgrade work order:

Never pause—(Default) The upgrade proceeds on each targeted device without requiring intervention.
Pause after every device—The 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 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 upgrade work order operation ceases on a device.

Auto commit check box

When an 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 work order.

Click the Device groups tab and click Add.

In the Select Device dialog box, expand a device folder in the Managed devices table, select a device row, and click Add to move the device to the Targeted devices table.

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 and bootloader 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, bootloader version, and same redundancy type (HA or standalone).

to one Work orders are moved to the targeted devices.

Repeat the previous steps to add additional targeted devices.

Click OK.

The devices appear in the devices table.

The devices table shows the IP address or FQDN depending on the details added by the user in the Device Manager.

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.

Boot Loader Upgrade field (Optional) Check the check box to include a Bootloader image upgrade.

Targeted boot image field

When Boot Loader Upgrade is checked, click the ellipse (...) icon to select the targeted bootloader image that you are upgrading from the Select node bootloader image dialog box and click OK.

Note:

Once you click OK, the OCSEM performs a compatibility check between the "Targeted software image" and the "Targeted Bootloader image" files and if a failure occurs, the following message displays:

Targeted software image version and Bootloader image version are different, do you still want to proceed...

.

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 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 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 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 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 image check box (Optional) Check the check box to intentionally pause the upgrade work order after the image is delivered to all targeted devices. Targeted devices are unlocked once the image is successfully delivered.

Remove old image from device on commit (Optional) Check the check box to remove the old device image on the devices after the execution and commit of the work order.

Select the Pause after checkbox next to any work flow step of the processing of the 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 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.

Click Apply. The upgrade work order appears in the Work orders table.