DB2 Version 8.1.4t Readme Contents 1) Readme for IBM(R) DB2 Universal Database(TM) Version 8.1.4t for AIX(R), Solaris Operating Environments, HP-UX 11i, HP-UX 11i v2, and Linux 1a) About this readme 1b) Who should read this readme file 1c) How to get help 1c.i) IBM FTP server 1d) PTF and VRMF information 1e) Supported products and components by operating system 1f) Prerequisites 1g) Updated patch levels -- servers 1h) Updated patch levels -- clients 1i) Prior to installing DB2 Version 8.1.4t 1i.i) Setting up Version 8.1.4t (Solaris Operating Environments, AIX 4.3.3, and AIX 5L) 1i.ii) Data Warehouse functionality (Linux, AIX, and Solaris Operating Environments) 1j) Installing DB2 Version 8.1.4t 1k) Installation of a FixPak or a modification level from a directory path 1l) Applying a FixPak or a modification level for Data Links Manager (AIX) 1m) Applying a FixPak or a modification level for Data Links Manager (Solaris Operating Environments) 1n) After installation 1n.i) Updating instances to use the new level of DB2 1n.ii) Restarting the instances 1n.iii) Re-binding bind files 1n.iv) Uninstalling FixPaks or modification levels on Linux or UNIX 1o) Known problems and workarounds (Version 8.1.4t) 1o.i) DB2 for AIX 4.3.3 and 5.1 and above requires AIX C++ Version 6 Runtime 1o.ii) Limitations of 64-bit server instances 1o.iii) Recommended application server for deploying DB2 Web Tools 1o.iv) New registry variable for Version 8.1.4t 1p) Known problems and workarounds (prior to Version 8.1.4t) 1p.i) DB2 Setup Wizard appears not to run using Exceed (Linux) 1p.ii) Creating the Tools Catalog database not supported on AIX, Solaris, and HP-UX 1p.iii) IBM Developer Kit for Java 1.3.1 required on Linux (x86, 32-bit) 1p.iv) DB2 Data Links Manager installation when DB2 Enterprise Server Edition already installed 1p.v) Loss of Control Center functionality 1p.vi) Controlling login restrictions of a connecting user on an AIX server 2) Notices 1) Readme for IBM(R) DB2 Universal Database(TM) Version 8.1.4t for AIX(R), Solaris Operating Environments, HP-UX 11i, HP-UX 11i v2, and Linux 1a) About this readme DB2 Version 8.1.4t is a modification level, not a FixPak. FixPaks are fix-oriented ship vehicles delivering mainly fixes to DB2 installations and have the designation FixPak x. Modification levels are feature-oriented ship vehicles delivering mainly new features to DB2 installations and have the designation 8.1.x. DB2 Version 8.1.4t is the fourth ship vehicle for DB2 Version 8. Previous ship vehicles include: Version 8 FixPak 1, Version 8.1.2, Version 8 FixPak 3, and now Version 8.1.4t. All ship vehicles are cumulative in nature. Set the font to monospace to better view this file. Note: If you have received special fixes from IBM support, you must contact IBM support before you install DB2 Version 8.1.4t to check if you need an updated version of the special fixes. This helps ensure that your system is in a consistent state and that no special fixes are lost. 1b) Who should read this readme file The information in this readme file should be read by database administrators who plan to upgrade their earlier level of DB2(R) Version 8 to Version 8.1.4t. This readme file contains operating system specific information about the latest changes and known problems and workarounds for DB2 UDB. This readme file contains DB2 Version 8.1.4t information for all Linux and UNIX(R) operating systems supported by DB2 Version 8. Specific information for each supported operating system is described in separate sections of this readme. Unless otherwise specified, the instructions are applicable to all supported operating systems. Users of DB2 Information Integrator can access the latest information at http://www.ibm.com/software/data/integration/db2ii, including product documentation and product Release Notes. 1c) How to get help Web-based support for DB2 products, including documentation, and APAR information is provided at * http://www.ibm.com/software/data/db2/udb/winos2unix/support The main Usenet newsgroup for DB2 product-related questions is comp.databases.ibm-db2. To contact DB2 Customer Service by phone: * In the United States, call 1-800-237-5511. * In Canada, call 1-800-IBM-SERV (426-7378). * Worldwide, call 1-404-238-1234 (charges may apply). For information on IBM offices in your country or region, consult the IBM Directory of Worldwide Contacts at http://www.ibm.com/planetwide For additional information about changes to the product, review the product Release Notes after you have installed DB2 Version 8.1.4t: AIX | /usr/opt/db2_08_01/Readme/%L/Release.Notes -----------------------+--------------------------------------------- HP-UX, Linux, and | /opt/IBM/db2/V8.1/Readme/%L/Release.Notes Solaris Operating | Environment | where %L represents the locale name. You can also view the latest product Release Notes without installing DB2 Version 8.1.4t by going to the DB2 Support Web site: * http://www.ibm.com/software/data/db2/udb/winos2unix/support Note: 1. You can review the Release Notes directly from the DB2 Version 8.1.4t CD-ROM without either installing them or going to the IBM Web site. The Release Notes can be found at /doc/%L/db2ir/index.htm, where %L represents the locale name. 2. The DB2 Information Integrator Version 8 Release Notes are located at http://www.ibm.com/software/data/integration/db2ii. 3. The DB2 Query Patroller Release Notes are located at http://www-3.ibm.com/cgi-bin/db2www/data/db2/udb/winos2unix/support/v8pubs_trans.d2w/report. 1c.i) IBM FTP server DB2 Version 8.1.4t can be downloaded from the IBM anonymous FTP server at ftp.software.ibm.com. Go to ps/products/db2/fixes/%L/peoplesoft/v81fp4t where: * %L represents the appropriate locale; for example, english-us, spanish, german. Supported languages for DB2 clients available from the FTP site The following table details the supported languages for DB2 clients that are available from the FTP site. +---------+----------------------+-------------------------+---------+ | Operati | DB2 Administration | DB2 Application | DB2 | | ng | Client | Development Client | Run-Tim | | System | | | e | | | | | Client | +---------+----------------------+-------------------------+---------+ | AIX 5L | * SBCS (English, | * SBCS (English, | All | | (32- | Brazilian | Brazilian Portuguese, | support | | and | Portuguese, Danish, | Danish, Finnish, | ed | | 64-bit) | Finnish, French, | French, German, | languag | | | German, Italian, | Italian, Norwegian, | es are | | | Norwegian, Spanish, | Spanish, and Swedish) | in one | | | and Swedish) | * DBCS (English, | tarred | | | * DBCS (English, | Japanese, Korean, | file | | | Japanese, Korean, | Simplified Chinese, and | | | | Simplified Chinese, | Traditional Chinese) | | | | and Traditional | | | | | Chinese) | | | +---------+----------------------+-------------------------+---------+ | HP-UX | All supported | All supported languages | All | | 11i | languages are in one | are in one tarred file | support | | (32- | tarred file | | ed | | and | | | languag | | 64-bit) | | | es are | | | | | in one | | | | | tarred | | | | | file | +---------+----------------------+-------------------------+---------+ | Linux | All supported | All supported languages | All | | | languages are in one | are in one tarred file | support | | | tarred file | | ed | | | | | languag | | | | | es are | | | | | in one | | | | | tarred | | | | | file | +---------+----------------------+-------------------------+---------+ | Solaris | All supported | All supported languages | All | | Operati | languages are in one | are in one tarred file | support | | ng | tarred file | | ed | | Environ | | | languag | | ments | | | es are | | | | | in one | | | | | tarred | | | | | file | +---------+----------------------+-------------------------+---------+ | Windows | All supported | All supported languages | All | | (R) | languages are in one | are in one | support | | | self-extracting zip | self-extracting zip | ed | | | file | file | languag | | | | | es are | | | | | in one | | | | | self-ex | | | | | tractin | | | | | g zip | | | | | file | +---------+----------------------+-------------------------+---------+ 1d) PTF and VRMF information The following table details the PTF and VRMF information. +-----------------------+----------------------+----------------------+ | Operating system | PTF | VRMF | +-----------------------+----------------------+----------------------+ | AIX 5 | U497250_10649 | 8.1.1.42 | +-----------------------+----------------------+----------------------+ | Solaris Operating | U497251_10651 | 8.1.0.43 | | Environment | | | +-----------------------+----------------------+----------------------+ | HP-UX 11i | U497252_10650 | 8.1.0.42 | +-----------------------+----------------------+----------------------+ | HP-UX 11i v2 | U497253_10656 | 8.1.0.41 | +-----------------------+----------------------+----------------------+ | LINUX (x86, 32-bit) | MI00075_10652 | 8.1.0.41 | +-----------------------+----------------------+----------------------+ | Documentation | U488489 | n/a | +-----------------------+----------------------+----------------------+ 1e) Supported products and components by operating system This readme file contains information for the following products and components for each Linux and UNIX operating system: AIX(R) 5L (32-bit and 64-bit) Product list: * DB2 Administration Client, Version 8 * DB2 Application Development Client, Version 8 * DB2 Connect Application Server Edition, Version 8 * DB2 Connect Enterprise Edition, Version 8 * DB2 Connect Enterprise Unlimited Edition, Version 8 * DB2 Cube Views, Version 8 * DB2 Data Links Manager, Version 8 * DB2 HTML Documentation, Version 8 * DB2 Information Integrator Non-Relational Wrappers, Version 8 * DB2 Information Integrator Relational Wrappers, Version 8 * DB2 PDF Documentation, Version 8 * DB2 Query Patroller, Version 8 * DB2 Run-Time Client, Version 8 * DB2 Spatial Extender, Version 8 * DB2 UDB Enterprise Server Edition, Version 8 * DB2 UDB Workgroup Server Edition, Version 8 * DB2 UDB Workgroup Server Unlimited Edition, Version 8 * DB2 Warehouse Manager, Version 8 * DB2 Warehouse Manager Connectors, Version 8 HP-UX(TM) 11i (32-bit and 64-bit) Product list: * DB2 Administration Client, Version 8 * DB2 Connect Application Server Edition, Version 8 * DB2 Connect Enterprise Edition, Version 8 * DB2 Connect Unlimited Edition, Version 8 * DB2 HTML Documentation, Version 8 * DB2 Information Integrator Non-Relational Wrappers, Version 8 * DB2 Information Integrator Relational Wrappers, Version 8 * DB2 Query Patroller, Version 8 * DB2 PDF Documentation, Version 8 * DB2 Run-Time Client, Version 8 * DB2 Spatial Extender, Version 8 * DB2 UDB Enterprise Server Edition, Version 8 * DB2 UDB Workgroup Server Edition, Version 8 * DB2 UDB Workgroup Server Unlimited Edition, Version 8 HP-UX(TM) 11i v2 (64-bit) Product list: * DB2 Administration Client, Version 8 * DB2 Connect Application Server Edition, Version 8 * DB2 Connect Enterprise Edition, Version 8 * DB2 Connect Unlimited Edition, Version 8 * DB2 HTML Documentation, Version 8 * DB2 Information Integrator Non-Relational Wrappers, Version 8 * DB2 Information Integrator Relational Wrappers, Version 8 * DB2 Query Patroller, Version 8 * DB2 PDF Documentation, Version 8 * DB2 Run-Time Client, Version 8 * DB2 Spatial Extender, Version 8 * DB2 UDB Enterprise Server Edition, Version 8 * DB2 UDB Workgroup Server Edition, Version 8 * DB2 UDB Workgroup Server Unlimited Edition, Version 8 Linux(TM) (x86, 32-bit) Product list: * DB2 Administration Client, Version 8 * DB2 Application Development Client, Version 8 * DB2 Connect Application Server Edition, Version 8 * DB2 Connect Enterprise Edition, Version 8 * DB2 Connect Personal Edition, Version 8 * DB2 Connect Unlimited Edition, Version 8 * DB2 Cube Views, Version 8 * DB2 HTML Documentation, Version 8 * DB2 Information Integrator Non-Relational Wrappers, Version 8 * DB2 Information Integrator Relational Wrappers, Version 8 * DB2 PDF Documentation, Version 8 * DB2 Query Patroller, Version 8 * DB2 Run-Time Client, Version 8 * DB2 Spatial Extender, Version 8 * DB2 UDB Enterprise Server Edition, Version 8 * DB2 UDB Express, Version 8 * DB2 UDB Personal Edition, Version 8 * DB2 UDB Workgroup Server Edition, Version 8 * DB2 UDB Workgroup Server Unlimited Edition, Version 8 * DB2 Warehouse Manager, Version 8 Solaris(R) Operating Environments (32-bit and 64-bit) Product list: * DB2 Administration Client, Version 8 * DB2 Application Development Client, Version 8 * DB2 Connect Application Server Edition, Version 8 * DB2 Connect Enterprise Edition, Version 8 * DB2 Connect Unlimited Edition, Version 8 * DB2 Cube Views, Version 8 * DB2 Data Links Manager, Version 8 * DB2 HTML Documentation, Version 8 * DB2 Information Integrator Non-Relational Wrappers, Version 8 * DB2 Information Integrator Relational Wrappers, Version 8 * DB2 PDF Documentation, Version 8 * DB2 Query Patroller, Version 8 * DB2 Run-Time Client, Version 8 * DB2 Spatial Extender, Version 8 * DB2 UDB Enterprise Server Edition, Version 8 * DB2 UDB Workgroup Server Edition, Version 8 * DB2 UDB Workgroup Server Unlimited Edition, Version 8 * DB2 Warehouse Manager, Version 8 * DB2 Warehouse Manager Connectors, Version 8 If you add new components after you install DB2 Version 8.1.4t, you need to reinstall DB2 Version 8.1.4t to ensure that the newly added components are updated. 1f) Prerequisites Ensure you have reviewed the software, hardware, and operating system requirements. See the Updated patch levels section and the Release Notes for the latest information. * You must have a DB2 product Version 8 installed at a lower VRMF level than DB2 Version 8.1.4t before installation. * Ensure that you have read the entire contents of this readme. To determine if the required prerequisites are installed, issue the appropriate command for your operating system to display information about the currently installed version of DB2. +--------+-------------------------+----------------------------------+ | Operat | Command | Output to look for | | ing | | | | System | | | +--------+-------------------------+----------------------------------+ | AIX | lslpp -al | db2_08_01.client 8.1.0.0 or | | | "db2_08_01.client*" | later (for AIX 4.3.3) | | | | | | | | db2_08_01.client 8.1.1.0 or | | | | later (for AIX 5) | | | | | | | | Sample outputs for DB2 for AIX | | | | 4.3.3: | | | | db2_08_01.client 8.1.0.0 | | | | COMMITTED ... | | | | 8.1.0.3 COMMITTED ... | | | | 8.1.0.8 COMMITTED ... | | | | | | | | Check the largest installation | | | | signature that is | | | | returned (8.1.0.x) to make sure | | | | it is smaller | | | | than the VRMF of the current DB2 | | | | level. | | | | For AIX 5, the signature looks | | | | like 8.1.1.y. | +--------+-------------------------+----------------------------------+ | HP-UX | swlist -l product | DB2V8CAE 8.1.0.x [product name] | | 11i | "*DB2*" | | | | | or, | | | | | | | | PDB2... 8.1.0.x Product Patch | | | | | | | | where x must be smaller than the | | | | current | | | | level (the 4th digit in VRMF). | +--------+-------------------------+----------------------------------+ | Linux | rpm -qa | grep db2 | db2cliv81-8.1.0-x | | | | | | | | where x must be smaller than the | | | | current | | | | level (the 4th digit in VRMF). | +--------+-------------------------+----------------------------------+ | Solari | pkginfo -l db2cliv81 | | VERSION: 8.1.0.x | | s | grep VERSION | | | Operat | | where x must be smaller than the | | ing | | current | | Enviro | | level (the 4th digit in VRMF). | | nment | | | +--------+-------------------------+----------------------------------+ 1g) Updated patch levels -- servers The following lists the updated patch level for DB2 Version 8.1.4t servers: AIX Version 5.1.0 (32-bit and 64-bit) With maintenance level 2 or later add APAR IY31080 AIX Version 5.2.0 To run DB2 on Concurrent I/O (CIO) mounted file systems on AIX 5.2B, apply APAR IY45707. HP-UX HP-UX 11i (11.11) for systems with PA-RISC 2.x (PA-8x00) processors with: * December 2001 GOLDBASE11i bundle * December 2001 GOLDAPPS11i bundle * Patches PHSS_26560, PHKL_28489 and PHCO_27434. * Patches for Java SDK 1.3.1. See http://www.hp.com/products1/unix/java/patches/index.html for required patches. Solaris Operating Environment For DB2 on 64-bit Fujitsu PRIMEPOWER systems, you also require: * Solaris 8 Kernel Update Patch 108528-16 or later to get the fix for patch 912040-01 * Solaris 9 Kernel Update Patch 112233-01 or later to get the fix for patch 912041-01. The Fujitsu PRIMEPOWER patches for the Solaris Operating Environment can be downloaded from FTSI at: http://download.ftsi.fujitsu.com/. Linux No additional patches required. 1h) Updated patch levels -- clients The following lists the updated patch level for DB2 Version 8.1.4t clients: AIX * Version 5.1.0 (32-bit or 64-bit) * With maintenance level 2 or later and APARs IY32905, and IY29345; or * With maintenance level 3 or later HP-UX HP-UX 11i (11.11) for systems with PA-RISC 2.x (PA-8x00) processors with: * December 2002 GOLDBASE11i bundle * December 2002 GOLDAPPS11i bundle * Patches PHSS_26560, PHCO_27434, and PHKL_28489 * Patches for Java SDK 1.3.1. See http://www.hp.com/products1/unix/java/patches/index.html for required patches. Solaris Operating Environment Solaris Version 7 or later. The following patches are required for the Solaris Operating Environment Version 7: * Solaris 7 (32-bit) "Recommended & Security Patches" + 107226-17 + 107153-01 + 106327-10 * Solaris 7 (64-bit) "Recommended & Security Patches" + 107226-17 + 107153-01 + 106300-11 + 106327-10 * Solaris 8 (32-bit) "Recommended & Security Patches" + 108921-12 + 108940-24 + 108434-03 and 108528-12 * Solaris 8 (64-bit) "Recommended & Security Patches" + 108921-12 + 108940-24 + 108435-03 + 108434-03 and 108528-12 * Solaris 9 (32-bit) * Solaris 9 (64-bit) Linux No additional patches required. 1i) Prior to installing DB2 Version 8.1.4t Please read the Known problems and workarounds sections before installing DB2 Version 8.1.4t. Before installing DB2 Version 8.1.4t, ensure all DB2 processes are stopped. 1. Switch to root authority by running the su - root command. 2. Run the following commands for each instance: su - iname . $HOME/sqllib/db2profile db2 force applications all db2 terminate db2stop db2licd -end # run at each physical node exit where iname represents the instance owner name. If you are a hacmp user, you must use the ha_db2stop command to stop DB2 instead of the db2stop command. Otherwise, the db2stop command triggers a failure event. 3. Run the following commands: su - aname . $HOME/das/dasprofile db2admin stop exit where aname represents the DAS owner name. 4. On AIX, you should also run, as root, slibclean to unload unused shared libraries from memory before installation: /usr/sbin/slibclean 5. Stop all instances that are using DB2 Version 8, including the Fault Monitor if it exists and is using DB2 Version 8. 1i.i) Setting up Version 8.1.4t (Solaris Operating Environments and AIX 5L) For Solaris Operating Environments, AIX 4.3.3 and AIX 5L, you need to have a filesystem with 2 GB of free space to contain the tar.Z file and the uncompressed installation image, in addition to the disk requirements of Version 8.1.4t in the installation path. Installing DB2 Version 8.1.4t from the CD-ROM (Solaris Operating Environment) If you have the DB2 Version 8.1.4t CD-ROM for the Solaris Operating Environment: 1. Copy the compressed tar file (FP4_$PTF.tar.Z), located on the CD-ROM, into a temporary directory on your system. This directory must have 2 GB of free space. 2. Uncompress and untar the file (FP4_$PTF.tar.Z). 3. Follow the instructions in the Version 8.1.4t readme to install Version 8.1.4t for the Solaris Operating Environment. Note: 1. In steps 1 and 2 $PTF represents: * U497251_10651 for Solaris Operating Environment 2. These steps also apply if you download the .tar.Z file from the IBM anonymous FTP server. Download the file and follow steps 1-3. Installing DB2 Version 8.1.4t from the CD-ROM (AIX 5L) To install IBM DB2 Version 8.1.4t from the CD-ROMs on AIX 5L, you are required to manually copy the file sets from two CD-ROMs: REGULAR FIXPAK 4t (Volume 1 of 4) and REGULAR FIXPAK 4t (Volume 2 of 4). The file sets on the REGULAR FIXPAK 4t (Volume 2 of 4) are only required if you have installed any of the following Version 8 products: DB2 Cube Views, DB2 Data Links Manager, DB2 Information Integrator Non-Relational Wrappers, DB2 Information Integrator Relational Wrappers, DB2 Query Patroller, DB2 Spatial Extender, DB2 Warehouse Connectors, or DB2 Warehouse Manager. If you do not have any of the products listed above installed, skip steps 2 and 4. 1. Copy the compressed tar file (FP4_U497250.tar.Z), located on REGULAR FIXPAK 4t (Volume 1 of 4), into a temporary directory on your system. This directory must have 2 GB of free space. 2. Copy the compressed tar file (extra.tar), located on REGULAR FIXPAK 4t (Volume 2 of 4), into the same temporary directory on your system that you used in Step 1. 3. Uncompress and untar the file (FP4_U497250.tar.Z). 4. Untar the extra.tar file. 5. Follow the instructions in the Installing DB2 Version 8.1.4t section. Note: These steps (except Step 2 and Step 4) also apply if you download the .tar.Z file from the IBM anonymous FTP server. 1i.ii) Data Warehouse functionality (Linux, AIX, and Solaris Operating Environments) If you are running Data Warehouse functionality on Linux, for example the Data Warehouse Agent that comes with some server products, you will need to back up your /opt/IBM/db2/V8.1/bin/IWH.environment. If you have this file, back it up before applying DB2 Version 8.1.4t. On AIX and Solaris, you should back up the same file (for AIX, this file is found in /usr/opt/db2_08_01/bin/IWH.environment). 1j) Installing DB2 Version 8.1.4t Please read the Known problems and workarounds sections before installing DB2 Version 8.1.4t. Restrictions The following restrictions apply when installing DB2 Version 8.1.4t: * DB2 Version 8.1.4t for AIX 5 can only be applied on AIX 5. * On AIX, the installFixPak script provides installation prerequisite checking that is not provided when you install DB2 Version 8.1.4t using SMIT or installp. Using SMIT is still supported, but installFixPak is the only method documented in this readme. For instructions on using SMIT, see your AIX manuals. It is strongly recommended that you use the installFixPak script to install DB2 Version 8.1.4t. * On Linux, once you have installed DB2 Version 8.1.4t, you cannot uninstall it and return to the previous DB2 level. Procedure To install DB2 Version 8.1.4t: 1. Change to the directory in which the installation image is located. 2. Enter the ./installFixPak command to launch the installation. Note: By default, installFixPak will commit all of the updated file sets on AIX. On AIX, if you do not wish to commit the updates, you should issue the installFixPak command with the -a option (for "apply" as versus "commit") as follows: ./installFixPak -a 1k) Installation of a FixPak or a modification level from a directory path When you download and untar a FixPak or a modification level, make sure that there are no spaces in your directory path where the file was located. If there are spaces in your directory path the installation will fail. For example, make sure your directory path resembles the following: /home/DB2FixPak/FP4/ ... It should not resemble the following: /home/DB2 FixPak/FP4/ ... 1l) Applying a FixPak or a modification level for Data Links Manager (AIX) To apply a fixpak or a modification level for Data Links Manager on AIX: 1. As the DB2 Data Links Manager Administrator, bring down the DB2 Data Links Manager by running the following commands: dlfm stop dlfm stopdbm Ensure that there are no DB2 or DLFM processes remaining. 2. As root, unmount each dlfs filesystem (filesystems controlled by the DB2 Data Links Manager) by running the following command: umount /filesystem_name where /filesystem_name represents the name of the dlfs filesystem which you want to unmount. 3. As root, unload the DLFS device driver by running the following command: strload -uf /usr/opt/db2_08_01/cfg/dlfs_cfg 4. Install the fixpak or the modification level. 5. After successful installation of the fixpak or the modification level, as root, update the Data Links Manager instance by running the following command: /usr/opt/db2_08_01/instance/dlfmupdt dlm_instance_name where dlm_instance_name represents the name of the DB2 Data Links Manager Administrator. 6. As root, load the DLFS device driver by running the following command: strload -f /usr/opt/db2_08_01/cfg/dlfs_cfg 7. As root, mount each of the DLFS filesystems by running the following command: mount -v dlfs /filesystem_name 8. As the DB2 Data Links Manager Administrator, run the following commands to bring up the DB2 Data Links Manager: dlfm bind dlfm start 1m) Applying a FixPak or a modification level for Data Links Manager (Solaris Operating Environments) To apply a fixpak or a modification level for Data Links Manager on Solaris Operating Environments: 1. As the DB2 Data Links Manager Administrator, bring down the DB2 Data Links Manager by running the following commands: dlfm stop dlfm stopdbm Ensure that there are no DB2 or DLFM processes remaining. 2. As root, unmount each dlfs filesystem (filesystems controlled by the DB2 Data Links Manager) by running the following command: umount /filesystem_name where /filesystem_name represents the name of the dlfs filesystem which you want to unmount. 3. As root, unload the DLFS device driver by running the following command: rem_drv dlfsdrv 4. Install the fixpak or the modification level. 5. After successful installation of the fixpak or the modification level, as root, update the Data Links Manager instance by running the following command: /opt/IBMdb2/V8.1/instance/dlfmupdt dlm_instance_name where dlm_instance_name represents the name of the DB2 Data Links Manager Administrator. 6. As root, load the DLFS device driver by running the following command: add_drv -m '* 0777 dlfm dlfmgrp' dlfsdrv 7. As root, mount each of the DLFS filesystems by running the following command: mount -v dlfs /filesystem_name 8. As the DB2 Data Links Manager Administrator, run the following commands to bring up the DB2 Data Links Manager: dlfm bind dlfm start 1n) After installation 1n.i) Updating instances to use the new level of DB2 This is mandatory. All instances must be updated after a new level of DB2 is installed. You need to be logged on as root to update the instances. For each instance, issue the command: INSTHOME/instance/db2iupdt iname where iname represents the instance name and INSTHOME represents the installation directory appropriate to your operating system. Run the dasupdt command if the database administration server (DAS) instance exists and is a DB2 Version 8 DAS instance. To update the DAS instance, issue the command: INSTHOME/instance/dasupdt dasname where dasname represents the DAS owner name and INSTHOME represents the installation directory appropriate to your operating system. For more information on the db2iupdt or dasupdt commands, run these commands with the -h option. 1n.ii) Restarting the instances To restart an instance: 1. Log in as the instance owner and enter the db2start command. 2. Repeat for each instance. To restart the administration server, log in as the DAS owner and run the db2admin start command. 1n.iii) Re-binding bind files You need to bind your DB2 utilities against all your databases after installation. This step is necessary for the fixes to complete the installation and ensure that the right code level is used. The procedure of binding, which follows, needs to be performed only once per database. Re-binding to DB2 UDB databases After applying fixes, you must do one of the following command sequences: At a command prompt, enter: db2 terminate db2 CONNECT TO db2 BIND /@db2ubind.lst BLOCKING ALL GRANT PUBLIC db2 BIND /@db2cli.lst BLOCKING ALL GRANT PUBLIC db2 terminate or, At the DB2 command line, enter: TERMINATE CONNECT TO BIND /@db2ubind.lst BLOCKING ALL GRANT PUBLIC BIND /@db2cli.lst BLOCKING ALL GRANT PUBLIC TERMINATE Where represents the name of a database to which the utilities should be bound, and where represents the full path name of the directory where the bind files are located, such as $HOME/sqllib/bnd where $HOME represents the home directory of the instance for the database server. db2ubind.lst and db2cli.lst contain lists of required bind files used by DB2 UDB. Re-binding host databases If you are connecting to host databases, you also need to bind the new bind files to the host. Use the DB2 Command Line Processor to connect to the host database and bind the utilities as follows: HOST COMMAND ======= =================================================== MVS BIND /@ddcsmvs.lst BLOCKING ALL GRANT PUBLIC SQLERROR CONTINUE VM BIND /@ddcsvm.lst BLOCKING ALL GRANT PUBLIC SQLERROR CONTINUE VSE BIND /@ddcsvse.lst BLOCKING ALL GRANT PUBLIC SQLERROR CONTINUE OS400 BIND /@ddcs400.lst BLOCKING ALL GRANT PUBLIC SQLERROR CONTINUE See "Binding Applications and Utilities" in the DB2 Connect User's Guide for a list of bind files that are used for your specific client operating system. If a bind file changes and your clients do not use that bind file, you do not need to bind it. Re-binding specific packages If you want to bind only a specific .bnd file to the database, issue one of the following command sequences for each database. At a command prompt, enter: db2 terminate db2 CONNECT TO db2 BIND / BLOCKING ALL GRANT PUBLIC sqlerror continue db2 terminate or, At the DB2 command line, enter: TERMINATE CONNECT TO BIND / BLOCKING ALL GRANT PUBLIC sqlerror continue TERMINATE where represents the name of the bind file, and represents the name of your database. Binding database utilities using the Run-Time Client The Run-Time Client cannot be used to bind the database utilities (import, export, reorg, the Command Line Processor) and DB2 CLI bind files. You must use the DB2 Administration Client or the DB2 Application Development Client instead. You must bind the database utilities (import, export, reorg, the Command Line Processor) and DB2 CLI bind files to each database before they can be used with that database. In a network environment, if you are using multiple clients that run on different operating systems or that are at different DB2 version or service levels, you must bind the utilities once for each operating system and DB2 client-version combination. Bind db2schema.bnd to existing databases After installation on the server, an additional bind file needs to be bound to existing databases. This requirement does not apply to clients. Procedure To bind db2schema.bnd on the server, execute one of these command sequences: At a command prompt: db2 terminate db2 CONNECT TO db2 BIND /db2schema.bnd BLOCKING ALL GRANT PUBLIC sqlerror continue db2 terminate or, At the DB2 command line: TERMINATE CONNECT TO BIND /db2schema.bnd BLOCKING ALL GRANT PUBLIC sqlerror continue TERMINATE where represents the name of a database to which the utilities should be bound, and where is the full path name of the directory where the bind files are located. 1n.iv) Uninstalling FixPaks or modification levels on Linux or UNIX Note: If you have received special fixes from IBM Support that you have applied to the DB2 Version 8.1.4t level, you will lose all of the special fixes when you uninstall DB2 Version 8.1.4t. The special fixes you received from IBM Support are only applicable to your current version. You should not apply the same special fixes on top of any backlevel version. If this applies to you, contact IBM Support before uninstalling DB2 Version 8.1.4t. Before uninstalling DB2 Version 8.1.4t, ensure that you: * Stop all instances and DAS * Backup your data AIX If DB2 Version 8.1.4t was installed and the file sets were applied but not committed, DB2 Version 8.1.4t can be rejected using SMIT. See the SMIT documentation for more details. If the file sets were committed when DB2 Version 8.1.4t was installed, which is the default, then DB2 Version 8.1.4t cannot be rejected. The only course of action available is to uninstall DB2 from your system, reinstall DB2 Version 8, and bring DB2 up to the desired level by applying the corresponding level of DB2. HP-UX DB2 Version 8.1.4t file sets can be uninstalled using the sam utility. If you use swlist or sam, you can list all file sets for DB2 Version 8.1.4t and receive output similar to the following: PDB2_810100010 8.1.0.8 PDB2_810100011 8.1.0.8 PDB2_810300011 8.1.0.24 PDB2_810300010 8.1.0.24 The installation signature is combined with the name of the file set. You should uninstall the group of PDB2_* file sets with the same signature starting with the largest number. You can remove DB2 Version 8.1.4t, or the latest version plus the second last, and so on. You can also select them all. Linux You cannot uninstall DB2 Version 8.1.4t on Linux. The only course of action available is to uninstall DB2 from your system, reinstall DB2 Version 8, and bring DB2 up to the desired level by applying the corresponding level of DB2. A db2_deinstall script is provided with DB2 Version 8.1.4t which will uninstall DB2 from your system. Solaris Operating Environment The backoutallpatch script is provided with all version images. Run this script to uninstall DB2 Version 8.1.4t and leave the system in the state that it was before installing DB2 Version 8.1.4t. You can find this script in /var/sadm/patch. The script will be named backoutallpatch.8.1.x.y where 8.1.x.y corresponds to the VRMF of DB2 Version 8.1.4t. You must uninstall from the highest to the lowest level until you have uninstalled the version that you want to remove. For example if you are at FixPak 3 and installed FixPak 1 and modification level 2 before FixPak 3 was installed, you would not be able to uninstall FixPak 1 unless you have uninstalled modification level 2 and FixPak 3. Update all instances, including the DAS instance. 1o) Known problems and workarounds (Version 8.1.4t) 1o.i) DB2 for AIX 4.3.3 and 5.1 and above requires AIX C++ Version 6 Runtime DB2 Version 8.1.4t for AIX Versions 4.3.3 and 5.1 and above requires that the AIX C++ Version 6 Runtime libraries are installed on your AIX system. This update is available as the March 2003 C++ Runtime PTF here: http://www-1.ibm.com/support/docview.wss?rs=0&q=xlC.rte&uid=swg24004427&loc=en_US&cs=utf-8&cc=us&lang=en Please follow the install instructions given on this page before using DB2 Version 8.1.4t. 1o.ii) Limitations of 64-bit server instances DB2 UDB Workgroup Server Edition and DB2 UDB Workgroup Server Unlimited Edition are not licensed for 64-bit server instances. With these products, you can create: * 32-bit server instances * 32-bit or 64-bit client instances. 1o.iii) Recommended application server for deploying DB2 Web Tools The recommended application server for deploying DB2 Web Tools is the embedded application server for DB2. The recommended method is to use the automated script that is provided. To deploy DB2 Web Tools on the embedded application server for DB2, the following order is recommended: 1. Installing the application server for DB2 2. Starting the application server for DB2 3. Deploying automatically on the application server for DB2 For detailed instructions for each step, see the DB2 Information Center. These additions to the following sections must also be noted. Installing the application server -- additional prerequisite The application server for DB2 requires DB2 ESE Version 8.1.2 or higher. Installing the application server -- additional restriction The default Red Hat installation creates an association between the hostname of the machine and the loopback address, 127.0.0.1. In addition, the /etc/nsswitch.conf file is set up to use /etc/hosts before trying to look up the server using a name server (DNS). This loopback processing can hang utilities that start and stop a server, such as startServer.sh, even though the server might successfully start or stop. Ensure that the host name is defined properly. The default configuration has localhost defined in the /etc/hosts file. The default /etc/nsswitch.conf looks only at the host file and not the DNS server. To correct this problem, remove the 127.0.0.1 mapping to localhost in the /etc/hosts file, or, edit the name service configuration file /etc/nsswitch.conf to resolve the proper host name by using the name server. For example, remove the 127.0.0.1 mapping from the /etc/hosts file, which might look like this example: # IP Address name of machine n.n.n.n hostname.domain.com 127.0.0.1 localhost Otherwise, change the etc/nsswitch.conf file to search DNS before searching the hosts file. For example, hosts : dns files Deploying automatically on the application server for DB2 -- additional prerequisite The application server for DB2 requires DB2 ESE Version 8.1.2 or higher. The command to automatically deploy DB2 Web Tools requires the DB2 instance name be specified: 1. Change to the /bin directory and run the deploy_db2wa script: /bin/db2wa_deploy -db2path db2path -instance instanceName where: * is the installation path for the application server for DB2. * db2path is the installation path for DB2. * instanceName is the DB2 instance name. For example: db2wa_deploy.sh -db2path /home/db2v8/sqlib -instance db2v8 2. Invoke the DB2 Web Tools enterprise application from a browser by entering the following: http://hostname:/db2wa where: * hostname is the name of the DB2 server. * port_number is 20000 by default, unless modified after the installation of the application server. 1o.iv) New registry variable for Version 8.1.4t +---------------------------+-------------+---------------------------+ | Variable Name | Operating | Values | | | System | | +---------------------------------------------------------------------+ | Description | +---------------------------+-------------+---------------------------+ | DB2AFFINITIES | AIX 5 or | Default=Not set | | | higher | | +---------------------------------------------------------------------+ | Defines a resource policy on NUMA enabled systems. | | The registry variable can be set to indicate the path to a | | configuration file which defines a policy for binding DB2 processes | | to operating system resources. The resource policy allows you to | | specify a set of operating system resources to restrict DB2. Each | | DB2 process is bound to a single resource of the set. Resource | | assignment occurs in a circular round robin fashion. | | Sample configuration files: | | Example 1: Bind all DB2 processes to either CPU 1 or 3. | | | | CPU | | 1 | | 3 | | | | | | Example 2: Bind DB2 processes to one of the following resource | | sets: sys/node.03.00000, sys/node.03.00001, sys/node.03.00002, | | sys/node.03.00003 | | | | RSET | | sys/node.03.00000 | | sys/node.03.00001 | | sys/node.03.00002 | | sys/node.03.00003 | | | | | | Note: Use of the RSET method requires CAP_NUMA_ATTACH capability. | +---------------------------------------------------------------------+ 1p) Known problems and workarounds (prior to Version 8.1.4t) 1p.i) DB2 Setup Wizard appears not to run using Exceed (Linux) When using Hummingbird(R) Exceed PC X Server software to connect to a Linux computer from a computer running Microsoft(R) Windows, the DB2 Setup wizard may not appear to run. This problem arises when Exceed is configured to use multiple window mode, with the Window Manager set to "Default to Native" and with the communications mode set to "Passive". The symptoms you may observe include: 1. The DB2 Setup Launchpad appears quite small, as small as 5 pixels x 5 pixels, and will need to be resized before it can be used. 2. Even after resizing, the DB2 Setup Launchpad sometimes will not paint properly and instead appears as a blank grey panel. To run the DB2 Setup Wizard on a Linux computer using Exceed, change either of the following Exceed configuration settings: * Change the Window Manager setting to "Native" and ensure the "Use Native WM for Embedded Clients" check box is checked, or, * Change the Window Mode to "Single" and the communication mode from "Passive" to "XDCMP-query". 1p.ii) Creating the Tools Catalog database not supported on AIX, Solaris, and HP-UX For DB2 UDB Version 8.1, FixPak 1, Version 8.1.2, FixPak 3, and Version 8.1.4t Tools Catalog creation is not supported during the installation of DB2 against 64-bit instances on the hybrid 64-bit platforms. The hybrid platforms are AIX, Solaris Operating Environments, HP-UX, and other platforms that support both 32-bit and 64-bit instances. If you wish to create a tools catalog against a 64-bit instance, this can be done after the installation of DB2 either through the CREATE TOOLS CATALOG CLP command or using the Control Center. You will also need to install a 64-bit IBM Developer Kit for Java for this operation. Refer to the DB2 Administration Server section of the DB2 Administration Guide for more details. 1p.iii) IBM Developer Kit for Java 1.3.1 required on Linux (x86, 32-bit) The IBM Developer Kit for Java 1.3.1 Service Release 4 is required for DB2 to use the DB2 Control Center or create and run Java applications, including stored procedures and user-defined functions. Only the IBM Developer Kit for Java is supported. The IBM Developer Kit for Java is installed whenever a component that requires Java is being installed. However, if the installer detects that the IBM Developer Kit for Java 1.3.1 is already installed, it will not install it again. The IBM Developer Kit for Java 1.3.1 is installed in its own directory and will not overwrite any previous levels of the IBM Developer Kit for Java. Restrictions The installation of the IBM Developer Kit for Java will only be attempted if you use one of the following DB2 installation methods: * GUI installation program (db2setup) * response file installation (db2setup -r response_file) Procedure To manually install the IBM Developer Kit for Java, run the following command from the /cdrom/db2/linux/Java-1.3.1 directory: rpm -ivh IBMJava2-SDK-1.3.1-4.0.i386.rpm This installs the IBM Developer Kit for Java to the /opt/IBMJava2-131 directory. To verify that IBM Developer Kit for Java is installed, run the following command from the UNIX shell prompt: /jre/bin/java -version where represents the path where Java was installed. For example, if your installation directory path is /opt/IBMJava2-131/, then the command would be: /opt/IBMJava2-131/jre/bin/java -version You should receive output similar to the following: java version "1.3.1" Java(TM) 2 Runtime Environment, Standard Edition (build 1.3.1) Classic VM (build 1.3.1, J2RE 1.3.1 IBM build cxia32131-20030329 (JIT enabled: jitc)) The IBM Developer Kit for Java is also available from the IBM developerWorks Web site at http://www.ibm.com/developerworks/java/jdk/index.html. 1p.iv) DB2 Data Links Manager installation when DB2 Enterprise Server Edition already installed The DB2 Data Links Manager installation will fail when creating the dlfm instance if DB2 ESE is already installed on the machine. The workaround is to modify the response file and continue or to perform a response file installation to install the DB2 Data Links Manager. For more information on response files, see the Installation and Configuration Supplement or search for "response file" in the Information Center. 1p.v) Loss of Control Center functionality Consult the Client/Server Compatibility and Migration Considerations whitepaper, which is available at: * http://www-3.ibm.com/software/data/pubs/papers/ 1p.vi) Controlling login restrictions of a connecting user on an AIX server By default, when a user is authenticated on an AIX server, DB2 checks the connecting user's local login restrictions before allowing the connection to proceed. The DB2LOGINRESTRICTIONS registry variable permits DB2 to enforce alternative modes of login restrictions. If DB2LOGINRESTRICTIONS is not set, the default value is LOCAL. The variable may be set to the following values: REMOTE DB2 will only enforce remote login restrictions SU DB2 will only enforce su restrictions NONE DB2 will not enforce any particular mode of login restrictions LOCAL DB2 will only enforce local login restrictions In all cases, DB2 will still check for the following error conditions: * expired account * locked account * invalid user 2) Notices IBM may not offer the products, services, or features discussed in this document in all 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 user's 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. For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country/region or send inquiries, in writing, to: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106, Japan The following paragraph does not apply to the United Kingdom or any other country/region 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. 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. IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. 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 that has been exchanged, should contact: IBM Canada Limited Office of the Lab Director 8200 Warden Avenue Markham, Ontario L6G 1C7 CANADA 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. Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems, and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment. 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. All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. This information may contain 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. COPYRIGHT LICENSE: This information may contain sample application programs, in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM for the purposes of developing, using, marketing, or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. Each copy or any portion of these sample programs or any derivative work must include a copyright notice as follows: (C) (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. (C) Copyright IBM Corp. _enter the year or years_. All rights reserved. IBM, DB2, Universal Database, and S/390 are trademarks of International Business Machines Corporation in the United States, other countries, or both. Windows is a registered trademark 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. ------------------------------------------------------------------------------- * are trademarks or registered trademarks of IBM Corporation. ** are trademarks or registered trademarks of their respective owners. ------------------------------------------------------------------------------- ******************************************************************************* ** ** (c) COPYRIGHT INTERNATIONAL BUSINESS MACHINES CORPORATION 1999-2003. ** ALL RIGHTS RESERVED. ** *******************************************************************************