SMI Cluster Manager Config Mode Command Reference

clusters action validate-cluster

Validates the cluster configuration.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

validate-cluster { logs | run log-level log_level } 

Usage Guidelines

Use this command to validate the cluster configuration.

clusters action validate-cluster logs

Displays the cluster configuration logs.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

logs 

Usage Guidelines

Use this command to view the cluster configuration logs.

clusters action validate-cluster run

Runs the cluster validation.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

run log-level log_level 

log-level log_level

Specify the log-level.

Must be one of the following:

  • CRITICAL: Critical.

  • ERROR: Error.

  • WARNING: Warning.

  • INFO: Info.

  • DEBUG: Debug.

Default Value: INFO.

Usage Guidelines

Use this command to run the cluster validation.

clusters actions k8s cluster-status

Displays overall status of the cluster including pod and etcd based statistics.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

k8s cluster-status 

Usage Guidelines

Use this command to view the overall status of the cluster including pod and etcd based statistics.

clusters actions logs

Displays the cluster synchornization logs.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

logs 

Usage Guidelines

Use this command to display the cluster synchronization.

clusters actions show

Displays the TCP, UDP, NTP and log-level information of the clusters.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

show { info { log-level log_level | ntp-info [ false | true ] | tcp-connections [ false | true ] | udp-connections [ false | true ] } | logs } 

Usage Guidelines

Use this command to view the TCP, UDP, NTP and log-level information of the clusters.

clusters actions show info

Displays the clusters TCP, UDP, NTP and log-level information.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

info { log-level log_level | ntp-info [ false | true ] | tcp-connections [ false | true ] | udp-connections [ false | true ] } 

Displays the TCP Services and connections.

Must be either "false" or "true".

Default Value: true.

udp-connections [ false | true ]

Displays the UDP services and connections.

Must be either "false" or "true".

Default Value: true.

ntp-info [ false | true ]

Displays the NTP clock server information.

Must be either "false" or "true".

Default Value: true.

log-level log_level

Displays the log level.

Must be one of the following:

  • CRITICAL

  • ERROR

  • WARNING

  • INFO

  • DEBUG

Default Value: INFO.

Usage Guidelines

Use this command to view the clusters TCP, UDP, NTP and log-level information.

clusters actions show logs

Displays the cluster configuration logs.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

logs 

Usage Guidelines

Use this command to view the cluster configuration.

clusters actions sync cancel

Cancels cluster synchronization

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

cancel 

Usage Guidelines

Use this command to cancel cluster synchronization.

clusters actions sync

Synchronizes the cluster configurations.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

sync { cancel | logs | run { debug | force-vm-redeploy | purge-data-disks | reset-k8s-nodes | upgrade-strategy { concurrent | rolling } } | status } 

Usage Guidelines

Use this command to synchronize the cluster configurations.

clusters actions sync run

Runs the cluster synchronization.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

run { debug | force-vm-redeploy | purge-data-disks | reset-k8s-nodes | upgrade-strategy { concurrent | rolling } } 

upgrade-strategy { concurrent | rolling }

Specify the upgrade strategy.

Must be one of the following:

  • rolling

  • concurrent

  • auto

Default Value: auto.

vm-redeploy { false | true }

Specify whether to redeploy the VM or not.

Must be either "false" or "true".

Default Value: false.

force-partition-redeploy { false | true }

Force redeploying the partition.

Must be either "false" or "true".

Default Value: false.

debug { false | true }

Specfies whether to debug or not.

Must be either "false" or "true".

Default Value: false.

reset-k8s-nodes { false | true }

Specify whether to reset the K8s nodes or not.

Must be either "false" or "true".

Default Value: false.

purge-data-disks { false | true }

Specify whether to purge data disks or not.

Must be either "false" or "true".

Default Value: false.

sync-phase { all | opscenter }

Specify the synchorinization phase.

Must be one of the following:

  • all

  • opscenter

  • distributed-registry

Default Value: all.

ansible-strategy { linear | free }

Specify the ansible startegy for the synchorinization.

Must be one of the following:

  • linear

  • free

Default Value: linear.

Usage Guidelines

Use this command to run the cluster synchronization.

clusters actions sync status

Displays the cluster synchronization status.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

status 

Usage Guidelines

Use this command to view the cluster synchronization status.

clusters actions validate-config

Validates the configuration defined for the clusters.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

validate-config { logs | run { k8s-node-checks [ false | true ] | log-level log-level log_level | netplan [ false | true ] | ntp [ false | true ] | proxy [ false | true ] | ssh [ false | true ] | vmware-checks [ false | true ] } } 

Usage Guidelines

Use this command to validate the configuration defined for the clusters.

clusters actions validate-config logs

Displays the cluster configuration logs.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

logs 

Usage Guidelines

Use this command to view the cluster configuration logs.

clusters actions validate-config run

Runs the cluster configuration validation.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

run { k8s-node-checks [ false | true ] | log-level log-level log_level | netplan [ false | true ] | ntp [ false | true ] | proxy [ false | true ] | ssh [ false | true ] | vmware-checks [ false | true ] } 

netplan [ false | true ]

Validates the netplan configuration.

Must be either "false" or "true".

Default Value: true.

ssh [ false | true ]

Validates the SSH configuration.

Must be either "false" or "true".

Default Value: true.

ntp [ false | true ]

Validates the NTP server configuration.

Must be either "false" or "true".

Default Value: true.

proxy [ false | true ]

Validates the proxy server configuration.

Must be either "false" or "true".

Default Value: true.

vmware-checks [ false | true ]

Validates the vcenter, datastore and host configuration before synchronzing.

Must be either "false" or "true".

Default Value: true.

k8s-node-checks [ false | true ]

