VisualAge(R) for Java(TM), Entry Edition for OS/2 (R), Version 3.0 README

To view this file in HTML format, open readme.htm from the root directory of the CD-ROM. To view this file in text format, open readme.txt from the root directory. For best results when printing this in text format, decrease the printing margins to the minimum allowed and decrease the point size of the font to 10.  This will prevent line wrapping.

This README file contains information about installing VisualAge for Java, Entry Edition and about installation and uninstallation problems. It also includes the following information: 

Important: This Entry Edition of the product is limited to the creation of 750 classes. Any additional classes developed will not be saved.

Where to find more information about VisualAge for Java

This file does not include detailed information about the specific components and features of VisualAge for Java, Entry Edition.

For that information, you should refer to the product Release Notes which you can access by opening the VisualAge for Java folder and double-clicking the Release Notes icon.

This file does not contain information about using VisualAge for Java. Refer to the Getting Started guide and online help for that information.

The online help contains a "Web Resources" page that contains links to VisualAge resources that are available on the Internet. 

The VisualAge Developer Domain (VADD) Web site offers information about tools, education, hints, and tips, along with easy access to support and product updates for VisualAge for Java. At this site, you can download the VisualAge for Java development tools, as well as reusable beans, wizards, and toolkits to complement your applet and servlet development. See the web site at http://www.ibm.com/software/vadd. You can also use this site to request features in upcoming releases of VisualAge for Java, using our new online Feature Request Database.

The product home page for VisualAge for Java home page is at http://www.ibm.com/software/ad/vajava

Table of Contents

1.0 Prerequisites 
2.0 Installation procedures
      2.1 Installing VisualAge for Java, Version 3.0
      2.2 Installing additional components later
3.0 Migrating from a previous version of VisualAge for Java
      3.1 Migrating from VisualAge for Java, Version 2.0
      3.2 Migrating from VisualAge for Java, Version 1.x
4.0 Limitations and known problems
      4.1 Limitations and known installation problems
      4.2 Limitations and known uninstallation problems
5.0 Browser configuration for online help

1.0 Prerequisites 

This edition of VisualAge for Java has the following software and hardware requirements: 

2.0 Installation procedures

This section contains information about installing VisualAge for Java, Version 3.0. 
Important
: If you are migrating from a previous version of VisualAge for Java, please refer to section 3.0 before installing VisualAge for Java, Version 3.0.

2. 1 Installing VisualAge for Java, Version 3.0

If you have installed the Feature Installer runtime, then installed an OS/2 Fixpak, you will need to reinstall the Feature Installer runtime before installing VisualAge for Java.

Before you install the product, check the following things:

  1. Insert the CD-ROM into your CD drive.
  2. Run install.exe from the root of the CD drive.
  3. In the Installation Selection window, select one of the following: 
    a) Select Install Netscape Navigator if you do not have Netscape Navigator, version 2.02 or 4.04 on your system.
    b) Select Install Feature Installer if you do not have the Feature Installer or installed Netscape Navigator after the last installation of Feature Installer. 
    c) Select Install VisualAge for Java to begin the installation of VisualAge for Java. Follow the on-screen instructions.
  4. Reboot after installing VisualAge for Java.

2.2 Installing additional components later

To install additional VisualAge for Java components after initial installation, insert the CD-ROM into your CD drive, and run install.exe from the root of the CD drive. Select the components that you want to install from the Drive, Directory and Component Selection panel.

3.0 Migrating from a previous version of VisualAge for Java 

Refer to section 3.1 for information about migrating from version 2.0 of VisualAge for Java. 

Refer to section 3.2 for instructions on manually migrating your user data from version 1.x of VisualAge for Java. 

3.1 Migrating from VisualAge for Java, Version 2.0

Migration from Version 2.0 to Version 3.0 of VisualAge for Java is automatic. The Version 3.0 installation program automatically uninstalls Version 2.0. 

Automatic migration

Follow these steps to migrate from Version 2.0 to Version3.0: 

  1. Perform steps 1 to 3 from section 3.2. It is strongly recommended that you create backup copies of your repository and resource files in case a problem occurs.  
  2. Install VisualAge for Java, Version 3.0 by following these steps:
  3. a) Insert the CD-ROM into your CD drive. 
    b) Run install.exe from the root of the CD drive.
    c) In the Install Selection screen, select Install VisualAge for Java to begin the installation of VisualAge for Java. Follow the on-screen instructions.
  4. Upon the completion of a successful upgrade installation, all of your project resources and your repository data are automatically migrated to Version 3.0 when you start the Version 3.0 IDE for the first time.
In the event that an installation failure occurs, you must manually migrate your user data. You also must manually migrate your user data if the IDE fails to start or if an error is encountered by the IDE when it is migrating your user data. Follow these steps to recover from a failure and manually migrate your user data: 

Manual migration

  1. Verify you have saved your repository and resource files outside of the file directory tree.
  2. Uninstall the product completely. All Version 2.0 and Version 3.0 subdirectories and files should be deleted.
  3. Reinstall Version 3.0. 
  4. Start the IDE. 
  5. Perform steps 5 to 8 from section 3.2.
