4 Deploying ATS Using VNFM

The ATS Master VNF supports dynamic and fixed IP deployment models.

Note:

ATS supports both IPv4 and IPv6 suites at the time of deployment.

To deploy the ATS Master VNF, you must have the following pieces of information:

• The VNF ID for a previously created ATS Master VNF instance.
• Information about the OpenStack instance on which the VNF must be deployed:
  • OpenStack Controller URI
  • User Domain Name
  • Project Domain Id
  • Username
  • Password
  • Tenant name
• The name of a public network in the selected OpenStack instance that will carry the ATS master traffic.
• The IP of an NTP server accessible by VMs within the selected OpenStack instance. The OpenStack controller that controls the selected OpenStack instance hosts an NTP server.

For more information about the list of all the inputs and possible outputs of the command instantiate VNF, refer to ETSI NFV-SOL 003, section 5.4.4.3.1, or the DSR VNFM Swagger specification.

Note:

It is mandatory to add two XSI Networks in ATS Master to instantiate a stack.

Sample Request for instantiating ATS Master Dynamic IP deployment model:

URL: https://<<VNFM HOST IP>>:8443/vnflcm/v1/vnf_instances/< VNF ID received from create request>/instantiate
        
        Accept: application/json
        Content-Type: application/json
        X-Token: Token generated after login
        
        {
        "flavourId": "master",
        "instantiationLevelId": "small",
        "extVirtualLinks": "extVirtualLinks",
        "extManagedVirtualLinks": [],
        
        "vimConnectionInfo":[ {
        "id": "vimid",
        "vimType": "OpenStack",
        "interfaceInfo": {
        "controllerUri": "https://oortcloud.us.oracle.com:5000/v3" 
        },
        "accessInfo": {
        "username": "dsrci.user",
        "password": "xxxxx",
        "userDomain": "Default",
        "projectDomain": "default",
        "tenant": "DSR CI"
        }
        
        }],
        "localizationLanguage": "localizationLanguage",
        "additionalParams": {
        "xmiNetwork": {
        "name": "ext-net8",
        "ipVersion": "IPv4",
        "xmiSubnetName":"ext-net8-subnet"
        },
        "xsiNetwork": [{
        "name": "ext-net7",
        "ipVersion": "IPv4",
        "xsiSubnetName":"ext-net7-subnet"
        },
        {
        "name": "ext-net6",
        "ipVersion": "IPv4",
        "xsiSubnetName":"ext-net6-subnet"
        }],
        "ntpServerIp": "10.250.32.10",
        "dnsServerIp": "10.250.32.10",
        "atsKeyName": "atsKeypair",
        "atsMasterFlavor": "ats.master",
        "atsMasterImage": "ATS_BOX.qcow2",
        "atsAvailabilityZone": "nova"
        }
        }
    

Sample request for initiating ATS Master Request for Fixed IP deployment model:

URL: https://<<VNFM HOST IP>>:8443/vnflcm/v1/vnf_instances/< VNF ID received from create request>/instantiate
        
        Accept: application/json
        Content-Type: application/json
        X-Token: Token generated after login
        
        {
        "flavourId": "master",
        "instantiationLevelId": "small",
        "extVirtualLinks": "extVirtualLinks",
        "extManagedVirtualLinks": [],
        
        "vimConnectionInfo":[ {
        "id": "vimid",
        "vimType": "OpenStack",
        "interfaceInfo": {
        "controllerUri": "https://oortcloud.us.oracle.com:5000/v3" 
        },
        "accessInfo": {
        "username": "dsrci.user",
        "password": "xxxxx",
        "userDomain": "Default",
        "projectDomain": "default",
        "tenant": "DSR CI"
        }
        }],
        "localizationLanguage": "localizationLanguage",
        "additionalParams": {
        "xmiNetwork": {
        "name": "ext-net8",
        "ipVersion": "IPv4",
        "xmiSubnetName":"ext-net8-subnet",
        "fixedIps": {
        "masterXmiIp":"10.75.123.16"
        }
        },
        "xsiNetwork": [{
        "name": "ext-net7",
        "ipVersion": "IPv4",
        "xsiSubnetName":"ext-net7-subnet",
        "fixedIps":                    
        {                       
        "xsiIp": "10.75.195.21"                     
        }
        },
        {
        "name": "ext-net6",
        "ipVersion": "IPv4",
        "xsiSubnetName":"ext-net6-subnet",
        "fixedIps":                    
        {                       
        "xsiIp": "10.75.195.22"                    
        }
        }],
        "ntpServerIp": "10.250.32.10",
        "dnsServerIp": "10.250.32.10",
        "atsKeyName": "atsKeypair",
        "atsMasterFlavor": "ats.master",
        "atsMasterImage": "ATS_BOX.qcow2",
        "atsAvailabilityZone": "nova"
        }
        }
    

Sample Response

Instantiating the ATS Master VNF response

202 Accepted
            
            Headers:
            {
            location: https://localhost:8443/vnflcm/v1/vnf_lcm_op_occs/lcmOp-fb21f9d3-43ad-46cd-a03f-7220bb36a5c6  
            date: Tue, 29 Jan 2019 10:39:24 GMT  
            content-length: 0  content-type:
            application/xml 
            }

The following table describes the parameters for ATS Master:

Table 4-1 ATS Master Parameters

Parameter	Definitions
flavourId	Identifier of the VNF deployment flavor to be instantiated.
xmiNetwork	Network used to provide access master VM communication.
ntpServerIp	IP of the NTP server.
dnsServerIp (optional)	IP of the DNS server. If not provided, NTP server IP will be considered as DNS server IP.
atsKeyName	Key pair name for ATS. To log in to the ATS instance, use same key pair.
masterXmiIp	In case of fixed IP scenario, the IP of master will be provided.
xsiNetwork	Network used for DSR signaling traffic.
atsMasterFlavor (optional)	Flavor used for OpenStack deploys.
atsMasterImage (optional)	Image used for OpenStack deploys.
atsAvailabilityZone (optional)	Name of logical partitioning in case of host aggregate.

Note:

The atsKeyName pair is created dynamically through VNFM. The same public key is put into all the ATS instances (master, core & tools), and the private key is in the ATS master stack output. Use the same private key to log in to the ATS instance (master, core & tools) by executing the following command:

ssh -i <ats private key> <username>@<ats master Ip>

Example: ssh -i atskey.pem cloud-user@10.75.189.120