Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 31 Next »

This is a continuation of the use case started in Casablanca: 5G - PNF Software Update

Background (R3 Casablanca)

In Casablanca,  the UC leveraged the Ansible adaptor of ONAP controller to implement three S/W upgrade related operations for 5G PNFs. As an important feature the new workflow supports an External Controller (EC) in the execution of these operations. All these operations  have shared the same LCM APIs with VNF S/W upgrade with PNF specific parameters passed in the API payloads. The corresponding DGs of LCM APIs are updated. The operations are:

  • /operations/LCM:upgrade-pre-check
  • /operations/LCM:upgrade-software
  • /operations/LCM:upgrade-post-check

Dublin Scope

For Dublin, the target of this UC includes:

  • 3GPP Software Management API alignment
    • South-bound of SDNC: Extend upgrade-software operation by leveraging sub-operations from 3GPP (like download/install/activate).
    • North-bound of SDNC: Rollback/fallback API support for 5G PNF
  • Workflow support for PNF in-place SW upgrade in SO (stretch goal)


Presentations and Discussion Slides:

Related Meeting Links:

Development Status

Proposed Dublin scope presented Dec 20, 2018 to the 5G UC meeting.

ProjectPTL/ContanctsJIRADescriptionStatus

APPC

SDNC

CCSDK

Takamune Cho

Dan Timoney


  1. Support vendor-specific mapping of upgrade APIs to NETCONF requests in addition to other options.

  2. Support of roll-back API for PNF, New DG needed. Impact to SO building blocks and SDNC.
  3. LCM API payload  and playbook enhancements for S/W upgrade for alignment with 3GPP S/W management APIs in ansible playbooks
  4. PNF S/W upgrade workflow design and test (Stretch goal)

VF-C

Yan Yang

Xiang Li[CMCC]


No Impact

SO

VID

Seshu Kumar Mudiganti

ittay


  1. Provide re-usable workflows and building blocks for PNF SW upgrade
  2. Trigger upgrade workflow from GUI

IntegrationYang Xu
No impact
External Controller

Enbo Wang

wangyaoguang


Support for 3GPP API calls for sw download, install and activate.

Project Impacts

Description

JIRA Links

SDNC/CCSDK

Add SDNC LCM action - rollback

SDNC-664 - Getting issue details... STATUS  

complete rollback LCM action for PNF   S/W upgrade

SDNC-669 - Getting issue details... STATUS

create a DG for PNF S/W upgrade

SDNC-670 - Getting issue details... STATUS

provide corresponding ansible playbook   for rollback operation

SDNC-671 - Getting issue details... STATUS

Extend PNF upgrade-software   operation by leveraging sub-operations from 3GPP (like   download/install/activate)

SDNC-677 - Getting issue details... STATUS

External   Controller

Support swFallback/download/install/activate operations

NA

Requirements Impact

CCSDK → Changes in LCM.yang file

SDN-C → (1) New ansible playbooks, (2) New DG for rollback

EC → New substeps such as sw download, install and activate

API changes

  • Yang model changes to current LCM:rollback action in CCSDK (mandatory fields in rollback action will be optional to make the LCM:rollback action more generic, optional output payload field is added)
  • Definition of rollback input and output payloads for 5G PNF specific rollback
  • Possible payload changes into existing API /operations/LCM:upgrade-software
  • sw download, install and activate APIs in southbound of SDNC (to EC) as part of Ansible playbook for LCM:upgrade-software API.

API details


(1) Provided by SDN-C/CCSDK:

LCM API Abbre.HTTP MethodURIYang Model SectionRequest ExampleResponse Example
rollbackPost/operations/LCM:rollback
rpc rollback {
    description "An operation to rollback to particular snapshot of a virtual network function (or VM)";
    input {
        uses common-header;
        leaf action {
            type action;
             mandatory true;
        }
        uses action-identifiers;
        leaf payload {
            type payload;
            mandatory false;
        }
        leaf identity-url {
            type string;
            mandatory false;
        }
        leaf snapshot-id {
            type string;
             mandatory false;
        }
    }
    output {
        uses common-header;
        uses status;
        leaf payload {
            type payload;
            mandatory false;
        }
    }
}
{
  "input": {
    "action": "Rollback",
    "action-identifiers": {
      "vnf-id": "5gDU0001"
    },
    "common-header": {
      "api-ver": "2.00",
      "flags": {
        "force": "FALSE",
        "mode": "NORMAL",
        "ttl": 65000
      },
      "originator-id": "MSO",
      "request-id": "a1171d12-2ae9-496b-a2df-99784572914d",
      "sub-request-id": "a1171d12-2ae9-496b-a2df-99784572914d",
      "timestamp": "2019-03-15T09:07:58.255Z"
    },
    "payload": "{\"pnf-flag\":\"true\", \"ipaddress-v4-oam\": \"192.168.35.83\", \"filter\": \"\\\\'$..[?(@.nEIdentification == \\\\\\\"5gDU0001\\\\\\\")]\\\\'\"}"
  }
}

