3.11. Configuring Global Service Entities with CLI

This section provides information to create subscriber (customer) accounts and to configure service destination points (SDPs) using the command line interface.

Topics in this section include:

3.12. Service Model Entities

The Nokia service model uses (logical) service entities to construct a service. Each entity within the model has properties that describe it and influence its behavior. The service model has four main entities to configure a service. The entities are:

3.13. Basic Configuration

Before configuring a subscriber service, the QoS, logs, and MPLS LSPs (if applicable) must be configured. Refer to the following guides for more information:

  1. 7705 SAR Quality of Service Guide
  2. 7705 SAR Router Configuration Guide
  3. 7705 SAR System Management Guide
  4. 7705 SAR MPLS Guide

A basic service configuration must have the following items configured:

  1. a customer ID
  2. a service type
  3. a service ID (a service-id number is mandatory and a service-name is optional)
  4. a SAP identifying a port and encapsulation value
  5. an interface (where required) identifying an IP address, IP subnet, and broadcast address
  6. an associated SDP (for distributed services)

The following example shows an Epipe service configuration displaying the SDP and Epipe service entities. SDP ID 2 was created with the far-end node 10.10.10.104. Epipe ID 6000 was created for customer ID 6, which uses the SDP ID 2.

A:ALU-B>config>service# info detail
#------------------------------------------
...
        sdp 2 mpls create
            description "MPLS-10.10.10.104"
            far-end 10.10.10.104
            ldp
            signaling tldp
            no vlan-vc-etype
            no path-mtu
            keep-alive
                shutdown
                hello-time 10
                hold-down-time 10
                max-drop-count 3
                timeout 5
                no message-length
            exit
            no shutdown
        exit
...
...
        epipe 6000 customer 6 vpn 6000 create
           service-mtu 1514
           service-name “Epipe_6000” 
           sap 1/1/2:0 create
               ingress
                   filter ip 1
                   qos 1
               exit
               egress
                    qos 1
               exit
           no shutdown
           exit
           spoke-sdp 2:6111 create
               ingress
                   no vc-label
           exit
               egress
                   no vc-label
           exit
               no shutdown
           exit
           no shutdown
       exit
...
#------------------------------------------
A:ALU-B>config>service#

3.14. Common Configuration Tasks

This section provides a brief overview of the following common configuration tasks that must be performed to configure a customer account and an SDP:

3.14.1. Configuring Customer Accounts

Use the customer command to configure customer information. Every customer account must have a customer ID. Optional parameters include:

  1. description
  2. contact name
  3. telephone number

If special characters are included in the customer description string, such as spaces, #, or ?, the entire string must be enclosed in double quotes.

Use the following CLI syntax to create and input customer information.

CLI Syntax:
config>service# customer customer-id create
contact contact-information
description description-string
phone phone-number
Example:
config>service# customer 5 create
config>service>cust# contact "Technical Support"
config>service>cust$ description "Nokia Customer"
config>service>cust# phone "650 555-5100"
config>service>cust# exit

The following example displays the customer account configuration output.

A:ALU-12>config>service# info
-------------------------------------------
    customer 5 create
        contact "Technical Support"
        description "Nokia Customer"
        phone "650 555-5100"
    exit

3.14.2. Configuring SDPs

