chserviceip
Use the chserviceip command to set the service address for a specific node.
Syntax
Parameters
- panel_name
- (Optional) Identifies the node being serviced. Note: If
panel_nameis not supplied, this applies to the node on which the command is running. - -serviceip
- (Optional) 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) The IPv4 gateway for the service assistant. If -gw is specified, -mask must be specified.
- -mask
- (Optional) The IPv4 subnet for the service assistant. If -mask is specified, -gw must be specified.
- -serviceip_6
- (Optional) 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) The IPv6 gateway for the service assistant. If -gw_6 is specified, -prefix_6 must be specified.
- -prefix_6
- (Optional) 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.
- -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.
- -default
- (Optional) Resets the IPv4 service address to the default address.
- -resetpassword cleartext_password
- (Optional) Sets the service assistant password to cleartext_password. The password must be in the range of 6 - 64 characters.
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.
- 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 64Remember:- 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