update commands

Update commands are used to update Digital Sandbox resources such as configurations and licenses.

The following update CLI commands are available:

dsctl

    — update

        — config

            — defaults

            — nokia-srlinux-license

        — deployment

        — topology

dsctl update config

Synopsis

dsctl update config defaults [-e <gluster_endpoint>] [-n <gluster_endpoint_namespace>] [-v <gluster_volume-name>] [-s <imagepullsecret_string>] [-k <K8_nodeselector_string>]

dsctl update config license

dsctl update config license-config

dsctl update config nokia-srlinux-license [-f <filename>] [-k <license_key_name>] [-v <version>]

Description

The dsctl update config command is used to update Digital Sandbox configuration details and has the following operations:

  • The defaults operation updates the Digital Sandbox default configuration.

  • The nokia-srlinux-license operation updates a license key for a specified Nokia SR Linux version.

Options

The following are dsctl update config default parameters:

Parameter:

-e <gluster_endpoint_string>

Used with operation:

update config default

Description:

Updates the default configuration with the specified gluster endpoint.

Parameter:

-n <gluster_endpoint_namespace>

Used with operation:

update config default

Description:

Updates the default configuration with the specified namespace of the gluster endpoint.

Parameter:

-v <gluster_volume-name>

Used with operation:

update config default

Description:

Updates the default configuration with the specified gluster volume-name.

Parameter:

-s <imagepullsecret_string>

Used with operation:

update config default

Description:

Updates the list of kubernetes image pull secrets, stored in the digital-sandbox-system namespace, that can be used during Digital Sandbox deployment creation. Default = regcred.

Parameter:

-k <K8_nodeselector_string>

Used with operation:

update config default

Description:

Updates the kubernetes node selector to use.

The following are dsctl update config nokia-srlinux-license parameters:

Parameter:

-f <filename>

Used with operation:

update config nokia-srlinux-license

Description:

Defines the name of the SR Linux license file.

Parameter:

-k <license_key_name>

Used with operation:

update config nokia-srlinux-license

Description:

Defines the license key that corresponds to the Nokia SR Linux version.

Parameter:

-v <version>

Used with operation:

update config nokia-srlinux-license

Description:

Defines the version of the Nokia SR Linux key.

Examples

To update the Digital Sandbox default configuration with a kubernetes endpoint value of ‟glusterEP2”:

dsctl update config defaults -e glusterEP2

To update the license key for a specified Nokia SR Linux version:

dsctl update config nokia-srlinux-license -k 00000000-0000-0000-0000-000000000000 -v srl_rel_21_6

dsctl update deployment

Synopsis

dsctl update deployment -f <filename_string> -i <ID_string> [-t <tar_filename_string>]

Description

The dsctl update deployment command is used to update an existing Digital Sandbox deployment.

Options

The following are dsctl update deployment parameters:

Parameter:

-f <filename_string>

Used with operation:

update deployment

Description:

Specifies the pathname of the file containing the node data. Mandatory field.

Parameter:

-i <ID_string>

Used with operation:

update deployment

Description:

Specifies the deployment ID. Mandatory field.

Parameter:

-t <tar_filename_string>

Used with operation:

update deployment

Description:

Specifies the pathname of the tar file that contains the configuration and state details required to build a deployment.

Examples

To update a deployment with a deployment ID named ‟star”, that has a filename of ‟/tmp2/7live.yaml”, and with a new configuration tar file named ‟/tmp2/7live2.tar”:

dsctl update deployment -i star -f /tmp2/7live.yaml -t /tmp2/7live2.tar

dsctl update topology

Synopsis

dsctl update topology -f <filename_string> -i <ID_string> [-t <tar_filename_string>]

Description

The dsctl update topology command is used to update an existing Digital Sandbox topology.

Options

The following are dsctl update topology parameters:

Parameter:

-f <filename_string>

Used with operation:

update topology

Description:

Specifies the pathname of the file containing the topology data. Mandatory field.

Parameter:

-i <ID_string>

Used with operation:

update topology

Description:

Specifies the deployment ID. Mandatory field.

Parameter:

-t <tar_filename_string>

Used with operation:

update topology

Description:

Specifies the pathname of the tar file that contains the configuration and state details required to build a topology.

Examples

To update a topology associated with a deployment ID named ‟star”, that has a filename of ‟/tmp2/7live3.yaml”, and with a new configuration tar file named ‟/tmp2/toplog2”:

dsctl update topology -i star -f /tmp2/7live3.yaml -t /tmp2/toplog2.tar