![]() |
If you have an older version of VisualAge for Java installed on your system, this version must be uninstalled before installing VisualAge for Java, Version 2.0. However, prior to uninstalling the older version of the software, your repository must be saved to a new location on your hard drive, so that it can later be imported into Version 2.0. During the Version 2.0 installation process, you will be prompted to back up your old project files. After your files have been moved by the install tool, the uninstall program for the original version of the software will then be automatically launched. Finally, the Version 2.0 installation process will then proceed.
Warning! Only versioned projects and packages can be imported into the new repository. Therefore, whether you are doing an automatic or manual migration, you must version your original projects and packages in order for your repository to migrate successfully. Please see your VisualAge for Java, Version 1.x Integrated Development Environment help documentation for versioning instructions.
On OS/2, an automatic
migration process is not available. Therefore, you will have to complete the migration
process manually (see Manual Migration below).
On Windows, an automatic
migration process is available. The automatic migration process will take the existing
repository and move it into the same directory as the Version 2.0 repository. On the
initial launch of Version 2.0, you will be prompted to select which projects and packages
you wish to move into the new repository.
Upon startup, if the install program detects an older version of VisualAge for Java on your system, InstallShield will prompt you to move your old project files to Version 2.0. If you click Yes, your files will be moved automatically. When you first launch the Version 2.0 Integrated Development Environment (IDE), the IDE will look for the old repository in ide\repository\ivj10.dat file. If the file exists, the import wizard will appear, prompting you to import any of your original packages or projects into the new repository.
Note: When you launch the IDE on the second and subsequent times, the IDE will not automatically take you to the import wizard, despite whether the ivj10.dat file exists.
If you encounter a failure during the automatic migration process, you can recover by following the manual migration instructions below. At the time of the automatic migration failure, the repository will most likely be saved in x:\_$migration\ivj10.dat. (If you do not find the repository there, search your hard drive for ivj10.dat). When VisualAge for Java, Version 2.0 has been successfully installed, choose File -> Import, enter the location of the old repository, and then select the packages and projects that you want to import.
Manual Migration
To migrate your project files manually, after you have versioned your Version 1.x project
files, you must exit VisualAge for Java, and copy the repository to a safe location outside
of the IBMVJava directory (we recommend that you select a unique name for the backup
copy of the old repository). If you have not already begun to install Version 2.0, the
copy of the repository will most likely be located in x:\IBMVJava\Ide\repository\ivj.dat.
You must then uninstall Version 1.x, and then install Version 2.0.
When you have VisualAge for Java, Version 2.0 installed on your system, you can import packages and projects from your old repository into the new repository by choosing File -> Import, and then selecting Repository. In the input field at the top of this SmartGuide, enter the location of your backup copy of ivj.dat. You will then be prompted to choose the projects and packages that you want to import.