IBM WebSphere Application Server - Express Version 5.0.2 Installation Guide

This fifth edition (August 2003) of the Installation Guide contains the following information for WebSphere Application Server - Express Version 5.0.2:

This document covers installing the complete WebSphere Application Server - Express 5.0.2 from the product CDs or CD image. If you already have version 5.0 or version 5.0.1 installed, then you have the option of downloading and applying the 5.0.2 PTF install package to update the runtime components of WebSphere Application Server - Express while maintaining your current configuration settings.

Consult the product support site at www.ibm.com/software/webservers/appserv/express/support.html for the following fixes and support information:

Installing 5.0.2 as a PTF

A PTF install program is downloadable from the support site which can be used to update the runtime components of WebSphere Application Server - Express to 5.0.2. This installation program determines which components are installed and updates the following if present:

  1. the WebSphere Application Server - Express server
  2. the WebSphere Application Server - Express test environment in WebSphere Studio
  3. the Agent Controller
  4. the Getting Started, Installation Guide, and readme documents

To run the installation program, unpack the 5.0.2 PTF install image. Then run the setupwin32.exe program for Windows or the setupLinux program for Linux. Click through the wizard panels to complete the installation. If you run into a server problem with the 5.0.2 PTF applied, you can remove the PTF from the server and revert back to the previous level. You will need access to the WebSphere Application Server - Express 5.0.2 PTF image. Change to the root directory of the image and you will see either a removePTF.bat (for Windows) or a removePTF.sh (for Linux). Run the appropriate program from a console window. Progress and informational messages are displayed to the console window. The 5.0.2 server updates will be removed from both the WebSphere Application Server - Express server and from the WebSphere Application Server - Express Site Developer test environment server if both are installed on the machine. Note that this procedure only removes the PTF updates from the server (and test server). The Agent Controller 5.0.2 updates and documentation updates remain at the 5.0.2 level. If you need to remove all traces of the 5.0.2 PTF, then uninstall the WebSphere Application Server - Express product and reinstall the previous version. Ensure that product directories are completely emptied and deleted after the uninstall has completed.

If errors are reported or suspected during the PTF install, browse the log files in the following directories:

Installation notes

Note the following about WebSphere Application Server - Express V5.0.2:

  1. If you have installed and used a previous version of WebSphere Application Server - Express, then you should export your projects as EAR files and then import the EAR files into the product. We support migration of your workspace, but still recommend that you export your projects as EAR files (including the source) so that you can easily import the projects into the new Site Developer in case there are any problems with the workspace migration.
  2. You MUST have Administrator privileges (for Windows) or 'root' privileges (for Linux) to install.
  3. If you have a previous version of WebSphere Application Server - Express installed then you should uninstall it. There can be only one instance of the IBM Agent Controller component of WebSphere Application Server - Express on a machine. Be sure to save your projects and workspace as described above before uninstalling the Beta version.
  4. If you install one of the features -- Application Server - Express or Studio Site Developer -- and later run the install again to install the other feature, you should use the same destination directory that you selected the first time.
  5. When uninstalling WebSphere Application Server - Express, a message may appear that an Agent Controller file is in-use. To proceed, go to a command prompt, enter the command 'net stop "IBM Agent Controller"' , and continue with the uninstall. Or, go to Control Panel -> Administrative Tools -> Services window, where you can stop the IBM Agent Controller. To stop the Agent Controller in Linux, type ./RAStop.sh from the /opt/IBMRAC/bin directory.
  6. If you cancel an uninstall, and depending on when you canceled, you may be left with a partially installed WebSphere Application Server - Express. The recommended way to recover from a partially successful install is to first uninstall WebSphere Application Server - Express, erase any leftover files in the install directory, correct the cause of the original problem, and then try the install again.
  7. The IBM Remote Agent Controller requires the Microsoft dll msvcp60.dll to be present on the machine where RAC is being installed. If you are using a Windows 2000 Server and encounter the error: "RAserver.exe cannot find MSVCP60.DLL" , install the Windows 2000 Support Tools to fix this problem. Then, reboot. The reboot should occur after the install of the Windows 2000 Support Tools and before the install of WebSphere Application - Server Express. The Windows 2000 Support Tools are located on the Microsoft Windows 2000 Server CD.
  8. The installation program can be run in an interactive console mode instead of using the GUI wizard panels. The console mode may be better suited for persons with accessibility requirements. The "-accessibility" mode provides additional audible information for visually-impaired end users. To run in console mode run this command from the root directory of the WebSphere Application Server - Express installation CD: Follow the prompts to complete the install. Note: The "-is:javaconsole" option is critical. If you do not specify this option the installation program will hang. The "-log @NONE" turns logging off to eliminate log information coming out on the console. If you experience any problem during the install, you may want to eliminate this option in order to collect log information. When running in console mode you must select the Typical install path.

Hardware prerequisites

The following hardware must be installed before you install WebSphere Application Server - Express:

For tools only on one machine

For tools and remote server on one machine

For remote server on Windows NT and Windows 2000

For remote server alone on Linux on Intel

For remote server on AIX

For remote server on Sun Solaris

For remote server on HP

Software prerequisites

Operating Systems

The following software must be installed before you install WebSphere Application Server - Express:

One of the following operating systems:

Third-party plug-ins

If you had WebSphere Application Server - Express installed and you installed any third-party plug-ins, you need to get the corresponding plug-ins for Version 5.1 and reinstall them.

Packaging information

This package contains two sets of CDs:

  1. WebSphere Application Server - Express (CDs for Windows and Linux (English only); UNIX CD for HP-UX, Solaris, or AIX), Web Server Security Plug-in CD for all Express Server supported platforms)
  2. DB2 Universal Database(R) Enterprise Express Edition

