satask chserviceip

Edit online

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

Syntax


1  satask chserviceip?  -serviceip ipv4?  -gw ipv4 -mask ipv4?  -resetpassword cleartext_password?  panel_name


1  satask chserviceip?  -serviceip_6 ipv6?  -gw_6 ipv6 -prefix_6 int?  -resetpassword cleartext_password?  panel_name


1  satask chserviceip  -default
1 dhcp
1 -dhcp_6
2?  -resetpassword cleartext_password
2?  panel_name

Parameters

-satask
(Required) Specifies a system administrator task, such as issuing service commands that are only used in specific circumstances.
-default
(Optional) Resets the Internet Protocol Version 4 (IPv4) service address to the default address.
panel_name
(Optional) Specifies the node being serviced.
-serviceip
(Required) Specifies the IPv4 address for the service assistant.
Note: The IPv4 service address can be unconfigured by setting the address to 0.0.0.0.
-gw
(Optional) Specifies the IPv4 gateway for the service assistant. If -gw is specified, -mask must be specified.
-mask
(Optional) Specifies the IPv4 subnet for the service assistant. If -mask is specified, -gw must be specified.
-serviceip_6 yes | no
(Required) Specifies the Internet Protocol Version 6 (IPv6) address for the service assistant.
Note: The IPv6 service address can be unconfigured by setting the address to 0:0:0:0:0:0:0:0.
-gw_6
(Optional) Specifies the IPv6 gateway for the service assistant. If -gw_6 is specified, -prefix_6 must be specified.
-prefix_6
(Optional) Specifies the IPv6 prefix for the service assistant. If -prefix_6 is specified, -gw_6 must be specified.
-default
(Optional) Resets to the default IPv4 address.
-resetpassword cleartext_password
(Optional) Sets the service assistant password to cleartext_password. The password must be in the range of 6 - 64 characters.
-dhcp
(Optional) Attempts to obtain an IPv4 address from Dynamic Host Configuration Protocol (DHCP).
-dhcp_6
(Optional) Attempts to obtain an IPv6 address from DHCP.

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 setpwdreset. 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