When configuring an SDP, consider the following points.

  1. SDPs can be configured for MPLS, GRE, or IP encapsulation.
  2. If you do not specify an encapsulation type, the default is MPLS.
  3. An SDP can have more than one service bound to it. That is, an SDP is not specific or exclusive to any one service or any type of service.
  4. By default, SDPs are not associated with services. After an SDP is created, services can be associated with that SDP.
  5. A distributed service must be bound to an SDP.
  6. When configuring a distributed service, you must identify an SDP ID and the far-end IP address. Use the show>service>sdp command to display a list of qualifying SDPs.
  7. If an SDP configuration does not include the IP address of the associated far-end router, VLL and VPLS services to the far-end router cannot be provided.
  8. Up to eight RSVP-TE or SR-TE LSPs can be configured under a single MPLS-encapsulated SDP. However, a mix of RSVP-TE and SR-TE LSPs is not supported. RSVP-TE LSPs are configured using the config>service>sdp>lsp command and SR-TE LSPs are configured using the config>service>sdp> sr-te-lsp command.
  9. For MPLS-encapsulated SDPs, LSPs must be configured before the LSP-to-SDP associations can be assigned. The LSP-to-SDP associations must be created explicitly.
  10. LSPs are configured in the config>router>mpls context. Refer to the 7705 SAR MPLS Guide for configuration and command information.
  11. The destination address of the LSPs must match the far-end IP address of the SDP.
  12. The far-end SDP IP address can be the system IP address of a 7705 SAR or an SR-series router, or loopback or network interface of the far-end router
  13. When configuring MPLS SDP parameters, you can either specify up to eight RSVP-TE LSPs using the config>service>sdp>lsp command or enable LDP using the config>service>sdp>ldp command. There cannot be two methods of transport in a single SDP unless the mixed-lsp-mode option is selected (the lsp and ldp commands are mutually exclusive).
    If mixed-lsp-mode is enabled and an LSP is specified, RSVP-TE is used for dynamic signaling in the LSP.
  14. Automatic ingress and egress labeling (targeted LDP) is enabled by default. Ingress and egress VC labels are signaled over a targeted LDP connection between two 7705 SAR routers.
    Note:

    If signaling is disabled for an SDP, ingress and egress vc-labels for the services using that SDP must be configured manually.

For a basic SDP configuration, perform the following steps:

  1. Create an SDP ID.
  2. Specify an encapsulation type.
  3. Specify a far-end node.

The following examples show the CLI syntax for a basic MPLS SDP configuration. The first two show the syntax for configuring the SDP without mixed-lsp-mode enabled; one shows an RSVP-TE LSP configuration and the other shows an LDP configuration. The third example shows the syntax for configuring the SDP with mixed-lsp-mode enabled, with both an RSVP-TE LSP and LDP configured.

CLI Syntax:
config>service>sdp sdp-id mpls create
far-end ip-addr
lsp lsp-name
keep-alive
shutdown
no shutdown
Example:
config>service# sdp 100 mpls create
config>service>sdp# far-end 10.10.10.10
config>service>sdp# lsp "LSP1"
config>service>sdp# no shutdown
config>service>sdp# exit

The following example displays a basic SDP LSP configuration output.

*A:Sar18 Dut-B>config>service# info
----------------------------------------------
.....
        sdp 100 create
            no shutdown
            far-end 10.10.10.10
            lsp "LSP1"
            keep-alive
                shutdown
            exit
        exit
 .....
-------------------------------------------
CLI Syntax:
config>service>sdp sdp-id mpls create
far-end ip-addr
ldp
keep-alive
shutdown
no shutdown
Example:
config>service# sdp 300 mpls create
config>service>sdp# far-end 10.10.10.10
config>service>sdp# ldp
config>service>sdp# no shutdown
config>service>sdp# exit

The following example displays a basic SDP LDP configuration output.

*A:Sar18 Dut-B>config>service# info
----------------------------------------------
.....
        sdp 300 create
            far-end 10.10.10.10
            ldp
            keep-alive
                shutdown
            exit
            no shutdown
        exit
 .....
-------------------------------------------
CLI Syntax:
config>service>sdp sdp-id mpls create
description description-string
far-end ip-addr
mixed-lsp-mode
exit
ldp
lsp lsp-name
keep-alive
shutdown
no shutdown
Example:
config>service# sdp 1 mpls create
config>service>sdp# description “SDI4”
config>service>sdp# far-end 10.10.10.10
config>service>sdp# mixed-lsp-mode
config>service>sdp# exit
config>service>sdp# ldp
config>service>sdp# lsp "LSP1"
config>service>sdp# no shutdown
config>service>sdp# exit

