4.3.22.2 ALTER NETWORK

This command modifies a network record for a machine in the existing configuration.

Syntax

ALTER NETWORK 
   { HOSTNAME=hostname |
     IP=ip_addr |
     NETMASK=netmask |
     DOMAINNAME=domain_name |
     MASTER=master |
     GATEWAY=gateway | 
     SSHENABLED={ true | false } |
     MAC=mac_addr |
     MTU=mtu |
     LINKSPEED=nic_speed |
     SLAVE='slave' |
     PKEY=pkey |
     PKEYNAME=pkey_name |
     STATUS=status |
     LACP={ true | false } |
     VLANID=vlan_id |
     INTERFACENAME=interface_name |
     DESCRIPTION='network_description' |
     VSWITCHNETWORKPARAMS='vswitchnetwork_parameters' |
     NATHOSTNAME=nat_host_name | 
     NATIP=nat_ip_addr |
     NATDOMAINNAME=nat_domain_name |
     NATNETMASK=nat_mask } ... 
WHERE 
   { ID=network_id |  
     NETWORKHOSTNAME=network_hostname | 
     NATHOSTNAME=nat_hostname |
     HOSTNAME=hostname NETWORKTYPE=network_type [ PRIVATEID=private_id ] |
     CLUSTERNAME=cluster_name { COMPUTENUMBER=compute_number | STORAGENUMBER=storage_number } NETWORKTYPE=network_type [ PRIVATEID=private_id ] | 
     CLUSTERNUMBER=cluster_number { COMPUTENUMBER=compute_number | STORAGENUMBER=storage_number } NETWORKTYPE=network_type [ PRIVATEID=private_id ] }

Arguments

You can specify the following attributes when altering a network:

  • HOSTNAME: Specifies the short host name for the network

  • IP: Specifies the IP address of the network

  • NETMASK: Specifies the netmask of the network

  • DOMAINNAME: Specifies the domain name of the network

  • MASTER: Specifies the primary adapter name

  • GATEWAY: Specifies the network subnet gateway

  • SSHENABLED: TRUE indicates that SSH should be enabled for this adapter

  • MAC: Specifies the MAC address

  • MTU: Specifies the network MTU (maximum transmission unit). Not applicable for PRIVATE or ILOM networks.

  • LINKSPEED: Either 10000 or 25000. Only for X7-2 or later 2-socket compute nodes.

  • SLAVE: Specifies a space-separated list of secondary devices for a bonded network, enclosed in single quotes

  • PKEY: Specifies the pkey, for PRIVATE networks only

  • PKEYNAME: Specifies the pkey name, for PRIVATE networks only

  • STATUS: Specifies the status of the network

  • LACP: TRUE indicates that LACP should be enabled

  • VLANID: Specifies the VLAN identifier. Applicable if the network is a non-private VLAN network, or a VLAN network on a KVM guest.

  • INTERFACENAME: The name for the private network on the VLAN for a KVM guest and cell, clre[0-1] or stre[0-1].

  • DESCRIPTION: The text description for this network, surrounded by single quotes.

  • VSWITCHNETWORKPARAMS: Parameters required for vswitches, surrounded by single quotes.

  • NATHOSTNAME: Specifies the NAT host name

  • NATIP: Specifies the NAT IP address

  • NATDOMAINNAME: Specifies the NAT domain name

  • NATNETMASK: Specifies the NAT netmask

The following arguments are available in the WHERE clause:

  • ID: Specifies the ID for the target network in the XML configuration file.

  • NETWORKHOSTNAME: Specifies the host name for an network object, not the machine host name

  • NATHOSTNAME: Specifies the NAT host name for an existing compute node

  • HOSTNAME: Specifies the host name for an existing compute node

  • NETWORKTYPE: Specifies the type of network, which can be ADMIN, CLIENT, BACKUP, PRIVATE, OTHER, INGESTVIP, REPLICATIONVIP, or ILOM.

  • PRIVATEID: Specifies the ID of the private network

  • CLUSTERNUMBER: Specifies the cluster number in the XML configuration file, starting at 1

  • CLUSTERNAME: Specifies the name of an existing cluster

  • COMPUTENUMBER: Specifies the number of an existing compute node in the cluster, starting at 1

  • STORAGENUMBER: Specifies the number of an existing storage cell in the cluster, starting at 1