IBM Books

Release Notes: Updated January 17, 2001


Contents

Updates to Release Notes

Introduction

General Information

  • Code Fixes and Customer Support
  • Online License Information
  • Product Registration
  • Staging Server Configuration
  • Log Files
  • Windows-related Considerations

  • IBM DB2 Administration Client and IBM DB2 Run-Time Client
  • IBM Installation Agent
  • Lotus SmartSuite
  • Linux-related Considerations

  • Version Checking for Linux Components
  • IBM DB2 Universal Database V7.1 Control Center
  • Lotus Domino Application Server
  • IBM HTTP Server
  • IBM Net.Data
  • Double-Byte Character Sets
  • Fonts
  • Add Custom Application Wizard

  • Hints and Tips
  • IBM WebSphere Homepage Builder
  • Lotus Domino Designer Client
  • Copyright Information

    Trademarks


    Updates to Release Notes

    The following information was added to the Release Notes on January 17, 2001:

    The information about the application build file name was moved to the section Hints and Tips on January 17, 2001.


    Introduction

    This document applies to licensed program IBM Small Business Suite for Linux Version 1 Release 6, Program Number 5697-G21.

    These Release Notes contain the most recent information about the IBM Small Business Suite for Linux as well as the information that was part of the Release Notes that was shipped with the product. This document is updated periodically.

    The information in this document is grouped into the following categories:


    General Information

    The information in this section applies to the IBM Small Business Suite for Linux, in general.


    Code Fixes and Customer Support

    To see the latest information about the IBM Small Business Suite for Linux code fixes, go to:

    ftp://ftp.software.ibm.com/ps/products/ibmsbs/fixes/linux/v160

    To access customer support for the IBM Small Business Suite for Linux, go to:

    www.ibm.com/support

    Select Advanced Search to display the Advanced Search window, and then select Product specific support sites from the Document Type list box. Search using the following keyword search string:

    ibm small business suite for linux
    

    Online License Information

    After you install the IBM Small Business Suite for Linux, you can find translated text versions of the license agreements in the following directories:

    The Finnish license file for IBM Small Business Suite for Linux is not installed automatically with the other license files. However, you can manually copy the Finnish license file (Finnish.txt) from the root directory of CD-ROM number 2 of the IBM Small Business Suite for Linux media to the directory in which the other licenses are installed.


    Product Registration

    Product registration for the IBM Small Business Suite for Linux may not work in the TurboLinux KDE desktop environment. To register the suite, switch to the GNOME desktop environment, click Product Registration from the IBM Small Business Suite for Linux shortcut on the IBM Suites Installer. When the product registration window displays, type the requested information on the panels, then click Submit.


    Staging Server Configuration

    The following configuration considerations apply to your staging server:


    Log Files

    Log files are automatically deleted from target computers after applications are installed. The information in log files is returned to the IBM Suites Installer, where it is stored in the working directory. (The default working directory is /opt/suites/com/ibm/jsdt/webserver/tree.) The IBM Suites Installer uses the following naming convention for log files:

    CBN_<host_name><vendor_name> <application_name> <version>.txt
    

    where


    Windows-related Considerations

    The information in this section is related to IBM Small Business Suite for Linux components that run on Windows platforms.


    IBM DB2 Administration Client and IBM DB2 Run-Time Client

    Before attempting to install the IBM DB2 Administration Client or the IBM DB2 Run-Time Client on a Windows 95 target computer, check the ws2setup.log file to ensure that a Microsoft version of the wsock32.dll file is installed on the target. If a non-Microsoft version of the wsock32.dll file is installed, the following message appears in the log file:

    Non-Microsoft copyright info for C:\WINDOWS\SYSTEM\WSOCK32.DLL
    

    The Microsoft wsock32.dll file is a prerequisite for installation of the IBM DB2 Administration Client and the IBM DB2 Run-Time Client on a Windows 95 target computer. If you have a non-Microsoft wsock32.dll file, you need to uninstall it and install a Microsoft wsock32.dll file.


    IBM Installation Agent

    The IBM Installation Agent does not operate on target computers that have the base Windows 95 operating system and Internet Explorer Version 4.0 or higher installed.


    Lotus SmartSuite

    The following considerations apply to Lotus SmartSuite:


    Linux-related Considerations

    The information in this section is related to IBM Small Business Suite for Linux components that run on the Linux platform.


    Version Checking for Linux Components

    The IBM Suites Installer detects whether the version of a Linux application on a target computer is identical to the version that is included in the IBM Small Business Suite for Linux. If an identical version is detected, the IBM Suites Installer does not reinstall the application. Instead, the IBM Suites Installer reports the installation as "successful."

    The IBM Suites Installer does not attempt to check for versions of applications that are different than the versions of applications included in the IBM Small Business Suite for Linux. As a result, the IBM Suites Installer will attempt to install the selected application on a target computer even if the target computer already has another version of the application installed. For this reason, after installation, you may find multiple versions of the application on a target computer.

    Special considerations apply to the Lotus Domino Application Server and the IBM HTTP Server. For more information, see Lotus Domino Application Server and IBM HTTP Server.


    IBM DB2 Universal Database V7.1 Control Center

    The IBM DB2 Control Center provides a centralized point-of-control from which you can manage a group of DB2 databases. Using the IBM DB2 Control Center, you can run DB2 commands, create Data Definition Language (DDL) statements, and execute DB2 utilities. You use the IBM DB2 Control Center together with the IBM DB2 Universal Database Workgroup Edition Server, which is one of the applications in the IBM Small Business Suite for Linux.

    The IBM DB2 Control Center installation image is located on CD-ROM number 5. This section describes how to setup a Linux target computer to run the IBM DB2 Control Center. If you select to install the IBM DB2 Control Center, you must have the IBM DB2 Universal Database Workgroup Edition Server already installed on the target computer.

    1. Install the IBM JDK on the target computer. The IBM JDK is an application in the IBM Small Business Suite for Linux that you can install using the IBM Suites Installer.
    2. Install the IBM DB2 Control Center and its prerequisite, RPM package db2cj71, on the Linux target computer. The installed size is 75000 KB.

      The RPM packages for the IBM DB2 Control Center and db2cj71 are located in directory /udb/linux/db2 on CD-ROM number 5:

      You can install the IBM DB2 Control Center and db2cj71 using the Add Custom Application wizard and the IBM Suites Installer. If you use the Add Custom Application wizard, follow the directions in the online help and in Hints and Tips. If you install the IBM DB2 Control Center and db2cj71 directly from CD-ROM number 5, use the following command:

      rpm -i db2wcc71-7.1.0-0.i386.rpm db2cj71-7.1.0-0.i386.rpm
      
    3. Configure the Java environment on the target computer by adding the following lines to the /etc/profile file:
      export JAVA_HOME=/usr/jdk118
      export PATH=$PATH:$JAVA_HOME/bin
      export CLASSPATH=$CLASSPATH:$JAVA_HOME/lib/classes.zip
      
    4. Reboot the target computer.
    5. From a terminal window on the target computer, create a symbolic link between the IBM DB2 Control Center files and the DB2 user you configured for the working installation of the IBM DB2 Universal Database Workgroup Edition Server. Use the following command to create a symbolic link:
      ln -s /usr/IBMdb2/V7.1/cc /home/<xxx>/sqllib/cc
      

      where <xxx> is the DB2 instance user or DB2 Administration Server user ID.

      Note:
      If you configured multiple users for the working installation of the IBM DB2 Universal Database Workgroup Edition Server, create a symbolic link for each user.

    Before starting the IBM DB2 Control Center, ensure that the operating system on the target computer is in graphical mode and that you are logged on as a DB2 user identified in the previous step. To start the IBM DB2 Control Center, use the db2cc command from a terminal window. There may be a delay before the IBM DB2 Control Center actually starts.


    Lotus Domino Application Server

    The following considerations apply to the Lotus Domino Application Server:


    IBM HTTP Server

    The following considerations apply to the IBM HTTP Server:


    IBM Net.Data

    IBM Net.Data requires either the IBM DB2 Administration Client or the IBM DB2 Universal Database Workgroup Edition Server to be installed on the same target computer. If you select to install IBM Net.Data and if either of the prerequisite DB2 application installations fails, IBM Net.Data will still install successfully; however, it will not operate.

    To enable IBM Net.Data to operate after one of the IBM DB2 products is installed successfully, ensure that the httpd.conf file and the db2www.ini file refer to the correct instance user of DB2:

    where <xxx> is the DB2 instance user you configured for the working installation of the IBM DB2 application.


    Double-Byte Character Sets

    If you are installing the IBM Suites Installer or the IBM Installation Agent on a Linux computer that supports double-byte character sets (DBCS), you must use a terminal that supports DBCS characters, such as KTERM, to run the installation commands. Do not use the GNOME terminal, which does not support DBCS characters.


    Fonts

    After using any of the IBM Small Business Suite for Linux components (for example, the IBM Suites Installer, the IBM Installation Agent, or any of the suite-specific shortcuts) on a Linux computer, applications may display with incorrect fonts. To reset the font path on your computer, you need to remove the IBM JRE font directory from the font path by entering the following command:

    xset -fp ,/opt/IBM_JRE/lib/fonts
    

    Add Custom Application Wizard

    The Add Custom Application wizard lets you make applications available for installation on groups of target computers. These applications should support silent installation and can include any of the following:

    To use the Add Custom Application wizard, you should be familiar with silent installations. For detailed information about fields and other interface elements on the wizard panels, refer to the online help. This section of the Release Notes provides some general hints and tips for using the wizard as well as the special panel settings to use for the IBM WebSphere Homepage Builder and the Lotus Domino Designer Client.

    This section of the Release Notes also provides directions for using the wizard to make the Homepage Builder User's Guide, the Homepage Builder Tutorial, and the IBM Wine for WebSphere Homepage Builder V4.0 for Linux available to groups of target computers. The IBM Wine for WebSphere Homepage Builder, which you can download from the Web to your staging server, is a co-requisite for the IBM WebSphere Homepage Builder.

    Note:
    The hints and tips apply, in general, to the Add Custom Application wizard. It is strongly recommended that you read the hints and tips before reading about the supplemental applications.

    Hints and Tips

    The following hints and tips will help you to use the Add Custom Application wizard:

    Application configuration:

    You can configure applications only through command line parameters (for example, rpm -nodeps) or response files. For information about customizing application configurations, refer to the installation documentation for the application.

    Installation image accessibility:

    If the installation image for the application is located on a CD-ROM and if you expect to edit any of the settings on Add Custom Application wizard at a later time, you may want to first copy the installation image files from the CD-ROM to a network drive. When specifying the root directory on the Step 3 panel of the wizard, browse to the root directory on the network drive. You do not have to have the CD-ROM available to finish using the wizard.

    Application root directory and response file availability:

    Create the root directory and the response file, if it is required for the application, before you begin using the Add Custom Application wizard. This is true whether you are adding or editing an application. If the root directory or the response file is not available, you will receive an error message when you click the Next buttons on the Step 3 and Step 4 panels.

    Files in the application root directory:

    The application build process packages all the files and subdirectories in the application root directory. If there are any files and subdirectories in the root directory that you do not want to include in the build package, remove them from the directory.

    Application name:

    Ensure that the application name specified in the Step 1 panel does not contain any periods (" . ") or file name characters that are invalid on either the staging server or the target operating system. If the application name contains a period or an invalid file name character, you will receive an installation failure message.

    Application build file name:

    Ensure that the build file name specified in the Step 3 panel does not contain any spaces or file name characters that are invalid on either the staging server or the target operating system. If the build file name contains a space or an invalid file name character, you will receive an installation failure message.

    Application install command parameters:

    If you use slash characters in a command name path and or in command parameters in the Step 4 panel, ensure that the direction of the slash characters conforms to the conventions of the target operating system. For Windows, use back slash characters (" \ "). For Linux, use forward slash characters (" / ").


    IBM WebSphere Homepage Builder

    This section describes how to use the Add Custom Application wizard to make the IBM WebSphere Homepage Builder, the Homepage Builder User's Guide, the Homepage Builder Tutorial, and the IBM Wine for WebSphere Homepage Builder available to groups of target computers. The IBM Wine for WebSphere Homepage Builder is a co-requisite for the IBM WebSphere Homepage Builder and must be installed on the same target computers as the IBM WebSphere Homepage Builder. If you select to install the IBM WebSphere Homepage Builder and do not install the IBM Wine for WebSphere Homepage Builder, the IBM WebSphere Homepage Builder will install successfully; however, it will not operate.

    Notes:

    1. Usage restrictions apply to the IBM WebSphere Homepage Builder. Read the suite license agreement before installing this application.

    2. The IBM WebSphere Homepage Builder is available in English only.

    To make the IBM WebSphere Homepage Builder, the Homepage Builder User's Guide, the Homepage Builder Tutorial, and the IBM Wine for WebSphere Homepage Builder available to groups of target computers, follow these steps:

    1. Mount CD-ROM number 1 in your CD-ROM drive, and then copy the Homepage Builder RPM packages to a directory on your network drive. The Homepage Builder RPM packages are located in the directory /hpbuilder/linux on CD-ROM number 1:
    2. Download the IBM Wine for WebSphere Homepage Builder RPM package from the Web to the same directory in which you copied the other Homepage Builder RPM packages. For directions on downloading the IBM Wine for WebSphere Homepage Builder, go to:

      http://www.ibm.com/software/hpbuilder/linux/wine/

    3. On the IBM Suites Installer main window, click Software --> Custom Applications --> Add. The Step 1 panel of the Add Custom Application wizard displays with Linux selected in the Operating System list box and English selected the Language list box (see Figure 1).

      Figure 1. Step 1 panel of the Add Custom Application wizard

      xxx

    4. In the Application Name field, type a name for the IBM WebSphere Homepage Builder application, for example:
      WebSphere Homepage Builder
      
    5. Click the Next button to display the Step 2 panel of the wizard (see Figure 2).

      Figure 2. Step 2 panel of the Add Custom Application wizard

      xxx

      The information in the fields in this panel is optional. If you choose, you can type the vendor name (IBM), the version number (4.0), and the installed size. The total installed size for the IBM WebSphere Homepage Builder, the Homepage Builder User's Guide, the Homepage Builder Tutorial, and the IBM Wine for WebSphere Homepage Builder is approximately 135000 KB:

    6. Click the Next button to display the Step 3 panel of the wizard (see Figure 3).

      Figure 3. Step 3 panel of the Add Custom Application wizard

      xxx

    7. Click the Next button to display the Step 4 panel of the wizard (see Figure 4).

      Figure 4. Step 4 panel of the Add Custom Application wizard

      xxx

    8. Click the Next button to display the Step 5 panel (see Figure 5).

      Figure 5. Step 5 panel of the Add Custom Application wizard

      xxx

      Ensure that Return Code is selected in the Response Method list box.

    9. Click the Finish button. The IBM WebSphere Homepage Builder is now available to groups of Linux/English target computers.

    When adding software to groups of Linux/English target computers, the IBM WebSphere Homepage Builder displays in the list of custom software on the Step 1 panel of the wizard (see Figure 6).

    Figure 6. Step 1 panel of the Add Software to a Group wizard

    xxx


    Lotus Domino Designer Client

    This section describes how to use the Add Custom Application wizard to make the Lotus Domino Designer Client available to groups of target computers.

    Notes:

    1. If you install the Lotus Domino Designer Client on a target computer, Lotus Notes is also installed by default, overwriting existing databases and configuration settings. Therefore, before installing the Lotus Domino Designer Client, check the target computer to determine if Lotus Notes is already installed.

    2. The language of the Lotus Domino Designer Client application must match the language associated with the locale of the target computer.

    The Lotus Domino Designer Client is available in the following languages (language codes are listed in parentheses):

    Note:
    Usage restrictions apply to the Lotus Domino Designer Client. Read the Suite license agreement before installing this application.

    The Lotus Domino Designer Client is located on the IBM Small Business Suite CD-ROM number 3. To make the Lotus Domino Designer Client available to groups of computers, follow the steps below:

    1. Create an application response file and save it in a directory on your staging server. For information about creating response files, refer to InstallShield documentation.
    2. Mount CD-ROM number 3 in your CD-ROM drive.
    3. On the IBM Suites Installer main window, click Software --> Custom Applications --> Add. The Step 1 panel of the Add Custom Application wizard displays with Linux selected in the Operating System list box and English selected the Language list box (see Figure 1).
    4. Do the following:
    5. Click the Next button to display the Step 2 panel of the wizard (see Figure 2). The information in the fields in this panel is optional. If you choose, you can type the vendor name (Lotus), the version number (5.0.4), and the installed size (150000 KB).
    6. Click the Next button to display the Step 3 panel of the wizard (see Figure 3).
    7. Click the Next button to display the Step 4 panel of the wizard (see Figure 4).
    8. Click the Next button to display the Step 5 panel of the wizard (see Figure 5).
    9. Click the Finish button. The Lotus Domino Designer Client is now available to groups of target computers for the Windows platform and language that you specified in the Step 1 panel.

    When adding software to groups of target computers meeting the platform and language requirements you specified in the Step 1 panel of the Add Custom Application wizard, the Lotus Domino Designer Client displays in the list of custom software in the Step 1 panel of the Add Software to a Group wizard (see Figure 7).

    Figure 7. Step 1 panel of the Add Software to a Group wizard

    xxx


    Copyright Information

    (C) Copyright IBM Corporation 2000. All rights reserved. U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.


    Trademarks

    The following terms are trademarks of the IBM Corporation in the United States, other countries or both:

    The following terms are trademarks of other companies:

    Other company, product and service names may be trademarks or service marks of others.