The following example displays a basic SDP mixed-lsp-mode configuration output.

A:Sar18 Dut-B>config>service# info
----------------------------------------------
.....
        sdp 1 create
            description "SDI4"
            far-end 10.10.10.10
            mixed-lsp-mode
            exit
            ldp
            lsp "LSP1"
            keep-alive
                shutdown
            exit
            no shutdown
        exit
.....
----------------------------------------------

The following examples show the CLI syntax for a basic GRE SDP configuration.

CLI Syntax:
config>service>sdp sdp-id gre create
description description-string
far-end ip-addr
keep-alive
shutdown
no shutdown
Example:
config>service# sdp 2 gre create
config>service>sdp# description “GRE-10.10.10.10”
config>service>sdp# far-end 10.10.10.10
config>service>sdp# no shutdown
config>service>sdp# exit

The following example displays a basic GRE SDP configuration output.

A:ALU-12>config>service# info
-------------------------------------------
.....
        sdp 2  create
            description "GRE-10.10.10.104"
            far-end 10.10.10.104
            keep-alive
                shutdown
            exit
            no shutdown
.....
-----------------------------------------
A:ALU-12>config>service#

3.14.2.1. Enabling IP Fragmentation for GRE SDPs

Use the following CLI syntax to enable fragmentation of IP packets for GRE SDPs.

CLI Syntax:
config>service>sdp sdp-id gre [create]
allow-fragmentation
Example:
config>service# sdp 2 gre create
config>service>sdp# allow-fragmentation
Note:

Fragmented IP packets require a reassembly profile in order to ensure that packets that cannot be reassembled are disposed of in a timely manner. See the 7705 SAR Router Configuration Guide for configuration and command information.

3.14.3. Configuring Service Names

After a service has been created, it can be assigned a service name.

Use the following CLI syntax to assign a service name to a service. The syntax example is for an Epipe.

CLI Syntax:
config>service>epipe# service-name service-name
Example:
config>service# epipe 1 customer 1 create
config>service>epipe# service-name “Epipe_1”

The following example displays the service name configuration output.

A:ALU-12>config>service>epipe# info
-------------------------------------------
...
            shutdown
            service-name "Epipe_1"
            sdp 2  create
                description "GRE-10.10.10.104"
                far-end 10.10.10.104
                keep-alive
                    shutdown
                exit
                no shutdown
            exit
...
-----------------------------------------
A:ALU-12>config>service#

3.15. ETH-CFM (802.1ag and Y.1731) Tasks

This section provides a brief overview of the following ETH-CFM tasks:

3.15.1. Configuring ETH-CFM Parameters (802.1ag and Y.1731)

Configuration commands for both the 802.1ag and the Y.1731 functions are entered in an eth-cfm context (global or Epipe or VPLS service). For information on Ethernet OAM commands for 802.1ag and Y.1731 OAM, refer to the “Ethernet OAM Capabilities” section in the 7705 SAR OAM and Diagnostics Guide.

An 802.1ag MEP and a Y.1731 MEP are similar in function. Configure a MEP to be a Y.1731 MEP by choosing the format none keywords in the global domain command, and the format icc-based keywords in the global association command. Configure a MEP to be a Y.1731 MEP that can interoperate with a 802.1ag MEP by choosing the format none keywords in the global domain command, and the format string keywords in the global association command.

802.1ag Configuration

The first set of commands occurs at the global level. The second set occurs at the Epipe or VPLS service level.

*A:ALU-1>config>eth-cfm# info
----------------------------------------------
    domain 1 name "kanata_MD" level 5
        association 1 format string name "kanata_MA"
            bridge-identifier 2
            exit
            ccm-interval 60
            remote-mepid 125
        exit
    exit
----------------------------------------------
 
