IMPORTANT INFORMATION ABOUT AIX FOR THE APPLE NETWORK SERVER ------------------------------------------------------------ CONTENTS -------- Information From Apple: - About the AIX Information From IBM - AIX 4.1.5 - Known Problems - Critical fixes - New Hardware Support - New AppleTalk Support - Disk Management Utility Enhancements - Driver and Operating System Enhancements - Shared Library Hookable Symbols - Safety Measures - Monitor Problems - Hardware Identification - The Network Server Diagnostic Utility - Interpreting the LCD - Printer Driver Installation - Ethernet Problems - Keyboard Problems - Open Firmware - Corrections Information from IBM: - Transitioning From Other AIX Systems - Moving From AIX 3.2 to the AIX Common Desktop Environment (CDE) - Moving From Any Version of AIX 4.1 to AIX CDE 1.0 - Moving From a Snapshot Version of CDE to AIX CDE 1.0 - In Case of Problems Running the AIX Common Desktop Environment - OSF/Motif Toolkit Widgets - National Language Support (NLS) Error Logging - System Dump - Note to InfoExplorer Users This document gives advice and information that supplements the information that appears in the manuals that came with your server. You may want to print a copy of this file and keep it with your manuals for future reference. Additional information is available at this location on the World Wide Web: http://www.solutions.apple.com INFORMATION FROM APPLE ----------------------- ABOUT THE AIX(*) INFORMATION FROM IBM ------------------------------------- The AIX Installation CD that includes this file also includes a number of separately-installable programs, known as licensed program packages, which also have Read Me files associated with them. To obtain a list of the Read Me files, enter this command: find /usr/lpp -name "*README*" -print The other Read Me files and the InfoExplorer database that's provided with the AIX operating system were written by IBM and include some hardware information as well as some installation and networking information that doesn't apply to the Network Server. For more information, see the manual "Using AIX, AppleTalk Services, and Mac OS Utilities on the Network Server." AIX 4.1.5 --------- The AIX for Apple Network Server accessory kit now includes AIX version 4.1.5. There are no human interface differences between this version and earlier Version 4 software. The new release is, however, faster and more reliable. In addition, the following software packages, which were not previously included with AIX for the Network Server, are now available with the current version: - bos.loc.utf Base System Locale UTF Code Set for Simplified Chinese - bos.pci PCI bus support - bos.powermgt Power Management Software - bos.som Distributed SOM Framework (DSOM) - xlC.cpp C for AIX Preprocessor - X11.x_st_mgr Xstation Manager - dce.client DCE Client Services - dce.compat DCE Compatibility with AIX 3.2 - dce.cds DCE Cell Directory Services - dce.dfs_server DCE DFS Base Server - ipfx Information Presentation Facility - ipx IPX and SPX Protocol Stacks KNOWN PROBLEMS -------------- The following is a list of the most visible user problems that were not fixed in this release. They are still candidates to be fixed and released as PTF's in the future. - The keyboard driver cannot be unloaded and then reloaded while the system is running; a reboot is required to make the keyboard available. - The 'chhwkbd' command is not fully supported. - The help information in 'rc.powerfail' doesn't apply to the Network Server. The correct information does appear in the error log and can be viewed by executing the following command... "errpt -a". - The 'smit' help file is incomplete for the Mammoth tape drive, it is missing information for the various tape densities supported by the drive. See the manufacturer's specifications for the correct values. - The Mylex RAID controller doesn't support non-zero SCSI LUN's. - The Mylex 'dacmgr' doesn't log events (e.g. drive failures, system drives offline, etc...) if the log window is closed. - If a Mylex RAID system drive is brought on-line through the intervention of 'dacmgr' (it was not on-line at system boot), AIX will NOT see it as available until after the next system reboot. - If the Xstation Manager package is installed, the Internet services BOOTP and TFTP are automatically configured. For systems which are NOT providing network services for X terminals, these services pose a security risk and Apple recommends disabling these services; see the file /etc/inetd.conf. CRITICAL FIXES -------------- The following is a list of the most critical fixes included in this release of AIX. Many more problems of a less critical nature were also fixed and are part of this release also. - The system will no longer crash if the Real Heap is set larger than the default. - I/O requests that hang due to a SCSI device that is no longer responding are now properly timed out and reported as an error. The code to bring the 'hung' device back on-line has been significantly re-written to improve the chances of a successful recovery. - Very 'dirty' ethernet segments could cause the on-board ethernet device to hang... this is no longer the case. - A new and improved version of PPP (from IBM) has been included. - This version of AIX fixes a memory leak triggered by heavy use of TCP/IP connections. - Under heavy FTP usage (lots of simultaneous connections), the system will no longer temporarily stop accepting new connections. - Heavy use of the Apache webserver may cause system crashes with AIX 4.1.4.1. This problem has been eliminated in AIX 4.1.5. - Multiple tape backups using the HP-DAT now work properly. - The fixes for the 'talkd', 'gethostbyname', "the ping of death" and the "SYN flood denial of service" problems (as reported by CERT) are included. - You can now increase the receive queue size for multiple ethernet adapaters without risking a system crash during the next system boot. The following post 4.1.5 fixes from IBM have also been included and will install as part of the Apple Server Bundle: - APAR IX62435...Paging I/O performance improvement - APAR IX62476...SYN flood denial of service - APAR IX62509...libc_r.a exports list is incorrect NEW HARDWARE SUPPORT -------------------- All models of the Network Server now include the following hardware enhancements: - Support has been added for the Seagate 2, 4 and 9 gigabyte hard drives and for 8x CD ROM drives. - Support has been added for external connection of Ultra-SCSI and differential devices to Symbios Logic PCI cards. - Ethernet performance and reliability have been improved. - Diaganostics have been added for both the on-board and PCI card ethernet devices. - PCI device driver binary compatibility has been substantially improved. - Common I/O support for FDDI, ATM, and Token Ring drivers has been added. - Support for both Spanish and Japanese keyboards has been added. NEW SOFTWARE FEATURES --------------------- The following software features have been added to the 4.1.5 software: SMP support. AIX 4.1 is designed to support SMP hardware platforms. The kernel is thread-based and core kernel extensions such as the file system and the network stacks already use fine-grained locks, and are therefore, MP-efficient. The AIX device driver model supports full parallelism in interrupt handling, supporting thread interrupt and interrupt-interrupt synchronization. Applications can take advantage of the parallelism provided by the base operating system by using the following kernel services: POSIX threads, the AIX processor affinity API, fast locks, semaphores and mutexes. Existing, traditional, multi-process applications also benefit from the SMP scalability. European localization. The installation CD-ROM includes AIX 4.1 localized message catalogs for French, German, Italian, Spanish, and other European languages. In addition, the French and Italian language versions include localalized versions of the messages Apple has added to support AppleTalk services, Apple devices and other Apple specific functionality. NEW APPLETALK SUPPORT --------------------- Multi-homing. Multi-homing now supports multiple AppleTalk networks without routing. Multi-homing is enabled from the Advanced Features section of the AppleTalk SMIT menu. Functionally, multi-homing means that when you register a service in the default zone ,"*", the service is registered once in the default zone for each configured network interface and shows up once in each of those zones. If no default zone is chosen, multi-homing does not come up. The user is prompted to specify a default zone for each configured network interface. Multi-zone registration allows the user to specify any local zone on any running interface. You can register as many services in as many local zones as there are, and they can all run at the same time. The default zone on any one interface cannot be the default zone on another interface. In addition, each port must have a router connected to it, otherwise AppleTalk won't start up. AFP over TCP/IP. The capability of running AFP over TCP/IP will significantly improve the performance of file sharing with clients that support this protocol, since network communication over TCP/IP is inherently faster than over AppleTalk due to the larger transmission packet size. The appropriate version of the AppleShare Client needs to be installed on the client machine in order to take advantage of this feature. Appletalk encapsulation in TCP/IP. IP tunneling provides the capability to route AppleTalk packets over the Internet using TCP/IP protocols, i.e., by encapsulating AppleTalk packets inside UDP packets before sending them over a TCP/IP network. This implementation follows the AppleTalk Update- based Routing Protocol (AURP) specification (AppleTalk routing over wide-area netorks), making it interoperable with Apple's Internet Router 3.0 product. Some users reported system hangs while printing over AppleTalk, particularly with the Apple LaserWriter Pro 810. These problems have been corrected, as have system crashes associated with the ADSP stack. In addition, support for AppleTalk over FDDI has been added. DISK MANAGEMENT UTILITY ENHANCEMENTS ------------------------------------ The following enhancements have been made to the Disk Management Utility: - The striped popup item in the logical volume allocation view has been disabled - File systems can no longer be created that exceed the total size of the logical volume group - The maximum number of logical partitions increases automatically when necessary - The Mirror Write Consistency Check now works properly - Log volumes for newly created files systems are displayed DRIVER AND OPERATING SYSTEM ENHANCEMENTS ---------------------------------------- The following enhancements have been made: - Write-behind I/O scheduling now works properly for all cases of sequential access - The Network System will not boot if a fan has failed - The serial driver now supports character sizes smaller than 8 bits - The output of the lscfg command no longer includes an entry for the "cpucard" as it did in the previous release. - The tagged command queue depth has been increased to 8 for those SCSI devices that support it. SHARED LIBRARY HOOKABLE SYMBOLS ------------------------------- Apple's AIX Installation CD-ROM includes support for an extra feature known as Shared Library Hookable Symbols (SLHS). The SLHS support is required by some third-party applications. The contents of the slhs.rte.obj fileset have been made part of the fileset which contains the standard libraries. The slhs.dev.obj fileset should be obtained from IBM. To use the slhs.dev.obj fileset to develop applications which use this Shared Library Hookable Symbols support, it is necessary to run the SLHS compiler setup script, /usr/lpp/slhs/etc/svCompSetup. Please read the manual page on svCompSetup for a detailed explanation by running the command 'man svCompSetup'. SAFETY MEASURES --------------- The following safety measures will help you safeguard your data and the Network Server itself. Power off before adding drives Unless you have installed and are using the Network Server PCI RAID Disk Array card, always shut down the server and turn power off before replacing or adding drives. For more information about adding drives with RAID, check the Network Server PCI RAID Disk Array Card Administrator's Guide. Replace only one drive at a time Do not insert multiple drive trays into the front drive bays at the same time. Ensure proper ventilation To ensure maximum airflow and cooling, don't leave any drive trays out or panels open while running the server. Exit properly from Installation Assistant After completing installation, be sure to click Exit to exit Easy Install, then click Tasks Completed/Exit to AIX Login. If you fail to exit in this manner, certain system parameters, such as paging space, may not be configured correctly. Check applications after reinstallation If you reinstall AIX for the Network Server from the CD, you may need to reinstall some or all of your server applications. When reinstalling, be sure to check the information that came with your server application software. Always unmount CD-ROM discs before removing them For instructions on mounting and unmounting CD-ROM discs, see Using AIX, AppleTalk Services, and Mac OS Utilities on the Network Server. Never use alcohol-style cleaning cartridges for tape drives. Always use Apple-approved cleaning cassettes or cartridges. Avoid running out of paging space. If paging space is inadequate, you may see the following error messages: No more processes killed You may also unexpectedly log out. Use the following command to check paging space: lsps -a You can increase paging space with the Install Assistant. For more information, see "Using System Administration Tools", Chapter 6 of Using AIX, AppleTalk Services, and Mac OS Utilities on the Apple Network Server. If you have inadvertently logged out and cannot restart from your hard disk, you can restart in maintenance mode. See the section "Booting from Maintenance Mode", in Chapter 10 of Using AIX, AppleTalk Services, and Mac OS Utilities on the Apple Network Server. MONITOR PROBLEMS ---------------- If your Network Server does not display data correctly, make sure that the monitor is compatible. The Network Server requires a monitor with multiple scan support, and many older monitors will not work. If the monitor is compatible (i.e. capable of multiple scan mode), and you are experiencing "rolling" video, do the following: 1. Boot in maintenance mode. Follow the instructions in "Booting from Maintenance Mode", in Chapter 10 of Using AIX, AppleTalk Services, and Mac OS Utilities on the Apple Network Server. 2. Select an appropriate video resolution and refresh rate. HARDWARE IDENTIFICATION ----------------------- There are a number of hardware identification details that you should be aware of. The serial I/O ports are labeled s1 and s2 on the system back panel; the AIX software numbers these ports as sa1 and sa0, respectively. This is the reverse of the relationship on IBM systems with native serial I/O support. As with all adapters, the numbering of the associated ttys depends on the order in which the ttys are configured. During installation, you can define the console with a terminal connected to the serial I/O port labeled s1. Quantum 1 GB and 1.2 GB hard drives are identified by SMIT and other device commands as type 'other' instead of 1.0 (or 1.2) GB disk drives. THE NETWORK SERVER DIAGNOSTIC UTILITY ------------------------------------- You can use the Diagnostic Utility to verify the hardware configuration and run a variety of system tests. For more information, see the Read Me file on the Network Server Diagnostic Utility floppy disk, or check the information available through the Network Server button at this World Wide Web site: http://www.solutions.apple.com INTERPRETING THE LCD -------------------- The liquid crystal display (LCD) screen on the Network Server displays a series of values while the Network Server starts up. These values are explained in the following table. Value Meaning ----- ------- 510 The system has started the configuration manager. 511 The configuration manager has completed. 517 The system is attempting to mount the / (root) and /usr file systems. 538 The configuration manager is calling a configuration method. 539 The configuration method has completed. 551 The system is attempting to varyon the root volume group. 553 The system has completed phase one of the boot process. 591 The system is configuring the Logical Volume Manager (LVM). 593 The system is configuring the low-function graphics terminal. 594 The system is configuring the rendering context manager. 704 The system is configuring a SCSI disk drive. 723 The system is configuring a CD-ROM or other SCSI device. 727 The system is configuring an asynchronous device. 731 The system is configuring a pseudo TTY. 811 The system is configuring the system planar (motherboard). 812 The system is configuring the standard I/O adapter. 814 The system is configuring the NVRAM. 821 The system is configuring the standard keyboard adapter. 823 The system is configuring the standard mouse adapter. 826 The system is configuring serial port 1. 828 The system is configuring the standard floppy disk adapter. 831 The system is configuring serial port 2. 868 The system is configuring the integrated SCSI adapter. 874 The system is configuring the graphics subsystem adapter. 890 The system is configuring a SCSI-2 adapter. 921 The system is configuring a keyboard. 925 The system is configuring a mouse. 935 The system is configuring a 3.5-inch diskette drive. PRINTER DRIVER INSTALLATION --------------------------- The Easy Install procedure detailed in Using AIX, AppleTalk Services, and Mac OS Utilities on the Apple Network Server does not install all the printer drivers that some users may need. If the drivers you require are not installed, the steps that follow will install them. Important: Before proceeding with the installation, be sure that you are logged in as root and that the AIX Installation CD-ROM disc is inserted in the Network Server. 1. Type smit install and then press Return at the prompt in a terminal window. The installation utility opens. 2. Click the Install and Update Software checkbox. A software installation screen appears. 3. Click the Install and Update Selectable Software (Custom Install) checkbox. The custom install screen appears. 4. Click the Install Additional Printer/Plotter Software checkbox. A dialog box opens, asking you to specify the software source. 5. Type /dev/cd0 and press Return. You can also click the List button (or press F4) and choose /dev/cd0 from the list that appears. The Install Additional Printer/Plotter Software screen appears. 6. Click the List checkbox next to Software to Install. A popup list appears. 7. Select the printer drivers you want to install by clicking their names in the popup list that opens. If you want to select all printer drivers, click All @@ printers 8. Click OK. The Install Additional Printer/Plotter Software screen reopens. 9. Click OK. A confirmation dialog box appears. 10. Click OK. The installation process begins. 11. When installation is complete, click Done. 12. Choose Exit SMIT from the Exit menu to return to the Common Desktop Environment. ETHERNET PROBLEMS ----------------- The following guidelines will help eliminate or avoid Ethernet problems: Connect an Apple PCI Ethernet card to only one network at a time Although the card has three connectors, it should not be connected to more than one network. Do not install an Apple PCI Ethernet card without connecting a network cable If you configure an Apple PCI Ethernet Card by assigning it an IP address or by enabling the AppleTalk stack on it, the card attempts to determine which of the three possible media types is connected to it. If you have not connected a network cable, you will hear clicking sounds every few seconds. These clicking sounds will continue until the cable is connected. Although this should cause no serious problems, the lack of a cable may cause long pauses during system booting, as the system attempts to contact other servers on the network. Installing Ethernet cards for best performance For maximum performance, always install Ethernet cards from the bottom slot up; slot 6 before slot 5, and so on. Accessing Printers or Zones with Apostrophes in Their Names ----------------------------------------------------------- The AIX System Management Interface Tool (SMIT) prevents you from selecting an AppleTalk printer if the printer name or the zone name contains an apostrophe. To solve this problem, do this: 1. Log in as root This gives you the necessary write permission to the /etc/atalk directory. 2. Determine the printer name and zone name for the printer. You can view the zone name and printer name by using the SMIT menu path Communications -> AppleTalk -> AppleTalk Services -> AppleTalk Printing -> Change or Select AppleTalk Printer Settings, then click the List button. Do NOT click OK to run the command. 3. At the command line, enter this command: /usr/sbin/at_printer_cfg "zone" "printer" Replace "zone" and "printer" with the correct zone and printer from step 2. Be sure to include the double quotes. The system displays a message stating that this printer is now the default printer. KEYBOARD PROBLEMS ----------------- A number of problems with keyboards utilizing a variety of language mappings have occurred. Try the following suggestions. If none of them solves the problem, contact Apple support for more information. See the Apple support brochure in your accessory kit. Problems using standard keyboards --------------------------------- It is sometimes possible to use a standard Apple keyboard with the Network Server, using the upper row of keys on the numerical keyboard to stand for the first four function keys, as described in Using AIX, AppleTalk Services, and Mac OS Utilities on the Apple Network Server. This method does not work for all languages. Important: It is strongly recommended that you use an Apple Extended Keyboard or an equivalent third-party keyboard with all models of the Network Server. For more information on keyboard mapping, see the AIX Technical Reference, available through InfoExplorer. Problems with number keys ------------------------- The number keys in most keyboards require you to press only the number key itself to type the number, with the shift key also pressed to type the second symbol, such as * or ^. Other keyboard maps, however, use the opposite scheme, requiring you to press the shift key when typing a number. If this is the case, you may encounter occasional conflicts. To solve the problem: 1. Press the number lock key on the numerical keypad on the right of the keyboard. 2. Enter all numbers from the numerical keyboard. For more information on keyboard mapping, see the AIX Technical Reference, available through InfoExplorer. Problems generating third symbols on keys ----------------------------------------- Apple keyboards include no more than two symbols on keys, while some IBM keys have three. To generate the third symbol, hold down the Alternate Graphic (AltGr) key while pressing the key you need. The AltGr key is always in position 60 and 62 on the keyboard, on either side of the space bar. On Apple keyboards, it is the Apple or Command key. For more information on keyboard mapping, see the AIX Technical Reference, available through InfoExplorer. OPEN FIRMWARE ------------- Open Firmware can be used to set basic Network Server parameters and for some diagnostic procedures. To boot the system into Open Firmware, restart the server while holding down these keys: COMMAND-OPTION-O-F You can use the following commands while in Open Firmware: printenv Lists the current (left column) and default (right column) values for all the Open Firmware variables. set-defaults Sets all the Open Firmware variables to their default values. setenv variable value Sets the Open Firmware variable to the value listed. Note that some variable changes take effect immediately, others only after rebooting. This sets the input device to serial port 'a' at 9600 baud: setenv input-device ttya:9600 This sets the output device to serial port 'a' at 9600 baud: setenv output-device ttya:9600 This sets the input device to the attached ADB keyboard: setenv input-device kbd This sets the output device to an attached monitor: setenv output-device screen probe-scsi0 Lists all the devices connected to the external SCSI bus. probe-scsi1 Lists all the devices connected to the first (top) internal SCSI bus. probe-scsi2 Lists all the devices connected to the second (bottom) internal SCSI bus. password Sets the Open Firmware password. By default the Open Firmware password is the same as the AIX root password. If you change the Open Firmware password, then changing the AIX password no longer changes the Open Firmware password. boot When the front key on the server is turned to the upright (normal) or right (locked) position, the server boots from the device listed as boot-device. When the front key is turned to the left (service), the server boots from the device listed as diag-device. shut-down Turns off server power. reset-all Reboots the server and forces changed variables into effect. .keyswitch (Note the leading period.) Reports the position of the front keyswitch (service, normal, or locked). Open Firmware Password ---------------------- If you forget the Open Firmware password, do this: 1. Turn the front key to the left (service) position. 2. Reboot the system, and then immediately hold down the following key combination: COMMAND-OPTION-P-R This resets the parameter RAM (PRAM). 3. Reboot the system in maintenance mode. See Chapter 10 of Using AIX, AppleTalk Services and Mac OS Utilities on the Network Server. 4. Reset the system date. 5. Reset the AIX root password to null. When you reassign an AIX password, the Open Firmware password will be the same. CORRECTIONS ----------- The following are corrections to the information in Using AIX, AppleTalk Services, and Mac OS Utilities on the Apple Network Server. - In Chapter 4, page 48, the manual provides the following incorrect command for starting the Common Desktop Environment: xinit /usr/dt/bin/dtsession The correct command is: xinit /usr/dt/bin/Xsession - On page 86, the keystroke esc-esc should be just esc. - On page 87, in the second table, in the description for "Return or Enter", the phrase "...advances to the next field," should read "...goes back to the first field." (C) 1996 Apple Computer, Inc. All rights reserved. Apple, the Apple logo, AppleTalk, Macintosh and Mac are trademarks of Apple Computer, Inc., registered in the United States and other countries. (*) AIX is a registered trademark of IBM Corp. and is being used under license. ---------------------------------------------------------------------- INFORMATION FROM IBM --------------------- TRANSITIONING FROM OTHER AIX SYSTEMS ------------------------------------ The remainder of the information in this Read Me file is from IBM. Much of it applies only if you already have other, older AIX systems and want to copy configuration information from those other AIX systems to the Network Server. Moving from AIX 3.2 or AIX 4.1 to the AIX Common Desktop Environment (CDE): AIX Common Desktop Environment (AIX CDE) is the default desktop shipped with AIX 4.1.4. AIXwindows Desktop is the default desktop shipped with AIX 3.2, 4.1.0,4.1.1 and 4.1.2. If you have previously logged onto the AIXwindows desktop on AIX 4.1.0, 4.1.1 or 4.1.2, online help assists you in migrating to AIX CDE 1.0 from the AIXwindows Desktop. This help appears automatically the first time you log onto AIX CDE 1.0 You can also view this online help by selecting "Welcome to AIX CDE 1.0" from the Help Manager subpanel. NOTE: A minimum of 64 MB of paging space is required to run AIX CDE. Moving from AIX 3.2 to the AIX Common Desktop Environment (CDE): Here's what you need to do in order to move from any version of AIX 3.2 to AIX CDE 1.0 : If you have not customized the AIXwindows desktop, you do not need to take any action. If you had customized the AIXwindows desktop, you can use the xdt2cde migration tool to move X.desktop objects from the AIXwindows version 3.2 desktop to the new graphical Common Desktop Environment desktop syntax. This migration tool also converts XPM2 pixmaps to XPM3 pixmaps. To start the xdt2cde migration tool: 1. Click the Application Manager control from the Front Panel. 2. Click the Desktop_Tools icon. 3. Click the Migration Tool icon. Online help is provided for the xdt2cde migration tool. In addition, you can order AIXwindows to CDE Migration Guide (SC23- 2531). Moving from Any Version of AIX 4.1 to AIX CDE 1.0: AIX 4.1.4 changes some action, data type and front panel definitions provided with previous releases of AIX 4.1. Here's what you need to do in order to move from any version of AIX 4.1 to AIX CDE 1.0 : o If you have not made any customizations to your desktop, if you do not have your home directory out in a networked environment, and if you do not mount a file system containing action, data type and front panel definition files, you do not need to make any changes. The X11.Dt.compat fileset should be installed to aid in the transition from AIXwindows Desktop on AIX 4.1 to the AIX CDE 1.0 desktop. This fileset contains executables, icons, action and data type definitions and symbolic links to maintain compatibility with previous versions of the CDE desktop. This fileset also contains the Migrate Actions icon and its associated action definition. The "Welcome to AIX CDE 1.0" help volume contains additional information about the contents of this fileset. This fileset can be deinstalled later when you no longer have a need for the files contained within it. o If you have made customizations to your desktop action and data type definition files (*.dt) or to your front panel definition files (*.fp) or installed icons on the front panel, you need to migrate these changes to the new desktop using Migrate Actions (dtmigrate). To start dtmigrate: 1. Click the Application Manager control from the Front Panel. 2. Click the Desktop_Tools icon. 3. Click the Migrate Actions icon. o If you have customized your desktop actions, data types or front panel, or are planning on running the desktop with file systems that contain action, data type or front panel definitions and the Calendar resource file (.desksetdefaults) shared between an AIXwindows Desktop on AIX 4.1.1 or 4.1.2 and an AIX Common Desktop Environment on AIX 4.1.4, you must take special action. See the "Welcome to AIX CDE 1.0" help for details. Moving from a Snapshot Version of CDE to AIX CDE 1.0: If you have installed a "snapshot version" of the Common Desktop Environment and are migrating to AIX Version 4.1.4 installing AIX CDE 1.0, remove the /etc/dt and /var/dt directories before installing AIX Version 4.1.4. While some customizations made in $HOME/.dt will still work unmodified, it is also recommended that the .dt directory be renamed to .dt.old prior to logging in to CDE 1.0. NOTE: A "snapshot version" of CDE was distributed to select customers in April, 1994 and runs with AIX 3.2.5 only. IN CASE OF PROBLEMS RUNNING THE AIX COMMON DESKTOP ENVIRONMENT -------------------------------------------------------------- If, after migrating to AIX CDE 1.0 from AIXwindows desktop on AIX 4.1.1 or 4.1.2, you have problems with the desktop (for example, icons on the front panel do not execute properly, icons are missing, or actions can not be found), check that the following has been done: 1. The X11.Dt.compat fileset has been installed 2. Action, data type and front panel definitions in personal directories have been migrated to a valid format for AIX CDE 1.0. The "Welcome to AIX CDE 1.0" help volume contains information about these steps and other useful information to aid in the transition to AIX CDE 1.0. OSF/MOTIF TOOLKIT WIDGETS ------------------------- When upgrading to AIX Version 4.1.4 from AIX Version 3.2.5, the OSF/Motif(*) toolkit widgets will have some slight changes in appearance, size, and shape. Any automated test tool that records and replays X mouse movements to simulate user input may fail as a result of these changes, and may have to be recalibrated to function correctly on AIX Version 4.1.4. To avoid having scripts affected by changes in widget size or position, record scripts using keyboard input wherever possible. Further changes of widget size or appearance will occur as a result of software upgrades, since the current Motif standard does not contain detailed descriptions of widget size or appearance. (*) Open Software Foundation, OSF, OSF/Motif and Motif are trademarks of Open Software Foundation, Inc. NATIONAL LANGUAGE SUPPORT (NLS) ERROR LOGGING --------------------------------------------- If you run the errpt command and get a 4 digit hex value where you should get message text, this means that the message number for that message was not found in your language's codepoint catalog. If you set LANG=C before running the errpt, English text is displayed for the bad message(s). SYSTEM DUMP ----------- There is a new item on the System Dump SMIT menu called Always Allow System Dump. The value defaults to false. If set to true, the cntl-alt-numpad1 and cntl-alt-numpad2 key sequences work with the key in normal or service position. These key sequences are used to start a system dump to the primary and secondary dump devices, and formerly always required the key to be in the service position. A flashing 888 on the LCD panel indicates a system dump. To set the system so that it automatically restarts after a crash: 1. Log in as root. 2. In SMIT, choose System Environments. 3. Choose Change / Show Characteristics of Operating System. 4. Set the "Automatically REBOOT system after a crash" attribute to true. You can also set this attribute by logging in as root and entering this command: chdev -a 'autorestart=true'-l sys0 NOTE TO INFOEXPLORER USERS -------------------------- If you try to read a CD with more than 64 InfoExplorer databases (for example IBM's May 95 Technical Library CD), InfoExplorer may core dump. To prevent a core dump, enter this command before running InfoExplorer: export MALLOCTYPE=3.1 (C) International Business Machines Corp. 1990, 1994 All Rights Reserved Licensed Materials - Property of IBM