Configuring Kernel Stack

Kernel Stack (kstack) uses well known Linux APIs to manage the routes and front panel ports. Open Containers, like the Guest Shell, are Linux environments that are decoupled from the host software. You can install or modify software within that environment without impacting the host software packages.

For more information, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:

https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-installation-and-configuration-guides-list.html/

Configuring the Local Port Range for Kstack

Configuring the Local Port Range for Kstack

POST http://<mgmt0_IP>/api/mo/sys/tcpudp.json

{
  "tcpudpEntity": {
    "children": [
      {
        "tcpudpInst": {
          "attributes": {
            "tcpEndPortRange": "51201",
            "tcpStartPortRange": "41703"
}}}]}}

{
    imdata:[]
}

<System>
  <tcpudp-items>
    <inst-items>
      <tcpEndPortRange>51201</tcpEndPortRange>
      <tcpStartPortRange>41703</tcpStartPortRange>
    </inst-items>
  </tcpudp-items>
</System>

Note: This example was added in Release 9.3(1).

CLI Commands

The CLI commands are equivalent to the payload examples displayed in the pane on the right. Click the DME tab in the top-left corner of the right pane to view the JSON payload. Click the YANG tab to view the XML payload.

sockets local-port-range 41703 51201

Verifying a DME Configuration

The following table contains the distinguished name (DN) for each managed object (MO) in the DME payload. Issue a GET request using the DN to verify the configuration was posted or to get information about the configured properties of a particular object.

MO	DN
tcpudpEntity	sys/tcpudp
tcpudpInst	sys/tcpudp/inst

tcpudpInst Properties

The following table contains information about the tcpudpInst properties in the DME payload. For more information about the properties and MOs, see the NX-API DME Model Reference linked in the Related Documentation section below.

Property Name	Data Type	Description	Values
tcpEndPortRange	tcpudp:TcpEndPort (scalar:Uint16)	Sockets Local End Port Range	RANGE: [22001 , 65535] DEFAULT: 58000
tcpStartPortRange	tcpudp:TcpStartPort (scalar:Uint16)	Sockets Local Start Port Range	RANGE: [15001 , 58000] DEFAULT: 15001

Related Documentation

For other CLI options, see the Cisco Nexus 9000 Series NX-OS Command Reference:

http://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-command-reference-list.html

For detailed information about classes and attributes in the payload, see the NX-API DME Model Reference: https://developer.cisco.com/media/dme/index.html

For information about using the payloads, see the Cisco Nexus 9000 Series NX-OS Programmability Guide:

https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-programming-reference-guides-list.html

Deleting the Local Port Range for Kstack

Deleting the Local Port Range for Kstack

POST http://<mgmt0_IP>/api/mo/sys/tcpudp.json

{
  "tcpudpEntity": {
    "children": [
      {
        "tcpudpInst": {
          "attributes": {
            "tcpEndPortRange": "58000",
            "tcpStartPortRange": "15001"
}}}]}}

{
    imdata:[]
}

<System>
  <tcpudp-items>
    <inst-items>
      <tcpEndPortRange>58000</tcpEndPortRange>
      <tcpStartPortRange>15001</tcpStartPortRange>
    </inst-items>
  </tcpudp-items>
</System>