The chclusterip command modifies the IP configuration parameters for the cluster.
Syntax
>>- svctask -- -- chclusterip -- -------------------------------> >--+--------------------------+-- ------------------------------> '- -clusterip -- ipv4addr -' >--+--------------------------+-- --+-------------------+-- ----> '- -serviceip -- ipv4addr -' '- -gw -- ipv4addr -' >--+------------------------+-- --+---------+-------------------> '- -mask -- subnet_mask -' '- -noip -' >--+----------------------------+-------------------------------> '- -clusterip_6 -- ipv6addr -' >--+----------------------------+-- --+---------------------+---> '- -serviceip_6 -- ipv6addr -' '- -gw_6 -- ipv6addr -' >-- --+-----------------------+-- --+-----------+-- ------------> '- -prefix_6 -- prefix -' '- -noip_6 -' >--+-------------------------+-- ------------------------------>< '- -port -- cluster_port -'
Parameters
- -clusterip ipv4addr
- (Optional) Changes the IPv4 cluster IP address. When you specify a new IP address for a cluster, the existing communication with the cluster is broken.
- -serviceip ipv4addr
- (Optional) Changes the IPv4 service IP address. This is the address that is used to manage any node that has to be started in service mode. A node that is operating in service mode does not operate as a member of the cluster.
- -gw ipv4addr
- (Optional) Changes the IPv4 default gateway IP address of the cluster.
- -mask subnet_mask
- (Optional) Changes the IPv4 subnet mask of the cluster.
- -noip
- (Optional) Unconfigures the IPv4 stack on the specified port, or both ports if none is specified.
- -clusterip_6 ipv6addr
- (Optional) Sets the IPv6 cluster address for the port.
- -serviceip_6 ipv6addr
- (Optional) Sets the IPv6 service address for the port.
- -gw_6 ipv6addr
- (Optional) Sets the IPv6 default gateway address for the port.
- -prefix_6 prefix
- (Optional) Sets the IPv6 prefix.
- -noip_6
- (Optional) Unconfigures the IPv6 stack on the specified port, or both ports if none is specified.
- -port cluster_port
- (Optional) Specifies which port (1 or 2) to apply changes to. This parameter is required unless the noip or noip_6 parameter is used.
Description
This command modifies IP configuration parameters for the cluster. The first time you configure a second port, all IP information is required. Port 1 on the cluster must always have one stack fully configured.
There are two active cluster ports on the configuration node. There are also two active service ports on any node that is in service mode.
If the cluster IP address is changed, the open command-line shell closes during the processing of the command. You must reconnect to the new IP address if connected through that port.
The noip and noip_6 parameters can be specified together only if the port is also specified. The noip and noip_6 parameters cannot be specified with any parameters other than port. Port 1 must have an IPv4 or IPv6 cluster address. The configuration of port 2 is optional.
Service IP addresses for all ports and stacks are initialized to DHCP. A service IP address is always configured.
Modifying an IP address: List the IP address of the cluster by issuing the svcinfo lscluster command. Modify the IP address by issuing the svctask chclusterip command. You can either specify a static IP address or have the system assign a dynamic IP address.
| IP type | ip_address_list format |
|---|---|
| IPv4 (no port set, SVC uses default) | 1.2.3.4 |
| IPv4 with specific port | 1.2.3.4:22 |
| Full IPv6, default port | 1234:1234:abcd:0123:0000:0000:7689:6576 |
| Full IPv6, default port, leading zeros suppressed | 1234:1234:abcd:123:0:0:7689:6576 |
| Full IPv6 with port | [1234:1234:abcd:0123:0000:0000:7689:6576]:23 |
| Zero-compressed IPv6, default port | 1234:1234:abcd:123::7689:6576 |
| Zero-compressed IPv6 with port | [1234:1234:abcd:123::7689:6576]:23 |
An invocation example
svctask chclusterip -clusterip 9.20.136.5 -gw 9.20.136.1 -mask 255.255.255.0 -port 1
The resulting output
No feedback