Validates the K8s nodes configuration size.

Must be either "false" or "true".

Default Value: true.

log-level log_level

Specify the log-level.

Must be one of the following:

  • CRITICAL

  • ERROR

  • WARNING

  • INFO

  • DEBUG

Default Value: INFO.

Usage Guidelines

Use this command to run the cluster configuration validation.

clusters addons

Configures the basic kubernetes cluster functionality.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

addons { ingress { bind-ip-address ipv4_address | disabled bind-ip-address ipv4_address | enabled bind-ip-address ipv4_address } | istio { disabled | enabled } | kubernetes-dashboard { enabled | diabled } | network type calico | openstack-volume-provider { auth-url url | domain-id domain_id | password string | tenant-id tenant_id | username username } } 

Usage Guidelines

Use this command to implement kubernetes basic functionality like Ingress and other functionality expected to be provided by the kubernetes cluster.

clusters addons cpu-partitioner

Enables or disables the CPU partitioning.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

cpu-partitioner { enabled | disabled } 

enabled

Specify to enable or disable CPU partitioning.

Must be either "false" or "true".

Default Value: false.

Usage Guidelines

Use this command to enable or disable CPU partitioning.

clusters addons distributed-registry

Enables or disables the distributed registry.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

distributed-registry { enabled | disabled | releases name } 

enabled { false | true }

Specify to enable or disable the distributed-registry.

Must be either "false" or "true".

Default Value: false.

Usage Guidelines

Use this command to enable or disable the distributed registry.

clusters addons distributed-registry releases

Specify the release name whose chart and images need to be added to the registry.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

releases name 

name

Specify the release name.

Must be a string.

Usage Guidelines

Use this command to specify the release name whose chart and images need to be added to the registry.

clusters addons ingress

Configures the ingress IPv4 address.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

ingress service-type { bind-ip-address ipv4_address | disabled bind-ip-address ipv4_address | enabled bind-ip-address ipv4_address } 

bind-ip-address ipv4_address

Specify the IPv4 address for binding.

enabled { false | true }

Specify to enable or disable.

Must be either "false" or "true".

Default Value: true.

failure-threshold failure_threshold

Specify the failure-threshold.

Must be an integer.

Default Value: 3.

timeout-seconds timeout

Specify the timeout in seconds.

Must be an integer.

Default Value: 1.

Usage Guidelines

Use this command to configure the ingress IPv4 address to Kubernetes cluster.

clusters addons istio

Enables or Disbales the Istio services.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

isitio { enabled | disabled } 

enabled

Specify to enable or disable the Istio services.

Must be either "false" or "true".

Default Value: false.

Usage Guidelines

Use this command to enable or disable the Istios services.

clusters addons kubernetes-dashboard

Configures the Kubernetes dashboard.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

kubernetes-dashboard enabled { false | true } 

enabled

Specify to enable or disable the Kubernetes dashboard.

Must be either "false" or "true".

Default Value: false.

Usage Guidelines

Use this command to configure the Kubernetes dashboard.

clusters addons network

Configures the network type.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

network type calico 

type calico

Specify the network type. The default type is Calico.

Must be one of the following:

  • calico

Default Value: calico.

Usage Guidelines

Use this command to configure the network type.

clusters addons openstack-volume-provider

Enables the OpenStack volume provider.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

openstack-volume-provider { auth-url url | domain-id domain_id | password password | tenant-id tenant_id | username user_name } 

username user_name

Specify the Openstack user name.

Must be a string.

password password

Specify the OpenStack password.

Must be an aes-cfb-128-encrypted string.

auth-url url

Specify the auth URL.

Must be a string.

tenant-id tenant_id

Specify the tenant ID.

Must be a string.

domain-id domain_id

Specify the domain ID.

Must be a string.

Usage Guidelines

Use this command to enable the OpenStack volume provider.

clusters addons vsphere-volume-provider

Consfigures vCenter vSphere.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

vsphere-volume-provider { server vcenter_server | server-port vcenter_port | allow-insecure { false | true } | user vcenter_username | password vcenter_password | datacenter vcenter_datacenter | datastore vcenter_datastor | network network_id | folder cluster_folder } 

server vcenter_server

Specify the vCenter server name.

Must be a string.

server-port vcenter_port

Specify the vCenter server port.

Must be an integer.

Default Value: 443.

allow-insecure { false | true }

Specify to allow or deny self-signed certificates.

Must be either "false" or "true".

Default Value: false.

user vcenter_username

Specify the vCenter user name.

Must be a string.

password vcenter_password

Specify the vCenter password.

Must be an aes-cfb-128-encrypted string.

datacenter vcenter_datacenter

Specify the vCenter datacenter.

Must be a string.

datastore vcenter_datastore

Specify the vCenter datastore.

Must be a string.

network network_id

Specify the vCenter network ID.

Must be a string.

folder cluster_folder

Specify the cluster folder containing the VMs.

Must be a string.

Usage Guidelines

Use this command to configure the vCenter vSphere.

clusters

Configures the cluster environment.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

clusters environment 

enviroment

Specify the environment used to deploy.

name name

Specify the name used to uniquely identify the cluster. Must be an alphanumeric string, and can contain the hyphen (-). It must not start with a hyphen.

Must be a string.

Usage Guidelines

Use this command to configure clusters enviroment.

clusters configuration

Configures the kubernetes cluster.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

configuration { additional-master-virtual-ip ipv4_address | additional-master-virtual-ip-cidr integer | addtional-master-virtual-ip-interface string | customization-image string | allow-insecure-registry { false | true } | master-virtual-ip ipv4_address | master-virtual-ip-cidr integer | master-virtual-ip-interface string | pod-subnet string | size { functional-test-aio | functional-test-ha | production} | virtual-ip-vrrp-router-id integer } 

