Cisco Cisco Elastic Services Controller 1.1 User Manuals

Table of Contents

• 1 Introduction

  5
  • 1.1 Using NETCONF

    5
    • 1.1.1 Get configuration

      5
    • 1.1.2 Get non-configurable data

      5
    • 1.1.3 Subscribe ESC notifications

      5
    • 1.1.4 Make RPC calls

      5
    • 1.1.5 Push in configurations

      5
  • 1.2 ConfD CLI

    5
  • 1.3 Change ConfD Admin Password

    5
  • 1.4 NETCONF Protocol Operations

    6
  • 1.5 NETCONF Capabilities

    7
• 2 Configuration Data

  9
  • 2.1 Reading Configuration Data

    9
    • 2.1.1 Fetching all config data

      9
      • 2.1.1.1 Netconf Request

        9
      • 2.1.1.2 Netconf Response

        9
    • 2.1.2 Example: Fetching deployed services by network name

      12
      • 2.1.2.1 Netconf Request

        12
      • 2.1.2.2 Netconf Response

        12
  • 2.2 Writing Configuration Data (CRUD operations)

    13
    • 2.2.1 Stage 1: Acceptance or Rejection of a Configuration Request

      13
    • 2.2.2 Stage 2: Activation of a new Configuration

      14
      • 2.2.2.1 Event Notifications

        14
      • 2.2.2.2 Operational Data

        14
      • 2.2.2.3 Activation Failures

        14
    • 2.2.3 Configuration Workflows

      14
    • 2.2.4 Combining Workflows

      14
• 3 Operational Data

  16
  • 3.1 Reading Operational Data

    16
    • 3.1.1 Fetching all operational data

      16
      • 3.1.1.1 Netconf Request

        16
      • 3.1.1.2 Netconf Response

        16
• 4 Custom RPC Methods

  18
  • 4.1 serviceAction method

    18
  • 4.2 vmAction method

    18
