This section contains information on how to configure the following SAs with CLI.
Blade
IPMI
ICMP
VMCHKHOST
libvirt
Blade
To configure the Blade shutdown agent, you can create or modify the following file:
/etc/opt/SMAW/SMAWsf/SA_blade.cfg
A sample configuration file can be found at the following location:
/etc/opt/SMAW/SMAWsf/SA_blade.cfg.template
The format of the SA_blade.cfg file is as follows:
community-string SNMP community string management-blade-ip IP address cfname slot-no Action
Additionally, you can add the IP address of the management Blade for a second Blade chassis. In this case, you would need to add one or more lines to specify the Blades in that chassis.
Note
management-blade-ip, community-string, cycle, and leave-off are reserved words. They must be described in lowercase letters.
The editable fields are defined as follows:
SNMP community string
The SNMP community string with read/write permissions for the server Blades. This string is the same value as the SNMP community string in the Management Blade SNMP configuration. By default, this string is usually set to public.
IP-address
The IP name or address in dot notation of the Management Blade. Available IP addresses are IPv4 and IPv6 address. The link local address of IPv6 is not available.
cfname
The name of the node in the CF cluster.
slot-no
The slot number of the Blade server.
Action
The action can either be cycle or leave-off. If it is cycle, the node will be powered on again after powering off. If it is leave-off, manual action is required to turn the system back on.
The following is an example of the SA_blade configuration file:
community-string public management-blade-ip 123.45.56.78 shasta1 1 cycle shasta2 3 leave-off management-blade-ip 123.45.56.79 shasta3 1 cycle shasta4 2 cycle
The log file is stored in the following:
/var/opt/SMAWsf/log/SA_blade.log
IPMI
To configure the IPMI SA, you need to create or modify the following file:
/etc/opt/SMAW/SMAWsf/SA_ipmi.cfg
A sample configuration file can be found at the following location:
/etc/opt/SMAW/SMAWsf/SA_ipmi.cfg.template
The SA_ipmi.cfg configuration file contains lines with four fields (and some subfields) on each line. Each line defines a node in the cluster than can be powered off (leaving it off) or powered off and then on again (power cycle). The fields are as follows:
cfname
The name of the node in the CF cluster.
Note
cfname must correspond to the IP address of the IPMI compliant onboard LAN interface in these nodes.
Access-Information
The access information is of the following format:
ip-address-of-unit:user:password
For ip-address-of-unit, specify the IP address of IPMI (BMC and iRMC). Available IP addresses are IPv4 and IPv6 address. The link local address of IPv6 is not available. When specifying the IPv6 address, enclose it in brackets "[ ]".
(Example: [1080:2090:30a0:40b0:50c0:60d0:70e0:80f0])
Action
The action can either be cycle or leave-off. If it is cycle, the node will be powered on again after powering off. If it is leave-off, manual action is required to turn the system back on.
Note
The permissions of the SA_ipmi.cfg file are read/write by root only. This is to protect the password to the BMC/iRMC unit.
The following is an example of the SA_ipmi configuration file:
fuji2 192.168.200.1::root:ipmipwd cycle fuji3 192.168.200.2::root:ipmipwd cycle fuji4 192.168.200.3::root:ipmipwd leave-off fuji5 192.168.200.4::root:ipmipwd leave-off
The log file is stored in the following:
/var/opt/SMAWsf/log/SA_ipmi.log
ICMP
To configure the ICMP SA (SA_icmp), you need to create or modify the following file:
/etc/opt/SMAW/SMAWsf/SA_icmp.cfg
The format of the SA_icmp.cfg file is as follows:
TIME_OUT=value cfname:ip-address-of-node:NIC-name1,NIC-name2
The editable fields are defined as follows:
value
Specify the time in seconds to check for the existence of a node. The recommended value is 5 seconds.
cfname
Specify a CF node name.
ip-address-of-node
Specify any of the following IP addresses of cfname. Available IP addresses are IPv4 and IPv6 address. The link local address of IPv6 is not available. When specifying the IPv6 address, enclose it in brackets "[ ]".
(Example: [1080:2090:30a0:40b0:50c0:60d0:70e0:80f0] )
Administrative LAN
Public LAN
Cluster interconnect
You must describe one or more IP addresses for all the nodes in the cluster. Add a new line to specify more than one LAN routes. It is recommended that you specify more than one routes to check the LAN routes.
NIC-nameX
For ip-address-of-node, specify a network interface used to check the existence of the node. If there are more than one network interfaces, separate them with a comma.
Note
Note the following when you describe network interfaces:
When duplicating the network by GLS, you need to describe all redundant network interfaces. (For example, eth0,eth1)
When bonding NICs, you need to describe a bonding device after the IP address. (For example, bond0)
When describing cluster interconnects, you need to describe all network interfaces used in all paths of the cluster interconnects. (For example, eth2,eth3)
The following is an example of the SA_icmp configuration file:
TIME_OUT=5 node1:10.20.30.100:eth0,eth1 node1:10.20.40.200:eth2 node2:10.20.30.101:eth0,eth1 node2:10.20.40.201:eth2
The log file is stored in the following:
/opt/SMAW/SMAsf/log/SA_icmp.log
VMCHKHOST
To configure the Shutdown Agent (SA_vmchkhost) to switch the HOST OS in the event of an error in the virtual machine environment, you must create or modify the following file:
/etc/opt/SMAW/SMAWsf/SA_vmchkhost.cfg
Templates of the configuration file are stored in the following:
/etc/opt/SMAW/SMAWsf/SA_vmchkhost.cfg.template
Each line of the configuration file SA_vmchkhost includes the following 5 fields:
guest-cfname
CF node name of a guest OS.
host-cfname
CF node name of the Host OS.
ip-address
IP address of the Host OS. Available IP addresses are IPv4 and IPv6 address. The link local address of IPv6 is not available.
user
Account of the Host OS.
For a KVM environment, specify the user name that was created when setting libvirt to the Shutdown Facility.
password
Login password for the account that was specified with "user."
The encrypted password for the user with general privileges for the Shutdown Facility, which was used when setting libvirt to the Shutdown Facility, is used.
The following is an example of the SA_vmchkhost configuration file:
fuji2 hostos2 192.168.200.1 FJSVvmSP 3CA1wxVXKD8a93077BaEkA== fuji3 hostos3 192.168.200.2 FJSVvmSP 3CA1wxVXKD8a93077BaEkA==
The log file is stored in the following:
/var/opt/SMAWsf/log/SA_vmchkhost.log
libvirt
To configure the Shutdown Agent (SA_libvirtgp) for PANIC or Shutdown Agent (SA_libvirtgr) for RESET of libvirt, you must create or modify the following files respectively.
/etc/opt/SMAW/SMAWsf/SA_libvirtgp.cfg /etc/opt/SMAW/SMAWsf/SA_libvirtgr.cfg
Templates of the configuration file are stored in the following:
/etc/opt/SMAW/SMAWsf/SA_libvirtgp.cfg.template /etc/opt/SMAW/SMAWsf/SA_libvirtgr.cfg.template
Each line of the configuration files, SA_libvirtgp.cfg and SA_libvirtgr.cfg, includes the following 5 fields:
cfname
Node name on the CF cluster.
domain
Domain name of a guest OS.
ip-address
IP address of the hypervisor. Available IP addresses are IPv4 and IPv6 address. The link local address of IPv6 is not available.
user
Account of the hypervisor. The user for shutdown facility is specified.
password
Login password for the account specified in "user" field. A password encrypted by the encryption command, sfcipher(8). For details on sfcipher(8), see "Manual pages."
The following is an example of the SA_libvirtgp configuration file:
fuji2 domain2 192.168.200.1 user 3CA1wxVXKD8a93077BaEkA== fuji3 domain3 192.168.200.2 user 3CA1wxVXKD8a93077BaEkA==
The following is an example of the SA_libvirtgr configuration file:
fuji2 domain2 192.168.200.1 user 3CA1wxVXKD8a93077BaEkA== fuji3 domain3 192.168.200.2 user 3CA1wxVXKD8a93077BaEkA==
The log file is stored in the following:
/var/opt/SMAWsf/log/SA_libvirtgp.log /var/opt/SMAWsf/log/SA_libvirtgr.log
