TOPIC
This article contains the AIX 4.1.5 Read Me document.
DISCUSSION
IMPORTANT INFORMATION ABOUT AIX FOR THE APPLE NETWORK SERVER CONTENTS Information From Apple: 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. Information From Apple Computer, Inc.
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: KNOWN ISSUES The following is a list of the most visible user issues that were not fixed in this release. They are still candidates to be fixed and released as PTF's in the future. CRITICAL FIXES The following is a list of the most critical fixes included in this release of AIX. Many more issues of a less critical nature were also fixed and are part of this release also. The following post 4.1.5 fixes from IBM have also been included and will install as part of the Apple Server Bundle: NEW HARDWARE SUPPORT All models of the Network Server now include the following hardware enhancements: 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
AFP over TCP/IP. The capability of running AFP over TCP/IP will significantly improve the performance of file sharing with
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 issues 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: DRIVER AND OPERATING SYSTEM ENHANCEMENTS The following enhancements have been made: 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
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
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 Chapter10 of Using AIX, AppleTalk Services, and Mac OS Utilities on the Apple Network Server.
MONITOR ISSUES 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
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.
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,
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.
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
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 ISSUES The following guidelines will help eliminate or avoid Ethernet issues:
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
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 issue, 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 ->
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 ISSUES
A number of issues with keyboards utilizing a variety of language mappings have occurred. Try the following suggestions. If none of
Issues 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
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.
Issues 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 issue: 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.
Issues 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
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: 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. ----------------------------------------------------------------------
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
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
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 :
If you have not made any customizations to your desktop, if you do not have your home directory out in a networked environment,
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
If you have made customizations to your desktop action and data type definition files (*.dt) or to your front panel definition
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.
If you have customized your desktop actions, data types or front panel, or are planning on running the desktop with file
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 ISSUES 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 issues 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
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
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
To avoid having scripts affected by changes in widget size or position, record scripts using keyboard input wherever possible.
(*) 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
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,
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
|
Document Information | |
Product Area: | Computers |
Category: | Apple Network Server |
Sub Category: | General Topics; Network Server 500 & 700 |
Keywords: |
Copyright © 2000 Apple Computer, Inc. All rights reserved.