Installation Usage Scenarios

  1. To use the application server component of WebSphere Application Server - Express without its Development tool component
    1. Use the appropriate installation CD (according to your operating system platform) from set one.
    2. During installation, specify that you want to install the application server component only.
  2. To use the application server component of WebSphere Application Server - Express with its Development tool component
    1. On the same machine
      • Use the appropriate installation CD (according to your operating system platform) from set one.
      • During installation, select the option to install both components in one step.
    2. On different machines
      • Install the Development tools component on either the Windows or the Linux machines as this component is supported only on these platforms.
      • Install the application server component on the other machine.
  3. To add a separate Web server to either of the first two scenarios Use the Web Server Security Plug-in CD for your platform to install the separate Web server.
  4. To add DB2 Universal Database Express Edition to either of the first two scenarios Use the CD from set 2 to install the database on your platform.

IMPORTANT: You may use DB2 Universal Database Express Edition on a machine only for demonstrating, testing and developing application programs. You may not install either program on a production server. See the enclosed license for more details.

Installing WebSphere Application Server - Express on Windows

This section contains information about installing WebSphere Application Server - Express on Windows. The major components of WebSphere Application Server - Express are the Application Server, the Remote Agent Controller, and WebSphere Studio Site Developer (WSSD). You can choose to install any or all of these components. You need to install the Remote Agent Controller along with the Application Server if you want to be able to administer the Application Server using WSSD.You can install WebSphere Application Server - Express either from the CD-ROM or from the electronic images that you download.

Migration and coexistence issues

Do not install this version of WebSphere Application Server - Express over an earlier version. You can either install into a different directory for coexistence, or you can uninstall the previous version before installing to the same directory.

Important: If you try to open a Version 4.0.x from the Version 5.0 IDE, the workspace will be converted to a Version 5.0 workspace. Project names, project source files, and project Java build paths (class paths) are retained. However, user interface settings, debug settings, and most preferences are lost. Refer to the migration information for instructions on safely migrating your existing projects to Version 5.0.

As a precaution, it is recommended that you make a backup copy of your workspace prior to migrating to Version 5.0.2. prior to migrating to Version 5.1.

Installing from the CD-ROM

Before you install the product, check the following things:

To install WebSphere Application Server - Express from the first product CD, follow these steps:

  1. Read "Migration and coexistence issues" before you begin the installation procedure.
  2. Insert the CD-ROM into your CD drive.
  3. If autorun is enabled on your system, the launchpad program will automatically come up. If autorun is disabled on your system, run launchpad.exe from the root of the first installation CD to display the WebSphere Application Server - Express Installation Launcher window.

    Tips:

  4. The WebSphere Application Server - Express installation launcher window contains several links that you can select to browse the readme file, this Installation Guide, the Getting Started Guide, the Migration Guide, or the Web development interactive tour. Select Install to begin installing the product. Select Exit to close the launchpad at any time. The launchpad does not have to remain running during the product installation.
  5. Follow the on-screen instructions for tasks such as specifying the target installation directory. Important: Do not install into a directory with a name that contains double-byte characters or special characters such as a dollar sign. Doing so may cause undesirable results such as class path problems in the WebSphere test environment.
  6. Note that the full install takes between 10 and 30 minutes depending on your hardware configuration and the features you choose to install.
  7. When WebSphere Application Server - Express is installed, click Finish to close the installation window.
  8. If any errors are reported, refer to the indicated log file (expressInstallLog in the install destination directory) for more information.

Installing from electronic images

There are multiple downloable parts for WebSphere Application Server - Express. All parts are self-extracting archives, and all parts are required.

Before you install the product, check the following:

To install the electronic image of WebSphere Application Server - Express, follow these steps:

  1. Click on each part and select the Save this program to disk option. Download each part to the same directory. Make sure you have plenty of space on the drive you download to. You need approximately 2 GB of disk space to download and unpack the images.
  2. Navigate to the extraction directory and click on each part. Select the same directory to unpack each of the parts into. Note that you must unpack all the parts to the same directory in order to produce a valid install image.
  3. After you have unpacked all the downloadable parts, delete them to save disk space.
  4. The unpacked files are the same as on the WebSphere Application Server - Express installation CD. Refer to the instructions above on installing from CD to complete the installation. Navigate to the directory containing the unpacked files and run launchpad.exe.

Verifying your installation

After installing WebSphere Application Server - Express you should have the following directory structure under the <Expressinstallpath> that you selected during the install:

 _uninst
Contains 3 files plus a _jvm directory for uninstalling Express.

AppServer
Application Server files -- approximately 8000 files.

Express
Miscellaneous files for databases and scripts -- approximately 400 files.

License
Contains approximately 13 license files.

Logs
Contains several installation log files.

RAC
IBM Agent Controller files -- approximately 50 files.

readme
Contains the readme, installation guide, and the Getting Started PDF - approximately 400 files.

SiteDeveloper
WebSphere Studio Site Developer files -- approximately 35,000 files (when national language support files are included).

Tour
Flash tutorial of using Studio Site Developer -- approximately 100 files.

If any of these directories contain a substantially different number of files, then you should suspect a problem happened during installation. Look at the expressInstallLog.txt file in the <Expressinstallpath>to diagnose the problem.

Verifying your Site Developer installation

If the installation completed successfully, start Site Developer through the Start >Programs > IBM WebSphere Application Server - Express v5.0.2 >Studio Site Developer menu item. Once Site Developer starts, follow the links on the Welcome page to load and run an Express example.

Verifying your Agent Controller installation

First look at the racInstallLog.txt file in the <Expressinstallpath>. Go to the bottom and check the install completion status. If the installation completed successfully then check that IBM Agent Controller it is running. The IBM Agent Controller is always installed as a Windows service and is automatically started. IBM Agent Controller provides the communication channel between Site Developer and Application Server. Check the Control Panel> Administrative Tools > Services to see that IBM Agent Controller is listed and running. If you suspect a problem take a look at the servicelog.log file in the <Expressinstallpath>\RAC\config directory.

If the installation did not complete successfully, look at racInstallLog.txt. If the racInstallLog.txt file does not exist, then it could mean that another version of IBM Agent Controller is already on the system. Uninstall the other version and retry the installation.

Verifying your Application Server installation

You can verify the basic operation of your Application Server installation by running the <Expressinstallpath>\Express\bin\testServer.bat file. This batch file will step through starting and stopping the Application Server using its default configuration. Note that this batch file is only used for testing your server installation. You will use Studio Site Developer for starting, stopping, and configuring the Application Server during normal use.