*A:ALU-1>config>service>epipe 2 customer 1 create
*A:ALU-1>config>service>epipe# info
----------------------------------------------
    shutdown
    sap 1/5/1 create
        eth-cfm
            mep 1 domain 1 association 1 direction down
                shutdown
            exit
        exit
    exit
    spoke-sdp 1:11 create
        eth-cfm
            mep 2 domain 1 association 1 direction down
                shutdown
            exit
        exit
    exit
----------------------------------------------
 
*A:ALU-1>config>service>vpls 2 customer 1 create
*A:ALU-1>config>service>vpls# info
----------------------------------------------
    shutdown
    sap 1/2/1:0 create
        eth-cfm
            mep 1 domain 1 association 1 direction down
                shutdown
            exit
        exit
    exit
    mesh-sdp 7:2 create
        eth-cfm
            mep 2 domain 1 association 1 direction down
                shutdown
            exit
        exit
    exit
----------------------------------------------
Note:

RDI information is carried in the CCM OAMPDU. To be able to transmit and also receive RDI information, a MEP must have CCM enabled. See Applying ETH-CFM Parameters.

Y.1731 Configuration

The following example displays a Y.1731 configuration. The first set of commands occurs at the global level. The second set occurs at the Epipe or VPLS service level.

*A:ALU-1>config>eth-cfm# info
----------------------------------------------
    domain 1 format none level 1
        association 1 format icc-based name "1234567890123"
            bridge-identifier 100
            exit
            ccm-interval 1
        exit
    exit
----------------------------------------------
 
*A:ALU-1>config>service>epipe# info
----------------------------------------------
    shutdown
    sap 2/2/1:40 create
        eth-cfm
            mep 1 domain 1 association 1 direction up
                ais-enable
                    priority 2
                    interval 60
                exit
                eth-test-enable
                    test-pattern all-ones crc-enable
                exit
                no shutdown
            exit
        exit
    exit
    no shutdown
...
----------------------------------------------
 
*A:ALU-1>config>service>vpls# info
----------------------------------------------
    shutdown
    sap 1/2/1:0 create
        eth-cfm
            mep 1 domain 1 association 1 direction up
                ais-enable
                    interval 60
                    priority 2
                exit
                eth-test-enable
                    test-pattern all-ones crc-enable
                exit
                no shutdown
            exit
        exit
    exit
    no shutdown
...
----------------------------------------------
Note:

To be able to transmit and also receive AIS PDUs, a Y.1731 MEP must have ais-enable set. To be able to transmit and also receive ETH-Test PDUs, a Y.1731 MEP must have eth-test-enable set.

3.15.2. Applying ETH-CFM Parameters

Apply ETH-CFM parameters to the following entities, as shown in the CLI syntax examples below:

  1. Epipe SAP
  2. Epipe spoke SDP
  3. VPLS SAP
  4. VPLS spoke or mesh SDP
  5. OAM tests (loopback, linktrace, Ethernet test, delay measurement, loss measurement, synthetic loss measurement)

The MAC address for a MEP on an Epipe SAP or on an Epipe or VPLS SDP cannot be changed. For a MEP on an Epipe SAP, the MAC address is the port MAC address. For a MEP on an Epipe or VPLS SDP, the MAC address is the system MAC address. The MAC address for a MEP on a VPLS SAP can be changed; the default is the port MAC address.

The 7705 SAR supports the following MEPs for both 802.1ag and Y.1731:

  1. SAP Up and Down MEPs
  2. spoke SDP Up and Down MEPs
  3. mesh SDP Up and Down MEPs (VPLS only)

The following two syntax examples are for an Epipe service. Configuration for VPLS is the same except that the hold-mep-up-on-failure and dual-ended-loss-test-enable parameters are not supported on VPLS SAPs.

The third syntax shows the OAM tests that can be applied to MEPs.