• 5 ESC Workflows using Netconf

  18
  • 5.1 Configuration Workflows

    18
    • 5.1.1 Create Tenant

      18
      • 5.1.1.1 Netconf Request

        18
      • 5.1.1.2 Netconf Response

        18
      • 5.1.1.3 Configuration Activation

        19
        • On Success:

          19
          • Event notification

            19
          • Operational data

            19
            • Netconf Request

              19
            • Netconf Response

              19
        • On Failure:

          20
          • Event notification

            20
          • Operational data

            20
          • Handling Activation Failures

            20
    • 5.1.2 Delete Tenant

      21
      • 5.1.2.1 Netconf Request

        21
      • 5.1.2.2 Netconf Response

        21
      • 5.1.2.3 Configuration Activation

        21
        • On Success:

          21
          • Event notification

            21
          • Operational data

            22
        • On Failure:

          22
          • Event notification

            22
          • Operational data

            22
          • Handling Activation Failures

            22
    • 5.1.3 Create Network

      23
      • 5.1.3.1 Netconf Request

        23
      • 5.1.3.2 Netconf Response

        23
      • 5.1.3.3 Configuration Activation

        23
        • On Success:

          23
          • Event notification

            23
        • On Failure:

          24
          • Event notification

            24
          • Handling Activation Failures

            24
    • 5.1.4 Delete Network

      25
      • 5.1.4.1 Netconf Request

        25
      • 5.1.4.2 Netconf Response

        25
      • 5.1.4.3 Configuration Activation

        25
        • On Success:

          25
          • Event notification

            25
        • On Failure:

          26
          • Event notification

            26
          • Handling Activation Failures

            26
    • 5.1.5 Create Subnet

      27
      • 5.1.5.1 Netconf Request

        27
      • 5.1.5.2 Netconf Response

        27
      • 5.1.5.3 Configuration Activation

        27
        • On Success:

          27
          • Event notification

            27
        • On Failure:

          28
          • Event notification

            28
          • Handling Activation Failures

            28
    • 5.1.6 Delete Subnet

      29
      • 5.1.6.1 Netconf Request

        29
      • 5.1.6.2 Netconf Response

        29
      • 5.1.6.3 Configuration Activation

        29
        • On Success:

          29
          • Event notification

            29
        • On Failure:

          30
          • Event notification

            30
          • Handling Activation Failures

            30
    • 5.1.7 Create Image

      31
      • 5.1.7.1 Netconf Request

        31
      • 5.1.7.2 Netconf Response

        31
      • 5.1.7.3 Configuration Activation

        31
        • On Success:

          31
          • Event notification

            31
          • Operational data

            32
            • Netconf Request

              32
            • Netconf Response

              32
        • On Failure:

          32
          • Event notification

            32
          • Operational data

            32
          • Handling Activation Failures

            32
    • 5.1.8 Delete Image

      33
      • 5.1.8.1 Netconf Request

        33
      • 5.1.8.2 Netconf Response

        33
      • 5.1.8.3 Configuration Activation

        33
        • On Success:

          33
          • Event notification

            33
          • Operational data

            33
        • On Failure:

          34
          • Event notification

            34
          • Operational data

            34
          • Handling Activation Failures

            34
    • 5.1.9 Create Flavor

      35
      • 5.1.9.1 Netconf Request

        35
      • 5.1.9.2 Netconf Response

        35
      • 5.1.9.3 Configuration Activation

        35
        • On Success:

          35
          • Event notification

            35
          • Operational data

            36
            • Netconf Request

              36
            • Netconf Response

              36
        • On Failure:

          36
          • Event notification

            36
          • Operational data

            36
          • Handling Activation Failures

            36
    • 5.1.10 Delete Flavor

      37
      • 5.1.10.1 Netconf Request

        37
      • 5.1.10.2 Netconf Response

        37
      • 5.1.10.3 Configuration Activation

        37
        • On Success:

          37
          • Event notification

            37
          • Operational data

            37
        • On Failure:

          38
          • Event notification

            38
          • Operational data

            38
          • Handling Activation Failures

            38
    • 5.1.11 Register Service with the Service Catalog

      39
      • 5.1.11.1 Netconf Request

        39
      • 5.1.11.2 Netconf Response

        39
      • 5.1.11.3 Configuration Activation

        40
        • On Success:

          40
          • Event notification

            40
          • Operational data

            40
            • Not applicable. There is no operational data for service registration.

              40
        • On Failure:

          40
          • Event notification

            40
          • Operational data

            41
            • Not applicable. There is no operational data for service registration.

              41
          • Handling Activation Failures

            41
    • 5.1.12 Unregister Service from the Service Catalog

      42
      • 5.1.12.1 Netconf Request

        42
      • 5.1.12.2 Netconf Response

        42
      • 5.1.12.3 Configuration Activation

        42
        • On Success:

          42
          • Event notification

            42
          • Operational data

            43
            • Not applicable. There is no operational data for service registration.

              43
        • On Failure:

          43
          • Event notification

            43
          • Operational data

            43
            • Not applicable. There is no operational data for service registration.

              43
          • Handling Activation Failures

            43
    • 5.1.13 Deploy Service

      44
      • 5.1.13.1 Netconf Request

        44
      • 5.1.13.2 Netconf Response

        46
      • 5.1.13.3 Configuration Activation

        46
        • Workflow Aggregation:

          46
        • On Success:

          46
          • Event notification

            46
          • Operational data

            48
            • Netconf Request

              48
            • Netconf Response

              48
        • On Failure:

          49
          • Event notification

            49
          • Operational data

            50
          • Handling Activation Failures

            50
    • 5.1.14 Un-deploy Service

      51
      • 5.1.14.1 Netconf Request

        51
      • 5.1.14.2 Netconf Response

        51
      • 5.1.14.3 Configuration Activation

        51
        • Workflow Aggregation:

          51
        • On Success:

          52
          • Event notification

            52
          • Operational data

            53
        • On Failure:

          53
          • Event notification

            53
          • Operational data

            53
          • Handling Activation Failures

            53
    • 5.1.15 Update Service

      53
      • 5.1.15.1 Netconf Request

        54
      • 5.1.15.2 Netconf Response

        56
      • 5.1.15.3 Configuration Activation

        56
        • On Success:

          56
          • Event notification

            56
          • Operational data

            57
            • Netconf Request

              57
            • Netconf Response

              57
        • On Failure:

          59
          • Event notification

            59
          • Operational data

            59
          • Handling Activation Failures

            59
  • 5.2 Operational Workflows

    59
    • 5.2.1 Service Operations

      59
      • 5.2.1.1 Stop Service

        59
        • 5.2.1.1.1 Netconf Request

          59
        • 5.2.1.1.2 Netconf Response

          60
        • 5.2.1.1.3 Event Notifications

          60
      • 5.2.1.2 Start Service

        61
        • 5.2.1.2.1 Netconf Request

          61
        • 5.2.1.2.2 Netconf Response

          61
        • 5.2.1.2.3 Event Notifications

          61
      • 5.2.1.3 Reboot Service

        63
        • 5.2.1.3.1 Netconf Request

          63
        • 5.2.1.3.2 Netconf Response

          63
        • 5.2.1.3.3 Event Notifications

          63
      • 5.2.1.4 Disable Service Monitor

        65
        • 5.2.1.4.1 Netconf Request

          65
        • 5.2.1.4.2 Netconf Response

          65
        • 5.2.1.4.3 Event Notifications

          66
      • 5.2.1.5 Enable Service Monitor

        67
        • 5.2.1.5.1 Netconf Response

          67
        • 5.2.1.5.2 Event Notifications

          67
    • 5.2.2 VM operations

      68
      • 5.2.2.1 Stop VM

        68
        • 5.2.2.1.1 Netconf Request

          68
        • The “force” option in the request decides if ESC considers the min_vm requirement for the service. Since stopping a VM would affect the service availability, after the VM is stopped the min_vm requirement specified in the datamodel may not be satisfitied. If the “force” option is true, ESC will ignore the requirement for min_vm.

          69
        • 5.2.2.1.2 Netconf Response

          69
        • 5.2.2.1.3 Event Notifications

          69
      • 5.2.2.2 Start VM

        70
        • 5.2.2.2.1 Netconf Request

          70
        • 5.2.2.2.2 Netconf Response

          70
        • 5.2.2.2.3 Event Notifications

          70
      • 5.2.2.3 Reboot VM

        72
        • 5.2.2.3.1 Netconf Request

          72
        • The “force” option in the request decides if ESC considers the min_vm requirement for the service. Since stopping a VM would affect the service availability, after the VM is rebooted the min_vm requirement specified in the datamodel may not be satisfitied. If the “force” option is true, ESC will ignore the requirement for min_vm.

          72
        • 5.2.2.3.2 Netconf Response

          72
        • 5.2.2.3.3 Event Notifications

          72
      • 5.2.2.4 Disable VM Monitor

        73
        • 5.2.2.4.1 Netconf Request

          73
        • 5.2.2.4.2 Netconf Response

          74
        • 5.2.2.4.3 Event Notifications

          74
      • 5.2.2.5 Enable VM Monitor

        75
        • 5.2.2.5.1 Netconf Request

          75
        • 5.2.2.5.2 Netconf Response

          75
        • 5.2.2.5.3 Event Notifications

          75
• 6 ESC Triggered Workflows

  76
  • Recovery Initialize

    77
  • Attempts for recovery

    77
  • Recovery complete

    77
  • Success Event notifications

    77
    • On Failure:

      79
      • Event notification

        79
      • Handling Recovery Failures

        79
  • 6.2 Scale Out/Scale in Work Flows

    79
    • 6.2.1 Scale Out Work Flow

      79
      • 6.2.1.1 Event Notifications

        79
    • 6.2.2 Scale In Work Flow

      81
      • 6.2.2.1 Event Notifications

        81