Invoking a Silent Install

WebSphere Application Server - Express installation program can be run silently, if you wish to bundle the product with your own. To install WebSphere Application Server - Express silently the -silent command-line option is used. During a silent install, you will not see wizard panels after you invoke the install command.

To run the installation silently taking all the defaults use a command similar to:

setupwin32.exe -silent

If you want to change the default Express installation location (IBM/WebSphere/Express), use:

setupwin32.exe -silent -P waseBean.installLocation=c:\<yourdirectory>

You can also use a response file to set additional options for a silent install. See the example response file on the installation CD for a template. To run a silent install using a response file use a command like:

setupwin32.exe -silent -options responsefile

Uninstalling WebSphere Application Server - Express on Windows

To uninstall WebSphere Application Server - Express:

  1. Close WebSphere Application Server - Express.
  2. Select the IBM WebSphere Application Server - Express v5.0.2 entry in Add/Remove Programs.
  3. Follow the instructions in the wizard to uninstall the product.
  4. Here are some directories that remain:

    To completely clean up any remaining files, go to the installation directory and remove the remaining folders.

Notes on IBM Agent Controller security configuration options

The IBM Agent Controller provides the communication mechanism between Studio Site Developer and Application Server. The Agent Controller is installed as a Windows service and is configured to run under the Local System account. You can use the Windows Services manager panel to change this configuration to have the IBM Agent Controller run under another user account if you wish. Since the Agent Controller is used to start Application Server, the account that Agent Controller is running under is also the account that the Application Server is running under.

There are various options in securing the link between Studio Site Developer and Agent Controller. The installation configures the link to allow any Studio Site Developer user to connect with Agent Controller. You will want to change this security default if using Agent Controller in a production server environment.

You can use the <Expressinstallpath>\RAC\bin\RACSecurityOn.bat and RACSecurityOff.bat files to enable and disable basic login security. When security is enabled the Studio Site Developer user must provide a valid username and password combination that is an operating system username and password when connecting to Agent Controller. The username and password are forwarded by Agent Controller to the operating system for authentication. On Windows, domain name passwords will not be authenticated. You must provide local username and password pairs.

Known problems and limitations

This section covers known problems and limitations with installation and uninstallation for WebSphere Application Server - Express on Windows.

Problems installing WebSphere Application Server - Express from a network drive

If you map to a network drive without specifying a device name (for example, \\computername\sharename), you may get the following message when you try to install WebSphere Application Server - Express: The wizard cannot continue because of the following error: could not load wizard specified in /wizard.inf(104). The work around is to locally map to the network drive by specifying a device name (for example, x:\sharename).

Disk limitations

Do not install to a Novell NetWare drive. Installation will fail on a Novell NetWare drive.

User authorization

You should log on as an administrator before beginning the WebSphere Application Server - Express installation.

Shell extension (Windows NT)

If you get a message that indicates that the installation program has detected a shell extension for Windows NT, the installation cannot proceed. You should then perform the following steps:

  1. Make sure you have an Emergency Recovery Disk. Instructions for creating this are available in the Windows help documentation.
  2. Type regedit.exe at a command prompt.
  3. In the Registry Editor, expand the key
    \\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon
    
  4. Select the shell name in the name/data pairs for the above key. Important: Make a note of the data recorded for this name, because you will need it after installing WebSphere Application Server - Express.
  5. Select Edit > Modify from the menu bar for the shell name/data pair.
  6. Set the value for the shell name to Explorer.exe. Click OK.
  7. Select Registry > Exit from the menu bar.
  8. Restart and complete the WebSphere Application Server - Express installation.
  9. Once installation is complete, restore the previous registry entry as follows:
    1. Type regedit.exe at a command prompt.
    2. In the Registry Editor, expand the key
      \\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon
      
    3. Select the shell name in the name/data pairs for the above key.
    4. Select Edit > Modify from the menu bar for the shell name/data pair.
    5. Restore the value for the shell name to the value that was recorded in Step 4. Click OK.
    6. Select Registry > Exit from the menu bar.

Recovering from failed installation

If your installation fails, you must remove any WebSphere Application Server - Express files that have been installed. If the directory where you intended to install WebSphere Application Server - Express is empty, then the installation process has already removed any files that were installed and you can delete the empty directory if you want to.

Steps to take if your installation fails:

  1. Analyze the installation log files to determine the nature of the problem.
  2. Correct the problem.
  3. Remove all traces of the partial install by running uninstall if it is available and then deleting the remaining files.
  4. Retry the install.

Installing WebSphere Application Server - Express on Linux

This section contains information about installing WebSphere Application Server - Express on Linux. The major components of WebSphere Application Server - Express are the Application Server, the Remote Agent Controller, and WebSphere Studio Site Developer (WSSD). You can choose to install any or all of these components. You need to install the Remote Agent Controller along with the Application Server if you want to be able to administer the Application Server using WSSD.

You can install WebSphere Application Server - Express either from the CD-ROM or from the electronic images that you download.

Migration and coexistence issues

Do not install this version of WebSphere Application Server - Express over an existing version. You must uninstall the previous version before installing this one.

WebSphere Application Server - Express can coexist with other WebSphere Studio products.

For instructions on safely migrating your existing projects from a previous version of WebSphere Application Server - Express to Version 5.1, refer to the Migration Guide.

As a precaution, it is recommended that you make a backup copy of your Version 4.0.x and Version 5.0 workspaces prior to migrating to Version 5.1.

Installing from the CD-ROM

If you have a previous copy of WebSphere Application Server - Express on your system, you should uninstall it before proceeding.