master-virtual-ip ipv4_address

Specify the virtual IPv4 address used to make the kubernetes masters Highly Available (HA).

master-virtual-ip-cidr cidr_notation

Specify the CIDR notation of the additional master virtual IP.

Default Value: 32.

Must be an integer in the range of 0-32.

master-virtual-ip-interface string

Specify the Ethernet interface to which the master IP will be assigned.

Default Value: "ens192".

Must be a string.

keepalived-auth AES_encrypted_string

Specify the authentication password for Keepalived.

Must be an aes-cfb-128-encrypted string.

Default Value: "4be37dc3b4c90194d1600c483e10ad1d".

additional-master-virtual-ip ipv4_address

Specfies the virtual IPv4 used to provide additional access to the HA kubernetes masters. This must be set on initial cluster creation.

additional-master-virtual-ip-cidr integer

Specfies the CIDR notation (netmask) of additional master virtual IP.

Default Value: 32.

Must be an integer in the range of 0-32.

addtional-master-virtual-ip-interface string

Specify the ethernet interface to which the additional master IP will be assigned. This will correspond to netplan network IDs

Default Value: "ens192".

Must be a string.

virtual-ip-vrrp-router-id vrrp_router_id

Specify the VRRP router ID. If multiple instances of VRRP are in use on the same subnet, router ID must be unique. This is typically needed if running multiple SMI k8s clusters in the same subnet. Issues will show up with virtual IP not binding properly.

Must be an integer in the range of 1-255.

pod-subnet string

Enters the pod subnet to configure k8s and calico.

Default Value: "192.168.0.0/16".

Must be a string.

customization-image string

Specify the Docker image to use for customizing the VMs deployed in the cluster.

Must be a string.

size { functional-test-aio | functional-test-ha | production }

Specify the cluster size.

Must be one of the following:

  • production

  • functional-test-ha

  • functional-test-aio

Default Value: production.

allow-insecure-registry { false | true }

Allows the use of insecure docker and helm registries.

Must be either "false" or "true".

Default Value: false.

Usage Guidelines

Use this command to configure the kubernetes cluster.

clusters configuration docker-address-pools

Updates the default docker bridge network address pools.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

clusters configuration docker-address-pools docker_bridge_address_pool_name{ base  ip_address/prefix_length  | size pool_size } 

docker_bridge_address_pool_name

Specify the name of docker bridge address pool.

base ip_address/prefix_length

Specify the docker bridge IP address and subnet.

size pool_size

Specify the size of the address pool.

Default Value: 24

Must be an integer in the range of 8-24 (multiples of 8).

Usage Guidelines

Use this command to update the default docker bridge network address pools.

Example

The following example updates the default docker bridge network address pools.

SMI Cluster Manager(config)# clusters cluster1 pool1
SMI Cluster Manager(config-docker-address-pools-pool1)# base 192.50.0.0/16
SMI Cluster Manager(config-docker-address-pools-pool1)# size 24
SMI Cluster Manager(config-docker-address-pools-pool1)# exit 

clusters environment

Configures the cluster environment.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

clusters environment 

environment

Specify the environment used to deploy.

name name

Specify the name used to uniquely identify the cluster. Must be an alphanumeric string, and can contain the hyphen (-). It must not start with a hyphen.

Must be a string.

Usage Guidelines

Use this command to configure clusters environment.

clusters environment nodes initial-boot

Configures the cloud-init configurations.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

initial-boot { default-user default_user | default-user-password password | default-user-ssh-public-key ssh_public_key } 

default-user user

Specify the default user when this node is created.

Must be a string.

default-user-ssh-public-key ssh_public_key

Specify the default SSH public key.

Must be a string.

default-user-password password

Specify the password.

Must be an aes-cfb-128-encrypted string.

Usage Guidelines

Use this command to configure the cloud-init configurations (only first boot of VM).

clusters environment nodes os

Configures OS-specific configurations.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

os { ntp | proxy { http-proxy http_proxy | https-proxy https_proxy | no-proxy no_proxy } } 

Usage Guidelines

Use this command to configure OS-specific configurations.

clusters environment nodes vmware numa-node-affinity

Configures the affinity to a processor socket.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

numa-node-affinity cpu_socket_number 

socket cpu_socket_number

Specify the physical CPU socket number.

Must be an integer in the range of 0-15.

Usage Guidelines

Use this command to configure affinity to a processor socket.

clusters environment vmware performance

Configures VMware parameters.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

performance { cpu-reservation { false | true } | latency-sensitivity latency_sensitivity | memory-reservation { false | true } } 

latency-sensitivity latency_sensitivity

Specify the latency-senstivity.

Must be one of the following:

  • high: High.

  • low: Low.

  • medium: Medium.

  • normal: Normal.

memory-reservation { false | true }

Memory reservation info.

Must be either "false" or "true".

cpu-reservation { false | true }

CPU reservation info.

Must be either "false" or "true".

Usage Guidelines

Use this command to configure the VMware parameters.

clusters k8s

Configures Kubernetes-specific configurations.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

k8s { node-labels key value | ssh-connection-password password | ssh-connection-private-key private_key | ssh-username user_name } 

ssh-username user_name

Specify the SSH username used for connecting to the node.

Must be a string.

ssh-connection-private-key private_key

Specify the SSH private key used for connecting to the node.

Must be an aes-cfb-128-encrypted string.

Usage Guidelines

Use this command to configure Kubernetes-specifc configurations.

clusters node-defaults

Configures the default configuration that applies to all nodes. All options are overridable at the node level.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

node-defaults { initial-boot | k8s | netplan | os | vmware } 