Once you have verified that your manual or automatic migration is successful, you can delete the backup copies that you created in step 1.

Attention: The coexistence of VisualAge for Java, Version 2.0 and VisualAge for Java, Version 3.0 is not supported . Version 2.0 can be installed on a system that has Version 3.0 installed, but the behavior of both versions of the product will be unpredictable.

3.2 Migrating from VisualAge for Java, Version 1.x

If you have Version 1.x of VisualAge for Java installed on your system, it must be uninstalled before installing VisualAge for Java, Version 3.0. Follow these steps BEFORE uninstalling Version 1.x if you want to import your Version 1.x repository and resource files into Version 3.0. 
  1. Version your projects and packages. Only versioned projects and packages can be imported into the VisualAge for Java, Version 3.0 repository. Refer to your VisualAge for Java online help for versioning instructions.
  2. Save your repository to a new location outside your VisualAge for Java directory tree. The file name and path of the repository is x:\IBMVJava\ide\repository\ivj.dat, where x:\IBMVJava is the VisualAge for Java installation directory.
  3. Copy any resource files (such as images or sound files) used by your Java applications to a directory outside your VisualAge for Java directory tree. By default, resource files for each VisualAge for Java project are located in subdirectories called  x:\IBMVJava\ide\project_resources\project, where x:\IBMVJava is the VisualAge for Java installation directory and project is the name of the project with which the resources are associated.
  4. Uninstall Version 1.x.  Remove x:\IBMVJava directory, where x:\IBMVJava is the VisualAge for Java 1.x installation directory. Install Version 3.0. Start the IDE.
  5. You can now import packages and projects from your old repository into the new repository. In the Workbench, select File > Import, and then select the Repository radio button and click Next. In the Repository name field enter the path of your saved copy of ivj.dat. Then select the projects and packages that you want to import. You will not be able to import any projects or packages that have not been versioned. 
  6. To automatically add the selected projects to the workspace, select the Add most recent project edition to the workspace checkbox. This checkbox is only available when the Projects radio button is selected.
  7. Click Finish.
  8. Copy your backup copy of your resource files into the subdirectories x:\IBMVJava\ide\project_resources\project, where x:\IBMVJava is the VisualAge for Java, Version 3.0 installation directory and project is the name of the project with which the resources are associated.
  9. Once you have verified that your manual migration is successful, you can delete the backup copies that you created in steps 2 and 3.

4.0 Limitations and known problems

4.1 Limitations and known installation problems

The following is a list of issues you should be aware of during installation: 

Recovering from a failed installation

To recover from a failed installation, you must perform the following steps:
  1. Remove the directory "OS2\INSTALL\VisualAge for Java" and its subdirectories, if they exist, from the boot drive using the command line, or through "Drives" in the "Warp Center". If the boot drive is a FAT drive, the directory will be "OS2\INSTALL\VISUALAGE".
  2. Delete the files "OS2\INSTALL\fi.ini" and "OS2\INSTALL\fi.bak" if they exist.  You will need to remove their read-only attributes using "attrib-R <filename>" before deleting.
  3. Delete the "VisualAge for Java" inventory object:

  4. a) On your boot drive, open the folder "OS2\INSTALL\Installed Features".
    b) Open the folder "VisualAge for Java - Inventory". This is the inventory object.
    c) Select the top object listed by clicking on the check box, and then click Uninstall button. 
    Attention: Using the mouse to click on the checkbox may not successfully select the item. If this occurs use the mouse to highlight the top object listed, and use the space bar to select it before clicking Uninstall.
  5. Restart your system and the installation program. 

Installation problems results in unusable system

If there is an installation problem resulting in an unusable system, perform the following tasks to remove all IBM VisualAge for Java components from your system:
  1. Delete the desktop folder for IBM VisualAge for Java.
  2. Delete all product files found in the directory where you installed IBM VisualAge for Java (for example, C:\IBMVJava).
  3. Perform steps 1 to 4 from "Recovering from a failed installation" to remove the Feature Installer objects.

4.2 Limitations and known uninstallation problems

5.0 Browser configuration for online help 

The VisualAge for Java installation program checks your browser configuration and offers to change it automatically so you can view online help. If you select Yes, localhost: 49213 and 127.0.0.1 are added to your proxy exception settings. If you select No, you may not be able to view online help. 

If you select No, and later decide you want to view online help, you can manually change your browser configuration to the correct settings. Refer to the Online Help Release Notes for instructions on how to correctly configure your browser for viewing online help.

(C) Copyright IBM Corporation 1997, 1999 - All Rights Reserved.

Notices

Licensed Materials - Property of IBM

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

Your use of this product is subject to the terms of the enclosed International Program License Agreement and License Information.

Trademarks and service marks

The following terms are 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 or other countries, or both.

Intel and Pentium are trademarks of Intel Corporation in the United States, or other countries, or both.