400: Success

{
    "output": {
        "common-header": {
            "api-ver": "2.00",
            "originator-id": "MSO",
            "request-id": "a1171d12-2ae9-496b-a2df-99784572914d",
            "sub-request-id": "a1171d12-2ae9-496b-a2df-99784572914d"
        },
        "payload": "{\"nEList\": [{\"nEIdentification\": \"5gDU0001\", \"swFallbackStatus\": \"fallbackSuccessful\"}], \"result\": \"Success\"}",
        "status": {
            "code": 400,
            "message": "Ansible Request  2e0690ed-6b7a-43b1-a061-8e4ac7534609 finished with Result = success, Message = FINISHED"
        }
    }
}
precheck*/operations/LCM:upgrade-pre-check
rpc upgrade-pre-check {
    description "An operation to check that the VNF has the correct software version needed for a software upgrade.";
    input {
        uses common-header;
        leaf action {
            type action;
            mandatory true;
        }
        uses action-identifiers;
        leaf payload {
            type payload;
            mandatory true;
       }
    }
    output {
        uses common-header;
        uses status;
        leaf payload {
            type payload;
            mandatory true;
                }
    }
}
{
  "input": {
    "action": "UpgradePreCheck",
    "action-identifiers": {
      "vnf-id": "5gDU0001"
    },
    "common-header": {
      "api-ver": "2.00",
      "flags": {
        "force": "FALSE",
        "mode": "NORMAL",
        "ttl": 65000
      },
      "originator-id": "MSO",
      "request-id": "a1171d12-2ae9-496b-a2df-99784572914d",
      "sub-request-id": "a1171d12-2ae9-496b-a2df-99784572914d",
      "timestamp": "2019-03-15T09:07:58.255Z"
    },
    "payload": "{\"pnf-flag\":\"true\", \"pnf-name\": \"5gDU0001\",\"pnfId\": \"5gDU0001\", \"ipaddress-v4-oam\": \"192.168.35.83\",\"oldSwVersion\": \"v1\", \"targetSwVersion\": \"v2\", \"ruleName\": \"r001\", \"Id\": \"10\", \"additionalData\":\"{}\"}"
  }
}

400: Success

{
    "output": {
        "common-header": {
            "api-ver": "2.00",
            "originator-id": "MSO",
            "request-id": "a1171d12-2ae9-496b-a2df-99784572914d",
            "sub-request-id": "a1171d12-2ae9-496b-a2df-99784572914d"
        },
        "payload": "{\"result\": \"Success\"}",
        "status": {
            "code": 400,
            "message": "Ansible Request  f0f45105-1a51-4592-a31b-f178d5eb4638 finished with Result = success, Message = FINISHED"
        }
    }
}
postcheck*/operations/LCM:upgrade-post-check
rpc upgrade-post-check {
    description "An operation to check the VNF upgrade has been successful completed and all processes are running properly.";
    input {
        uses common-header;
        leaf action {
            type action;
            mandatory true;
        }
        uses action-identifiers;
        leaf payload {
            type payload;
            mandatory true;
       }
    }
    output {
        uses common-header;
        uses status;
        leaf payload {
            type payload;
            mandatory true;
                     }
    }
}
{
  "input": {
    "action": "UpgradePostCheck",
    "action-identifiers": {
      "vnf-id": "5gDU0001"
    },
    "common-header": {
      "api-ver": "2.00",
      "flags": {
        "force": "FALSE",
        "mode": "NORMAL",
        "ttl": 65000
      },
      "originator-id": "MSO",
      "request-id": "a1171d12-2ae9-496b-a2df-99784572914d",
      "sub-request-id": "a1171d12-2ae9-496b-a2df-99784572914d",
      "timestamp": "2019-02-23T09:07:58.255Z"
    },
    "payload": "{\"pnf-flag\":\"true\", \"pnf-name\": \"5gDU0001\",\"pnfId\": \"5gDU0001\", \"ipaddress-v4-oam\": \"192.168.35.83\",\"oldSwVersion\": \"v1\", \"targetSwVersion\": \"v2\", \"ruleName\": \"r102\", \"Id\": \"10\", \"additionalData\":\"{}\"}"
  }
}

