satask chserviceip

Use the satask chserviceip command to set the service address for a specific node.

Syntax

Read syntax diagramSkip visual syntax diagram satask chserviceip -serviceipipv4-gwipv4-maskipv4-resetpasswordcleartext_passwordpanel_name

Read syntax diagramSkip visual syntax diagram satask chserviceip -serviceip_6ipv6-gw_6ipv6-prefix_6int-resetpasswordcleartext_passwordpanel_name

Read syntax diagramSkip visual syntax diagram satask chserviceip dhcp-dhcp_6-resetpasswordcleartext_passwordpanel_name

Parameters

Description

This command sets the service assistant IP address for a specific node. If the node is part of a system, then the system gateway, subnet, and prefix are used unless specified otherwise. If the node is a candidate node, the subnet, prefix, and gateway must be specified. If you specify an IPV4 or IPV6 address, but do not provide a gateway, mask, or prefix, then the existing gateway, mask, and prefix values are preserved.

Therefore, you can configure both an IPv4 and an IPv6 address concurrently. Setting the IPv4 address does not change the IPv6 setting, and setting the IPv6 address does not change the IPv4 setting. It is possible to clear any values set by setting the IPv4 address to 0.0.0.0 or leaving the IPv6 value empty.

If the -resetpassword parameter is provided, the superuser password for the system is reset to the value provided. The superuser password cannot be reset back to the default password. If the node or canister is active in a system, the superuser password for the system is reset; otherwise, the superuser password is reset on the individual node canister. If the node canister later becomes active in a system, the superuser password is reset to that of the system. You can configure the system to disable resetting the superuser password, see Managing the password reset feature using the CLI. If you disable that function, this action fails.

Use the chserviceip command to:
  • Clear the IPv4 service IP address:
    satask chserviceip -serviceip 0.0.0.0 -gw 0.0.0.0 -mask 0.0.0.0
    
  • Clear the IPv6 service IP address:
    satask chserviceip -serviceip_6 0::0 -gw_6 0::0 -prefix_6 64
    Remember:
    • If -gw is specified, -mask must also be specified.
    • If -gw_6 is specified, -prefix_6 must also be specified.

An invocation example using specific -serviceip, -gw, and -mask parameters

satask chserviceip -serviceip 1.2.3.4 -gw 1.2.3.1 -mask 255.255.255.0

The resulting output:

No feedback