This information describes the activities that the admin user needs to execute when changing the IP address or hostname for the SP nodes and control workstation (CW). Avoid making any hostname or IP address changes if possible. The tasks are numerous and in some cases require re-execution of the installation steps.
This document is intended solely for use on AIX Version 4.1.3 or later and Parallel System Support Program (PSSP) version 2.1 systems.
The changing of the hostnames and IP addresses of SP nodes affects the whole SP system. Hostnames and IP addresses are located in the System Data Repository (SDR) and require working with objects and attributes. Hostnames and IP addresses are also kept in various files that are located on the SP nodes and the CW. These changes can cause problems with Network Installation Manager (NIM), System Partition objects and configuration files on your SP system.
NOTE: In this document "hostname" refers to the name returned as output when the hostname command is run on the machine. "Short_hostname" refers to the portion of the machine hostname before the first period.
For example:
spcntl.aix.dfw.ibm.comThe hostname is spcntl.aix.dfw.ibm.com and the "short_hostname" is spcntl.
spcntlThe hostname is spcntl and the "short_hostname" is spcntl.
This document is intended solely for use on AIX 4.1.3 or later and Parallel System Support Program (PSSP) version 2.1 systems. If you are unsure which version of PSSP you are running, run the command lslpp -h ssp.basic. You should see the version number displayed in the output:
PATH: /usr/lib/objrepos ssp.basic 02.01.0000.0000 ******
The SDR objects that reference the hostname and IP address changes are as follows:
The following are files which contain IP Addresses, or hostnames that exist on SP nodes and CW. Look through these files when completing the procedures for changing hostnames and IP addresses for your SP system.
Changing the hostname or IP address for an SP node and CW will follow the same procedures, except that the Control Workstation will include additional network and SP configuration steps.
NOTE: Know the new selected IP addresses and hostnames being used by the SP nodes, Control Workstation, and gateway servers. This is required so that the SP node will properly communicate to the Control Workstation during the reboot activity. This is a manual activity for each SP node.
After the SP nodes have completed the reboot and customized, verify that the files on the SP nodes reflect the new IP address and hostname changes.
NOTE: The added Install support in AIX 4.1 for NIM requires the admin user to replace the NIM master objects. It may be necessary to update the NIM network and machine resources to match the new IP address or hostname. The NIM updates will be needed for the CWS and bootserver nodes.
NOTE: If you had previously used System Partitioning on your SP system, it will be necessary to re-execute the System Partition steps on your system. This will allow the necessary syspar config files to reflect any changes.
NOTE: Do not proceed until this step is completed. Many commands use name resolution to update the system.
Current mksysb images may have old name resolution data in them. To avoid accidentally restoring inaccurate name resolution data, the mksysb images should be remade after the conversion of hostnames and IP addresses on the entire system is complete.
The following SP node updates need to be made on every SP node prior to updates made to the Control Workstation (CW).
This will update the en0 interface on each SP node to allow the proper communication paths between the SP node and the Control Workstation. The mktcpip command will allow you to:
HI: The mktcpip command can be executed through smit mktcpip or the mktcpip command on each SP node. The following are examples of using the mktcpip command.
mktcpip -h <new node hostname> -a <new node IP addr> -m <subnet mask> -i en0 -n <name server> -d <domain> -g <gateway IP addr> -t N/A "
The following will change the hostname of node k22n06 to be referenced as new node hostname k88n06 in domain ppd.pok.ibm.com.
"/usr/sbin/mktcpip -h'k88n06.ppd.pok.ibm.com' -a'129.40.88.70' -m'255.255.255.192' -i'en0' -n'129.40.70.1' -d'ppd.pok.ibm.com' -g'129.40.88.126' -t'N/A'"
NOTE: Do not change the hostname via the hostname command. This only makes a temporary change. If you don't want to use mktcpip to change the hostname, then use smitty hostname to make the change permanent.
/etc/niminfo
Change NIM_NAME, NIM_HOSTNAME, NIM_MASTER_HOSTNAME, NIM_BOSINST_RECOVER, SPOT, NIM_CUSTOM, and NIM_HOSTS, replacing old names and addresses with the new ones.
/usr/sbin/nim -o unconfig master
HI:
/usr/sbin/installp -u bos.sysmgt.nim.master
vi /etc/SDR_dest_infoChange the IP address of the SP ethernet interface to the control workstation (keep in mind that you may need to put in one of the alias addresses depending on the partition to which this node belongs).
vi /etc/ssp/cw_name
vi /etc/ssp/server_hostname
vi /etc/server_name
HI: Change the node's hostname and IP address.
vi /etc/ssp/reliable_hostname
unset SP_NAME
/usr/lpp/ssp/kerberos/bin/kdestroy vi /etc/krb.confMake sure that it has the name of the control workstation so that it can find the kerberos database.
You should now be completed at the SP node. You need to make the changes at the Control Workstation and then reboot the SP nodes.
The following tasks need to be executed by the admin (root) user on the Control Workstation when changing the ethernet IP addresses or hostname.
vi /etc/filesystems
ls /etc/jmd*
vi /etc/jmd.config.<SP_NAME>
vi /tftpboot/script.cust
/usr/lpp/ssp/bin/SDRArchive
tar -cvf /dev/rmt0 /spdata (provided you are backing up to tape rmt0)
You will need to reference the old and the new System Partition names (SP_NAME) and IP addresses for the following tasks.
9076 SP System Management 9076 SP Configuration Database Management Enter Database Information System Partition Configuration Select System Partition Configuration (select a single partition configuration - for example, config.16) press Enter to execute hit PF3 to back up one screen Display Information for Given Configuration or Layout hit enter to execute verify that the output is a single partition that is a true representation of your system hit PF3 to back up one screen hit PF3 to back up one screen to the screen entitled: System Partition Configuration Select System Partition Layout select .../layout.1 (there should not be a layout.2, and so on) hit PF3 to back up a screen Enter Customization Information for a Selected System Partition select .../layout.1/syspar.1 fill in the IP address of the SP ethernet adapter on the Control Workstation select a PSSP Code Level of PSSP-2.1 press Enter to execute and create the custom file hit PF3 to back up one screen hit PF3 to back up one screen to the screen entitled: System Partition Configuration Apply System Partition Configuration
At this point the SDR (System Data Repository) is set for a single partition. This will make it easier to change the hostname and IP addresses on the CW.
SDRChangeAttrValues SP control_workstation=<short_hostname>
/bin/stopsrc -g sdr /bin/stopsrc -g hb /bin/stopsrc -g hr /bin/stopsrc -s hardmon
/usr/lpp/ssp/bin/sdr -spname <SP_NAME> rmsrc /usr/lpp/ssp/bin/hb -spname <SP_NAME> rmsrc /usr/lpp/ssp/bin/hr -spname <SP_NAME> rmsrc
HI To obtain the spname for each partition to be used in each of the preceding commands, execute the following command:
/usr/lpp/ssp/bin/SDRGetObjects Syspar_map syspar_nameExecute the preceding commands for each DIFFERENT partition name (syspar_name).
mktcpip -h <new CW hostname> -a <new CW IP addr> -m <subnet mask> -i en0 -n <name server> -d <domain> -g <gateway IP addr> -t N/A "
NOTE: Do not change the hostname via the hostname command, as this makes only a temporary change. If you don't want to use mktcpip to change the hostname, then use smitty hostname to make the change permanent.
vi /etc/rc.net
/usr/sbin/ifconfig <adapter> alias <ip-address> netmask <ip mask> up \>>$LOGFILE 2>&1
<adapter> is the adapter that corresponds to the IP address returned from the hostname command, <ip-address> is the alias IP address for the partition, and <ip mask> is the netmask for that IP address. For example:
/usr/sbin/ifconfig tr0 alias 129.40.127.101 netmask 255.255.255.0 up
Make sure you enter the above command into /etc/rc.net for each partition other than the default.
I: vi /etc/SDR_dest_info H: vi /spdata/sys1/spmon/hmacls
cd /spdata/sys1/sdr/partitions /bin/mv <OLD IP_ADDR> <New IP_ADDR>
This should only be executed for hostname changes for the CW. It is not required for changes made to IP addresses, or with SP node updates. Reference Step 12 in the SP Installation Guide.
H: Manually check that the authentication files /etc/krb.conf, /etc/krb.realms, and /etc/krb-srvtab reference the new hostname.
setup_authent vi /etc/krb.conf (change the hostname) pg /etc/krb.realms (to see if it exists) if /etc/krb.realms exists: vi /etc/krb.realms (change the hostname) ksrvutil list (check for new hostname in krb-srvtab)
HI: Execute the /usr/lpp/ssp/inst_root/ssp/inst_root/ssp.basic.post_i script to recreate and start the daemons. It is NORMAL to get errors, so do not rerun this script. Ignore the errors at at this point.
/usr/lpp/ssp/inst_root/ssp.basic.post_i /bin/lssrc -g sdr (check that an sdr for each partition is listed) /bin/lssrc -g hb (check that an hb for each partition is listed) /bin/lssrc -g hr (check that an hr for each partition is listed)
SDRChangeAttrValues SP_ports hostname=<hostname>
SDRChangeAttrValues Frame MACN=<hostname><hostname> is the hostname for the control workstation.
SDRChangeAttrValues Syspar syspar_name=<short_hostname> \ ip_address=<New IP_addr> SDRChangeAttrValues Syspar_map syspar_name= <short_hostname> syspar_addr=<New IP_addr>
/usr/sbin/nim -o unconfig master /usr/sbin/installp -u bos.sysmgt.nim.master
shutdown -FrHI: Verify that all PSSP daemons are getting activated from the /etc/inittab.
ps -ef | pg
Look for sdrd, hrd, hbd, hardmon, kadmind, and xntpd.
(optional) HI: Type smitty.
9076 SP System Management 9076 SP Configuration Database Management Enter Database Information Site Environment InformationChange any necessary hostnames or IP addresses and execute.
mv /home/<old_CW_hostname> /home/<new_CW_hostname> vi /etc/exports (change the exported home directory) exportfs -a vi /etc/amd/amd-maps/amd.uDo a global change from the old hostname to the new hostname throughout the file as follows:
:g/old_hostname/s//new_hostname/g :wq
Now amd will function properly once supper propagates the amd.u file.
9076 SP System Management 9076 SP Configuration Database Management Enter Database Information Node Database Information SP Ethernet Information
Change any necessary hostnames or IP addresses and execute.
9076 SP System Management 9076 SP Configuration Database Management Enter Database Information Node Database Information Additional Adapter Information
Change any necessary hostnames or IP addresses and execute.
9076 SP System Management 9076 SP Configuration Database Management Enter Database Information Node Database Information Hostname Information
Change any necessary hostnames or IP addresses and execute.
9076 SP System Management 9076 SP Configuration Database Management Enter Database Information Node Database Information Boot/Install/usr Server Information
Change any necessary hostnames or IP addresses, set the bootp response to "customize", and press Enter to execute the SMIT panel.
The SMIT panel will execute a setup_server command, which will create all the NIM-based files and resources required for installation. It will also create the authentication principals for the new SP nodes. This process may take approximately 30 minutes.
/etc/ntp.conf /tftpboot/<host>.config_info /tftpboot/<host>.install_info /tftpboot/<host>-new-srvtab
pg /etc/ntp.conf
ls -la /tftpboot/<host>.config_info ls -la /tftpboot/<host>.install_info ls -la /tftpboot/<host>-new-srvtab
If the date and time indicate a new file was generated, it is probably safe to assume that the new hostname and IP addresses are incorporated in the files.
9076 SP System Management 9076 SP Configuration Database Management Enter Database Information System Partition Configuration Select System Partition Configuration (select the proper partition configuration that you desire) press Enter to execute hit PF3 to back up one screen Display Information for Given Configuration or Layout hit Enter to execute verify that the output indicates the porper partitioning that you desire hit PF3 to back up one screen hit PF3 to back up one screen to the screen entitled: System Partition Configuration Select System Partition Layout select the proper layout that you desire hit PF3 to back up a screen Enter Customization Information for a Selected System Partition *select .../layout.?/syspar.1 *fill in the IP address of the SP ethernet adapter on the Control Workstation *select the proper PSSP Code Level *press Enter to execute and create the custom file *hit PF3 to back up one screen complete the previous 5 steps (marked with an *) for each additional partition hit PF3 to back up one screen to the screen entitled: System Partition Configuration Apply System Partition Configuration
Follow the same install sequence as for Installation, by customizing the boot servers first and then customizing the remaining SP nodes. For each bootserver node, unconfigure NIM and re-execute setup_server to create the Installation files.
Since the SP nodes are in customize mode, most configuration files will be updated to reflect the IP address and hostname changes.
Some files will not be updated on the nodes during the customization. You may want to rcp these files from the CW to the SP nodes by including them in the /tftpboot/script.cust file. These may include the /etc/resolv.conf, /.rhosts, and other SP customer-owned files.
The SMIT panel may run for approximately 30 minutes because NIM is being reconfigured.
/usr/sbin/nim -o unconfig master /usr/sbin/installp -u bos.sysmgt.nim.master
The SMIT panel may execute for approximately 30 minutes because NIM is being reconfigured.
The following steps need to be executed for IP address and hostname changes for both the Control Workstation and the each of the SP nodes.
If any of the files are not correct, make the proper updates for the correct IP address or hostname manually.
/usr/sbin/nim -o unconfig master /usr/sbin/installp -u bos.sysmgt.nim.master
When the SP nodes initialize, your SP system should be activated using the new IP addresses and hostnames.