Break out intro content for each CLI Ref for reusability. Convert VIM to an abbrev. Signed-off-by: Ron Stone <ronald.stone@windriver.com> Change-Id: I7f4ee6f9bd6120ad84b77dfcfeb900bfba362835
23 KiB
system
system usage
system [--version] [--debug] [-v] [-k] [--cert-file CERT_FILE]
[--key-file KEY_FILE] [--ca-file CA_FILE] [--timeout TIMEOUT]
[--os-username OS_USERNAME] [--os-password OS_PASSWORD]
[--os-tenant-id OS_TENANT_ID] [--os-tenant-name OS_TENANT_NAME]
[--os-auth-url OS_AUTH_URL] [--os-region-name OS_REGION_NAME]
[--os-auth-token OS_AUTH_TOKEN] [--system-url SYSTEM_URL]
[--system-api-version SYSTEM_API_VERSION]
[--os-service-type OS_SERVICE_TYPE]
[--os-endpoint-type OS_ENDPOINT_TYPE]
[--os-user-domain-id OS_USER_DOMAIN_ID]
[--os-user-domain-name OS_USER_DOMAIN_NAME]
[--os-project-id OS_PROJECT_ID]
[--os-project-name OS_PROJECT_NAME]
[--os-project-domain-id OS_PROJECT_DOMAIN_ID]
[--os-project-domain-name OS_PROJECT_DOMAIN_NAME]
<subcommand> ...
For a list of all system
subcommands and options, enter:
system help
Subcommands
For a full description of usage and optional arguments for a specific
system
command,
enter:
system help COMMAND
Certificate management
Certificate management commands allow you to install custom certificates for a variety of use cases. For example:
- REST APIs and Horizon web server.
- local Docker registry.
- OpenStack REST APIs and OpenStack Horizon web server.
- trusted certificate authority(s).
certificate-install
-
Install certificate.
certificate-list
-
List certificates.
certificate-show
-
Show certificate details.
certificate-uninstall
-
Uninstall certificate; only applicable to trusted certificate authority(s).
Local Docker registry management
Local Docker registry management commands enable you to remove images and free disk resources consumed by the local Docker registry. This is required if the local Docker registry's file system (docker-distribution) becomes full.
registry-garbage-collect
-
Run the registry garbage collector.
This frees up the space on the file system used by deleted images. In rare cases, the system may trigger a swact in the small time window when garbage-collect is running. This may cause the registry to get stuck in read-only mode. If this occurs, run garbage-collect again to take the registry out of read-only mode.
Note
The
registry-garbage-collect
command executes background tasks that may affect access to the docker registry. It is recommended to wait a few minutes before executing other registry related commands. registry-image-delete
-
Remove the specified Docker image from the local registry.
The image should be specified in the form
name:tag
. This command only removes the image from the local Docker registry. It does not free space on the file system.Note
Any stx-openstack images in a system with stx-openstack applied should not be deleted. If space is needed, you can delete the older tags of stx-openstack images, but do not delete the most recent one. Deleting both the registry stx-openstack images and the one from the Docker cache will prevent failed pods from recovering. If this happens, manually download the deleted images from the same source as application-apply and push it to the local registry under the same name and tag.
registry-image-list
-
List all images in local docker registry.
registry-image-tags
-
List all tags for a Docker image from the local registry.
Host/controller file system configuration
Host/controller file system configuration commands manage file systems on hosts. These commands primarily support the ability to resize the file systems.
Use host-fs-*
commands to manage un-synchronized file systems on controller and worker
nodes.
Use controllerfs-*
commands to manage -synchronized
file systems on controller nodes.
host-fs-add
-
Add an optional host file system; e.g. image-conversion file system.
host-fs-delete
-
Delete an optional host file system; e.g. image-conversion file system.
host-fs-list
-
Show list of host file systems.
host-fs-modify
-
Modify the size of a file system.
host-fs-show
-
Show details of a host file system.
controllerfs-list
-
Show list of controller file systems.
controllerfs-modify
-
Modify controller file system sizes.
controllerfs-show
-
Show details of a controller file system.
drbdsync-modify
-
Modify sync rate parameters.
drbdsync-show
-
Show sync config details.
System configuration
The following set of commands enable configuration of:
- Basic system attributes
- OAM IP address(es), subnet, and gateway
- Remote DNS servers for hosts
- Time synchronization protocols, for example: and/or
modify
-
Modify system attributes.
show
-
Show system attributes.
dns-modify
-
Modify DNS attributes.
dns-show
-
Show DNS (Domain Name Server) attributes.
ntp-modify
-
Modify NTP attributes.
ntp-show
-
Show NTP (Network Time Protocol) attributes.
ptp-apply
-
Apply modified PTP attributes to hosts.
ptp-modify
-
Modify PTP attributes.
ptp-show
-
Show PTP (Precision Time Protocol) attributes.
oam-modify
-
Modify external OAM attributes.
oam-show
-
Show external OAM attributes.
System configuration service-parameter
Service parameters provide a generic mechanism to configure a variety of configurable parameters in , including:
- HTTP and HTTPS ports
- Horizon authentication lockout parameters
- Keystone token expiration
- host management parameters such as heartbeat intervals and host boot timeouts
service-parameter-add
-
Add service parameter.
service-parameter-apply
-
Apply the service parameters.
service-parameter-delete
-
Delete a service parameter.
service-parameter-list
-
List service parameters.
service-parameter-modify
-
Modify service parameter attributes.
service-parameter-show
-
Show service parameter.
Host IPMI configuration and management
The host-sensor*
commands provide the ability to:
- Display the sensors collected from hosts over .
- Define thresholds.
- Configure behavior when thresholds are crossed (for example ignore, log, or reset).
host-sensor-list
-
List sensors.
host-sensor-modify
-
Modify a sensor.
host-sensor-show
-
Show host sensor details.
host-sensorgroup-list
-
List sensor groups.
host-sensorgroup-modify
-
Modify sensor group of a host.
host-sensorgroup-relearn
-
Relearn sensor model.
host-sensorgroup-show
-
Show host sensor group attributes.
Application management
provides an application package management based on FluxCD and Kubernetes Helm. The application management provides:
- System Helm overrides to automatically apply applications according to the particular configuration currently running.
- Management for user specified Helm overrides.
helm-chart-attribute-modify
-
Modify Helm chart attributes.
helm-override-delete
-
Delete overrides for a chart.
helm-override-list
-
List system Helm charts.
helm-override-show
-
Show overrides for chart.
helm-override-update
-
Update Helm chart user overrides.
application-abort
-
Abort the current application operation.
application-apply
-
Apply/reapply the application manifest.
application-delete
-
Remove the uninstalled application from the system.
application-list
-
List all containerized applications.
application-remove
-
Uninstall the application.
application-show
-
Show application details.
application-update
-
Update the deployed application to a different version.
application-upload
-
Upload application Helm chart(s) and manifest.
SNMP configuration
supports SNMPv2c and SNMPv3, but it is now configured using Helm charts.
For more information, see : SNMP overview <snmp-overview>
.
Host configuration
Host commands manage the general configuration of a host. This includes assignment of CPU cores to platform or hosted applications, the configuration of amount and size for memory huge pages, and the configuration of Kubernetes node labels.
host-list
-
List hosts.
host-show
-
Show host attributes.
host-add
-
Add a new host.
host-bulk-add
-
Add multiple new hosts.
host-bulk-export
-
Export host bulk configurations.
host-cpu-list
-
List CPU cores.
host-cpu-modify
-
Modify CPU core assignments.
host-cpu-show
-
Show CPU core attributes.
host-memory-list
-
List memory nodes.
host-memory-modify
-
Modify platform reserved and/or application huge page memory attributes for worker nodes.
host-memory-show
-
Show memory attributes.
host-label-assign
-
Update the Kubernetes labels on a host.
host-label-list
-
List Kubernetes labels assigned to a host.
host-label-remove
-
Remove Kubernetes label(s) from a host
host-delete
-
Delete a host.
Host operational commands
The following set of commands provides operational host commands, including taking a host in and out of service (lock/unlock), resetting a host, rebooting a host, and powering a host on and off.
host-lock
-
Lock a host.
host-unlock
-
Unlock a host.
host-swact
-
Switch activity away from this active host.
host-power-off
-
Power off a host.
host-power-on
-
Power on a host.
host-reboot
-
Reboot a host.
host-reset
-
Reset a host.
host-reinstall
-
Reinstall a host.
Host interface configuration
The following set of commands manages the display and configuration of host interfaces.
host-ethernet-port-list
-
List host Ethernet ports.
host-ethernet-port-show
-
Show host Ethernet port attributes.
host-port-list
-
List host ports. Displays the L1 host ports and their attributes.
host-port-show
-
Show host port details. Displays the L1 host ports and their attributes.
host-if-add
-
Add an interface. Adds L2 host interfaces (Ethernet, VLAN, and LAG type L2 host interfaces).
host-if-delete
-
Delete an interface. Deletes L2 host interfaces (Ethernet, VLAN, and LAG type L2 host interfaces).
host-if-list
-
List interfaces. Displays L2 host interfaces (Ethernet, VLAN, and LAG type L2 host interfaces).
host-if-modify
-
Modify interface attributes. Modifies L2 host interfaces (Ethernet, VLAN, and LAG type L2 host interfaces).
host-if-show
-
Show interface attributes. Displays L2 host interfaces (Ethernet, VLAN, and LAG type L2 host interfaces).
Host platform L2 network, IP addressing, and routing
The following set of commands defines types of L2 platform networks, assignment of L2 platform networks to interfaces, and configuration of L3 IP interfaces and routing.
network-add
-
Add a network.
network-delete
-
Delete a network.
network-list
-
List IP networks on host.
network-show
-
Show IP network details.
host-addr-add
-
Add an IP address.
host-addr-delete
-
Delete an IP address.
host-addr-list
-
List IP addresses on host.
host-addr-show
-
Show IP address attributes.
addrpool-add
-
Add an IP address pool.
addrpool-delete
-
Delete an IP address pool.
addrpool-list
-
List IP address pools.
addrpool-modify
-
Modify interface attributes.
addrpool-show
-
Show IP address pool attributes.
host-route-add
-
Add an IP route.
host-route-delete
-
Delete an IP route.
host-route-list
-
List IP routes on host.
host-route-show
-
Show IP route attributes.
interface-network-assign
-
Assign a network to an interface.
interface-network-list
-
List network interfaces.
interface-network-remove
-
Remove an assigned network from an interface.
interface-network-show
-
Show interface network details.
Host data networks
The following set of commands defines types of L2 data networks and assignment of L2 data networks to interfaces. Data networks represent the underlying L2 networks for Kubernetes SRIOV/PCIPASSTHROUGH network attachments or OpenStack tenant networks.
datanetwork-add
-
Add a data network.
datanetwork-delete
-
Delete a data network.
datanetwork-list
-
List data networks.
datanetwork-modify
-
Modify a data network.
datanetwork-show
-
Show data network details.
interface-datanetwork-assign
-
Assign a data network to an interface.
interface-datanetwork-list
-
List data network interfaces.
interface-datanetwork-remove
-
Remove an assigned data network from an interface.
interface-datanetwork-show
-
Show interface data network details.
Host disk configuration
The following set of commands enables the display and configuration of host disks, volume groups, and disk partitions.
host-disk-list
-
List disks.
host-disk-show
-
Show disk attributes.
host-disk-wipe
-
Wipe disk and GPT format it.
host-lvg-add
-
Add a local volume group.
host-lvg-delete
-
Delete a local volume group.
host-lvg-list
-
List local volume groups.
host-lvg-modify
-
Modify the attributes of a local volume group.
host-lvg-show
-
Show local volume group attributes.
host-pv-add
-
Add a physical volume.
host-pv-delete
-
Delete a physical volume.
host-pv-list
-
List physical volumes.
host-pv-show
-
Show physical volume attributes.
host-disk-partition-add
-
Add a disk partition to a disk of a specified host.
host-disk-partition-delete
-
Delete a disk partition.
host-disk-partition-list
-
List disk partitions.
host-disk-partition-modify
-
Modify the attributes of a disk partition.
host-disk-partition-show
-
Show disk partition attributes.
Ceph configuration
The following set of commands is used to configure and manage Ceph OSDs, Ceph tiers, and Ceph storage cluster backends.
ceph-mon-add
-
Add a ceph monitor to a specific host.
ceph-mon-delete
-
Delete a ceph monitor from a specific host.
ceph-mon-list
-
List Ceph mons.
ceph-mon-modify
-
Modify parameters of a ceph monitor on a specific host.
ceph-mon-show
-
Show ceph_mon of a specific host.
cluster-list
-
List ceph clusters.
cluster-show
-
Show ceph cluster attributes.
host-stor-add
-
Add a ceph storage disk (i.e. journal or ) to a host.
host-stor-delete
-
Delete a ceph storage disk (i.e. journal or ) from a host.
host-stor-list
-
List ceph storage disks (i.e. journal or ) of a host.
host-stor-show
-
Show attributes of a ceph storage disk (i.e. journal or ) on a host.
host-stor-update
-
Modify ceph journal or attributes.
storage-backend-add
-
Add a storage backend.
storage-backend-delete
-
Delete a storage backend.
storage-backend-list
-
List storage backends.
storage-backend-modify
-
Modify a storage backend.
storage-backend-show
-
Show a storage backend.
storage-tier-add
-
Add a storage tier to a disk of a specified cluster.
storage-tier-delete
-
Delete a storage tier.
storage-tier-list
-
List storage tiers.
storage-tier-modify
-
Modify the attributes of a storage tier.
storage-tier-show
-
Show storage tier attributes.
Host PCI device management
The following set of commands provides host PCI device management (not including NICs).
host-device-list
-
List devices.
host-device-modify
-
Modify device availability for worker nodes.
host-device-show
-
Show device attributes.
Host LLDP operational commands
The following set of commands displays neighbor information learned from the Link Layer Discovery Protocol (LLDP), which runs on all host interfaces.
host-lldp-agent-list
-
List host LLDP agents.
lldp-agent-show
-
Show LLDP agent attributes.
host-lldp-neighbor-list
-
List host LLDP neighbors.
lldp-neighbor-show
-
Show LLDP neighbor attributes.
Controller services management
The following set of commands enables display of services running on the controllers. Optional services can be enabled or disabled using these commands.
servicenode-list
-
List service nodes.
servicenode-show
-
Show a service node's attributes.
servicegroup-list
-
List service groups.
servicegroup-show
-
Show a service group.
service-disable
-
Disable optional service
service-enable
-
Enable optional service
service-list
-
List services.
service-show
-
Show a service.
Unsupported commands
Important
The following commands are no longer supported.
remotelogging-modify
-
Modify remote logging attributes.
remotelogging-show
-
Show remote logging attributes.
sdn-controller-add
-
Add an SDN controller.
sdn-controller-delete
-
Delete an SDN controller.
sdn-controller-list
-
List all SDN controllers.
sdn-controller-modify
-
Modify SDN controller attributes.
sdn-controller-show
-
Show SDN controller details and attributes.
Licensing commands
Important
The following commands are not supported upstream.
license-install
-
Install license file.
license-show
-
Show license file content.
Software upgrade commands
Important
The following commands are not yet supported.
host-downgrade
-
Perform software downgrade for the specified host.
host-patch-reboot
-
Command has been deprecated.
host-update
-
Update host attributes.
host-upgrade
-
Perform software upgrade for a host.
host-upgrade-list
-
List software upgrade info for hosts.
load-delete
-
Delete a load.
load-import
-
Import a load.
load-list
-
List all loads.
load-show
-
Show load attributes.
upgrade-abort
-
Abort a software upgrade.
upgrade-abort-complete
-
Complete a software upgrade.
upgrade-activate
-
Activate a software upgrade.
upgrade-complete
-
Complete a software upgrade.
upgrade-show
-
Show software upgrade details and attributes.
upgrade-start
-
Start a software upgrade.
health-query
-
Run the health check.
health-query-upgrade
-
Run the health check for an upgrade.
Host FPGA Configuration - Intel N3000
The following set of commands allow you to update the Intel N3000 user image on StarlingX hosts.
For more information, see N3000 FPGA Overview </node_management/kubernetes/hardware_acceleration_devices/n3000-overview>
.
host-device-image-update
-
Update device image on a host.
host-device-image-update-abort
-
Abort device image update on a host.
device-image-apply
-
Apply the device image.
device-image-delete
-
Delete a device image.
device-image-list
-
List device images.
device-image-remove
-
Remove the device image.
device-image-show
-
Show device image details.
device-image-upload
-
Upload a device image.
device-image-state-list
-
List image to device mapping with status.
device-label-list
-
List all device labels.
host-device-label-assign
-
Assign a label to a device of a host.
host-device-label-list
-
List device labels.
host-device-label-remove
-
Remove a device label from a device of a host.
Kubernetes version upgrade
The following set of commands allow you to upgrade the version of
Kubernetes. For more information, see Manual Kubernetes Version Upgrade <manual-kubernetes-components-upgrade>
.
kube-host-upgrade
-
Perform Kubernetes upgrade for a host.
kube-host-upgrade-list
-
List Kubernetes upgrade info for hosts.
health-query-kube-upgrade
-
Run the health check for a Kubernetes upgrade.
host-label-list
-
List Kubernetes labels assigned to a host.
kube-cluster-list
-
List all Kubernetes clusters.
kube-cluster-show
-
Show Kubernetes cluster details.
kube-version-list
-
List all Kubernetes versions.
kube-version-show
-
Show Kubernetes version details.
kube-upgrade-complete
-
Complete a Kubernetes upgrade.
kube-upgrade-delete
-
Delete a Kubernetes upgrade.
kube-upgrade-download-images
-
Download Kubernetes images.
kube-upgrade-networking
-
Upgrade Kubernetes networking.
kube-upgrade-show
-
Show Kubernetes upgrade details and attributes.