To install WebSphere Application Server - Express from the product CD, follow these steps:

  1. Insert the Linux CD-ROM into your CD drive.
  2. Log in as root.
  3. Run launchpad.sh from the root of the CD drive.
  4. The WebSphere Application Server - Express installation launcher window contains several links that you can select to browse the readme file, this Installation Guide, the Getting Started Guide, or the Migration Guide. Select Install to begin installing the product. Select Exit to close the launchpad at any time. The launchpad does not have to remain running during the product installation.
  5. Follow the on-screen instructions to navigate through the installation wizard
  6. Note that the full install takes between 10 and 30 minutes depending on your hardware configuration and the features you choose to install.
  7. When WebSphere Application Server - Express is installed, click Finish to close the installation window.
  8. If any errors are reported refer to the indicated log file (/opt/IBM/WebSphere/Express/expressInstallLog.txt) for more information.
  9. The Application Server and miscellaneous Express files are installed in the /opt/IBM/WebSphere/Express directory.
  10. The Studio Site Developer component is installed in the /opt/IBM/WebSphereStudio/SiteDeveloper directory.
  11. The IBM Agent Controller is installed in the /opt/IBMRAC directory.
  12. You will use Studio Site Developer to create and to deploy applications to Application Server. In addition you will use Studio Site Developer to administer (start, stop, change configurations) Application Server. You can also use the browser-based Administrative Console for administering the server.
  13. The install will start the IBM Agent Controller to enable communication between Site Developer and Application Server. To start the IBM Agent Controller manually change to the /opt/IBMRAC/bin directory and run ./RAStart.sh.
  14. Site Developer should be started from a user login. To start Site Developer, change to the /opt/IBM/WebSphere/Express/SiteDeveloper directory and run ./wasexpress51 or click on the WebSphere Application Server - Express Studio Site Developer entry in the Start >Programs menu.

Installing from the downloadable images

Before you install the product, check the following:

The image of the Linux CD for WebSphere Application Server - Express is split into multiple parts to reduce download size. Each part is a tape archive (tar) file and all parts are required.

To install the electronic images of WebSphere Application Server - Express, follow these steps:

  1. Download each part to the same directory.
  2. Use a command similar to the following to unpack the tar file: tar -zxvf downloadpart.tar.gz
  3. After you have unpacked all the downloadable parts you are finished with them, and may delete them to save disk space.
  4. The unpacked files are the same as on the WebSphere Application Server - Express CD. Refer to the instructions above on installing from CD to complete the installation. Navigate to the directory that you unpacked the files to and run the launchpad.sh program.

Verifying your installation

After installing WebSphere Application Server - Express you should have the following directory structure:

/opt/IBM/WebSphere/Express/_uninst
Contains 3 files plus a _jvm directory for uninstalling Express.

/opt/IBM/WebSphere/Express/AppServer
Application Server files -- approximately 8000 files.

/opt/IBM/WebSphere/Express/Express
Miscellaneous files for databases and scripts -- approximately 400 files.

/opt/IBM/WebSphere/Express/License
Contains approximately 13 license files.

/opt/IBMRAC
IBM Agent Controller files -- approximately 65 files.

/opt/IBM/WebSphere/Express/readme
Release notes for the components of WebSphere Studio.

/opt/IBM/WebSphere/Express/SiteDeveloper
WebSphere Studio Site Developer files -- approximately 35,000 files.

If any of these directories contain a substantially different number of files, then you should suspect a problem happened during installation. Look at the /opt/IBM/WebSphere/Express/expressInstallLog.txt file.

Verifying your Site Developer installation

First look at the /opt/IBM/WebSphere/Express/expressInstallLog.txt file. Go to the bottom and check the install completion status. If the installation completed successfully, start Site Developer by running wasexpress51 or /opt/IBM/WebSphere/Express/SiteDeveloper/wasexpress51. Once Site Developer starts, follow the links on the Welcome page to load and run one of the Express examples.

If the installation did not complete successfully look through the expressInstallLog.txt to determine the reason.

Verifying your Agent Controller installation

First look at the /opt/IBM/WebSphere/Express/logs/racInstallLog.txt file. Go to the bottom and check the install completion status. If the installation completed successfully then start IBM Agent Controller by running the /opt/IBMRAC/bin/RAStart.sh. If you suspect a problem take a look at the /opt/IBMRAC/config/servicelog.log file.

If the installation did not complete successfully look through the racInstallLog.txt to determine the reason.

Verifying your Application Server installation

You can verify the basic operation of your Application Server installation by running the /opt/IBM/WebSphere/Express/Express/bin/testServer.sh script. This script will step through starting and stopping the Application Server using its default configuration. Note that this script is only used for testing your server installation. You will use Studio Site Developer for starting, stopping, and configuring the Application Server during normal use. You can also use the browser-based Administrative Console for administering the server.

Invoking a Silent Install

The WebSphere Application Server - Express installation program can be run silently, if you wish to bundle the product with your own. To install WebSphere Application Server - Express silently the -silent command-line option is used. During a silent install, you will not see wizard panels after you invoke the install command.

To run the installation silently taking all the defaults use a command similar to:

./setupLinux -silent

You can also use a response file to set additional options for a silent install. See the example response file on the installation CD for a template. To run a silent install using a response file use a command like:

./setupLinux -silent -options responsefile

Notes on IBM Agent Controller security configuration options

The IBM Agent Controller provides the communication mechanism between Studio Site Developer and Application Server.

There are various options in securing the link between Studio Site Developer and Agent Controller. The installation configures the link to allow any Studio Site Developer user to connect with Agent Controller. You will want to change this security default when using Agent Controller in a production server environment.

You can use the /opt/IBMRAC/bin/RACSecurityOn.sh and RACSecurityOff.sh scripts to enable and disable basic log in security. When security is enabled the Studio Site Developer user must provide a valid username and password combination that is an operating system username and password when connecting to Agent Controller. The username and password are forwarded by Agent Controller to the operating system for authentication.

(Optional) Upgrading to GTK 2.2 or later

Warnings:

If you want to use double-byte character set (DBCS) on Red Hat 8.0, you need to perform the following steps to upgrade GTK to 2.2 or later. The below instructions are for GTK 2.2.

  1. Log in as root user.
  2. From the prompt command window, type:
    export LD_LIBRARY_PATH=/usr/local/lib/:$LD_LIBRARY_PATH
    
  3. Ensure that the libtiff-devel RPM package has been installed. To verify that it is installed on your machine, type this command:
    rpm -q libtiff-devel
    

    If it is not installed, install it from the Red Hat installation CD.

  4. Edit the /etc/ld.so.conf file and add the following line:
    /usr/local/lib
    
  5. Go to the FTP site at ftp.gtk.org/pub/gtk/v2.2/ and download the following files:
  6. For each of these files and in the order specified in the previous step, do the following steps:
    1. Unzip and untar the file (for example, tar xvfz gtk+-2.0.0.tar.gz).
    2. Change to the directory that you created.
    3. Run the following commands:
      ./configure
      make
      make install
      /sbin/ldconfig
      

