Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation
Guide That Contains This Content
[+] Expand All
[-] Collapse All

    Creating a Customer

    A customer in Cloud CPE Tenant, Site and Service Manager represents a customer who accesses VNFs in a service provider’s centralized cloud through a Layer 3 VPN. You assign users and sites to customers in Cloud CPE Tenant, Site and Service Manager to represent the staff in the customer’s organization and the geographical locations in the customer’s network.

    This procedure uses the following Cloud CPE Tenant, Site and Service Manager API:

    • Create the customer:
      http://server-IP-address:9788/csas/customers/
    • View details for the customer:
      http://server-IP-address:9788/csas/customers/customer-identifier

    Table 1 shows the fields that you must specify for this procedure.

    Table 1: Required Fields for Creating a Customer

    Field

    Description

    Example

    fq_name

    Fully qualified domain name of the customer, including the domain name, project name, and customer name.

    "default-domain",
    "Buddhi",
    "Buddhi"

    pop

    Identifier of the POP in Cloud CPE Tenant, Site and Service Manager

    f8567ec7-34bd-4fd9-a170-9019b0be9d06

    route_target

    Route target of the virtual network for the customer

    64512:12000

    subnet

    Subnet of the virtual network for the customer

    137.1.1.0/24

    Before you begin this procedure, create a default tenant type, which allocates standard resources for VNFs, network services, and other related properties to customers.

    To create a customer:

    1. Create an input file.
      For example:
      ubuntu@vm1:~$cat cust.json
      {
          "customer":{
              "fq_name":[
                  "default-domain",
                  "Buddhi",
                  "Buddhi"
              ],
              "pop": "f8567ec7-34bd-4fd9-a170-9019b0be9d06",
              "route_target": "64512:12000",
              "subnet": "137.1.1.0/24"
          }
      }
      
    2. Issue a REST call to create the customer in Cloud CPE Tenant, Site and Service Manager.

      The API returns:

      • The URL and identifier for the customer (href, name, uuid).
      • The URL and identifier for the project (parent_href, parent_uuid).

      For example:

      ubuntu@vm1:~$ curl -X POST -D headers -H "content-type:application/json" -H "x-auth-token:$OS_TOKEN" http://10.102.56.39:9788/csas/customers -d@cust.json
       
      {
          "customer": {
              "fq_name": [
                  "default-domain",
                  "Buddhi",
                  "Buddhi"
              ],
              "href": "http://10.102.56.39:9788/csas/customers/d1a671b0-cb18-4975-be60-03057f1056de",
              "name": "Buddhi",
              "parent_href": "http://10.102.56.39:9788/csas/projects/26be7cb8-1c8c-4c96-a0fa-97a36a4deaca",
              "parent_uuid": "26be7cb8-1c8c-4c96-a0fa-97a36a4deaca",
              "uuid": "d1a671b0-cb18-4975-be60-03057f1056de"
          }
      }
      
    3. Issue a REST call to view full details for the customer.

      The API returns information for the customer.
      For example:

      ubuntu@vm1:~$ curl -X GET -H "x-auth-token:$OS_TOKEN" http://10.102.56.39:9788/csas/customers/d1a671b0-cb18-4975-be60-03057f1056de
       
      {
          "customer": {
              "display_name": "Buddhi",
              "fq_name": [
                  "default-domain",
                  "Buddhi",
                  "Buddhi"
              ],
              "href": "http://10.102.56.39:9788/csas/customers/d1a671b0-cb18-4975-be60-03057f1056de",
              "name": "Buddhi",
              "parent_href": "http://10.102.56.39:9788/csas/projects/26be7cb8-1c8c-4c96-a0fa-97a36a4deaca",
              "parent_type": "project",
              "parent_uuid": "26be7cb8-1c8c-4c96-a0fa-97a36a4deaca",
              "pop_refs": [
                  {
                      "attr": null,
                      "href": "http://10.102.56.39:9788/csas/pops/f8567ec7-34bd-4fd9-a170-9019b0be9d06",
                      "to": [
                          "default-domain",
                          "buddhi-pop"
                      ],
                      "uuid": "f8567ec7-34bd-4fd9-a170-9019b0be9d06"
                  }
              ],
              "route_target": "64512:12000",
              "stream_href": "http://10.102.56.39:9788/streams/csp",
              "subnet": "137.1.1.0/24",
              "tenantid": "26be7cb81c8c4c96a0fa97a36a4deaca",
              "uuid": "d1a671b0-cb18-4975-be60-03057f1056de"
          }
      }
      
    4. Verify the tenant identifier returned in Step 3 from Cloud CPE Tenant, Site and Service Manager is the same as the project identifier in Contrail OpenStack.

      1. Log in to the Contrail OpenStack node as root.
      2. Look for the customer information in the file openstackrc.

        For example:

        root@nfv-contrail:~# source /etc/contrail/openstackrc
        root@nfv-contrail:~# keystone tenant-list | grep Buddhi
        | 26be7cb81c8c4c96a0fa97a36a4deaca |  Buddhi  |   True  |
        

    Modified: 2016-01-29