ssh-username username

Specify the SSH username used for connecting to the node.

Must be a string.

ssh-connection-private-key private_key

Specify the SSH private key used for connecting to the node.

Must be an aes-cfb-128-encrypted string.

Usage Guidelines

Use this command to configure the default configuration that applies to all nodes. All options are overridable at the node level.

clusters node-defaults initial-boot

Configures the initial boot options for the node.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

initial-boot { default-user user | default-user-password password | default-user-ssh-public-key ssh_public_key } 

default-user user

Specify the default user when this node is created.

Must be a string.

default-user-ssh-public-key ssh_public_key

Specify the default SSH public key.

Must be a string.

default-user-password password

Specify the password.

Must be an aes-cfb-128-encrypted string.

Usage Guidelines

Use this command to configure the initial boot options for the node. Cloud-init configurations which only take effect on initial boot of OS and will not cause respin without other changes.

clusters node-defaults k8s

Configures Kubernetes-specific configurations.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

k8s { node-labels key value | ssh-connection-password password | ssh-connection-private-key private_key | ssh-username username } 

ssh-username username

Specify the SSH username used for connecting to the node.

Must be a string.

ssh-connection-private-key private_key

Specify the SSH private key used for connecting to the node.

Must be an aes-cfb-128-encrypted string.

Usage Guidelines

Use this command to configure Kubernetes-specifc configurations.

clusters node-defaults netplan

Configures netplan.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

netplan template template 

template template

Specify the netplan YAML template used for defining network configurations.

Must be a string.

Usage Guidelines

Use this command to configure netplan template.

clusters node-defaults netplan variable-definitions

Configures the variables that can be input into netplan template.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

variable-definitions name name default-value default_value 

name name

Specify the variable name.

Must be a string.

default-value default_value

Specify the variable's default value.

Must be a string.

Usage Guidelines

Use this command to configure the variables that can be input into netplan template.

clusters node-defaults variable-definitions

Configures the variables that can be input into netplan template.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

variable-definitions name name default-value default_value 

name name

Specify the variable name.

Must be a string.

default-value default_value

Specify the variable's default value.

Must be a string.

Usage Guidelines

Use this command to configure the variables that can be input into netplan template.

clusters node-labels

Configures node labels.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

node-lables key value 

key

Specify the prefix for the node label. Must be an alphanumeric value in the format a-zA-Z0-0 and can contain the _ - . characters.

Must be a string.

value

Specify the suffix for the node label. Must be an alphanumeric value in the format a-zA-Z0-0 and can contain _-. characters. Spaces are not allowed.

Must be a string.

Usage Guidelines

Use this command to configure node labels.

clusters nodes

Configures the nodes for both OS and Kubernetes management.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

nodes node_name 

nodes node_name

Specify machines for both OS and Kubernetes management.

name

Specify the name of the node. name can be an alphanumeric string containing the hyphen (-). A hostname cannot start with a hyphen. For example, Example: kashaio-123.

Must be a string.

Usage Guidelines

Use this command to configure the nodes for both OS and Kubernetes management.

clusters nodes actions

Runs node synchornizations.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

actions { k8s pod-status show-pod-details { false | true } | sync { cancel | drain | logs | run { debug { false | true } | force-vm-redeploy { false | true } | purge-data-disks { false | true } | reset-k8s-nodes { false | true } } | status } } 

Usage Guidelines

Use this command to run node synchornizations.

clusters nodes actions k8s

Displays the status of the k8s pods in the nodes.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

k8s pod-status show-pod-details { false | true } 

Usage Guidelines

Use this command to view the status of the pods in the nodes.

clusters nodes actions k8s pod-status

Configures displaying the status of the pods scheduled on the node.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

pod-status show-pod-details { false | true } 

show-pod-details { false | true }

Specify whether to display the list of pods in addition to the counts.

Must be either "false" or "true".

Default Value: false.

Usage Guidelines

Use this command to configure displaying the status of the pods scheduled on the node.

clusters nodes actions sync cancel

Removes the node configuration.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

cancel 

Usage Guidelines

Use this command to remove the node configuration.

clusters nodes actions sync

Configures to synchorinze only one node.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

sync { cancel | drain { remove-node { false | true } | ansible-strategy { free | linear } } | logs | run { debug { false | true } | force-vm-redeploy { false | true } | purge-data-disks { false | true } | reset-k8s-nodes { false | true } } | status | serial-logs } 

Usage Guidelines

Use this command to to synchorinze only one node. Typically needed for manual upgrade cases where cluster rolling upgrade is not used.

clusters nodes actions sync drain

Drains the node in preparation for an upgrade.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

drain { remove-node { false | true } | ansible-strategy { free | linear } } 

remove-node { false | true }

Removes the specified node.

Must be either "false" or "true".

Default Value: false.

ansible-strategy { free | linear }

Specify the ansible startegy used for synchorinization.

Must be one of the following:

  • linear

  • free

Default Value: free.

Usage Guidelines

Use this command to drain the node in preparation for an upgrade.

clusters nodes actions sync logs

Displays the node configuration logs.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

logs 

Usage Guidelines

Use this command to view the node configuration logs.

clusters nodes actions sync run

Upgrades the nodes.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

run { debug { false | true } | force-vm-redeploy { false | true } | purge-data-disks { false | true } | reset-k8s-nodes { false | true } } 

vm-redeploy { false | true }

Specify whether to redeploy the VM or not.

Must be either "false" or "true".

Default Value: false.

force-partition-redeploy { false | true }

Force redeploying the partition.

Must be either "false" or "true".

Default Value: false.

debug { false | true }

Specfies whether to debug or not.

Must be either "false" or "true".

Default Value: false.

reset-k8s-nodes { false | true }

