AIX Install Guide
AIX Install Guide
AIX Install Guide
Release Notes
SC23-5201-08
Release Notes
SC23-5201-08
Note Before using this information and the product it supports, read the information in Appendix D, Notices, on page 67.
Ninth Edition (October 2009) Copyright International Business Machines Corporation 2004, 2009. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
Contents
Chapter 1. Read this before installation . Installation tips . . . . . . . . . . . Software License Agreements (SLA) . . . Service. . . . . . . . . . . . . . Fixes and problem-solving databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1 1 1 1 3 3 3 3 3 4 6 7 7 7 7 7 8 8 8 9
Chapter 2. System requirements . . . . . . . . . . . Required hardware . . . . . . . . . . . . . . . . . Firmware . . . . . . . . . . . . . . . . . . . . . Some AIX systems might not boot from CD-ROM . . . . . Minimum firmware levels required for AIX 5.3 . . . . . . Firmware upgrade required to support an alternate boot device I/O devices IPL limitation . . . . . . . . . . . . . . Storage adapter microcode . . . . . . . . . . . . . Memory requirements . . . . . . . . . . . . . . . . Host Ethernet Adapter memory requirements . . . . . . . Paging space requirements . . . . . . . . . . . . . . Disk requirements . . . . . . . . . . . . . . . . . . Disk capacity . . . . . . . . . . . . . . . . . . . Supported devices . . . . . . . . . . . . . . . . . Parallel printer cable selection . . . . . . . . . . . . Supported Enhanced Error Handling (EEH) devices . . . .
Chapter 3. Installation, migration, upgrade, and configuration information . Installation . . . . . . . . . . . . . . . . . . . . . . . . . . Installing AIX 5L Version 5.3 . . . . . . . . . . . . . . . . . . IBM Systems Director Common Agent . . . . . . . . . . . . . . . Common 32-bit kernel installation issues . . . . . . . . . . . . . . Disk format requirement . . . . . . . . . . . . . . . . . . . . Creating a bootable CD . . . . . . . . . . . . . . . . . . . . Base Operating System installation options . . . . . . . . . . . . . rsct.opt.storagerm fileset . . . . . . . . . . . . . . . . . . . . AIX Toolbox Media and NIM lpp_sources . . . . . . . . . . . . . . Graphics software bundle requires two CDs . . . . . . . . . . . . . Customized bosinst.data files . . . . . . . . . . . . . . . . . . Network Installation Management . . . . . . . . . . . . . . . . CSM Server . . . . . . . . . . . . . . . . . . . . . . . . IBM 32-bit SDK for AIX, Java 2 Technology Edition, Version 1.4.2 . . . . Perfagent Tools . . . . . . . . . . . . . . . . . . . . . . . Other installation information . . . . . . . . . . . . . . . . . . Using mkcd and mksysb to create a 64-bit boot image . . . . . . . . . Troubleshooting problems with installation from mksysb backup . . . . . If applications fail to run after downgrade is done . . . . . . . . . . . Migration . . . . . . . . . . . . . . . . . . . . . . . . . . Maximum size of boot image increased . . . . . . . . . . . . . . System migrated to AIX 5.3 might experience double boot . . . . . . . Migration from AIX 4.2.1 . . . . . . . . . . . . . . . . . . . . Replacements for the vmtune and schedtune commands . . . . . . . . xlC.rte fileset . . . . . . . . . . . . . . . . . . . . . . . . bos.clvm.enh fileset after migration to AIX 5L Version 5.3 . . . . . . . . KDE desktop . . . . . . . . . . . . . . . . . . . . . . . . Performance monitoring API . . . . . . . . . . . . . . . . . . SNMPv3 . . . . . . . . . . . . . . . . . . . . . . . . . .
Copyright IBM Corp. 2004, 2009
11 11 11 11 12 13 13 13 13 14 14 14 14 15 15 16 16 17 17 17 17 17 17 18 18 18 18 18 18 19
iii
Kerberos . . . . . . . . . . . . . . . . . AIX Toolbox for Linux Application migration information Multipath I/O (MPIO) . . . . . . . . . . . . . System V Printing Subsystem migration from AIX 4.3.3
. . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
19 19 20 24 25 25 25 25 25 25 25 26 26 26 26 27 28 28 28 29 30 30 30 30 31 31 32 32 32 33 33 33 33 33 34
Chapter 4. Limitations and restrictions. . . . . . . . Base Operating System (BOS) . . . . . . . . . . . console special file limitation . . . . . . . . . . . Known problems with the ksh and ksh93 commands . . IBM Directory with Ja_JP locale . . . . . . . . . . System management . . . . . . . . . . . . . . . Cluster Systems Management . . . . . . . . . . . Reliable Scalable Cluster Technology . . . . . . . . AIX VSCSI client device driver . . . . . . . . . . NPIV support of DS4000 storage products . . . . . . Web-based System Manager . . . . . . . . . . . Inventory Scout, Version 2.2.0.9 . . . . . . . . . . Known limitations for POWER4 systems . . . . . . . Host Ethernet Adapter limitation . . . . . . . . . . InfiniBand limitation . . . . . . . . . . . . . . . InfiniBand EEH limitation . . . . . . . . . . . . . Known problems . . . . . . . . . . . . . . . . IBM 4.7 GB IDE Slimline DVD-RAM drive limitations . . Known problem writing to DVD drive . . . . . . . . Limitation on placement of boot image on hard disk . . . Machine limitations with Universal Disk Format (UDF) . . Logical Volume Manager memory impact . . . . . . . Server Message Block File System (SMBFS) mounting . Restrictions using HEA under EtherChannel. . . . . . Limitations on number of devices per vscsi client adapter . Other software . . . . . . . . . . . . . . . . . AIXlink/X.25 . . . . . . . . . . . . . . . . . AIX Fast Connect, Version 3.2. . . . . . . . . . . Communications Server for AIX, Version 6.1 . . . . . Distributed Computing Environment (DCE) . . . . . . Enterprise Identity Mapping (EIM) . . . . . . . . .
Chapter 5. Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 AIX Information Center . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 Appendix A. AIX 5L Version 5.3 changes . . . . . . . New and Enhanced Functionality in AIX 5L Version 5.3 . . Base Operating System (BOS) . . . . . . . . . . . 64-bit system identifier . . . . . . . . . . . . . 64-bit kernel . . . . . . . . . . . . . . . . . 32-bit kernel . . . . . . . . . . . . . . . . . Long user names, group names, and path names . . . System support . . . . . . . . . . . . . . . . Base functionality . . . . . . . . . . . . . . . JFS2 maximum file system support . . . . . . . . . JFS2 file system freeze and thaw feature. . . . . . . JFS2 sync tunables. . . . . . . . . . . . . . . New memory allocation algorithm MALLOCTYPE=watson The -l option removed from the make command . . . . System performance recordings and reports . . . . . Reliability, availability, serviceability utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 37 37 37 37 37 37 38 38 39 39 39 40 40 40 41
iv
AIX Web browser Mozilla Firefox 1.5 for AIX . . . . License Use Management (LUM). . . . . . . . . Exclusive resource sets . . . . . . . . . . . . Multiple instances of AIX on a single root volume group Multiple page size support . . . . . . . . . . . USB flash drive support . . . . . . . . . . . . Communications, networking, and I/O . . . . . . . . IP Security . . . . . . . . . . . . . . . . . Asynchronous I/O fast path for CIO with JFS2 . . . . AIX Network Data Administration Facility . . . . . . Internet Key-Exchange logging . . . . . . . . . RADIUS Server . . . . . . . . . . . . . . . Path MTU (PMTU) discovery . . . . . . . . . . AF_INET6 sockets . . . . . . . . . . . . . . Removal of support for devices . . . . . . . . . The devices.artic960 fileset . . . . . . . . . . . The devices.pci.14108c00 fileset . . . . . . . . . Missing resource processing . . . . . . . . . . IBM Tivoli Directory Server (LDAP) . . . . . . . . Dynamic Tracking and Fast I/O Failure of Fibre Channel Internet Protocol (IP) over Fibre Channel . . . . . . Sendmail, Version 8.13.4. . . . . . . . . . . . Generic Routing Encapsulation . . . . . . . . . AIX iSCSI software initiator . . . . . . . . . . . iSCSI Boot Support and IPv6 Support . . . . . . . Configurable IP Multipath Routing . . . . . . . . Virtual SCSI client adapter . . . . . . . . . . . System management . . . . . . . . . . . . . . AIX Network Data Administration Facility . . . . . . Distributed Command Execution Manager (DCEM) . . dscrctl Command . . . . . . . . . . . . . . Enhanced nimadm command . . . . . . . . . . Predefined XOPEN macros . . . . . . . . . . . Lightweight Infrastructure . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
44 45 46 46 46 47 48 48 49 49 49 49 50 50 50 50 51 51 51 52 52 53 53 53 54 54 56 56 56 57 57 58 58 59
Appendix B. AIX 5L Version 5.3 unsupported devices . . . . . . . . . . . . . . . . . . 61 Unsupported devices and machines. . . . . . . . . . . . . . . . . . . . . . . . . . 61 Unsupported functions and filesets . . . . . . . . . . . . . . . . . . . . . . . . . . 62 Appendix C. Listing of filesets on the AIX media . . . . . . . . . . . . . . . . . . . . 65 AIX 5L for POWER Version 5.3 CD set . . . . . . . . . . . . . . . . . . . . . . . . 65 Appendix D. Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Contents
vi
These Release Notes support AIX 5L Version 5.3 with the recommended 5300-11 Technology Level. The AIX 5L Version 5.3 Release Notes include information that helps you install AIX 5L Version 5.3. The release note information center is located at the following Web site:
Release Notes Index for AIX 5.3 and Expansion Pack
(http://publib.boulder.ibm.com/infocenter/pseries/v5r3/index.jsp?topic=/com.ibm.aix.resources/ 53relnotes.htm)
Installation tips
The latest installation hints and tips are available from the IBM Subscription Service for UNIX servers at:
http://www14.software.ibm.com/webapp/set2/subscriptions/pqvcmjd
These tips might contain information that are critical for successful installation of this software.
Required hardware
Only Common Hardware Reference Platform (CHRP) machines are supported. To see if you have a CHRP machine, log into the machine as the root user, and run the following command:
lscfg | grep Architecture
For more information about supported and unsupported items, see Appendix B, AIX 5L Version 5.3 unsupported devices, on page 61.
2. Examine the data that is returned. If Part Number is 04N2964 and ROS Level and ID is less than or equal to 1_04 (for example, 1_02, 1_01, or 1_00), contact your local service representative. Tell your service representative that your system requires the CD-ROM firmware upgrade that is described in RETAIN TIP H1332. If the data returned does not match the data described in the preceding paragraph, your system is not affected by this problem.
Minimum Firmware Level 20040716 20040716 20040716 20040716 L04197 CL050203 CL050203 NAN04194 L04197 SST04195 CM050203
Model Number 7026-M80 7026-6H0/6H1 7026-6M1 7028-6C1 7028-6C4 7028-6E1 7028-6E4 7029-6C3 7029-6E3 7038-6M2 7039-651 7040-671 7040-681 7043-150 7043-260 7043-270 7044-170 7044-270 7046-B50 9112-265 9114-275
Product Name RS/6000 Model M80 pSeries 660 Models 6H0/6H1 pSeries 660 Model 6M1 pSeries 610 Model 6C1 pSeries 630 Model 6C4 pSeries 610 Model 6E1 pSeries 630 Model 6E4 pSeries 615 Model 6C3 pSeries 615 Model 6E3 pSeries 650 Model 6M2 pSeries 655 Model 651 pSeries 670 Model 671 pSeries 690 Model 681 RS/6000 Model 150 RS/6000 Model 260 RS/6000 7043 Model 270 RS/6000 Model 170 RS/6000 Model 270 RS/6000 Model B50 IntelliStation POWER Model 265 IntelliStation POWER Model 275
Minimum Firmware Level MM050203 CM050203 MM050203 CLT04194 3R041029 CLT04194 3R041029 3F041029 3F041029 3K041029 3J041029 3H041029 3H041029 TCP04195 SPX04197 SPH04194 SPH04194 SPH04194 TCP04194 CLT04194 3F041029
If you experience problems booting your POWER4 system after updating AIX or firmware, to verify and correct the value of the real-base firmware variable, perform the following steps: 1. Go to the open firmware prompt when the system is booting by typing 8 when a beep is heard or the banner displays. If applicable, the HMC can also be used to set to boot to the SMS menu. From the SMS menu, type 0 and go to the open firmware prompt. 2. At the open firmware prompt, type:
printenv real-base
The value following real-base must be c00000. If any value other than c00000 displays, run the following command:
setenv real-base c00000
3. After updating the real-base variable, reboot your system using the power switch.
Installation
Some systems might encounter installation problems when you are installing AIX 5.3 on a system that is currently installed with a earlier version of AIX or when you are installing an earlier version of AIX on a system currently installed with AIX 5.3. A firmware upgrade is required to support the following installation scenarios: 1. When an installation device is specified using the SMS menus or the Open Firmware command-line and the specified device is not the first available device in the AIX bootlist. Note: SMS menus differ, depending on the system. On some systems, the installation device is specified under the Multiboot menus. On other systems, the installation device is specified under the Select Boot Options menus. 2. When the F5 key is selected during boot, which is the fast path to install from the CD device, and the CD device is not the first available device in the AIX bootlist. No firmware upgrade is required if no installation device is specified in the SMS menus or the Open Firmware prompt or if the specified installation device is the first available device in the AIX bootlist.
* The 7040-671/681 Version 2 microcode does not support AIX 5.3. The required version of the firmware can be obtained from the following Web site:
http://www14.software.ibm.com/webapp/set2/firmware/gjsn
The device is not selectable as a boot Use a device in the first 144 I/O slots. source from the SMS menus. The boot will succeed to the installation menus, but devices beyond the first 144 I/O slots will not be listed as bootable installation targets in the AIX menus. Select a device that is available and marked as bootable.
Use a device in the first 144 I/O slots The boot will succeed to the installation menus, and the device will for all paths. be listed as bootable in AIX installation menus. The installation will proceed, but it will fail with the bootlist command failure "unable to set bootpath for all paths." The device will not be listed as bootable. Use a device in the first 144 I/O slots.
Using DLPAR to add an adapter in a slot beyond the first 144 I/O slots, and then attempting to run the alt_disk_install command for the newly added device. Using DLPAR to add an adapter in a slot beyond the first 144 I/O slots, and using the bootlist command to add the device as a bootable device (for example, by dynamically adding a redundant path to a current boot device or setting up for a network boot). Then removing the original adapter and rebooting.
The bootlist command succeeds, but Use a device in the first 144 I/O slots. the boot fails from the specified device, and AIX will not receive control.
Table 1. Scenarios for partitions with more than 144 assigned I/O slots (continued) Scenario Using DLPAR to add an adapter whose probe order will make it displace a current bootable device, and then rebooting. Result The boot fails, and AIX will not receive control. Resolution Move the boot device to one of the first 144 I/O slots or remove the previously added device.
Memory requirements
AIX 5L Version 5.3 minimum current memory requirements vary, based on the configuration. A general rule for a minimum current memory requirement for AIX 5L Version 5.3 is 256 MB512 MB. AIX 5L Version 5.3 requires the minimum current memory requirement to increase as the maximum memory configuration or the number of devices scales upward, or both. Larger maximum memory configurations or additional devices scale up the minimum current memory requirement. If the minimum memory requirement is not increased along with the maximum memory configuration, the partition hangs during the initial program load (IPL).
Disk requirements
AIX 5L Version 5.3 with the recommended 5300-11 Technology Level requires a minimum of 4 GB of physical disk space for a default installation, which in includes all devices and the Graphics bundle.
Notes: 1. The following measurements provide information about disk usage when you install AIX 5L Version 530011. 2. The boot logical volume is required to be 24 MB with AIX 5L with 5300-11. The pre-migration script in the usr/lpp/bos directory on your media or in your 530011 NIM SPOT will verify that you have adequate room. During the migration, hd5 is increased if necessary. The logical partitions must be contiguous and within the first 4 GB of the disk.
Disk requirements for AIX 5L Version 5.3 with the recommended 5300-11 Technology Level Location / /usr /var /tmp /opt Allocated (Used) 72 MB (62 MB) 1700 MB (1579 MB) 360 MB (235 MB) 128 MB (4 MB) 364 MB (198 MB)
Note: Before migrating, ensure that you have an adequate number of available partitions and increase the /tmp directory to 44 MB. During a migration installation, if /opt exists only as a directory and has less than 3 MB of data, then a new /dev/hd10opt logical volume and /opt file system are created, and the data that existed in the /opt directory is moved to the new /opt file system. If there is more than 3 MB of data in the /opt directory, then the new logical volume and file system are not created. If any existing file system has a mount point in the /opt directory, or a mount point of /opt itself, the new logical volume and file system are not created.
Disk capacity
For the AIX 32bit kernel, the maximum supported capacity of a disk is 1 TB. For the AIX 64bit kernel, SAS RAID controller arrays (hdisk) are supported that have capacities that exceed 2 TB (up to the RAID array capacity limitation of the SAS RAID controller). For additional information about SAS RAID controllers, see the SAS RAID controller for AIX Web page. For disks other than SAS RAID controller arrays, the maximum supported capacity of a disk is 2 TB. For information about AIX capacity limitations for logical storage, see the Limitations for logical storage management Web page.
v The output of the lsdev -C -l ppa0 command contains the word IEEE1284. If the output of the lsdev command contains the word Standard, or if the printer is a dot-matrix printer, an IEEE1284-compliant cable is not required. Cables that are not IEEE1284-compliant may not correctly transmit data to high-speed printers. Loss of printer data may occur because the cables may not be capable of transmitting data at rates that are possible with newer ECP parallel ports.
Certain hardware and firmware requirements must be met for EEH to work on a given system. Refer to your system guides to determine if EEH will work on your system.
10
11
When the AIX system is rebooted, the Director agent and the prerequisite processes for it, like the Pegasus CIM server, are automatically enabled. If you do not want to install or enable the Director agent, see the following information for the steps needed to stop, disable, and uninstall the Director agent. To stop the Director agent, run the following commands:
/opt/ibm/director/agent/runtime/agent/bin/endpoint.sh stop stopsrc -s platform_agent
To permanently disable the Director agent, do the following: 1. Comment out the following lines in /etc/inittab file:
platform_agent:2:once:/usr/bin/startsrc -s platform_agent >/dev/null 2>&1
Note: Comment out the following line only if you do not need the cimserver command to run other applications.
cimservices:2:once:/usr/bin/startsrc -s cimsys >/dev/null 2>&1
To permanently uninstall the Director agent components and leave the filesets that might be used by other applications, run the following command:
/opt/ibm/director/bin/diruninstall
To uninstall the filesets that remain after you run the diruninstall command (if they are not required for other applications), do the following: v To uninstall the CAS agent, run the following command:
installp -u cas.agent
For more information about IBM Systems Director 6.1, see the IBM Systems Director V6.1 Web page. For additional Power systems information about IBM Systems Director 6.1, see the IBM Systems Director Best Practices Redwiki Web page.
12
v When an installation is to a root volume group (rootvg) that is larger than 1.2 TB, the installation fails and the following message is displayed:
ATTENTION: The total size of a disk selected for rootvg is larger than what the running kernel supports. Select a samller disk size or reboot using media that supports running the 64-bit kernel.
The installation failures described in this section do not occur when a 64-bit network boot image is used.
Creating a bootable CD
It is recommended that you create a CD that can be used to boot and perform maintenance on your system that matches your current level of AIX. To create a bootable CD, run the following commands (where cdx is an attached CD writer). The bosinst.data file must be set for a prompted install (PROMPT = yes).
cd /var/adm/ras ls ./bosinst.data ./image.data | backup -ivqf/tmp/fakemksysb mkcd -m /tmp/fakemksysb -d /dev/cdx
OR
mkcd -m /tmp/fakemksysb -S
will create a CD image that can be transferred to a system with a CD writer. Note: The final mkcd command in the previous example makes an image that can be transferred to another system (AIX or non-AIX) for burning.
rsct.opt.storagerm fileset
The rsct.opt.storagerm fileset is not automatically installed with the Reliable Scalable Cluster Technology (RSCT) updates. You can install this fileset after the RSCT updates are applied. If you install the rsct.opt.storagerm fileset, to reject the RSCT updates, you must uninstall the rsct.opt.storagerm fileset before you request PTF rejects.
Chapter 3. Installation, migration, upgrade, and configuration information
13
This command restores in /tmp/usr/sys/inst.data/sys_bundles. Copy it to the location of your choice, and create a new NIM bundle resource, smitty nim_mkres.
14
For NIM rte installs, when using the New and Complete Overwrite installation method, if you are using an lpp_source created from a previous version of AIX 5.3 base media, and updates from the current version of AIX (from the Update CD), you should specify an image_data resource. After your NIM SPOT is updated from your lpp_source, you can copy the <SPOT_location>/lpp/bosinst/image.template to a new location, and make it your image_data resource. This is because the number of partitions required for hd5 (boot logical volume) increased in AIX 5.3 with the 5300-07 Technology Level.
CSM Server
Before you install the CSM Server, you must read the Software Planning and Installation Guide for specific procedural steps to use when you are installing CSM. Installation of this product is not possible if you do not use the documented procedures in this book. CSM Server requires four open-source rpm filesets that must be installed prior to installing the CSM Server software and its dependent packages, the CSM Distributed Command Execution Manager (DCEM) GUI and the CSM DCEM Web-based System Manager application. The required rpm filesets are: v tcl v tk v expect v conserver As the root user, do the following to install the rpm filesets and the CSM Server: 1. Install the above rpm filesets using SMIT Install Software (type smitty install_latest at the AIX command line). a. Press F4, and select /dev/cd0 (CD Drive) as the INPUT device / directory for software. b. Press F4, and select (by pressing F7 for each package) tcl-8.3.3, tk-8.3.3, expect-5.32, and conserver-7.2.4 as the SOFTWARE to install values, or press F4 and select all of the software packages you want. c. To accept the software license agreements, press the Tab key to change no to yes as the ACCEPT new license agreements value, and then press Enter. d. Press Enter again to confirm that you want to continue the installation process. e. Review the installation results, and press F3 to return to the installation panel, or press F10 to return to the AIX command line. 2. Install the CSM Server and its dependent software using SMIT Install Software (type smitty install_latest at the AIX command line). a. Press F4, and select (by pressing F7 for each package) csm.server, csm.gui.dcem, and csm.gui.websm as the SOFTWARE to install values, or press F4 and select all of the software packages you want. b. To accept the software license agreements, press the Tab key to change no to yes as the ACCEPT new license agreements value, and then press Enter. c. Press Enter again to confirm that you want to continue the installation process. d. Review the installation results, and press F3 to return to the installation panel, or press F10 to return to the AIX command line.
IBM 32-bit SDK for AIX, Java 2 Technology Edition, Version 1.4.2
IBM 32-bit SDK for AIX, Java 2 Technology Edition, Version 1.4.2 is released in Java14.* filesets, and it is shipped with the base operating system. For more information about this version, see the /usr/java14/docs/sdkguide.aix32.htm file. The 64-bit version is available on both the AIX 5L Version 5.3 Expansion Pack and the following AIX Java Web site:
http://www.ibm.com/developerworks/java/jdk/aix/
Chapter 3. Installation, migration, upgrade, and configuration information
15
You can dynamically reconfigure a logical partition (LPAR) that is running a Java 1.4.2 application. Note: If the number of processors or the amount of real memory that is allocated to an LPAR is decreased, the performance of a Java application is reduced, but the application continues to run. The following versions are not supported: v IBM AIX Developer Kit, Java 2 Technology Edition, Version 1.3.1, 32-bit version for POWER v IBM AIX Developer Kit, Java 2 Technology Edition, Version 1.3.1, 64-bit version for POWER
Perfagent Tools
The perfagent.tools fileset is automatically installed with the base operating system installation. Four files have been moved to the new bos.perf.fdpr fileset that is not automatically installed. The moved files are: v /usr/lib/perf/fdprpro v /usr/lib/perf/libfdprinst.a v /usr/bin/fdpr v /usr/lib/perf/libfdprinst64.a If you require these files, the new fileset is on the Volume 3 CD.
The RPM packages are located in the following path, where mount_point is the mount point:
/mount_point/RPMS/ppc
If you have media that contains ISMP packages for AIX 5.3, the ISMP packages are located in the following path, where mount_point is the mount point:
/mount_point/ismp/ppc
The installp, bffcreate, geninstall, gencopy and nim commands recognize this media structure. For more information about software packaging, see the Software Product Packaging Concepts section in the Installation and migration in the AIX Information Center.
16
Migration
This section contains information about installing AIX 5.3 that supplements the information contained in AIX 5L Version 5.3 Installation and migration. The installation guide is available online in the AIX Information Center and in printed hardcopy (SC23-4887-04). Note: Installing any new level of AIX requires more disk space than previous levels. Read the Disk Requirements in Chapter 2 for the disk requirements for a basic installation and ensure that you have free space either already existing in the systems, or free partitions in the rootvg. Migrating will require slightly more free space than a basic installation.
17
xlC.rte fileset
If you are migrating to AIX 5.3 from AIX 4.2.x or AIX 4.3.x, check the level of the xlC.rte fileset by typing the following command:
lslpp -L xlC.rte
If the xlc.rte level is earlier than 5.0.2.x, you must apply APAR IY17981 before migrating to AIX 5.3. Without APAR IY17981 installed, the migrated system might fail to boot. APAR IY17981 is available from the following Web site:
http://www-933.ibm.com/eserver/support/fixes/fixcentral/main/pseries/aix
KDE desktop
If the CDE and KDE desktops are both installed on a system migrated from AIX 4.3 to AIX 5.3, the KDE desktop might not start from the CDE login. To fix this problem, remove the following CDE startup information from the /etc/inittab file:
dt:2:wait:/etc/rc.dt
Note: You must have root user authority to remove this CDE startup information. Do not delete the following KDE entry from the /etc/inittab file:
kdm:2:once:/opt/freeware/kde/bin/kdm
18
setup_branchtable: Processor not yet supported. instal: Failed while executing the ./bos.pmapi.pmsvcs.post_i script.
When you are migrating from any level of AIX with any level of the beta fileset installed, you must uninstall the pmtoolkit fileset and reboot the machine before you install the bos.pmapi fileset. If you do not, the machine will fail to boot when you attempt to load the pmtoolkit filesets kernel extension. Verify that the pmtoolkit fileset is installed by typing the following at the command line:
lslpp -l pmtoolkit
you can safely install the bos.pmapi fileset. If you get the following output:
Fileset Level State Description ---------------------------------------------------------------------------Path: /usr/lib/objrepos pmtoolkit 1.3.1.6 COMMITTED Performance Monitor Toolkit 1.3.1
2. Reboot the machine. After the machine reboots, you can safely install the bos.pmapi fileset.
SNMPv3
After you migrate to AIX 5.3, the non-encrypted version of SNMPv3 will run by default. If you have your own community, trap, or smux entries in your /etc/snmpd.conf file, those must be manually migrated to the /etc/snmpdv3.conf file. For instructions on how to migrate this information, see Network Management in Networks and communication management in the AIX Information Center.
Kerberos
All of the secure remote commands use the Kerberos Version 5 library and the GSSAPI library provided by IBM Network Authentication Service Version 1.4 that is located on the AIX 5L Version 5.3 Expansion Pack CD. However, you must install the krb5.client.rte fileset. If you are migrating to AIX 5.3, using CD or DVD media, and have Kerberos Version 5 installed, the installation scripts will prompt you to install the krb5.client.rte fileset from the Expansion Pack. If you are migrating your operating system using NIM resources, add krb5 to your lpp_source. The secure remote commands support Kerberos clients and servers from both Native Kerberos 5 and DCE. For more information, see Understanding the Secure Rcmds in Managing Communications and Networks in the AIX Information Center.
19
overwritten during a preservation installation. To remove your existing rpm filesets, use the destroyRPMS tool available in the /contrib directory on the AIX Toolbox for Linux Applications CD by typing the following:
mount -vcdrfs -oro /dev/cd0 /mnt /mnt/contrib/destroyRPMS
If you are migrating your system from AIX 4.3.3 to AIX 5L and you installed the rpm.rte fileset without creating your own /opt or /opt/freeware file system, after running the destroyRPMS command it is recommended that you remove the /opt/freeware directory and the /usr/opt/freeware directory before migrating. On AIX 5L, the system provides a /opt file system into which the rpm.rte fileset is normally installed. However, if the RPM Package Manager (RPM) finds a pre-existing /usr/opt/freeware directory, it uses this location instead. You do not need to do this if you want your RPM freeware installed under the /usr file system, but the /opt file system is recommended. If you have already migrated with the /usr/opt/freeware file system and want to change this afterwards, run the destroyRPMS command again, remove any existing /usr/opt/freeware and /opt/freeware directories, and install the rpm.rte fileset again. Additional information is also available on the AIX Toolbox for Linux Applications CD in the /README.TXT file.
The following DS4000 models are supported by AIX MPIO: v 1722-600 = DS4300 = FAStT 600 v 1742-900 = DS4500 = FAStT 900 v 1814 = DS4700/DS4200 v 1815 = DS4800 To convert DS4000 disks from FCPARRAY to MPIO, do the following: 1. Change the NVSRAM settings on DS4000 storage used in the SAN (or direct attach) by doing the following:
20
Note: If this step was previously performed, go to step 2. However, if DS4000 firmware was updated, this step must be performed again. a. From the main Enterprise Management screen, highlight the subsystem you want to change. b. From the Tools menu, select Execute Script to open a Script Editor window. c. Enter the following:
set controller [a] HostNVSRAMBYTE [0x06,0x27] = 0; set controller [b] HostNVSRAMBYTE [0x06,0x27] = 0;
d. From the Tools menu, use the Script Editor to select Verify & Execute. e. Wait for the script to complete. Attention: Do not cancel the script operation. When the script completes, exit the Storage Manager. 2. Install the MPIO_DS3_4K APAR/iFIX that is appropriate for the AIX release on the server, and then reboot the AIX server. 3. Determine the DS4000 model or models that you are using on your AIX host by running the following commands, where X is the hdisk number for the DS4000 Array Disk type:
lsdev Cc disk | grep DS4K lscfg vl hdiskX
For example:
# lsdev -Cc disk hdisk2 Available 0C-08-02 DS4K Disk Array Device # lscfg -vl hdisk2 hdisk2 U787A.001.DPM0WY4-P1-C5-T1-W200800A0B81326B7L3000000000000 1742-900 (900) Disk Array Device Manufacturer................IBM Machine Type and Model......1742-900 ROS Level and ID............30393134 Serial Number............... Device Specific.(Z0)........0000053245004032 Device Specific.(Z1)........
4. Use the following table and the Machine Type and Model output from step 3 to determine your DS4000 Array Disk type.
Table 2. DS4000 Array Disk Cross Reference Machine Type-Model 1722-600 1742-900 1814 1815 Array Disk DS4300 DS4500 DS4700/DS4200 DS4800 Storage Server FAStT 600 FAStT 900
5. Check the AIX systems driver support and state by running the following command:
# 'manage_disk_drivers
The output from this command displays the DS4000 devices that are supported by MPIO and RDAC, and indicates if they are currently configured for MPIO or RDAC enablement. For example:
# manage_disk_drivers 1: DS4300: currently RDAC/fcparray; supported: RDAC/fcparray, MPIO 2: DS4500: currently RDAC/fcparray; supported: RDAC/fcparray, MPIO 3: DS4700/DS4200: currently RDAC/fcparray; supported: RDAC/fcparray, MPIO 4: DS4800: currently RDAC/fcparray; supported: RDAC/fcparray, MPIO
Note: If the AIX system has more than one type of DS4XXX models attached, run the manage_disk_drivers command for each model type.
Chapter 3. Installation, migration, upgrade, and configuration information
21
In the example in step 3 on page 21, hdisk2 is a DS4500. In the example in step 5 on page 21, DS4500 is currently enabled for RDAC/fcparray. To change the driver that manages the DS4000, run the following commands in order, where X in the first command is the number of the array disk stanza from the output of the manage_disk_drivers command. For example: for DS4700, enter # manage_disk_drivers c 3; for DS4800, enter # manage_disk_drivers c 4, etc.
# manage_disk_drivers c X
6. After the server reboots, all of the hdisk devices that were converted will be configured under the MPIO driver. All of the hdisks that are connected to DS4000 should be displayed as MPIO Other DS4K Array Device as indicated by the lsdev Cc disk output. 7. To verify that hdisks are mapped to the appropriate LUNs on DS4000, run the mpio_get_config A command. This command is similar to the fget_config command for the RDAC driver. The mpio_get_config command is for informational purposes only; you cannot change the LUN ownership using this command.
To convert the DS4000 driver from MPIO to FCPARRAY, do the following: 1. Install the MPIO_DS3_4K APAR/iFIX that is appropriate for the AIX release on the server. 2. Change the NVSRAM settings on DS4000 storage used in the SAN (or direct attach) by doing the following: Note: If this step was previously performed, go to step 3. However, if DS4000 firmware was updated, this step must be performed again. a. From the main Enterprise Management screen, highlight the subsystem you want to change. b. From the Tools menu, select Execute Script to open a Script Editor window. c. Enter the following:
set controller [a] HostNVSRAMBYTE [0x06,0x27] = 0; set controller [b] HostNVSRAMBYTE [0x06,0x27] = 0;
d. From the Tools menu, use the Script Editor to select Verify & Execute. e. Wait for the script to complete. Attention: Do not cancel the script operation. When the script completes, exit the Storage Manager. 3. To migrate from MPIO to RDAC, there must be no more than two connections between the server and the storage (one per controller). Verify that this requirement is met by verifying that there is a separate zone for each HBA and controller pair. Refer to the RDAC documentation for valid configuration details. 4. After the installation completes successfully, reboot the system. 5. Determine the DS4000 model or models that you are using on your AIX host by running the following command where X is the hdisk number for the DS4000 Array Disk type:
lsdev Cc disk | grep DS4K lscfg vl hdiskX
For example:
22
# lsdev -Cc disk hdisk2 Available 0C-08-02 DS4K Disk Array Device # lscfg -vl hdisk2 hdisk2 U787A.001.DPM0WY4-P1-C5-T1-W200800A0B81326B7L3000000000000 1742-900 (900) Disk Array Device Manufacturer................IBM Machine Type and Model......1742-900 ROS Level and ID............30393134 Serial Number............... Device Specific.(Z0)........0000053245004032 Device Specific.(Z1)........
6. Use the following table and the Machine Type and Model output from step 5 on page 22 to determine your DS4000 Array Disk type.
Table 3. DS4000 Array Disk Cross Reference Machine Type-Model 1722-600 1742-900 1814 1815 Array Disk DS4300 DS4500 DS4700/DS4200 DS4800 Storage Server FAStT 600 FAStT 900
7. Check the AIX systems driver support and state by running the following command:
# 'manage_disk_drivers
The output from this command displays the DS4000 devices that are supported by MPIO and RDAC, and indicates if they are currently configured for MPIO or RDAC enablement. For example:
# manage_disk_drivers 1: DS4300: currently RDAC/fcparray; supported: RDAC/fcparray, MPIO 2: DS4500: currently RDAC/fcparray; supported: RDAC/fcparray, MPIO 3: DS4700/DS4200: currently RDAC/fcparray; supported: RDAC/fcparray, MPIO 4: DS4800: currently RDAC/fcparray; supported: RDAC/fcparray, MPIO
Note: If the AIX system has more than one type of DS4XXX models attached, run the manage_disk_drivers command for each model type. In the example in step 5 on page 22, hdisk2 is a DS4500. In the example in step 7, DS4500 is currently enabled for RDAC/fcparray. To change the driver that manages the DS4000, run the following commands in order, where X in the first command is the number of the array disk stanza from the output of the manage_disk_drivers command. For example: for DS4700, you would enter # manage_disk_drivers c 3; for DS4800, you would enter # manage_disk_drivers c 4, etc.
# manage_disk_drivers c X
8. After the server reboots, all of the hdisk devices that were converted will be configured under the RDAC driver.
23
24
Click the Cluster info center link, and then click the Cluster Systems Management link in the Overview section.
Software requirements
The CSM management server can be any supported System p, System i, or System x machine. If the CSM management server is running AIX, it must use a minimum of AIX 5L Version 5.3 or AIX 5L Version 5.2 with the 5200-04 Recommended Maintenance package. Other machines within the CSM cluster are referred to as managed nodes. Managed nodes can also be any supported System p, System i, or System x machine. If the managed node is running AIX, it must use a minimum of AIX 5L Version 5.3, AIX 5L Version 5.2 with the 5200-04 Recommended Maintenance package and APARs as previously mentioned, or AIX 5L for POWER Version 5.1 with the 5100-07 Recommended Maintenance package. Please refer to the CSM documentation for more information on which machines and which versions of Linux are supported in a CSM environment.
25
26
then the wsm_remote Software Bundle allows you to install IHS from the hard disk by specifying the directory path name that contains your copy of the software installation images. To install IHS on AIX using the wsm_remote Software Bundle, manually complete the setup as follows: 1. The installation directory path name must be in the format ./ismp/ppc/package_name. For example, downloaded installation images can be copied to the /usr/sys/inst.images/ismp/ppc/IHS2 directory. In this example, the installation source name is /usr/sys/inst.images, and the package name is IHS2. 2. The response file named silent.res must be linked to the name IHS2.response for AIX to detect automatic responses during a silent installation, such as specifying the -P ihs.installLocation=/usr/ HTTPServer preferred AIX installation location and a language other than the default en (English) language. When installing any other HTTP Server on an AIX machine, complete the following: 1. Install the Web server. 2. Upon successful installation of the software, configure the Web server using the smitty web_based_system_manager SMIT fast path command. 3. Provide the required information in the panels. A configuration script runs and consolidates the steps needed to configure and initiate remote access and file-serving capabilities for Web-based System Manager. After updating the sysmgt.websm filesets, wsmserver in the /etc/services file and in the /etc/inittab file is updated. If modifications were previously made to these entries, the files might need to be re-edited after updating.
27
http://www14.software.ibm.com/webapp/set2/firmware/gjsn
To enable the new Inventory Scout functionality, the following filesets must be installed at the following levels or higher:
invscout.com invscout.ldb invscout.rte invscout.websm 2.2.0.1 2.2.0.2 2.2.0.9 2.2.0.5
To obtain the required filesets, order APAR IY58377 from the following Web site:
http://www-933.ibm.com/eserver/support/fixes/fixcentral/main/pseries/aix
If platform firmware levels are upgraded, CPU Gard functions can be re-enabled by typing the following command:
chdev -l sys0 -a cpuguard='enable'
In either case, no system reboot is required for the changes to take effect. System p 690 Memory The System p 690 model 681 (7040-681) supports a maximum system memory size of 1 TB (terabyte) with appropriate memory Feature Codes installed. AIX 5.3 and Linux logical partitions can have nearly 512 GB logical partition memory sizes (about 503 GB after page table, POWER Hypervisor, and TCE table usage). AIX 5.3 and Linux logical partitions should have the Small Real Mode Address Region option selected on the HMC partition profile memory panel, and must be defined for logical partitions greater than 256 GB.
InfiniBand limitation
There are two InfiniBand device drivers: one for the GX bus and the one for the PCIX bus. Both of these device drivers support only 64 bit kernel mode. Concurrent mode diagnostic support for the PCIX adapter is not provided. Infiniband has a debug tracing capability built into the software stack for both adapters. The tracing is disabled by default. It can be controlled by the following commands: v IbDebugChk - returns the current debug status v IbDebugOn - enables the debug tracing
28
v IbDebugOff - disables the debug tracing There is no tcpdump support for IPoIB. You can use the ibstat Command to display operational information.
ibstat command
The ibstat command displays Infiniband operational information pertaining to a specified Host Channel Adapter Device (HCAD). If an HCAD device name is not entered, status for all available HCAD's appear. You can display specific categories of information such as Node, Port, Interface, and Debug information, or you can choose to display all of the information categories. You can use one of the following flags to narrow down your search results:
-d -h -i -n -p -v Displays current debug setting Displays ibstat command usage Displays Network Interface Information Displays IB node information Displays IB port information Displays all IB device information
The following information appears on all valid calls and contains these fields: Device Name Displays the name of an available HCAD (example: iba0) Port State Displays the current state of each HCAD port
Down Initialized Armed Active Unknown Port Port Port Port Port is is is is is disabled. enabled and issuing training sequences. trained and attempting to configure to the active state. in a normal operational state. in an invalid or unknown state.
If you specify an invalid Device_Name, the ibstat command produces error messages stating that it could not connect to the device such as:
IBSTAT: No device iba2 configured IBSTAT: Device iba3 is not available.
29
Known problems
The following devices have limitations in the ability to update microcode with the microcode management feature: v PCI 4 Channel Ultra3 SCSI RAID Adapter. v CD-ROM and DVD-ROM Drives. v RAID Devices. v SSA devices and adapters. v Inventory Scout does not properly handle some OEM adapters and devices. For more information about these devices, see the readme files at the following Web site:
http://www14.software.ibm.com/webapp/set2/firmware/gjsn
You can verify the level of cdrecord by running the lslpp -L cdrecord command. It needs to be at least at level 1.9-6, which is available on this current AIX release or you can get it from:
ftp://ftp.software.ibm.com/aix/freeSoftware/aixtoolbox/RPMS/ppc/cdrecord/cdrecord-1.9-6.aix5.2.ppc.rpm
30
The only way that you can encounter this problem is by creating and initializing a new boot logical volume that extends past the 4 GB boundary of the hard disk. In almost all cases, you do not need to create a new boot logical volume, but if you do, use the lsvg and lslv commands to verify that the newly created boot logical volume does not reside above the 4 GB address on the hard disk. An example of this calculation follows: 1. Run lsvg rootvg to determine PP SIZE. On a 4.5 GB hard disk, the default PP SIZE is 8 MB. Make a note of that size. 2. Run lslv -m bootlv00, where bootlv00 is the name of the newly created boot logical volume. The numbers in the second, fourth, and sixth columns indicate the physical partitions that have been assigned to the boot logical volume. If the PP SIZE is 8 MB, the boot logical volume must not use any physical partition above 511 (512 * 8 = 4096, which is 4 GB). Similarly, if the PP SIZE is 16 MB, the boot image must not use any partition above 255, and if the PP SIZE is 4 MB, the boot image must not use any partition above 1023.
After running the above command, the bosboot command must be run, and a system must be rebooted in order for the tunable change to take effect. In order to reduce the AIX 5.3 LVM memory footprint by disabling memory affinity, AIX 5.3 Technology Level 5300-05 must be installed. With AIX 5.3 Technology Level 5300-05, the extra LVM memory footprint related to memory affinity only applies to hardware platforms that support memory affinity. Thus, disabling the memory_affinity tunable on a system, which doesnt support memory affinity, will not have any effect on the LVM memory footprint. On systems where memory affinity is unsupported, the LVM only requires approximately 270 KB of additional pinned memory per physical volume on AIX 5.3 Technology Level 5300-05 than on AIX 5.2 or AIX 5.1.
31
On systems that support memory affinity, disabling memory affinity reduces the additional AIX 5.3 LVM pinned memory requirements to approximately 270 KB per physical volume. Thus, on a system with two physical volumes and memory affinity disabled, the LVM only requires an additional 540 KB on AIX 5.3 than on AIX 5.2 or AIX 5.1.
32
Other software
This section contains information about other software. Additional information about AIX-supported products is available from the following Web sites: v IBM Global Services Supported Products List (http://www.ibm.com/services/sl/products) v IBM Software Support Lifecycle (http://www.ibm.com/software/info/supportlifecycle/)
AIXlink/X.25
AIXlink/X.25, Version 2.1
AIXlink/X.25 Version 2.1 is supported on AIX 5.3. For more information about supported adapters and about configuration and installation, see the AIXlink/X.25 Version 2.1 for AIX: Guide and Reference at http://publib.boulder.ibm.com/infocenter/pseries/ index.jsp. Select AIX documentation Networking and communication AIXlink/X.25 Version 2.1 for AIX: Guide and Reference.
Quick start
To install AIX Fast Connect: 1. Install AIX Fast Connect from the distribution CD using the smitty install_all fast path. 2. Use the smitty smb fast path to access AIX Fast Connect SMIT menus. 3. Configure AIX Fast Connect for encrypted passwords, and add a user. 4. Access the AIX Fast Connect server from a PC client by mapping a network drive. The server name is the same as the AIX host name, and HOME share is available by default.
You can download the PTF level 6.1.0.5 or later installable image from the Communications Server Service Update Web site using the Service Key provided with the product. Note: The AnyNet functions of CS/AIX are not supported on the 64-bit kernel.
33
34
Chapter 5. Documentation
AIX Information Center
The IBM System p and AIX Information Center is an information portal for AIX and System p customers. From this site, you can access the following: v AIX 5L Version 5.3 documentation v Hardware documentation v Message database for 7-digit error codes, LEDs, and error identifiers v How-tos for users and system administrators v FAQs v Links to Redbooks, white papers, and related products To access the Information Center, go to the following Web site:
http://publib.boulder.ibm.com/infocenter/pseries/v5r3/index.jsp
35
36
64-bit kernel
AIX 5L Version 5.3 provides a scalable 64-bit kernel that is capable of supporting large application workloads running on 64-bit hardware. The 64-bit kernel scalability is primarily provided through a larger kernel address space. This space supports larger system software applications without requiring practical bounds and kernel extension interfaces.
32-bit kernel
The AIX 5L operating system previously contained both a uniprocessor 32-bit kernel and a 32-bit multiprocessor kernel. Effective with AIX 5L Version 5.3, the operating system supports only the multiprocessor kernel. The AIX 5L Version 5.3 32-bit multiprocessor kernel supports the following systems: RS/6000, System p, or OEM hardware based on the Common Hardware Reference Platform (CHRP) architecture, regardless of the number of processors. The maximum real memory supported by a 32-bit kernel system (or partition) is 96 GB. AIX 5L Version 5.2 is the last release of AIX that supports the uniprocessor 32-bit kernel.
Notes: 1. The 53 notation is respective source code compiled with the AIX 5.3 OS environment. 2. The pre53 notation is respective source code compiled with the pre-AIX 5.3 OS environment. Any application calling addssys(), chssys(), defssys(), getsubsvr(), or getssys() should be recompiled with AIX 5.3 if it is to run on AIX 5.3.
37
System support
For information about supported and unsupported items, see Appendix B, AIX 5L Version 5.3 unsupported devices, on page 61.
Base functionality
The AIX 5L Version 5.3 kernels provide the same functionality, regardless of which kernel is being used. The 32-bit and 64-bit kernel systems have common base libraries, commands, utilities, and header files. Differences between 32-bit and 64-bit kernel systems are limited to the following: v System and I/O Support. The 64-bit kernel limits support to 64-bit POWER-based systems, while the 32-bit kernel supports both 32-bit and 64-bit POWER-based systems. In addition, the 64-bit kernel does not support all I/O that is supported by the 32-bit kernel. v Application Support. The 64-bit kernel supports both 32-bit and 64-bit applications. Application source and binaries are portable between AIX 5L Version 5.3 64-bit and 32-bit kernel systems, in the absence of any application dependencies on internal kernel details or on kernel extensions that are not supported under the 64-bit kernel but are supported under the 32-bit kernel. Binary Compatibility. Binary compatibility is provided for 32-bit applications running on earlier versions of AIX on POWER-based systems, except for applications linked statically or applications dependent on undocumented or unsupported interfaces. In addition, some system file formats have changed, and 32-bit applications processing these files might need to be recompiled. Application Scalability. AIX 5L Version 5.3 provides a more scalable application binary interface (ABI) for 64-bit applications. To take advantage of the scalability improvements to 64-bit programs, all 64-bit applications and libraries must be recompiled on AIX 5L Version 5.3. In addition, existing 32-bit kernel extensions and device drivers used by 64-bit applications might have to be modified in order to support the new 64-bit ABI. v Kernel Extensions. Kernel extensions for the 64-bit kernel run in 64-bit mode and have the scalability of the larger kernel address space. Some kernel services available in the 32-bit kernel are no longer provided by the 64-bit kernel, so existing 32-bit kernel extensions may have to be ported in order to be used with the 64-bit kernel. Existing 32-bit kernel extensions continue to be supported by the 32-bit kernel, but these kernel extensions are not usable by the 64-bit kernel. Not all of the kernel extensions supported for the 32-bit kernel are supported for the 64-bit kernel, particularly the device drivers for the I/O. Dual-mode Kernel Extensions. AIX 5L Version 5.3 supports dual-mode kernel extensions, which can be loaded by a common configuration method, regardless of which kernel is being used. A dual-mode kernel extension is an archive file that contains both the 64-bit and 32-bit versions of the kernel extension as members. v Installation and Enablement. The 32-bit and 64-bit kernels are provided as part of the AIX 5L Version 5.3 base media and are installed on all supported hardware systems. The default kernel enabled during installation is dependent on the hardware system being installed. On POWER5 systems, the 64-bit kernel is enabled during base system installation. On all other systems, the 32-bit kernel is enabled. However, you can override this default option at installation time through the system installation panels. You can switch between the 32-bit and 64-bit kernels without reinstalling the operating system. 1. Modify the /usr/lib/boot/unix directory and the /unix directory to be a symbolic link to the binary for the desired kernel. 2. Run the bosboot command to write a new system boot image. 3. Reboot the system. The path name of the 64-bit kernel is /usr/lib/boot/unix_64, and the path name of the multiprocessor versions of the 32-bit kernel is /usr/lib/boot/unix_mp.
38
v API:
fscntl() fscntl(vfs, FSCNTL_FREEZE, (caddr_t)timeout, 0); fscntl(vfs, FSCNTL_REFREEZE, (caddr_t)timeout, 0); fscntl(vfs, FSCNTL_THAW, NULL, 0);
39
When you are running an application that uses file system caching and does large numbers of random writes, you might need to adjust this setting to avoid lengthy application delays during sync operations. The recommended values are in the range of 256 to 1024. The default value of zero gives the normal sync behavior of writing all dirty pages in a single call. Small values for this tunable result in longer sync times and shorter delays in application response time. Larger values have the opposite effects.
j2_syncPageLimit Default: 16 Range: 1-65536 Type: Dynamic Unit: Numeric
Set this tunable when j2_syncPageCount is set, and increase it if the effect of the j2_syncPageCount change does not reduce application response times. The recommended values are in the range of 1 to 8000. The j2_syncPageLimit setting has no effect if the j2_syncPageCount setting is 0.
40
For local recordings, data is placed in the /etc/perf/daily/ directory and with files formatted as xmwlm.YYMMDD. The /usr/lpp/perfagent/config_aixwle.sh configuration script allows this function to be configured as an inittab process. For multi-partition (LPAR) recordings, data is placed in the /etc/perf/ directory and files are formatted as topas_cec.YYMMDD. The /usr/lpp/perfagent/config_topas.sh configuration script allows this function to be configured as an inittab process. If you are using the Performance Toolbox LPP, you must apply APAR IY76131 on any partition containing the perfagent.server fileset. If you are using either type of recording, you must allocate additional space to the /etc/perf directory. As recordings are retained for 7 days, 1 MB/day should be allocated for each type of recording used (7 MB for each type). For topas -R operation, choose a single LPAR to perform this data collection. The topasout command is used to post-process these recordings to generate text-based reports in formats similar to the topas command panels. Configuration, use and detailed explanations of these functions are located in the /usr/lpp/perfagent/ README.perfagent.tools file.
System dump
Extended system failure status information is captured as part of the dump, detailing dump success or failure. Display this extended information by using the sysdumpdev command. System dump compression is turned on by default. For information about dump compression, see the sysdumpdev command documentation. In AIX 5L Version 5.3 with the 5300-05 Technology Level, there are changes to improve dump performance. As a result of these changes, the compression format of dump has changed. It is no longer a .Z compressed file. Instead it is a .BZ file (not to be confused with bzip2 format which uses the .bz2 extension). Use the /usr/bin/dmpuncompress command to uncompress the new dump format file. The uncompress command does not work on the new dump format file. For example, for a compressed dump saved by snap or savecore, use:
dmpuncompress vmcore.1.BZ
If the dump is partial (non-zero status), the -p flag should be used to retrieve the partially compressed file:
dmpuncompress -p vmcore.1.BZ
For more information, refer to the dmpuncompress command documentation. System dump is enhanced to support DVD-RAM as the dump media. A DVD-RAM can be used as the primary or secondary dump device. The snap command is enhanced to support the following:
Appendix A. AIX 5L Version 5.3 changes
41
v Independent service vendors (ISVs) can use custom scripts to collect their custom problem data as part of the snap process. For programming and process details, see Copying a System Dump in AIX 5L Version 5.3 Kernel Extensions and Device Support Programming Concepts. v Large outputs can be split into smaller files for ease of transport. v Output can be written to DVD-RAM media. In addition to any full system dump, a small minidump is now taken when the system crashes. The minidump is visible in the AIX error log after operating system reboot, and is included in the failure information sent to IBM service for diagnosis.
You can then choose to enable or disable FFDC features. Note that a bosboot and reboot are required to fully enable or disable all FFDC features. Any change to LMT will not take effect until the next boot.
System trace
The system trace facility has been enhanced to support process and thread-based tracing. You can restrict the tracing to a process and capture the events in relation to the process for better debugging. For more information, see the trace command documentation. The trace command supports settings of larger trace buffers for regular users. For more information, see the trcctl command documentation. The system trace can be used to trace processor utilization register (PURR) to provide more accurate event timings in a shared processor partition environment.
42
Machine POWER3 (375 MHz CPU) POWER3 (375 MHz CPU) POWER5 (1656 MHz CPU, SPLPAR, 60% ent cap, SMT) POWER5 (1656 MHz CPU)
System Memory 1 GB 4 GB 16 GB
16
64 GB
512 MB
16 MB
To determine the amount of memory being used by LMT, enter the following shell command:
echo mtrc | kdb | grep mt_total_memory
The raso tunable command can be used to disable LMT. It can also be used to increase or decrease the memory trace buffer sizes. For more information, see the raso command documentation.
Component Trace
The Component Trace (CT) facility provides system trace information for specific system components. This information allows service personnel to access component state information through either in-memory trace buffers or through traditional AIX system trace. CT is enabled by default. The use of in-memory CT buffers can be persistently disabled across reboots by using the ctctrl -P memtraceoff command. CT can be persistently enabled by running the ctctrl -P memtraceon command. Note: A bosboot is required to make the command persistent on the next boot Information on these and other CT commands can be found in the ctctrl command documentation.
43
Report these error logs to IBM service. The detailed report contains additional information including a stack traceback and LMT (trace) data that can be used by IBM to identify the source of the problem. Only one period of interrupt disablement that exceeds .5 seconds is logged per boot (default). Note that each of these error log entries might identify a unique potential problem. These error reports are persistently disabled if RTEC is globally disabled. On a per-boot basis, disablement detection can be disabled by running the following command:
errctrl errcheckoff -c proc.disa
Finally, the following functions can be called from a disabled code section of a detected kernel extension to exempt the section from future excessive disablement reporting:
disablement_checking_suspend disablement_checking_resume
For more information about disablement checking, see disablement_checking_suspend Kernel Service and disablement_checking_resume Kernel Service in the AIX 5L Version 5.3 Technical Reference: Kernel and Subsystems Volume 1. Also see the errctrl command documentation.
Mozilla Firefox for AIX requires GNOME libraries, which are available on the Mozilla Firefox CD, the AIX Toolbox, or from the following Web site:
http://www.ibm.com/servers/aix/products/aixos/linux
44
The default setting is to not install Firefox. 2. When prompted to do so, insert the Firefox CD. v Install Mozilla Firefox as a bundle using the following Configuration Assistant process: 1. Start configassist. 2. Select Manage software, and click Next. 3. Select Install additional software, and click Next. 4. Select Install by bundle, and click Next. 5. Specify the device or directory that contains the installation images, and click Next. If the location is a directory, such as /usr/sys/inst.images, verify the following: The Firefox.base installp package is in the /usr/sys/inst.images/installp/ppc directory The rpm filesets are in the /usr/sys/inst.images/RPMS/ppc directory 6. Select the Firefox bundle, and click Next. 7. Accept the license agreement, and click Next to start the installation process. v Install Mozilla Firefox as a bundle using the following smit or smittyprocess: 1. Run the smitty install_bundle or the smit install_bundle command. 2. Specify the INPUT device/directory for software. If the location is a directory, such as /usr/sys/inst.images, verify the following: The Firefox.base installp package is located in the /usr/sys/inst.images/installp/ppc directory The rpm filesets are located in the /usr/sys/inst.images/RPMS/ppc directory 3. Select the Fileset Bundle = Firefox. 4. In the Install Software Bundle screen, accept the license agreement, and press Enter to start the installation process.
45
LUM Version 4
The i4blt, i4cfg, i4target, and i4tv LUM Version 4 commands are in the /usr/opt/ifor/ls/os/aix/bin directory. Note: To configure LUM Version 4, use the i4cfg command. The default directory for the nodelock file is the /var/ifor directory. For more information about LUM Version 4, see the License Use Management User Guide at /usr/opt/ifor/ls/os/aix/doc/lumusg.htm.
LUM Version 5
The LUMblt, LUMcfg, LUMtarget, and LUMtv LUM Version 5 commands are in the /opt/ LicenseUseManagement/bin directory. Note: To configure LUM Version 5, use the LUMcfg command. The default nodelock directory is the /var/LicenseUseManagement/nodelock directory. For more information about LUM Version 5, see the License Use Management User Guide at /opt/LicenseUseManagement/doc/lumusg.htm.
46
virtual memory page sizes are supported in addition to the previously supported virtual memory page sizes of 4 KB and 16 MB. Using a larger virtual memory page size like 64 KB for an application's memory can significantly improve an application's performance and throughput due to hardware efficiencies associated with larger page sizes. The specific page sizes supported on a system depends on a system's processor type. You can use the pagesize -af command to display all of the virtual memory page sizes supported by AIX on a system. You can specify the page sizes to use for three regions of a process's address space using an environment variable or settings in an applications XCOFF binary with the ldedit or ld commands as shown in the following table:
Region Data Stack Text ld / ldedit option -bdatapsize -bstackpsize -btextpsize LDR_CNTRL environment variable DATAPSIZE STACKPSIZE TEXTPSIZE Description Initialized data, bss, heap Initial thread stack Main executable text
For example, the following command causes mpsize.out to use 64 KB pages for its data, 4 KB pages for its text, and 64 KB pages for its stack on supported hardware:
$ LDR_CNTRL=DATAPSIZE=64K@TEXTPSIZE=4K@STACKPSIZE=64K mpsize.out
Unless page sizes are selected using one of the above mechanisms, a process will continue to use 4 KB pages for all three process memory regions by default. Using 64 KB pages rather than 4 KB pages for a multi-threaded process's data can reduce the maximum number of threads a process can create. Applications that encounter this limit can reduce internal pthread library memory usage and allow for more threads to be created by setting the environment variable AIXTHREAD_GUARDPAGES to 0. In addition to these three memory regions of a process's address space, you can select the page size for system V shared memory regions by using the SHM_PAGESIZE command to the shmctl() system call. The 4 KB and 64 KB page sizes are intended to be general-purpose, and no system configuration changes are necessary to enable a system to use these page sizes. The 16 MB large page size and 16 GB huge page size are intended only to be used in very high performance environments, and a system administrator must configure a system to use these page sizes. Furthermore, the support for 16 MB large pages and 16 GB huge pages is limited. 16 MB large pages are only supported for process data and shared memory, and 16 GB huge pages are only supported for shared memory. The ps -Z command displays the page sizes being used for the data, stack, and text memory regions of a running process. The vmstat command is enhanced to display information about multiple page sizes. The -p and -P options to the vmstat command displays VMM statistics for each supported page size. Finally, the following vmo command can be used to disable all kernel support for 64 KB and 16 GB pages:
vmo -r -o vmm_mpsize_support=0
The following USB flash drives are supported for use with AIX 5.3 with 5300-09 and AIX 6.1 with 6100-02:
Appendix A. AIX 5L Version 5.3 changes
47
v Lenovo USB2.0 Essential Memory Key, part number 41U4944 v Kingston 4GB DataTraveler, USB2.0 v SanDisk 4GB Cruzer Micro Flash Drive, USB2.0 Note: The AIX USB-host controller supports only USB1.1 on AIX 5.3 with 5300-09 and AIX 6.1 with 6100-02. All of the supported flash drives function with USB1.1. These flash drives are configured with logical names such as flashdrive0 and flashdrive1, and they present both raw and block special files. For example, the raw special file for flashdrive0 is /dev/rflashdrive0, and the block special file is /dev/flashdrive0. Only the ISO file system (read-only ISO9660) is supported on these drives. However, you can create a system backup on the drives by using the tar command, cpio command or the backup or restore archives. You can also use the dd command to add ISO images to the drives. These images can be used in read-only environments. To make a flash drive available to AIX users, a root user must connect the drive to a system USB port and run the following command:
cfgmgr -l usb0
Note: Note: Use caution when you remove the flash drives from ports. If the drives are not properly closed or unmounted before you remove them, data on the drives can be corrupted. After you remove the drives, they remain in the available state in the ODM until the root user runs the following command:
rmdev -l flashdrive<n>
When a drive is in the available state, you can reconnect it to the system, and it can be remounted or reopened. If a drive is disconnected from a system USB port while it is still open to a user, that drive will not be reusable until the user closes and reopens it. AIX 5.3 with 5300-09 and AIX 6.1 with 6100-02 do not include plug-and-play support for USB flash drives.
48
Write quit to save and close the file. Then move the gskikm.jar file from the /usr/java14/jre/lib/ext directory to the /tmp directory.
RADIUS Server
The RADIUS Server implements a client and server protocol that lets remote access clients communicate with a central server to gain access to a network. The RADIUS server authenticates users, authorizes their requests for access to services, and writes accounting data. The protocol is based on IETF RFCs 2865 and 2866.
Appendix A. AIX 5L Version 5.3 changes
49
AF_INET6 sockets
Beginning with AIX 5.3, the behavior of AF_INET6 sockets for protocol IPPROTO_RAW has changed to comply with RFC3542. When an application performs a receive on this type of socket, it will receive only payload data from the packet. In earlier versions of AIX, when an application performed a receive on an AF_INET6 IPPROTO_RAW socket, it received the IPv6 header, followed by the payload data. To preserve the former behavior (to continue receiving the IPv6 header followed by payload data), applications must now have their code modified to set the new IPV6_AIXRAWSOCKET socket option on any AF_INET6 IPPROTO_RAW sockets and recompile.
Remove the unsupported Ethernet adapter from the machine. This adapter will not be configured by AIX 5L Version 5.3.
50
v devices.artic960.ucode, IBM ARTIC960 Adapter Software v devices.artic960.diag, IBM ARTIC960 Adapter Diagnostics When a PCI I/O error occurs on an IBM PCI ARTIC960 adapter, the adapter slot becomes frozen and the IBM ARTIC960 adapter can be reset. Following an EEH error, the adapter software needs to be downloaded to the adapter again. To determine if an EEH error occurred on an IBM ARTIC960 adapter, inspection of the error log is necessary. A temporary EEH error on an IBM ARTIC960 adapter is logged as a temporary EEH error followed by I/O errors specific to the IBM ARTIC960 adapter. Recovery from a temporary EEH error is accomplished by removing and making the IBM ARTIC960 device driver using the rmdev and mkdev command. This process loads the necessary adapter software onto the adapter. If the error log shows a permanent EEH error, it is necessary to use the hot plug manager to remove and make the adapter again.
From the IBM Tivoli Directory Server category on this Web site, click Technical Documentation > Version: 5.2. Read the following documents: v Installation and Configuration v Server Readme v Client Readme
Appendix A. AIX 5L Version 5.3 changes
51
v Readme Addendum Before you run the ldapxcfg command, the following symbolic links must exist:
/usr/ldap/db2 -> /usr/opt/db2_08_01 /usr/ldap/lib/libdb2.a -> /usr/opt/db2_08_01/lib/libdb2.a
You can verify that these links exist by typing the following commands:
ls -l /usr/ldap/lib ls -l /usr/ldap/db2
If these links are not present, create these links by typing the following commands:
ln -s -f /usr/opt/db2_08_01/lib/libdb2.a /usr/ldap/lib/libdb2.a ln -s -f /usr/opt/db2_08_01 /usr/ldap/db2
You can install the Web Administration Tool on a system with or without the client or server. If you are using DB2 8.1, you must enable asynchronous I/O before you begin the configuration. To enable asynchronous I/O, type the following command at the command prompt:
smitty aio
There is a size underestimation with ldap.server.com. This can cause the installation to fail if not enough disk space is allocated.
Administration
After you install the ldap.client package, create the following link by typing the following:
ln -s -f /usr/ldap/lib/aix5/libldapiconv64.a /usr/lib/libldapiconv64.a
52
To set up the Fibre Channel networking capability between AIX and Thomson Grass Valley Media Servers (such as Profile PVS 1000). In addition, the following steps are recommended to establish the communication between the two host systems: 1. Disable FARP (Fibre Channel Address Resolution Protocol) on AIX. For example, if the IP over Fibre Channel protocol driver instance is fcnet0, type the following command:
chdev -l fcnet0 -a enable_farp=no
2. If the Profile Media Server is set up to disable checksum and re-transmit on error (this is the default option), type the following command on the AIX command line, assuming fc0 is the interface for this purpose:
ifconfig fc0 tcp_disable_cksum
You can also use the AIX ifconfig fc0 command to verify whether TCP checksum is disabled. To re-enable the TCP checksum on the IP over Fibre Channel interface, type the following command:
ifconfig fc0 -tcp_disable_cksum
3. It is recommended that initial communication always be established from AIX with the ping command. Initiating the exchange (pinging) from the Profile Media Server, prior to any exchange over Fibre Channel from the AIX side, might result in a prolonged delay in the establishment of communication between the two systems.
53
failure. The login redirection cannot occur between IPv4 and IPv6 networks. If the original login was on an IPv4 network address, the redirection must be to an IPv4 network address.
54
Weighted Random (WRND) With this policy, the configured weights of all routes are added, and a random number between 0 and the total weight is chosen. This random number is scaled down to a number between 0 and the number of routes in the MPR set, and chooses the route that corresponds to this scaled-down value. Lowest Utilization (LUT) With this policy, a route with the lowest reference count in the MPR set is chosen. The reference count is an indicator of the number of active connections using this route and therefore is used as an indicator of the use of these routes. Hash-Based (HSH) With this policy, a hash calculation is performed, based on the destination IP address, and a route is selected. You should not use this policy in the following cases: v If the routes in an MPR set are all host routes. v If most connections from the host that is being configured are to a specific destination IP address. In both cases above, because this policy is based on the destination IP address, the hash-algorithm always chooses the same route. These new policies can be configured globally on a per-system basis, or on a per-MPR set basis (each MPR set comprises a set of routes to a single destination network or host). The local setting takes precedence over the global setting when it is configured. The global configuration is provided through a new network option that can be viewed through the no command. The new option is called mpr_policy, which can be set to any value from 1 to 5, with each value corresponding to the numbers above for the policies. For more information about this option, see the no command documentation. To configure the policies on a per-MPR set basis (each MPR set comprises a set of routes to a single destination network or host) the policy can either be set during route creation or by using the route set command after the route has been created. For more information about this command, see the route command documentation and the examples below. The configuration information, such as the weight and policies currently used, can be viewed using the netstat -Cn command.
Examples
Example 1: Adding Multiple Routes with Different Weights: To add multiple routes with different weights, which are displayed as follows:
==> netstat -rn Destination Gateway Flags Refs Use If PMTU Exp Groups
Route tree for Protocol Family 2 (Internet): default 9.3.149.65 UGc 0 default 10.10.10.3 UGc 0
0 0
en0 en1
=>
Here are two default routes through two different gateways: 9.3.149.65 and 10.10.10.3. To configure weights and policies for these routes, as follows:
55
Flags
Wt
Policy
If
Cost Config_Cost
Route tree for Protocol Family 2 (Internet): default 9.3.149.65 UGc default 10.10.10.3 UGc
2 4
LUT -"-
en0 en1
0 0
0 => 0
Route 1 through 9.3.149.65 is configured with a weight of 2 and a policy corresponding to Lowest Utilization (4). Route 2 has a weight of 4. The policy information is per multipath routing set, not individual routes. To add route 1 and route 2, type the following commands:
route add default 9.3.149.65 -weight 2 -policy 4 route add default 10.10.10.3 -weight 4
Example 2: Changing Weight and Policy Information for Routes: To change weight and policy information for routes already created, use the following command:
route set
To change the weight and policy information of the default routes added in Example 1, type the following commands:
route set default 9.3.149.65 -weight 3 -policy 2 route set default 10.10.10.3 -weight 6
Flags
Wt
Policy
If
Cost Config_Cost
Route tree for Protocol Family 2 (Internet): default 9.3.149.65 UGc default 10.10.10.3 UGc
3 6
RND -"-
en0 en1
0 0
0 => 0
56
dscrctl Command
Purpose Allows the system administrator to read the current settings for the hardware streams mechanism and to set a system wide value for the Data Stream Control Register (DSCR). The Data Streams Control Register is privileged. It can be read or written only by the operating system. For more information on the Data Stream Control facilities, refer to the POWER Instruction Set Architecture V2.05 publicly available from http://www.power.org. Syntax To query the characteristics of the hardware streams on the system:
dscrctl -q
To set the operating system default prefetch depth on the system temporarily (i.e, for the current session) or permanently (i.e after each reboot):
dscrctl [-n] [-b] -s <dscr_value>
To cancel a permanent setting of the operating system default prefetch depth at boot time:
dscrctl -c
Description The dscrctl -q subcommand queries and displays the number of hardware streams, and the platform and operating system default prefetch depth. Any user can run this subcommand. The dscrctl -s subcommand sets the operating system default prefetch depth. It requires root authority to run. This default can be changed either for the current session (-n), at boot time (-b) or both (-n -b). The dscrctl -c option cancels the setting of the operating system default prefetch depth at boot time. This option removes the dscrctl command from the /etc/inittab file and thus takes effect after the next reboot. Flags -q -c -n -b Query: Display the number of hardware streams supported by the platform and the values of the firmware and operating system default prefetch depth. Cancel: Cancels a permanent setting of the system default prefetch depth at boot time by removing the dscrctl command from the /.etc/inittab file. Now: Used in conjunction with the -s flag, changes the runtime value of the operating system default prefetch depth. The change is not persistent across boot. Boot: Used in conjunction with the -s flag, makes change persistent across boots by adding a dscrctl command to the /etc/inittab file.
-s dscr_value Set: Defines the value for the new operating system default prefetch depth. The value is treated as a decimal number unless it starts with 0x in which case it is treated as hexadecimal. Examples
Appendix A. AIX 5L Version 5.3 changes
57
1. Set the value of the operating system default prefetch depth to 13 for the current session:
# dscrctl -n -s 13
58
Lightweight Infrastructure
The following AIX components rely on and incorporate Lightweight Infrastructure (LWI) v7.1: v Electronic Service Agent (eSA) v IBM Systems Director Console for AIX v Common Agent Services (CAS) Agent For information about licensing LWI v7.1, see the Program-unique Terms section of the AIX license information documentation.
59
60
2855 3DX (GXT550P), PCI/LONG/32BIT/3.3 OR 5V, GRAPHICS ADAPTER 2856 PCI/SHORT/32BIT/3.3 OR 5V, 7250 ATTACH ADAPTER 8242 10/100BASET ETHERNET PCI/SHORT/32BIT/5V v ISA adapters: 2647 VIDEO CAPTURE ENHANCEMENT, ISA/SHORT 2701 4 PORT SDLC, ISA/LONG, EIA 232/V.35/X.21 2931 8-PORT, ISA/LONG, EIA232 ADAPTER/FAN-OUT BOX 2932 8-PORT, ISA/LONG, EIA232/422 ADAPTER/FAN-OUT BOX 2933 128-PORT, ISA/LONG, EIA232 ASYNCH CONTROLLER 2961 1 PORT X.25, SDLC, PPP, ISA/LONG, ADAPTER (C1X) 2971 TOKEN RING ADAPTER, ISA 2981 ETHERNET ADAPTER, ISA, RJ45/BNC 8240 A/M 3COM ETHERNET ISA/SHORT TP ONLY 8241 A/M 3COM ETHERNET ISA/SHORT BNC/AUI v Non-CHRP Graphics Adapters: Gt3/Gt3i Gt4/Gt4e/Gt4i/Gt4x/Gt4xi GXT110P GXT150L/GXT150M/GXT150P GXT155L GXT500 GXT500D GXT500P
61
GXT800M GXT1000 MVP MULTIPCI Adapter S15 VIDEO OUTPUT OPTION (#3200) (FC 7254) 7250 ATTACH Adapter (FC 2856)
v Network Terminal Accelerator v The 9333 Serial Link DASD Subsystem v v v v v v devices.pci.331101e0 OpenGL.html.xx_XX PEX_PHIGS.html.xx_XX X11.html.xx_XX bos.html.xx_XX.adapt bos.html.xx_XX.cmds
62
v v v v v
63
64
65
66
Appendix D. Notices
This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the users responsibility to evaluate and verify the operation of any non-IBM product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Corporation Dept. LRAS/Bldg. 003 11400 Burnet Road Austin, TX 78758-3498 U.S.A. Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee. The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us. For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:
67
IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106, Japan IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products. Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.
Trademarks
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at Copyright and trademark information at www.ibm.com/legal/copytrade.shtml Java and all Java-based trademarks and logos are registered trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. Linux is a trademark of Linus Torvalds in the United States, other countries, or both. Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both. UNIX is a registered trademark of The Open Group in the United States and other countries. Other company, product, or service names may be trademarks or service marks of others.
68
Printed in U.S.A.
SC23-5201-08