---

HMC Manual Reference Pages  - MKSYSCONN (1)

---

mksysconn - create system connection

CONTENTS

Synopsis
Description
Options
Examples
Environment
Bugs
Author
See Also

To establish a connection and add a system or frame to the Hardware Management Console (HMC):
mksysconn --ip IP-address [-r {sys | frame}]
[-u user-ID] [--passwd password] [--force]
[--help]

To enable all systems and frames to be automatically discovered by the HMC when using DHCP:
mksysconn -o auto [--help]

mksysconn establishes a connection from the Hardware Management Console (HMC) to a system in the network and adds the system to the systems managed by the HMC. If a connection to the system cannot be established because the network is down, the service processor for the system is down, or too many other HMCs have already established a connection to the system, the system will be added as a managed system which is in the No Connection state.

mksysconn can also establish a connection from the HMC to a frame in the network and add the frame to the frames managed by the HMC. If a connection to the frame cannot be established because the network is down, the bulk power assembly (BPA) for the frame is down, or too many other HMCs have already established a connection to the frame, the frame will be added as a managed frame which is in the No Connection state.

If your HMC is set up as a DHCP server on a private network, mksysconn -o auto can enable all systems and frames to be automatically discovered by the HMC in the event that the Remove Connection task or the rmsysconn command was previously run to remove a system or frame from the HMC.

If your HMC is set up as a DHCP server on a private network, do not use this command to establish HMC connections to managed systems and frames that are DHCP clients. This command is intended for use on a public network only, where the systems are set to use static IP addresses. Using this command in a DHCP environment establishes a temporary connection that will not continue to work properly over network configuration changes, system power loss, and service repair actions.

--ip	To connect to a system and add the system to the systems managed by the HMC, specify the IP address or host name of the service processor for the system. To connect to a frame and add the frame to the frames managed by the HMC, specify the IP address or host name of one side of the bulk power assembly (BPA) for the frame. Note that to properly connect to a frame, it is recommended that you run this command twice, once for each side of the BPA, in order to connect to both sides of the BPA for the frame.
-r	The type of resource to which to connect and add to the HMC. Valid values are sys for system and frame for frame. If this option is omitted, the HMC determines the resource type by determining if the specified IP address belongs to a system or a frame. If the HMC is unable to determine if the specified IP address belongs to a system or a frame, this command will fail unless the --force option is specified.
-u	The user ID for the Baseboard Management Controller (BMC) system to which to connect. If you created a user ID for your BMC system, use this option to specify that user ID. Otherwise omit this option and the default user ID will be used. This option is only valid for BMC systems.
--passwd	The HMC Access password for the system or the frame to which to connect. If this option is omitted, you will be prompted to enter the password.
--force	If the HMC is unable to determine if the specified IP address belongs to a system or a frame, use this option to force the HMC to attempt to establish a connection. The HMC will use the value specified with the -r option to determine the type of connection to establish. If the -r option is not specified, the HMC will attempt to establish a connection to a system.
-o	If your HMC is set up as a DHCP server on a private network, specify auto with this option to enable the HMC to automatically discover all systems and frames. You may need to do this if the Remove Connection task or the rmsysconn command was previously run to remove a system or frame from the HMC, and you want the HMC to be able to manage a system or frame with the same IP address again. Whenever a managed system or a managed frame is removed from the HMC when using DHCP, the HMC places the IP address(es) of that system or frame in a list of removed IP addresses. Any IP address in that list will not be automatically rediscovered by the HMC. The mksysconn -o auto command removes all IP addresses from that list. To remove a specific IP address from that list, you can run the rmsysconn -o rediscover command instead. auto is the only value that can be specified with this option. When this option is specified, all other options are ignored.
--help	Display the help text for this command and exit.

Connect to and add the system with the host name sys1.company.com:

mksysconn --ip sys1.company.com --passwd sys1pw

Connect to and add the system with the IP address 9.3.152.145 (the HMC Access password for the system must be entered when prompted):

mksysconn --ip 9.3.152.145

Connect to and add the frame with the host names frame1_A.company.com and frame1_B.company.com:

mksysconn --ip frame1_A.company.com -r frame --passwd
frame1pw
mksysconn --ip frame1_B.company.com -r frame --passwd
frame1pw

To enable all systems and frames to be automatically discovered by the HMC when using DHCP:

mksysconn -o auto

None

None

IBM Austin

lssysconn, rmsysconn, lssyscfg