Specify whether to reset the K8s nodes or not.

Must be either "false" or "true".

Default Value: false.

purge-data-disks { false | true }

Specify whether to purge data disks or not.

Must be either "false" or "true".

Default Value: false.

sync-phase { all | opscenter }

Specify the synchorinization phase.

Must be one of the following:

  • all

  • opscenter

  • distributed-registry

Default Value: all.

ansible-strategy { linear | free }

Specify the ansible startegy for the synchorinization.

Must be one of the following:

  • linear

  • free

Default Value: linear.

Usage Guidelines

Use this command to upgrade the nodes.

clusters nodes actions sync serial-logs

Displays the node configuration serial logs.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

serial-logs 

Usage Guidelines

Use this command to view the node configuration serial logs.

clusters nodes actions sync status

Displays the status of the node.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

status 

Usage Guidelines

Use this command to display the status of the node.

clusters nodes k8s

Configures the cluster specific configuration.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

k8s {node-ip node_ip | node-labels key value| node-type type | ssh-connection-private-key AES_encrypted_string | ssh-ip ssh_ip | ssh-username ssh_username | ssh-bind-to-ssh-ip {false | true} } 

node-type node_type

Specify the Kubernetes node type.

Must be one of the following:

  • master

  • worker

  • etcd

Default Value: worker.

ssh-ip ssh_ip

Specfies the hostname or IP address used to connect through SSH for node management.

Must be a string.

sshd-bind-to-ssh-ip { false | true }

Specify if the SSHD should only listen on SSH IP.

Must be either "false" or "true".

Default Value: false.

node-ip node_ip

Specify the node IP used by kubernetes for inter-node communication.

Must be a string.

ssh-username user_name

Specify the SSH username used for connecting to the node.

Must be a string.

ssh-connection-private-key private_key

Specify the SSH private key used for connecting to the node.

Must be an aes-cfb-128-encrypted string.

Usage Guidelines

Use this command to configure cluster specific configuration.

clusters nodes netplan

Configures the netplan template.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

netplan variables variable_name value value 

Usage Guidelines

Use this command to configure the netplan template.

clusters nodes os netplan-additions actions

Displays a preview of netplan YAML and validates it with "netplan generate".

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

actions preview-netplan 

Usage Guidelines

Use this command to displays a preview of netplan YAML and validates it with 'netplan generate'. This command is used for debugging. It shows only the committed data.

clusters nodes netplan variables

Configures the netplan template variables.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

variables variable_name 

variable_name

Specify the variable name from the netplan template.

value

Specify the variable value.

Must be a string.

Usage Guidelines

Use this command to configure the netplan template variable.

clusters nodes os disable-log-ratelimit

Enables or disables JournalID rate limiting.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

disable-log-ratelimit enabled { false | true } 

enabled { false | true }

Specify to enable or disable JournalID rate limiting.

Must be either "false" or "true".

Usage Guidelines

Use this command to enable or disable JournalD rate limiting.

clusters nodes os netplan-additions

Allows adding to netplan configuration from initial-boot (cloud-init). NOTE: currently only routes are supported and not all netplan fields are available.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

netplan-additions 

Usage Guidelines

Use this command to add netplan configuration from initial-boot. At present only routes are supported and not all netplan fields are available.

clusters nodes os netplan-additions actions preview-netplan

Displays a preview of netplan YAML and validates with "netplan generate". This command displays only the commited data and it is useful for debugging.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

preview-netplan 

Usage Guidelines

Use this command to preview the netplan.

clusters nodes os netplan-additions bonds

Configures netplan bonds device type. See https://netplan.io/reference#properties-for-device-type-bonds.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

bonds 

device-id device_id

Specify the netplan device ID. Must be unique throughout the entire set of configuration files. Their primary purpose is to serve as anchor names for composite devices, for example to enumerate the members of a bridge that is currently being defined. See: https://netplan.io/reference#device-configuration-ids

Must be a string.

Usage Guidelines

Use this command to configure netplan bonds device type.

clusters nodes os netplan-additions bonds routes

Configures netplan routes. This command defines the standard static routes for an interface. It is mandatory to specify values for to and via. See https://netplan.io/reference#routing.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

routes to destination_address via gateway_address from source_ip_address metric metric_value 

to destination_address

Specify the destination address. Must be a string in 'x.x.x.x/x' or 'x.x.x.x' format.

Must be a string.

via gateway_address

Specify the gateway address. Must be a string in 'x.x.x.x/x' or 'x.x.x.x' format.

Must be a string.

from source_ip_address

Specify the source IP address going through the route.

Must be a string.

metric metric_value

Specify the relative priority of the route.

Must be a string.

Usage Guidelines

Use this command to configure netplan routes.

clusters nodes os netplan-additions ethernets

Configures netplan ethernets device type. See https://netplan.io/reference#properties-for-device-type-ethernets.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

ethernets 

device-id device_id

Specify the netplan device ID. Must be unique throughout the entire set of configuration files. Their primary purpose is to serve as anchor names for composite devices, for example to enumerate the members of a bridge that is currently being defined. See: https://netplan.io/reference#device-configuration-ids

Must be a string.

Usage Guidelines

Use this command to configure netplan ethernets device type.

clusters nodes os netplan-additions ethernets routes

Configures netplan routes. This command defines the standard static routes for an interface. It is mandatory to specify values for to and via. See https://netplan.io/reference#routing.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

routes to destination_address via gateway_address from source_ip_address metric metric_value 

to destination_address

Specify the destination address. Must be a string in 'x.x.x.x/x' or 'x.x.x.x' format.

Must be a string.

via gateway_address

Specify the gateway address. Must be a string in 'x.x.x.x/x' or 'x.x.x.x' format.

