chserviceip

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

Syntax

 satask  chserviceip    [ -serviceipipv4 [ -gwipv4 -maskipv4 ]   ] [  -resetpassword  ]   [  panel_name  ]
 satask  chserviceip    [  -serviceip_6  ipv6  [  -gw_6  ipv6   -prefix_6 int ]   ] [  -resetpassword  ]   [  panel_name  ]
 satask  chserviceip    {  -default  |  -dhcp  |  -dhcp_6  }   [  -resetpassword  ]   [  -techport  { enable | disable } ] [  -force  ]   [  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
(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
(Optional) Sets the service assistant password to default.
-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.
-techportenable | disable
(Optional) Enables or disables the technician port for a node if emergency maintenance is required.
Important: If you specify enable you must also specify -force.
-force
(Optional) Helps enable the technician port for emergency maintenance. This parameter is required if you specify enable with -techport.

Description

This command sets the service assistant IP address for a specific node. If the node is part of clustered system (system) then the system gateway, subnet and prefix will be 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.

Consequently, 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 will 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.

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

An invocation example enabling the technician port on a node

satask chserviceip -techport enable -force

The resulting output:

No feedback