By default, the GTK 2.0.6 installation is picked up. To make sure your application uses GTK 2.2, every time you need to run the following example commands from the command line before launching the application.

export LD_LIBRARY_PATH=/usr/local/lib/:$LD_LIBRARY_PATH
export PATH=/usr/local/bin/:$PATH
/usr/bin/

For more information on using GTK, consult the Web site at developer.gnome.org/doc/API/2.2/gtk/gtk-building.html.

Uninstalling WebSphere Application Server - Express on Linux

To uninstall WebSphere Application Server - Express on Linux, follow these steps:

  1. Log in as root.
  2. Change to the /opt/IBM/WebSphere/Express/_uninst directory.
  3. Uninstall WebSphere Application Server - Express by typing this command:
    ./uninstaller
    
  4. To completely clean up any remaining files, go to the installation directory and remove the remaining folders.
  5. Here are some directories that remain:

    To completely clean up any remaining files, go to the installation directory and remove the remaining folders.

Known problems and limitations

This section covers known problems and limitations with installation and uninstallation of WebSphere Application Server - Express for Linux.

Recovering from failed installations

If your installation fails:

  1. Analyze the installation log files to determine the nature of the problem.
  2. Correct the problem.
  3. Remove all traces of the partial install by running uninstall if it is available and then deleting the remaining files.
  4. Retry the install.

Unable to locate JVM when trying to uninstall

Occasionally an install failure can result in the uninstall files in the _uninst directory not being complete. The symptom of this is a message stating that a suitable JVM can not be found when trying you run the uninstall. You should manually run the uninstall as follows:

  1. Open a command prompt to the <Expressinstallpath>/_uninst directory.
  2. Locate a Java JVM on your machine. You can do this by searching your machine for java or you can type in "java -version" at the command line to see if the Java executable is in your path.
  3. Enter this command to run the uninstall: <javapath>/java -jar uninstall.jar
  4. Follow the uninstall wizard to complete the uninstall.
  5. Erase any left over files in the <Expressinstallpath > after the uninstall completes.

Installing WebSphere Application Server - Express on AIX

This section contains information about installing WebSphere Application Server - Express on AIX. The major components of WebSphere Application Server - Express that can be installed on AIX are the Application Server and the Remote Agent Controller. You can choose to install either or both of these components. You need to install the Remote Agent Controller along with the Application Server if you want to be able to administer the Application Server on AIX using Studio Site Developer on Windows or Linux. You may also use the browser-based Administrative Console to administer the Application Server.

You may install WebSphere Application Server - Express either from the CD-ROM or from the electronic images that you download.

Installing from the CD-ROM

If you have a previous copy of WebSphere Application Server - Express on your system, you should uninstall it before proceeding.

To install WebSphere Application Server - Express from the product CD, follow these steps:

  1. Insert the AIX CD-ROM into your CD drive.
  2. Login as root.
  3. Run launchpad.sh from the root of the CD drive.
  4. The WebSphere Application Server - Express installation launcher window contains several links that you can select to browse the readme file, this Installation Guide, the Getting Started Guide, or the Migration Guide. Select Install to begin installing the product. Select Exit to close the launchpad at any time. The launchpad does not have to remain running during the product installation.
  5. Follow the on-screen instructions to navigate through the installation wizard
  6. Note that the full install takes between 10 and 30 minutes depending on your hardware configuration and the features you choose to install.
  7. When WebSphere Application Server - Express is installed, click Finish to close the installation window.
  8. If any errors are reported refer to the indicated log file (/opt/IBM/WebSphere/Express/expressInstallLog.txt) for more information.
  9. The Application Server and miscellaneous Express files are installed in the /opt/IBM/WebSphere/Express directory.
  10. The IBM Agent Controller is installed in the /opt/IBMRAC directory.
  11. You may use Studio Site Developer (running on Windows or Linux) to create and to deploy applications to Application Server. In addition, you can use Studio Site Developer to administer (start, stop, change configurations) Application Server. You can also use the browser-based Administrative Console for administering the server.
  12. The install will start the IBM Agent Controller to enable communication between Site Developer and Application Server. To start the IBM Agent Controller manually change to the /opt/IBMRAC/bin directory and run ./RAStart.sh.

Installing from the downloadable images

Before you install the product, check the following:

The image of the AIX CD for WebSphere Application Server - Express is split into multiple parts to reduce download size.

Each part is a tape archive (tar) file and all parts are required. To install the electronic images of WebSphere Application Server - Express, follow these steps:

  1. Download each part to the same directory.
  2. Use a command similar to the following to unpack the tar file: tar -zxvf downloadpart.tar.gz
  3. After you have unpacked all the parts you are finished with the downloaded parts and may remove them to save disk space.
  4. The unpacked files are the same as on the WebSphere Application Server - Express CD. Refer to the instructions above on installing from CD to complete the installation. You essentially just navigate to the directory that you unpacked the files to and run the launchpad.sh program.

Verifying your installation

After installing WebSphere Application Server - Express you should have the following directory structure:

/opt/IBM/WebSphere/Express/_uninst
Contains 3 files for uninstalling Express.

/opt/IBM/WebSphere/Express/AppServer
Application Server files -- approximately 8000 files.

/opt/IBM/WebSphere/Express/Express
Miscellaneous files for databases and scripts -- approximately 380 files.

/opt/IBM/WebSphere/Express/License
Contains approximately 13 license files.

/opt/IBMRAC
IBM Agent Controller files -- approximately 65 files.

/opt/IBM/WebSphere/Express/readme
Contains the readme, installation guide, and the Getting Started PDF.

If any of these directories contain a substantially different number of files, then you should suspect a problem happened during installation. Look at the /opt/IBM/WebSphere/Express/expressInstallLog.txt file.

Verifying your Agent Controller Installation