Must be a string.

from source_ip_address

Specify the source IP address going through the route.

Must be a string.

metric metric_value

Specify the relative priority of the route.

Must be a string.

Usage Guidelines

Use this command to configure netplan routes.

clusters nodes os netplan-additions vlans

Configures netplan vlan device type. See https://netplan.io/reference#properties-for-device-type-vlans

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

vlans 

device-id device_id

Specify the netplan device ID. Must be unique throughout the entire set of configuration files. Their primary purpose is to serve as anchor names for composite devices, for example to enumerate the members of a bridge that is currently being defined. See: https://netplan.io/reference#device-configuration-ids

Must be a string.

Usage Guidelines

Use this command to configure netplan vlan device type.

clusters nodes os netplan-additions vlans routes

Configures netplan routes. This command defines the standard static routes for an interface. It is mandatory to specify values for to and via. See https://netplan.io/reference#routing.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

routes to destination_address via gateway_address from source_ip_address metric metric_value 

to destination_address

Specify the destination address. Must be a string in 'x.x.x.x/x' or 'x.x.x.x' format.

Must be a string.

via gateway_address

Specify the gateway address. Must be a string in 'x.x.x.x/x' or 'x.x.x.x' format.

Must be a string.

from source_ip_address

Specify the source IP address going through the route.

Must be a string.

metric metric_value

Specify the relative priority of the route.

Must be a string.

Usage Guidelines

Use this command to configure netplan routes.

clusters nodes os ntp

Configures the NTP servers for the nodes.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

ntp { disabled | enabled servers url | servers url } 

enabled servers url

Enables the NTP servers for configuration.

Must be either "false" or "true".

Usage Guidelines

Use this command to configure the NTP servers for the nodes.

clusters nodes os ntp servers

Configures the time server parameters.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

servers url { key-id key_id | sha-key sha_key | sha-type sha_type } 

url

Specify the NTP server url. For example, clock.cisco.com.

Must be a string.

key-id key_id

Spcify the key-id for the chrony server keys.

Must be a string.

sha-type sha_type

Specify the type of SHA for the Chrony server keys. For instance, SHA1, SHA256, SHA512 etc. See: https://chrony.tuxfamily.org/manual.html.

Must be one of the following:

  • SHA1

  • SHA256

  • SHA384

  • SHA512

  • RMD128

  • RMD160

  • RMD256

  • RMD320

  • TIGER

  • WHIRLPOOL

sha-key sha_key

Specify the SHA authentication key with Chrony server.

Must be a string.

Usage Guidelines

Use this command to configure time server parameters, which need to be input into the NTP configuration.

clusters nodes os proxy

Configures the proxy servers at the node level.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

proxy { http-proxy http_proxy | https-proxy https_proxy | no-proxy no_proxy } 

http-proxy http_proxy

Specify to send HTTP traffic to an HTTP proxy.

Must be a string.

https-proxy https_proxy

Specify to send HTTPS traffic to an HTTP proxy.

Must be a string.

no-proxy no_proxy

Specify the hosts to avoid proxy.

Must be a string.

Usage Guidelines

Use this command to configure the proxy servers at the node level.

clusters nodes os tuned

Enable or disable.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

tuned { disabled | enabled } 

enabled { false | true }

Enable or disable.

Must be either "false" or "true".

Usage Guidelines

Use this command to enable or disable.

clusters node-type-defaults

Configures the default configuration that applies to all nodes of a specific type. Takes precedence over node-defaults. All options are overridable at the node level.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

node-type-defaults type 

type

Specify the node type.

Must be one of the following:

  • master

  • worker

  • etcd

Usage Guidelines

Use this command to configure the default configuration that applies to all nodes of a specific type. Takes precedence over node-defaults. All options are overridable at the node level.

clusters node-type-defaults initial-boot

Configures the cloud-init configurations, which only take effect on initial boot of OS and will not cause respin without other changes.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

initial-boot { default-user user | default-user-password password | default-user-ssh-public-key ssh_public_key } 

default-user user

Specify the default user when this node is created.

Must be a string.

default-user-ssh-public-key ssh_public_key

Specify the default SSH public key.

Must be a string.

default-user-password password

Specify the password.

Must be an aes-cfb-128-encrypted string.

Usage Guidelines

Use this command to configure the cloud-init configurations, which only take effect on initial boot of OS and will not cause respin without other changes.

clusters node-type-defaults k8s

Configures Kubernetes-specific configurations.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

k8s { node-labels key value | ssh-connection-password password | ssh-connection-private-key private_key| ssh-username user_name } 

ssh-username user_name

Specify the SSH username used for connecting to the node.

Must be a string.

ssh-connection-private-key private_key

Specify the SSH private key used for connecting to the node.

Must be an aes-cfb-128-encrypted string.

Usage Guidelines

Use this command to configure Kubernetes-specific configurations.

clusters node-type-defaults k8s

Configures Kubernetes-specific configurations.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

k8s { node-labels key value | ssh-connection-password password | ssh-connection-private-key private_key | ssh-username username } 

ssh-username username

Specify the SSH username used for connecting to the node.

Must be a string.

ssh-connection-private-key private_key

Specify the SSH private key used for connecting to the node.

Must be an aes-cfb-128-encrypted string.

Usage Guidelines

Use this command to configure Kubernetes-specific configurations.

clusters node-type-defaults k8s node-labels

Configures node labels.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

node-lables key value. 

key

Specify the prefix for the node label. Must be a alphanumeric string, and contain capital letters, and the underscore (_), hyphen (-), and dot (.) characters.

Must be a string.

value

Specify the suffix for the node label. Must be a alphanumeric string, and can contain capital letters, the underscore (_), hypen (-) and dot (.) characters. Spaces are not allowed.