CLI Syntax:
config>service>epipe>sap
eth-cfm
hold-mep-up-on-failure
mep mep-id domain md-index association ma-index [direction {up | down}]
ais-enable
ccm-enable
ccm-ltm-priority priority
dual-ended-loss-test-enable
eth-test-enable
low-priority-defect {allDef|macRemErrXcon| remErrXcon|errXcon|xcon|noXcon}
one-way-delay-threshold seconds
[no] shutdown
config>service>epipe>spoke-sdp
eth-cfm
mep mep-id domain md-index association ma-index [direction {up | down}]
ccm-enable
ccm-ltm-priority priority
low-priority-defect {allDef|macRemErrXcon| remErrXcon|errXcon|xcon|noXcon}
[no] shutdown
oam
eth-cfm eth-test mac-address mep mep-id domain md-index association ma-index [priority priority] [data-length data-length]
eth-cfm linktrace mac-address mep mep-id domain md-index association ma-index [ttl ttl-value]
eth-cfm loopback mac-address mep mep-id domain md-index association ma-index [send-count send-count] [size data-size] [priority priority]
eth-cfm one-way-delay-test mac-address mep mep-id domain md-index association ma-index [priority priority]
eth-cfm two-way-delay-test mac-address mep mep-id domain md-index association ma-index [priority priority]
eth-cfm single-ended-loss-test mac-address mep mep-id domain md-index association ma-index [priority priority] [interval interval] [send-count send-count]
eth-cfm two-way-slm-test mac-address mep mep-id domain md-index association ma-index [priority priority] [send-count send-count] [size data-size] [timeout timeout] [interval interval]

3.16. Service Management Tasks

This section provides a brief overview of the following service management tasks:

3.16.1. Modifying Customer Accounts

Use the show>service>customer command to display a list of customer IDs.

To modify a customer account:

  1. Access the specific account by specifying the customer ID.
  2. Enter the parameter to modify (description, contact, phone) and then enter the new information.
CLI Syntax:
config>service# customer customer-id create
[no] contact contact-information
[no] description description-string
[no] phone phone-number
Example:
config>service# customer 27 create
config>service>customer$ description “Western Division”
config>service>customer# contact “John Dough”
config>service>customer# no phone “(650) 237-5102”

3.16.2. Deleting Customers

The no form of the customer command typically removes a customer ID and all associated information; however, all service references to the customer must be shut down and deleted before a customer account can be deleted.

CLI Syntax:
config>service# no customer customer-id
Example:
config>service# epipe 5 customer 27 shutdown
config>service# epipe 9 customer 27 shutdown
config>service# no epipe 5
config>service# no epipe 9
config>service# no customer 27

3.16.3. Modifying SDPs

Use the show>service>sdp command to display a list of SDP IDs.

To modify an SDP:

  1. Access the specific SDP by specifying the SDP ID.
  2. Enter the parameter to modify, such as description, far-end, or lsp, and then enter the new information.
Note:

Once the SDP is created, you cannot modify the SDP encapsulation type.

CLI Syntax:
config>service# sdp sdp-id
Example:
config>service# sdp 79
config>service>sdp# description “Path-to-107”
config>service>sdp# shutdown
config>service>sdp# far-end “10.10.10.107”
config>service>sdp# path-mtu 1503
config>service>sdp# no shutdown

3.16.4. Deleting SDPs

The no form of the sdp command typically removes an SDP ID and all associated information; however, before an SDP can be deleted, the SDP must be shut down and removed (unbound) from all customer services where it is applied.

CLI Syntax:
config>service# no sdp 79
Example:
config>service# epipe 5 spoke-sdp 79:5
config>service>epipe>spoke-sdp# shutdown
config>service>epipe>spoke-sdp# exit
config>service>epipe 5 no spoke-sdp 79:5
config>service>epipe# exit
config>service# no sdp 79

3.16.5. Deleting LSP Associations

The no form of the lsp command removes an LSP ID and all associated information; however, before an LSP can be deleted, it must be removed from all SDP associations.

CLI Syntax:
config>service# sdp sdp-id
[no] lsp lsp-name
Example:
config>service# sdp 79
config>service>sdp# no lsp 123
config>service>sdp# exit all