Before order flow upgrade, the pre-check script is run automatically. This pre-check script checks existing order flows for the upgrade possibility. The following checks are performed by this script:

  • Whether identifiers of new order flow handlers already exist and contain methods other than those that will be installed with the update. If so, the pre-check script writes this inconsistency into a log file on the Billing node.
  • Whether the “EC” status already exists for the “CH” order. If so, refer to this article.
  • Whether the “AP” status already exists and has incorrect handlers for the “CH” order. If so, the pre-check script writes this inconsistency into a log file on the Billing node.

If the precheck fails, perform the following actions:

  1. Ensure that the following identifier exists in the “FlowHandler” table: 153. If this does not, add this identifier or replace the incorrect identifier with the correct one by downloading and copying the move_old_handlers.py script to the BSS node, then running it:

    # python move_old_handlers.py

    As a result, incorrect identifiers will be replaced with correct ones for all inconsistent flow handlers.

    You can also use this script in manual mode. You will be asked to specify old and new identifiers. To do this, run this script with the option --manual:

    # python move_old_handlers.py --manual
  2. Fix inconsistencies found by the precheck in custom order flows using the default order flow as an example:
    1. If an order flow already includes the “AP” status, then rename this status using the interactive rename-status.py script. Note that this script does not change the default record in the “OrderOperation” table. If you want to rename the initial status of an order flow, this record must be updated manually and with care.
    2. Ensure that actions described in this article are performed and the order flow is configured according with this article.

If the described steps do not work for your configuration, you can configure the order flow after upgrade.

  • The new status “AP” must be inserted before the “EC” status for “CH” orders: “AP” > “EC”.

  • The new status must have the following handler: “AP”: “OF_FinishProvisioningCH”.

To add new statuses and their transitions, complete the following actions:

  1. Log in to the PCP, go to Billing > Settings > Order Processing > All Order Flows and click the required order flow and then the required order type.
  2. In the Order Statuses tab, add new statuses. Flags for them can be taken from the status before which new statuses are added, or from the same statuses from the default order flow.
  3. In the Order Flow Transitions tab, add their transitions. The new statuses must have the following transitions (you can copy them from the default order flow):
    • For the “CH” orders:
    • From: “AP”; Success: “EC”; Fail: “AP”; Action: “Finish Provisioning”; Order Flow Handler: “OF_FinishProvisioningCH”; Transition Type: “On Event”

The “EC” status must already exist. Refer to this article.

If you have any customized transitions, you must change them also.

If an order flow still cannot be modified, send a copy of it to the support team for investigation.

3. Run the upgrade script.