Must be a string.

Usage Guidelines

Use this command to configure node labels.

clusters node-type-defaults netplan

Configures netplan.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

netplan template template 

template template

Specify the netplan YAML template used for defining network configurations.

Must be a string.

Usage Guidelines

Use this command to configure netplan template.

clusters ops-centers

Allows installation of application Ops centers used to install and manage applications.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

ops-centers app_name instance { repository url | netconf-ip ipv4_address | netconf-port port_number | ssh-ip ipv4_address | ssh-port port_number | ingress-hostname ip_address.nip.io } 

app_name

Specify the app name of the Ops center. For example, cee, ccmts. Chart name will be app-name-ops-center.

Must be a string.

instance

Specify the name of the instance. For example, data, infra etc.

Must be a string.

repository url

Specify the product chart repository URL.

username username

Specify the username to login to the repository.

Must be a string.

password password

Specify the password to login to the repository.

Must be an aes-cfb-128-encrypted string.

sync-default-repository { false | true }

Synchronizes the default helm repository to ops-center.

Must be either "false" or "true".

Default Value: true.

netconf-ip ipv4_address

Specify the Netconf IPv4 address for the Ops Center.

netconf-port port_number

Specify the Netconf port number for the Ops Center.

Must be an integer.

Default Value: 830.

ssh-ip ipv4_address

Specify the SSH IP address for the Ops Center.

ssh-ip port

Specify the SSH port number for the Ops Center.

Must be an integer.

Default Value: 2022.

ingress-hostname ip-address.nip.io

Specify the ingress hostname to be set to the Ops Center. Uses the ip-address .nip.io format.

Must be a string.

Usage Guidelines

Use this command to allow installation of application Ops centers used to install and manage applications.

clusters ops-centers initial-boot-parameters

Configures the initial boot parameters for helm chart deployment.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

initial-boot-parameters { use-volume-claims { false | true } | first-boot-password password | auto-deploy { false | true } | single-node { false | true } | image-pull-secrets name } 

use-volume-claims { false | true }

Specify the usage of persistent volumes. To use persistent volumes, set to true.

Must be either "false" or "true".

Default Value: false.

Usage Guidelines

Use this command to configure the initial boot parameters for helm chart deployment.

clusters ops-centers initial-boot-parameters image-pull-secrets

Configures the docker registry secret name.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

image-pull-secrets secret_name 

secret_name

Specify the docker registry secret name.

Must be a string.

first-boot-password password

Must be an aes-cfb-128-encrypted string.

Default Value: "p@ssw0rd".

auto-deploy { false | true }

Must be either "false" or "true".

Default Value: true.

single-node { false | true }

Specify whether to deploy the product chart on a single node. For multi-node deployments, set to false.

Must be either "false" or "true".

Default Value: true.

Usage Guidelines

Use this command to configure the docker registry secret name.

clusters ops-centers initial-boot-parameters

Configures the initial boot parameters for helm chart deployment.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

initial-boot-parameters { use-volume-claims { false | true } | first-boot-password password | auto-deploy { false | true } | single-node { false | true } | image-pull-secrets name } 

use-volume-claims { false | true }

Specify the usage of persistent volumes. To use persistent volumes, set to true.

Must be either "false" or "true".

Default Value: false.

first-boot-password password

Must be an aes-cfb-128-encrypted string.

Default Value: "p@ssw0rd".

auto-deploy { false | true }

Must be either "false" or "true".

Default Value: true.

single-node { false | true }

Specify whether to deploy the product chart on a single node. For multi-node deployments, set to false.

Must be either "false" or "true".

Default Value: true.

Usage Guidelines

Use this command to configure the initial boot parameters for helm chart deployment.

clusters ops-centers initial-boot-parameters image-pull-secrets

Configures the docker registry secret name.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

image-pull-secrets secret_name 

secret_name

Specify the docker registry secret name.

Must be a string.

Usage Guidelines

Use this command to configure the docker registry secret name.

clusters secrets

Configures the Kuberentes cluster-wide secrets.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global configuration

Syntax

secrets { tls { namespace namespace secret-name name { private-key string | certificate path_to_cert } } | docker-registry secret-name { docker-server server_name | docker-username user_name | docker-password password | docker-email email | namespace namespace } } 

Usage Guidelines

Use this command to configure the cluster-wide secrets.

clusters secrets docker-registry

Configures the name of the registry secret.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

docker-registry secret_name { docker-server server_name | docker-username user_name | docker-password password | docker-email email | namespace namespace } 

secret_name

Specify name of the secret. For example, regcred.

Must be a string.

docker-server server_name

Specify the name of the docker-server. For example, regcred.

Must be a string.

docker-username user_name

Specify the docker registry user name.

Must be a string.

docker-password password

Specify the docker registry password.

Must be a string.

docker-email email

Specify the docker registry email address.

Must be a string.

namespace namespace

Specify the docker registry namespace.

Must be a string.

Usage Guidelines

Use this command to configure the name of the registy secret.

clusters secrets tls

Configures the TLS associated secret.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

tls { namespace namespace secret-name name { private-key string | certificate path_to_cert } } 

namespace namespace

Specify the Kubernetes namespaces to create secret.

Must be a string.

secret-name name

Specify the name of the secret. For example, cert-grafana-ingress.

Must be a string.

private-key string

Specify the private-key associated with the certificate.

Must be a string.

certificate path_to_cert

Specify the path to the PEM encoded public key certificate.

Must be a string.

Usage Guidelines

Use this command to configure TLS associated secret.

clusters virtual-ips

Configures virtual IPs within the k8s cluster.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