First look at the /opt/IBM/WebSphere/Express/expressracInstallLog.txt file. Go to the bottom and check the install completion status. If the installation completed successfully, then start IBM Agent Controller by running the /opt/IBMRAC/bin/RAStart.sh. If you suspect a problem, take a look at the /opt/IBMRAC/config/servicelog.log.file.

If the installation did not complete successfully look through the racInstallLog.txt to determine the reason.

Verifying your Application Server installation

You can verify the basic operation of your Application Server installation by running the /opt/IBM/WebSphere/Express/bin/testServer.sh script. This script will step through starting and stopping the Application Server using its default configuration. Note that this script is only used for testing your server installation. You will use Studio Site Developer for starting, stopping, and configuring the Application Server during normal use. You can also use the browser-based Administrative Console for administering the server.

Invoking a Silent Install

The WebSphere Application Server Express installation program can be run silently, if you wish to bundle the product with your own. To install WebSphere Application Serve - Express silently, the -silent command-line option is used. During a silent install, you will not see wizard panels after you invoke the install command.

To run the installation silently, taking all the defaults use a command similar to:

./aix/setupAIX -silent

You can also use a response file to set additional options for a silent install. See the example response file on the installation CD for a template. To run a silent install using a response file, use a command like:

./aix/setupAIX -silent -options responsefile

Notes on IBM Agent Controller security configuration options

The IBM Agent Controller provides the communication mechanism between Studio Site Developer and Application Server.

There are various options in securing the link between Studio Site Developer and Agent Controller. The installation configures the link to allow any Studio Site Developer user to connect with Agent Controller. You will want to change this security default when using Agent Controller in a production server environment.

You can use the /opt/IBMRAC/bin/RACSecurityOn.sh and RACSecurityOff.sh scripts to enable and disable basic login security. When security is enabled the Studio Site Developer user must provide a valid username and password combination that is an operating system username and password when connecting to Agent Controller. The username and password are forwarded by Agent Controller to the operating system for authentication.

Uninstalling WebSphere Application Server - Express on AIX

To uninstall WebSphere Application Server - Express on AIX, follow these steps:

  1. Log in as root.
  2. Change to the /opt/IBM/WebSphere/Express/_uninst directory.
  3. Uninstall WebSphere Application Server - Express by typing:
    ./uninstall.sh
    
  4. To completely clean up any remaining files, go to the installation directory and remove the remaining folders.

Known problems and limitations

This section covers known problems and limitations with installation and uninstallation of WebSphere Application Server - Express for AIX.

Recovering from failed installations

If your installation fails:

  1. Analyze the installation log files to determine the nature of the problem.
  2. Correct the problem.
  3. Remove all traces of the partial install by running uninstall if it is available and then deleting the remaining files.
  4. Retry the install.

Unable to locate JVM when trying to uninstall

Occasionally an install failure can result in the uninstall files in the _uninst directory not being complete. The symptom of this is a message stating that a suitable JVM can not be found when trying you run the uninstall. You should manually run the uninstall as follows:

  1. Open a command prompt to the <Expressinstallpath>/_uninst directory.
  2. Locate a Java JVM on your machine. You can do this by searching your machine for java or you can type in "java -version" at the command line to see if the java executable is in your path.
  3. Enter this command to run the uninstall: <javapath>/java -jar uninstall.jar
  4. Follow the uninstall wizard to complete the uninstall.
  5. Erase any left over files in the <Expressinstallpath > after the uninstall completes.

Installing WebSphere Application Server - Express on Solaris

Installing from the CD-ROM

If you have a previous copy of WebSphere Application Server - Express on your system, you should uninstall it before proceeding.

To install WebSphere Application Server - Express from the product CD, follow these steps:

  1. Insert the Solaris CD-ROM into your CD drive.
  2. Login as root.
  3. Run launchpad.sh from the root of the CD drive.
  4. The WebSphere Application Server - Express installation launcher window contains several links that you can select to browse the readme file, this Installation Guide, the Getting Started Guide, or the Migration Guide. Select Install to begin installing the product. Select Exit to close the launchpad at any time. The launchpad does not have to remain running during the product installation.
  5. Note that the full install takes between 10 and 30 minutes depending on your hardware configuration and the features you choose to install.
  6. When WebSphere Application Server - Express is installed, click Finish to close the installation window.
  7. If any errors are reported refer to the indicated log file (/opt/IBM/WebSphere/Express/expressInstallLog) for more information.
  8. The Application Server and miscellaneous Express files are installed in the /opt/IBM/WebSphere/Express directory.

Installing from the downloadable images

Before you install the product, check the following:

The image of the Solaris CD for WebSphere Application Server - Express is split into multiple parts to reduce download size. Each part is a tape archive (tar) file and all parts are required.

To install the electronic images of WebSphere Application Server - Express, follow these steps:

  1. Download each part to the same directory.
  2. Use a command similar to the following to unpack the tar file: tar -zxvf downloadpart.tar.gz
  3. After you have unpacked all the downloadable parts you are finished with them, and may delete them to save disk space.
  4. The unpacked files are the same as on the WebSphere Application Server - Express CD. Refer to the instructions above on installing from CD to complete the installation. Navigate to the directory that you unpacked the files to and run the launchpad.sh program.

Verifying your installation

After installing WebSphere Application Server - Express you should have the following directory structure:

/opt/IBM/WebSphere/Express/_uninst
Contains 3 files for uninstalling Express.

/opt/IBM/WebSphere/Express/AppServer
Application Server files -- approximately 8000 files.

/opt/IBM/WebSphere/Express/Express
Miscellaneous files for databases and scripts -- approximately 380 files.

/opt/IBM/WebSphere/Express/License
Contains approximately 13 license files.

/opt/IBM/WebSphere/Express/readme
Contains the readme, installation guide, and the Getting Started PDF.

If any of these directories contain a substantially different number of files, then you should suspect a problem happened during installation. Look at the /opt/IBM/WebSphere/Express/expressInstallLog.txt file.

Invoking a Silent Install

The WebSphere Application Server - Express installation program can be run silently, if you wish to bundle the product with your own. To install WebSphere Application Server - Express silently the -silent command-line option is used. During a silent install, you will not see wizard panels after you invoke the install command.

