Skip to end of metadata
Go to start of metadata

VID instantiation flow

Use VID to trigger instantiation of an infrastructure service and its components using the following order:

  1. Create a service instance container
  2. Add a Network associated with the service (if part of service composition)
  3. Add a VNF associated with the service
  4. Add a volume group (where required)
  5. Add a VF module (where required)
Repeat steps 2 to 5 (where required) until all VNFs and components for a service are instantiated.

Verify that prerequisite configuration is in the cloud and inventory

The cloud organization creates a tenant associated with a service. The VID user may want to verify that a tenant was created as well as confirm other cloud-related information prior to instantiating an infrastructure service.

Verify:

  • tenant initializations

  • customer and subscriptions for infrastructure services

For information about tenant creation, see Pre-Onboarding.

Prerequisites:

  • Upload component-specific information
  • Determine VID input
  • Validate entitlements

Convert spreadsheet data

Convert each spreadsheet to a format that is acceptable to SDNC (.csv).

Prerequisites:
  1. Navigate to the directory that contains the spreadsheet.
  2. Use a conversion tool to convert the spreadsheet to .csv format.
  3. Provide the data to the SDNC administrator for upload.

Upload conversion output to SDNC

Upload the converted preload spreadsheets to SDNC. The spreadsheets contain information about the infrastructure service and/or network being instantiated.

Prerequisites:

  1. Navigate to the SDNC Admin Portal.
  2. Click the Preload Tools tab and select Preload VNF Network Data.
  3. Scroll to the bottom of the page and click Browse to select the converted spreadsheet created in Convert spreadsheet data.
  4. After selecting the spreadsheet, click Upload Network Worksheet CSV files.
    The GUI displays the uploaded data.

Trigger instantiation of an infrastructure service using VID

Use the Virtual Instantiation Deployment (VID) GUI to trigger MSO instantiation of services and components that are required by infrastructure customers. Create/add services and components in the order provided.


The service instance may contain multiple VNFs, and VNFs may contain one or more volume groups and/or VF modules.

The user must be authorized to use VID and the SDC service model must be in a Distributed state.
  1. Log into the VID Home page.
  2. Click Browse SDC Service Models and search for the service to instantiate.
    The view displays service models in a DISTRIBUTED state.
  3. Select a service and click Deploy.
    A dialog box displays.
  4. Complete the fields indicated by the red star and click Confirm:
    • For the Subscriber Name, select the internal customer requesting the service. The subscriber name maps to the ID of the customer that owns this infrastructure service.
    • For the Service Type, select the type required.
    • All other input fields are derived from the TOSCA model associated with the service model being instantiated. These fields can vary from one service model to another.
    For the Instance Name field, for resources that are orchestrated into the cloud, such as Volume Group, VF Module, and Network, the Instance Name field is the heat stack name. Only alphanumeric characters and underscore "_" are allowed. The name must begin with an alphabetic character. Spaces are not allowed and must be replaced with the underscore "_" character.
    A status message displays that shows the MSO instantiation progress as well as any messages associated with the process.
    The View/Edit Service screen displays the instantiated service model.
  5. Click Add VNF and select the appropriate VNF from the dropdown list.
    After selecting the VNF, the Add VNF dialog box displays.
  6. Complete all required fields in the dialog box and click Confirm:
    • Provide a name for the VNF
    • Select the product family
    • Select the cloud region to locate the VNF.
    • Select the tenant available to the subscriber in the selected region
    A status message shows the MSO instantiation progress as well as any exceptions.
  7. In the View/Edit Service Instance view, click one of the following (where required) and select the appropriate option:
    • Add Volume Group
    • Add VF Module


    These options only display if the SDC Model permits VF modules or volume groups. Only add these options according to the SDC service model.
    For VF modules with supporting volume groups, create the volume groups first. Also make sure that the volume group name matches to the name of the VF module that supports it.
    The Add Volume Group or Add VF Module dialog box displays.
  8. Complete the required fields and click Confirm.
    A status message shows the MSO instantiation progress as well as any exceptions.
  9. Repeat step 7 and step 8 to add another volume group or VF module.
    To create another VNF associated with this service, repeat steps 5 to 9 depending on the component requirements of this service.

VID instantiation errors

Codes associated with the instantiation process.


CodeReasonDescription
201

Created

The service instance was successfully created.

202

Accepted

The request has been accepted for processing, but the processing has not been completed.

The request may or may not be acted upon; it might be disallowed when processing actually takes place.

400

Bad Request

Many possible reasons not specified by the other codes, such as missing required parameters or incorrect format. The response body may include a further exception code and text.

HTTP 400 errors may be mapped to:

  • SVC0001 (general service error)
  • SVC0002 (bad parameter)
  • SVC2000 (general service error with details)
  • PO9003 (message content size exceeds the allowable limit)

401

Unauthorized

Authentication failed or was not provided. HTTP 401 errors may be mapped to:

  • POL0001 (general policy error
  • POL2000 (general policy error with details)

404

Not Found

The server has not found anything matching the Request-URI.

No indication is given of whether the condition is temporary or permanent.

405

Method Not Allowed

A request was made of a resource using a request method not supported by that resource, such as using PUT on a REST resource that only supports POST.

409

Locked

The request could not be completed due to a conflict with the current state of the resource.

500

Internal Server Error

The server encountered an internal error or timed out; please retry (general catch-all server-side error).

HTTP 500 errors may be mapped to:

  • SVC1000 (no server resources)

503

Service Unavailable

The server is currently unable to handle the request due to a temporary overloading or maintenance of the server. The implication is that this is a temporary condition which will be alleviated after some delay.

504

Gateway Timeout

The server, while acting as a gateway or proxy, did not receive a timely response from the upstream process.

  • No labels

3 Comments

  1. Please provide the either the CSV file or the spreadsheet to be loaded to SDNC. We are trying to do the conversation to csv and upload to SDNC but can not find the spreadsheet or the CSV file. . below are the sections referring to upload SDNC.


    Upload conversion output to SDNC

    Upload the converted preload spreadsheets to SDNC. The spreadsheets contain information about the infrastructure service and/or network being instantiated.

    Prerequisites:

    1. Navigate to the SDNC Admin Portal.
    2. Click the Preload Tools tab and select Preload VNF Network Data.
    3. Scroll to the bottom of the page and click Browse to select the converted spreadsheet created in Convert spreadsheet data.
    4. After selecting the spreadsheet, click Upload Network Worksheet CSV files.
      The GUI displays the uploaded data.

    Convert spreadsheet data

    Convert each spreadsheet to a format that is acceptable to SDNC (.csv).

    Prerequisites:
  2. Which ECOMP component creates the "preload data", or is this function outside of current ECOMP scope?

    Thank you