virtual-ips vip_group { check-port port_number | hosts host_name priority priority_number | vrrp-interface name | vrrp-router-id router_id | ipv4-addresses ipv4_address { mask netmask | broadcast ip_address | device interface_name } | ipv6-addresses ipv6_address {device device_name | mask netmask } } 

vip_group

Specify the logical grouping of virtual IPs. This will set the VRRP instance. vip_group can be an alphanumeric string of 0-8 characters.

Must be a string in the pattern "[a-z][0-9a-z]*".

check-port port_number

Specify the check-port number. Set it to true to check if a localhost is listening on the expected port. If the port is not listening, the VRRP instance (or synch group) should not be up. This only applies to certain use cases - typically where an application is utilizing host networking and providing a service over this port.

Must be an integer in the range of 1-65535.

vrrp-interface name

Specify the host interface name that this VRRP instance is bound to.

Must be a string.

vrrp-router-id router_id

Specify the VRRP router ID. Must be an integer in the range of 1-255. 51 is reserved.

Must be an integer.

Usage Guidelines

Use this command to configure virtual IPs within the k8s cluster.

clusters virtual-ips hosts

Configures the host addresses.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

hosts hostname priority priority 

hostname

Specify the host name to run the logical VIP group.

priority priority

Specify the priority of the host.

Must be an integer in the range of 1-100.

Default Value: 50.

Usage Guidelines

Use this command to configure the host address.

clusters virtual-ips ipv4-addresses

Configures virtual IPv4 addresses.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

ipv4-addresses ipv4_address { mask netmask | broadcast ipv4_address | device interface_name } 

ipv4_address

Specify the IPv4 address.

mask netmask

Specify the mask value.

Must be an integer in the range of 1-32.

broadcast ipv4_address

Specify the broadcast IPv4 address.

device interface_name

Specify the device to attach to the virtual IP.

Must be a string.

Usage Guidelines

Use this command to configure the virtual IPv4 addresses.

clusters virtual-ips ipv6-addresses

Configures the IPv6 addresses.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

ipv6-addresses ipv6_address { device device_name | mask netmask } 

ipv6_address

Specify the IPv6 addresses.

mask netmask

Specify the netmask.

Must be an integer in the range of 1-128.

device device_name

Specify the device name attached to the VIP.

Must be a string.

Usage Guidelines

Use this command to configure the IPv6 address.

environments

Configures environment available for clusters.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

environments name { vcenter { allow-self-signed-cert { false | true } | cluster string | datacenter string | datastore string | host string | nics network-name | password password | port port | server url | user user_name } | manual } 

name

Specify the name of the datastore.

Must be a string.

datacenter string

Specify the name of the vCenter datacenter.

Must be a string.

host string

Specify the default host used to deploy the VMs.

Must be a string.

Usage Guidelines

Use this command to configure the environment available for clusters.

environments manual

Allows generating artifacts to be deployed manually.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

manual 

Usage Guidelines

Use this command to generate artifacts to be deployed manually.

environments vcenter

Deploys using the vCenter API.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

vcenter { allow-self-signed-cert { false | true } | cluster string | datacenter string |datastore string | host string | nics network-name | password password | port port_number | server url| user user_name } 

server server_name

Specify the IP or domain name of vCenter or ESXi host.

Must be a string.

port port_number

Specify the port number of vCenter or ESXi host.

Must be an integer.

Default Value: 443.

allow-self-signed-cert { false | true }

Specify whether the server allows a self-signed certificate to access or not.

Must be either "false" or "true".

Default Value: false.

user user_name

Specify the user name to login.

Must be a string.

password

Specify the password to login.

Must be an aes-cfb-128-encrypted string.

datastore datastore

Specify the name of the datastore used for files and VMs.

Must be a string.

cluster cluster_name

Specifes the cluster used for the placemnet of VM template.

Must be a string.

Usage Guidelines

Use this command to deploy using the vCenter API.

environments vcenter nics

Configures NICS.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec > Global Configuration

Syntax

nics network_name 

network_name

Specify the vmware network name.

Must be a string.

Usage Guidelines

Use this command to configure a list of networks assigned to VMs.

show

Displays system configuration information.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec

Syntax

show { cli | confd-state | configuration | history | jobs | nacm | netconf-state | notification | parser | restconf-state | running-config | version } 

Usage Guidelines

Use this command to view system configuration information.

show version

Displays system configuration information.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec

Syntax

version 

Usage Guidelines

Use this command to view system configuration information.

software-packages

Manages the available software packages.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec

Syntax

software-packages { delete package_name | download { user user_name password password url url accept-self-signed-certificate { false | true } retain-package { false | true } | url url} | list } 

Usage Guidelines

Use this command to download, delete, or list the available software packages.

software-packages delete

Removes the specified software packages.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec

Syntax

delete package package_name 

package package_name

Specify the package name.

Must be a string.

Usage Guidelines

Use this command to remove the specified software packages.

software-packages download

Downloads the software packages through HTTP/HTTPS protocols.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec

Syntax

download { user user_name password password url url accept-self-signed-certificate { false | true } retain-package { false | true } | url url } 

url url

Specify the URL.

user user_name

Specify the user name for HTTP/HTTPS authentication.

Must be a string.

password password

Specify the password for HTTP/HTTPS authentication.

Must be an aes-cfb-128-encrypted string.

accept-self-signed-certificate { false | true }

Accept or deny self-signed-certificates for HTTPS URLs.

Must be either "false" or "true".

Default Value: false.

Usage Guidelines

Use this command to download software packages.

software-packages list

Lists the available software packages.

Privilege Level

Security Administrator, Administrator

Command Mode

Exec

Syntax

list 

Usage Guidelines

Use this command to lists the available software packages.