HMC Manual Reference Pages  - CHSYSCONN (1)

NAME

chsysconn - change system connection

CONTENTS

Synopsis
Description
Options
Examples
Environment
Bugs
Author
See Also

SYNOPSIS

To configure the Virtualization Management Interface (VMI) network settings:
chsysconn -r vmi -m managed-system -o set -i {eth0 | eth1}
-t {ipv4dhcp | ipv6dhcp | slaac | static}
[-a IP-address] [--nm network-mask] [-g gateway]
[--force] [--help]

To clear the VMI network settings:
chsysconn -r vmi -m managed-system -o clear -i {eth0 | eth1}
[-a IP-address] [--force] [--help]

DESCRIPTION

chsysconn changes the network settings for the Virtualization Management Interface (VMI) for an Enterprise Baseboard Management Controller (BMC) based managed system.

OPTIONS

-r The type of resource to change. The only valid value is vmi for VMI network settings.
-m The name of the Enterprise BMC-based managed system for which to change the VMI network settings. The name may either be the user-defined name for the managed system, or be in the form tttt-mmm*sssssss, where tttt is the machine type, mmm is the model, and sssssss is the serial number of the managed system. The tttt-mmm*sssssss form must be used if there are multiple managed systems with the same user-defined name.
-o The operation to perform. Valid values are set to configure the VMI network settings, and clear to clear the VMI network settings.
-i The name of the VMI network interface to set or clear. Valid values are eth0 and eth1.
-t The type of network protocol to use. Valid values are ipv4dhcp for IPv4 Dynamic Host Configuration Protocol (DHCP), ipv6dhcp for IPv6 DHCP, slaac for IPv6 stateless address auto-configuration (SLAAC), and static for a static IP address.
-a The network IPv4 or IPv6 address. When setting an IPv6 address, it must be specified in the following format: IPv6-address/prefix-length.

This option is required when setting a static IP address. This option is not valid when using DHCP or SLAAC.

--nm The IPv4 network mask. This option is required when setting a static IPv4 address, otherwise this option is not valid.
-g The gateway IPv4 or IPv6 address. This option is required when setting a static IP address, otherwise this option is not valid.
--force Specify this option to change or clear the network settings for the VMI network interface currently being used for communication between the Hardware Management Console (HMC) and the managed system. This will cause the managed system to go into No Connection state and cause any HMC operations to the managed system currently in progress to fail.
--help Display the help text for this command and exit.

EXAMPLES

Configure the VMI eth0 interface to use IPv4 DHCP:

chsysconn -m ebmcSys -r vmi -o set -i eth0 -t ipv4dhcp

Configure the VMI eth1 interface to use IPv6 SLAAC:

chsysconn -m 9105-22A*1234567 -r vmi -o set -i eth1 -t slaac

Configure the VMI eth0 interface to use a static IPv4 address:

chsysconn -m ebmcSys -r vmi -o set -i eth0 -t static -a 9.140.2.155
-g 9.140.2.1 --nm 255.255.255.0

Configure the VMI eth0 interface to use a static IPv6 address:

chsysconn -m ebmcSys -r vmi -o set -i eth0 -t static
-a 2002:903:15f:325:9:3:1:123/64 -g 2002:903:15f:325::1

Clear the network settings for the VMI eth1 interface:

chsysconn -m ebmcSys -r vmi -o clear -i eth1

Clear the IPv6 address from the VMI eth0 interface:

chsysconn -m ebmcSys -r vmi -o clear -i eth0
-a 2002:903:15f:325:9:3:1:123

ENVIRONMENT

None

BUGS

None

AUTHOR

IBM Austin

SEE ALSO

lssysconn, mksysconn, rmsysconn


Linux CHSYSCONN (1) November 2023
Generated by manServer 1.07 from chsysconn.1 using man macros.