To run the installation silently taking all the defaults use a command similar to:

./solaris/setupSolaris -silent

You can also use a response file to set additional options for a silent install. See the example response file on the installation CD for a template. To run a silent install using a response file use a command like:

./solaris/setupSolaris -silent -options responsefile

Uninstalling WebSphere Application Server - Express on Solaris

To uninstall WebSphere Application Server - Express on Solaris, follow these steps:

  1. Log in as root.
  2. Change to the /opt/IBM/WebSphere/Express/_uninst directory.
  3. Uninstall WebSphere Application Server - Express by typing:
    ./uninstall.sh
    
  4. To completely clean up any remaining files, go to the installation directory and remove the remaining folders.

Known problems and limitations

This section covers known problems and limitations with installation and uninstallation of WebSphere Application Server - Express for Solaris.

Recovering from failed installations

If your installation fails:

  1. Analyze the installation log files to determine the nature of the problem.
  2. Correct the problem.
  3. Remove all traces of the partial install by running uninstall if it is available and then deleting the remaining files.
  4. Retry the install.

Unable to locate JVM when trying to uninstall

Occasionally an install failure can result in the uninstall files in the _uninst directory not being complete. The symptom of this is a message stating that a suitable JVM can not be found when trying you run the uninstall. You should manually run the uninstall as follows:

  1. Open a command prompt to the <Expressinstallpath>/_uninst directory.
  2. Locate a Java JVM on your machine. You can do this by searching your machine for java or you can type in "java -version" at the command line to see if the java executable is in your path.
  3. Enter this command to run the uninstall: <javapath>/java -jar uninstall.jar
  4. Follow the uninstall wizard to complete the uninstall.
  5. Erase any left over files in the <Expressinstallpath > after the uninstall completes.

Installing WebSphere Application Server - Express on HP-UX

This section contains information about installing WebSphere Application Server - Express on HP-UX. Only the Application Server component of WebSphere Application Server - Express can be installed on HP-UX. You use the browser-based Administrative Console to administer the Application Server on HP-UX.

You may install WebSphere Application Server - Express either from the CD-ROM or from the electronic images that you download.

Installing from the CD-ROM

If you have a previous copy of WebSphere Application Server - Express on your system, you should uninstall it before proceeding.

To install WebSphere Application Server - Express from the product CD, follow these steps:

  1. Insert the HP/UX CD-ROM into your CD drive.
  2. Login as root.
  3. Run launchpad.sh from the root of the CD drive.
  4. The WebSphere Application Server - Express installation launcher window contains several links that you can select to browse the readme file, this Installation Guide, the Getting Started Guide, or the Migration Guide. Select Install to begin installing the product. Select Exit to close the launchpad at any time. The launchpad does not have to remain running during the product installation.
  5. Note that the full install takes between 10 and 30 minutes depending on your hardware configuration and the features you choose to install.
  6. When WebSphere Application Server - Express is installed, click Finish to close the installation window.
  7. If any errors are reported refer to the indicated log file (/opt/IBM/WebSphere/Express/expressInstallLog) for more information.
  8. The Application Server and miscellaneous Express files are installed in the /opt/IBM/WebSphere/Express directory.

Installing from the downloadable images

Before you install the product, check the following:

The image of the HP/UX CD for WebSphere Application Server - Express is split into multiple parts to reduce download size. Each part is a tape archive (tar) file and all parts are required.

To install the electronic images of WebSphere Application Server - Express, follow these steps:

  1. Download each part to the same directory.
  2. Use a command similar to the following to unpack the tar file: tar -zxvf downloadpart.tar.gz
  3. After you have unpacked all the downloadable parts you are finished with them, and may delete them to save disk space.
  4. The unpacked files are the same as on the WebSphere Application Server - Express CD. Refer to the instructions above on installing from CD to complete the installation. Navigate to the directory that you unpacked the files to and run the launchpad.sh program.

Verifying your installation

After installing WebSphere Application Server - Express you should have the following directory structure:

/opt/IBM/WebSphere/Express/_uninst
Contains 3 files for uninstalling Express.

/opt/IBM/WebSphere/Express/AppServer
Application Server files -- approximately 8000 files.

/opt/IBM/WebSphere/Express/Express
Miscellaneous files for databases and scripts -- approximately 380 files.

/opt/IBM/WebSphere/Express/License
Contains approximately 13 license files.

/opt/IBM/WebSphere/Express/readme
Contains the readme, installation guide, and the Getting Started PDF.

If any of these directories contain a substantially different number of files, then you should suspect a problem happened during installation. Look at the /opt/IBM/WebSphere/Express/expressInstallLog.txt file.

Verifying your Application Server installation

You can verify the basic operation of your Application Server installation by running the /opt/IBM/WebSphere/Express/bin/testServer.sh script. This script will step through starting and stopping the Application Server using its default configuration. Note that this script is only used for testing your server installation.

Invoking a Silent Install

The WebSphere Application Server - Express installation program can be run silently, if you wish to bundle the product with your own. To install WebSphere Application Server - Express silently the -silent command-line option is used. During a silent install, you will not see wizard panels after you invoke the install command.

To run the installation silently taking all the defaults use a command similar to:

./hpux/setupHPUX -silent

You can also use a response file to set additional options for a silent install. See the example response file on the installation CD for a template. To run a silent install using a response file use a command like:

./hpux/setupHPUX -silent -options responsefile

Uninstalling Websphere Application Server - Express on HP-UX

To uninstall WebSphere Application Server - Express on HP-UX, follow these steps:

  1. Log in as root.
  2. Change to the /opt/IBM/WebSphere/Express/_uninst directory.
  3. Uninstall WebSphere Application Server - Express by typing:
    ./uninstall.sh
    
  4. To completely clean up any remaining files, go to the installation directory and remove the remaining folders.

Known problems and limitations

This section covers known problems and limitations with installation and uninstallation of WebSphere Application Server - Express for HP-UX.

Recovering from failed installations

If your installation fails:

  1. Analyze the installation log files to determine the nature of the problem.
  2. Correct the problem.
  3. Remove all traces of the partial install by running uninstall if it is available and then deleting the remaining files.
  4. Retry the install.