400: Success

{
    "output": {
        "common-header": {
            "api-ver": "2.00",
            "originator-id": "MSO",
            "request-id": "a1171d12-2ae9-496b-a2df-99784572914d",
            "sub-request-id": "a1171d12-2ae9-496b-a2df-99784572914d"
        },
        "payload": "{\"result\": \"Success\"}",
        "status": {
            "code": 400,
            "message": "Ansible Request  c1c14dee-a80d-40b8-800a-9216a27c7d1c finished with Result = success, Message = FINISHED"
        }
    }
}
upgrade-software*/operations/LCM:upgrade-software
rpc upgrade-software {
    description "An operation to upgrade the target VNF to a new version and expected that the VNF is in a quiesced status .";
    input {
        uses common-header;
        leaf action {
            type action;
            mandatory true;
        }
        uses action-identifiers;
        leaf payload {
            type payload;
            mandatory true;
       }
    }
    output {
        uses common-header;
        uses status;
    }
}
{
  "input": {
    "action": "UpgradeSoftware",
    "action-identifiers": {
      "vnf-id": "5gDU0001"
    },
    "common-header": {
      "api-ver": "2.00",
      "flags": {
        "force": "FALSE",
        "mode": "NORMAL",
        "ttl": 65000
      },
      "originator-id": "MSO",
      "request-id": "a1171d12-2ae9-496b-a2df-99784572914d",
      "sub-request-id": "a1171d12-2ae9-496b-a2df-99784572914d",
      "timestamp": "2019-03-15T09:07:58.255Z"
    },
    "payload": "{\"pnf-flag\":\"true\", \"pnfId\": \"5gDU0001\", \"ipaddress-v4-oam\": \"192.168.35.83\", \"targetSwVersion\": \"\\\\'[{\\\\\\\"swLocation\\\\\\\": \\\\\\\"http://192.168.35.144:10080/ran_du_pkg1-v2.zip\\\\\\\", \\\\\\\"swFileSize\\\\\\\": 353, \\\\\\\"swFileCompression\\\\\\\": \\\\\\\"ZIP\\\\\\\", \\\\\\\"swFileFormat\\\\\\\": \\\\\\\"zip\\\\\\\"}, {\\\\\\\"swLocation\\\\\\\": \\\\\\\"http://192.168.35.144:10080/ran_du_pkg2-v2.zip\\\\\\\", \\\\\\\"swFileSize\\\\\\\": 353, \\\\\\\"swFileCompression\\\\\\\": \\\\\\\"ZIP\\\\\\\", \\\\\\\"swFileFormat\\\\\\\": \\\\\\\"zip\\\\\\\"}]\\\\'\"}"
  }
}

400: Success

{
    "output": {
        "common-header": {
            "api-ver": "2.00",
            "originator-id": "MSO",
            "request-id": "a1171d12-2ae9-496b-a2df-99784572914d",
            "sub-request-id": "a1171d12-2ae9-496b-a2df-99784572914d"
        },
        "status": {
            "code": 400,
            "message": "Ansible Request  a3962a33-86ba-4346-8ef2-e2890d1ba734 finished with Result = success, Message = FINISHED"
        }
    }
}

*: These lcm APIs inherit from R3.

(2) Provided by External Controller:


Test cases and Status

Master Integration Test Page: Dublin Release Integration Testing Status


#Test Case DescriptionTest Status

1 PreCheck test

Ensure LCM:upgrade-pre-check can be executed (north-bound of SDNC)

NOT TESTED

2 SwUpgrade test

Ensure LCM:upgrade-software can be executed (north-bound of SDNC)

NOT TESTED

3 PostCheck test

Ensure LCM:upgrade-post-check can be executed (north-bound of SDNC)

NOT TESTED

4 SwRollback testEnsure LCM:rollback can be executed (north-bound of SDNC)

NOT TESTED

5 SwDownload

Ensure software download API can be executed (south-bound of SDNC to EC)

NOT TESTED

6 SwInstall

Ensure software install API can be executed (south-bound of SDNC to EC)

NOT TESTED

7 SwActivate

Ensure software activate API can be executed (south-bound of SDNC to EC)

NOT TESTED



  • No labels