Oracle Migration Workbench Release Notes Release 9.2.0 for Microsoft Windows 98/2000 and Microsoft Windows NT Part Number A97250-01 |
Home |
Book List |
Contents |
Master Index |
Feedback |
Release 9.2.0 for Microsoft Windows 98/2000 and Microsoft Windows NT
March 2002
Part No. A97250-01
This document contains the following topics:
Oracle Migration Workbench (Migration Workbench), release 9.2.0 enables you to migrate the following databases to an Oracle9i or Oracle8i database:
This document outlines how to install the Migration Workbench. It also provides tips on using the Migration Workbench. For more information on the Migration Workbench, see the following documentation:
The following new plug-ins and features are supported by of release 9.2.0 of the Migration Workbench:
The IBM/AS400 V4R5 plug-in was developed using 9.2.0 dependencies, and upgraded to work against the 9.2.0 Migration Workbench core.
The T/SQL parser contains parser intelligence capable of working out the inter-dependencies of stored procedures. The first phase of the Parser Intelligence feature was completed in version 2.0.2 of the Oracle Migration Workbench. However, with some of the more complex Sybase Adaptive Server databases, schema objects are stored in tempdb
and referenced by stored procedures in other databases. These objects need to be migrated as part of a database migration. T/SQL Parser Intelligence has been improved in release 9.2.0 to handle temp tables generated by references to other temp tables.
Before you install the Migration Workbench, review the Hardware Requirements and Software Requirements topics.
The Migration Workbench has the following minimum and recommended hardware requirements:
The Migration Workbench has minimum and recommended software requirements. This sections contains the following:
In order to migrate any plug-in, it is recommended that you have the following:
In order to migrate from Informix Dynamic Server 7.3 to Oracle, you must have the Informix JDBC Driver 1.4 installed on the same system as the Migration Workbench.
The Informix JDBC Driver 1.4 is available from the Informix Dynamic Server 7.3 CD. To install the Informix JDBC Driver 1.4, follow the instructions in the install.txt file. You can locate the install.txt file in the JDBC directory.
Note: After you have installed the Informix JDBC Driver 1.4, copy the ifxjdbc.jar file of the driver to the |
In order to migrate to a destination Oracle database using the Migration Workbench, logging must be turned on in the Informix Dynamic Server database. The Migration wizard can then use the following Informix Dynamic Server syntax:
database:owner.object
The Informix sysmaster database must exist under the Informix Dynamic Server that controls the databases you want to migrate.
In order to migrate from Microsoft Access 2.0, Microsoft Access 95, and Microsoft Access 97 to Oracle, you must have the following installed on the same system as the Migration Workbench:
In order to migrate from Microsoft Access 2000 to Oracle, you must have the following installed on the same system as the Migration Workbench:
In order to migrate from Microsoft SQL Server 6.5, Microsoft SQL Server 7.0, or Microsoft SQL Server 2000 to Oracle, you must have the Microsoft SQL Server ODBC driver release 3.70.06.23 or higher installed on the same system as the Migration Workbench. The ODBC driver is shipped with the Microsoft SQL Server client software.
In order to migrate from MySQL to Oracle, you must install the MM MySQL JDBC driver Release 1.2a on the same system as the Migration Workbench. You can obtain this by downloading the MM MySQL JDBC driver from the WorldServer Web site at:
http://www.worldserver.com/mm.mysql
Copy and unzip the mm.mysql.jdbc-1.2a.zip file to the
%ORACLE_HOME%\Omwb\drivers
directory. This automatically creates a new directory called mm.mysql.jdbc-1.2a within the drivers directory.
In order to migrate from Sybase Adaptive Server to Oracle, you must have the Sybase Adaptive Server ODBC driver Release 3.11.00.01 or higher installed on the same system as the Migration Workbench. The Sybase Adaptive Server ODBC driver is shipped with the Sybase Adaptive Server 11 and Sybase Adaptive Server 12 client software.
In order to migrate from IBM DB2/AS400 V4R5 to Oracle, you must have the following installed on the same system as the Migration Workbench:
http://oss.software.ibm.com/developerworks/opensource/jt400
To download the jt400.jar file:
%ORACLE_HOME%/omwb/drivers
directory.
To install the Migration Workbench:
%ORACLE_HOME%
, see the Installing into an Oracle Home Directory topic.
Note: If the Migration Workbench Repository database has a listener using a port number other than 1521, select Use another port number, enter the correct port number and click Next. |
In order to obtain a successful migration, consider the following, when Installing into an Oracle Home Directory.
Since the Migration Workbench release 9.2.0 includes Oracle 9.2.0 dependencies, it can only be installed into an Oracle 9.2.0 home directory or its own home directory. If there is a previous release of Oracle installed on the system, you must install the Migration Workbench into a separate Oracle home directory.
You then need to switch the default Oracle home directory to point to the previous Oracle installation so that you do not pick up the new NT client dependencies for other applications you may use on the system.
To switch the Oracle home directory:
If you attempt to install into an Oracle home directory other than Oracle 9.2.0 home directory, the Oracle Universal Installer displays the following error message:
Migration Workbench can only be installed into a new %ORACLE_HOME%
or an existing Oracle 9.2.0 %ORACLE_HOME%
.
After installing the core and at least one plug-in, you can launch the Migration Workbench. If you are running Microsoft Windows 98, restart the system before running the Migration Workbench. Rebooting the system resets the path for the JRE.
To launch the Migration Workbench:
Note: If you have problems launching the Migration Workbench, see the Problem Launching the Migration Workbench from Microsoft Windows 98 topic. |
While launching the Migration Workbench from Microsoft Windows 98, you may obtain the Finished - Shortcut To dialog box containing the following error message:
Out of environment space Out of environment space Bad command or file name
To launch the Migration Workbench after receiving these error messages:
The Migration Workbench release 9.2.0 supports the migration of Microsoft SQL Server 6.5, Microsoft SQL Server 7.0, Microsoft SQL Server 2000, Sybase Adaptive Server 11, Sybase Adaptive Server 12, MySQL 3.22 and 3.23, Microsoft Access 2.0, 95, 97, 2000, Informix Dynamic Server Version 7.3, and IBM DB2/AS400 V4R5 to Oracle9i or Oracle8i. The Migration Workbench is located in the Oracle home directory, %ORACLE_HOME%\
Omwb. This directory contains all components of the Migration Workbench in several sub-directories as follows:
The Migration Workbench release 9.2.0 only works with a repository created by this release. You can create a Migration Workbench repository in an Oracle9i or Oracle8i database. To create a repository, you must create a user in the Oracle database where you want to store the Migration Workbench Repository. You must have already granted CONNECT
and RESOURCE
pre-defined roles to this user. The first time you log in to this user account you are asked if you would like to create the repository. The user name, password, and service that you enter in the Oracle Migration Workbench Repository Login dialog box define where you want to create the repository.
During the capture phase of the migration, the Migration Workbench takes a snapshot of the data dictionary of the database being migrated to Oracle. This information is stored in the repository and the amount of space required for it depends on the size of the database being migrated. It is recommended that you have at least 30MB of space available in the default tablespace of the repository owner to accommodate the snapshot and the meta data of the Migration Workbench.
In order to use the Migration Workbench to successfully migrate to an Oracle database, you need the following:
CONNECT
and RESOURCE
privileges to access the Migration Workbench Repository, unless you are using the default repository.Aliases are defined in the following file:
%ORACLE_HOME%\network\admin\tnsnames.ora
To add or edit a Net Service Name, run the Oracle Net Configuration Assistant tool from the Configuration of Migration Tools program group in the Oracle home directory.
To view Migration Workbench HTML files, such as the Quick Tour, the release notes, or reference guide, the Migration Workbench attempts to activate the default browser on a Microsoft Windows 98/2000 or Microsoft Windows NT system. However, the Migration Workbench does not know the name or path of the default browser. It relies on the Microsoft Windows file associations to activate the browser, if one exists.
To avoid any Web browser problems, the state.properties file is used to specify the exact path of the system browser. The state.properties file is automatically generated the first time you launch the Migration Workbench.
If there is a problem executing the browser command on a Microsoft Windows system, you receive the following error message:
Problem executing Browser command <command executed>. Please specify the browser path in the <c:\Oracle\Ora9\Omwb\state.properties> initialization file for the BROWSER_PATH property, then restart the Migration Workbench. For more information please read the release notes.
To ensure the Migration Workbench launches the correct browser you must edit the state.properties file:
%ORACLE_HOME%\Omwb\
bin directory.c:\Program Files\Netscape\Communicator\Program\Netscape.exe
The Migration Workbench Development Team provides support and solutions to the migration problems. Choose Help -> Online Support to launch a page that explains how to report a problem. It also provides a list of the supported platforms and additional documentation. For more information, see the Oracle Migration Workbench Help desk at:
http://otn.oracle.com/support/tech/migration/workbench/content.html
In order to report a bug, refer to the Online Support page within the product. For more information about reporting bugs, see the Online Support topic. This section contains the following topics:
The following issues must be considered when using the Migration Workbench to migrate a Microsoft Access database to Oracle:
The Migration Workbench does not support the migration of Microsoft Access security settings, such as the user name and password. In order to migrate a secured database, you must first make a copy of it. This duplicates the contents of the Microsoft Access database without the security. You can than take the new Microsoft Access database and migrate it to Oracle using the Migration Workbench.
To copy the contents of the Microsoft Access database:
The Migration Workbench does not support the migration of a replica Microsoft Access database. Select the master database to migrate to Oracle.
The Migration Workbench only supports one level of linked tables. If you have a table with links to a second table, these links are preserved. However, links in the second table are not migrated to Oracle.
The Migration Workbench is unable to load BLOBs
when you choose Object -> Generate SQL*Loader Scripts to generate off-line data loading.
CLOBs
that contain line breaks when you choose Object -> Generate SQL*Loader Scripts to generate off-line data loading.Bug 1509958
Description: Timestamp columns do not load with SQL*Loader direct path load. When a timestamp column is migrated to Oracle the Migration Workbench generates a sequence and a trigger to mimic the behavior of the timestamp column. However, when you migrate the data in Migration Workbench release 1.3.0 or migration Workbench release 1.3.1 using SQL*Loader, the Migration Workbench uses the direct=true
syntax in the sql_load_script.bat file. This means that the sequence and trigger are bypassed and the original timestamp entry is inserted into the column with an error.
Workaround: In order to load timestamp columns correctly, you must manually edit the sql_load_script.bat file and remove the direct=true
syntax for the table that contains the timestamp column. The sql_load_script.bat file is located in the %ORACLE_HOME%/Omwb/sqlloader_scripts/<plug-in name>/<timestamp>/oracle directory.
Bug 1333552
Description: The Microsoft Access plug-in does not support databases (MDB files) with spaces in their name.
Workaround: Rename the MDB file so that it does not contain a space. The migration should then function correctly.
Oracle is a registered trademark, and Oracle8i and Oracle9i are trademarks or registered trademarks of Oracle Corporation. Other names may be trademarks of their respective owners.
Copyright © 1998, 2002 Oracle Corporation. All Rights Reserved.
|
Copyright © 1998, 2002 Oracle Corporation. All Rights Reserved. |
|