Unable to locate JVM when trying to uninstall

Occasionally an install failure can result in the uninstall files in the _uninst directory not being complete. The symptom of this is a message stating that a suitable JVM can not be found when trying you run the uninstall. You should manually run the uninstall as follows:

  1. Open a command prompt to the <Expressinstallpath>/_uninst directory.
  2. Locate a Java JVM on your machine. You can do this by searching your machine for java or you can type in "java -version" at the command line to see if the java executable is in your path.
  3. Enter this command to run the uninstall: <javapath>/java -jar uninstall.jar
  4. Follow the uninstall wizard to complete the uninstall.
  5. Erase any left over files in the <Expressinstallpath > after the uninstall completes.

Setting up HTTP Web Server Plug-ins

This section describes how to setup the Web server plug-in feature for WebSphere Application Server - Express. The Web server plug-in feature should be installed from the Web server plug-in CD included with WebSphere Application Server - Express Version 5.0.2.

The Web server plug-ins allow users to separate the Web server machine and the Express Application server machine for increased security and performance. This separation also allows you to be more flexible in the architecture of the Web site in general.

These plug-ins communicate with WebSphere Application Server - Express over HTTP(S).

The Web Server plug-in installation includes all of the necessary components to automatically configure the following Web servers on platforms for which they are supported.

The Web server plug-in must be installed on the same machine as your HTTP Web server. Therefore, Ensure your HTTP Web server is already installed on the machine before installing the HTTP Web server plug-in.

Refer to the README file located on the Web Server Plug-in CD for detailed information about the following topics:

Installing from the CD

To install the HTTP Web Server Plug-ins from the CD, follow these steps:.

  1. Insert the Web Server Plug-in CD-ROM into your CD drive.
  2. Run the platform specific installation program
  3. Follow the on-screen instructions to navigate through the installation wizard.
  4. Note that you will be prompted for the following information during the installation process:
  5. Please read the installation summary panel to determine if any errors or warnings are reported .
  6. When WebSphere Application Server - Express Plug-ins is installed, click Finish to close the installation window.
  7. The HTTP Web server configuration file will be automatically configured. Restart the your Web server to ensure the Web server was configured correctly. If the Web server fails to restart, refer to the Troubleshooting section of the README file located on the Web Server Plug-in CD.

Invoking a Silent Install

WebSphere Application Server - Express Plugin-ins installation program can be run silently, if you wish to bundle the product with your own. To install WebSphere Application Server - Express Plug-ins silently the -silent command-line option is used. During a silent install, you will not see wizard panels after you invoke the install command.

You should use a response file to set the appropriate options for a silent install. See the example response file on the installation CD for a template. To run a silent install using a reponse file use a command like:

install.exe -silent -options responsefile

Uninstalling HTTP Web Server Plug-ins on Windows

To uninstall the HTTP Web Server Plug-ins for WebSphere Application Server - Express, follow these steps:

  1. Select the IBM WebSphere Application Server - Express Plugins v5.0.2 entry in Add/Remove Programs.
  2. Follow the uninstall wizard to uninstall the product.
  3. To completely clean-up any remaining files, go to the installation directory and remove the remaining folders.

Uninstalling HTTP Web Server Plug-ins on Linux and Unix

To uninstall the HTTP Web server plug-ins for WebSphere Application Server - Express on Linux and Unix platforms, follow these steps:

  1. Log in as root.
  2. Change to the /opt/IBM/WebSphere/Express/Plugins/_uninst directory.
  3. Uninstall the HTTP Web Server Plug-ins for WebSphere Application Server - Express by typing:

    ./uninstall.sh
    
  4. To completely clean up any remaining files, go to the installation directory and remove the remaining folders.

 

Setting up WebSphere Application Server - Express for working in a team environment

By default, Concurrent Versions System (CVS) plug-ins are automatically installed. However, you can still choose between CVS and Rational(R) ClearCase(R) as your software configuration management (SCM) system. Several other SCM repositories can be integrated with WebSphere Application Server - Express through SCM team adapters (known in Eclipse as team providers). Vendors of other SCM systems provide SCM team adapters for WebSphere Application Server - Express. To find a list of SCM products and adapters provided by IBM Business Partners, go to www-3.ibm.com/software/awdtools/studioappdev/about/ and from the Further reading section select SCM Adaptor Vendors. From this list, you can access the SCM product vendors' Web sites to download the SCM adapters of your choice. IBM does not endorse or warrant these adapters. For support, or further information, please contact the SCM product vendor directly.

The most recent version of the CVS server is available from www.cvshome.org. You do not need to install a CVS client to use CVS, only a CVS server. For more information about installing and using CVS, refer to the team online help. Also, there is an article about CVS team support in WebSphere Application Server - Express at www.ibm.com/websphere/developer/library/ techarticles/0108_karasiuk/0108_karasiuk.html

Notices

Note to U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the 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 or send inquiries, in writing, to:


IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan

IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OR CONDITIONS OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:


Lab Director
IBM Canada Ltd. Laboratory
8200 Warden Avenue
Markham, Ontario, Canada L6G 1C7

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.

Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples may 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 contains sample application programs in source language, which illustrates 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. 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 IBM's application programming interfaces.

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. 2000, 2003. All rights reserved.

Programming interface information

Programming interface information is intended to help you create application software using this program.

General-use programming interfaces allow you to write application software that obtain the services of this program's tools.

However, this information may also contain diagnosis, modification, and tuning information. Diagnosis, modification and tuning information is provided to help you debug your application software.

Warning: Do not use this diagnosis, modification, and tuning information as a programming interface because it is subject to change.

Trademarks and service marks

The following terms are trademarks or registered trademarks of International Business Machines Corporation in the United States, or other countries, or both:

Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries.

ActiveX, Microsoft, Windows, Windows NT, and the Windows logo are trademarks or registered trademarks of Microsoft Corporation in the United States, or other countries, or both.

UNIX is a registered trademark of The Open Group.

Other company, product or service names, which may be denoted by a double asterisk (**), may be trademarks or service marks of others.