Run overbuild#

Overview#

The Run Overbuild tool imports objects.

Note

To access the Run Overbuild tool, go to Run Overbuild.

../../_images/run-overbuild.png

Overbuild action

The table describes options available for Overbuild Action on the Run Overbuild page

Overbuild action

Description

All Enabled Sites Using Settings Below

  • Includes all devices selected on the form.

  • Includes all sites that have their site defaults doc configured to include the site in overbuild

  • An internal number inventory is created at customer level when Create Internal Number Inventory at Customer setting is selected, else, it’s created at the site (if lines are included).

  • Device pools are from the General Defaults tab in the Site Defaults, and additional device pools are from the Overbuild Defaults tab.

  • The devices that display when Limit Move Devices is selected on the Overbuild Defaults tab are ignored. Runs Overbuild for all sites, and uses the devices selected on the Run Overbuild page.

When Run Overbuild executes with this option, it applies to all sites and uses devices selected on the Run Overbuild page.

Run Overbuild devices supersede the devices selected in Limit Move Devices.

All Enabled Sites Using Site Defaults Doc Overbuild Settings

  • Hides and ignores selected devices on the Run Overbuild page. Moves all selected devices (when Limit Moved Devices is selected on the Overbuild Defaults tab in the Site Defaults)

  • Includes sites that are included for overbuild in their Site Defaults doc.

  • Creates internal number inventory at Customer level (when Create Internal Number Inventory at Customer option is chosen, else at site level (if lines is selected).

  • Device pools are from the General Defaults tab in the Site Defaults, and Additional Device Pools are used from the Overbuild Defaults tab in the Site Defaults.

Overbuild action

Description

Single Enabled Site Using Settings Below

  • Overbuild is applied to the single site you choose.

  • The only sites available for selection are sites included for overbuild via their Site Defaults.

  • Includes all devices you choose on the page

  • Creates internal number inventory at Customer (if Create Internal Number Inventory at Customer option is selected); else, only at site (if Lines are included)

  • Device pools are from the General Defaults tab in the Site Defaults doc, and Additional Device Pools from the Overbuild Defaults tab.

  • Devices displayed when the Limit Move Devices option is selected on the Overbuild Defaults tab are ignored. Runs Overbuild for the selected site, and uses the devices selected on the Run Overbuild page.

When the Run Overbuild tool executes with this option, it applies to the selected site only, and uses devices selected on the Run Overbuild page. Run Overbuild devices supersede the devices selected in Limit Move Devices.

Available device types

The available device types are shown in accordance with enabled services in Global settings (see: Global settings), for example:

  • Cisco CUCM

  • Cisco CUCX

  • Cisco WebEx

  • Cisco Webex App(Teams)

  • Cisco UCCX

  • Microsoft

  • Defender for Office

  • Defender for Endpoint

Available device types include:

  • Phones

  • Phone Remote Destinations

  • Users (device/cucm/User)

  • Device Profiles

  • Remote Destination Profiles (RDP)

  • RDP Remote Destinations

  • Lines (a number inventory entry is also added for all device/cucm/Line) instances that are in the system at the customer or site level)

  • CUC Users

  • Webex App Users

  • Pexip Users

  • Contact Center Agents

  • Microsoft Users

  • Microsoft Defender for Endpoint

  • Microsoft Defender for Office

Affected device models

The following device models are affected by the overbuild move:

  • device/cuc/User

  • device/cuc/UserPassword

  • device/cuc/UserPin

  • device/cuc/AlternateExtension

  • device/cuc/ExternalServiceAccount

  • device/cuc/SmtpDevice

  • device/cuc/SmsDevice

  • device/cuc/PagerDevice

  • device/cuc/PhoneDevice

  • device/cuc/HtmlDevice

  • device/cuc/Callhandler

  • device/cuc/CallhandlerMenuEntry

  • device/cuc/CallhandlerTransferOption

  • device/cuc/Greeting

  • device/cuc/MessageHandler

  • device/cucm/Phone

  • device/cucm/User

  • device/cucm/DeviceProfile

  • device/cucm/RemoteDestinationProfile

  • device/cucm/RemoteDestination

  • device/cucm/Line

  • device/pexip/Conference

  • device/spark/User

  • device/uccx/Team

  • device/uccx/Skill

  • device/uccx/ResourceGroup

  • device/uccx/Agent

  • device/msexchangeonline/SafeAttachmentPolicy

  • device/msexchangeonline/SafeLinksPolicy

  • device/msexchangeonline/QuarantinePolicy

  • device/mssecurity/Machine

  • device/msgraphsecurity/Alert

  • device/msgraphsecurity/Incident

Related topics

Affected data models

The following data models are affected when moving a user during overbuild:

  • data/User

Device types available for selection depend on the status of other device type check boxes. For example:

  • The following device types are only available if you’ve selected Phones:

    • Dual-Mode Remote Destinations

    • Users

    • Lines

  • The following device types are only available if you’ve selected Users:

    • Device Profiles

    • Remote Destination Profiles

    • CUC Users

Overbuild and failures

Overbuild workflows do not stop on any transaction failures and no transaction rollback takes place on errors. For example, device instance move operations to sites continue for all selected devices. Inspect the transaction log for errors.

In the Transaction log, sub-transactions of a successful overbuild workflow show their status as “Fail” if a model (such as a User) already exists. The sub-transaction logs also show details of the duplicate model and an “ignore error code” information message.

If a number already exists and the global setting Prevent Duplicate Number is enabled, the sub-transaction to create a duplicate of an existing number fails.

Related topics