# =============================================================================
# Oracle IZ_MIGRATION             (c) 2006-2007 by IzzySoft (devel@izzysoft.de)
# -----------------------------------------------------------------------------
# $Id: readme.txt,v 1.1 2006/12/18 18:35:38 izzy Exp $
# -----------------------------------------------------------------------------
# Helper for Database-to-UTF8-Migration
# =============================================================================

Contents
--------

1) Copyright and warranty
2) Requirements
3) Limitations
4) Scripts in this package and their usage
5) Installation

===============================================================================

1) Copyright and Warranty
-------------------------

These little programs are (c)opyrighted by Andreas Itzchak Rehberg
(devel@izzysoft.de) and protected by the GNU Public License Version 2 (GPL).
For details on the License see the file LICENSE in this directory. The
contents of this archive may only be distributed all together.

===============================================================================

2) Requirements
---------------

Since these are scripts for the Oracle DBA, it implies one simple requirement:
an Oracle Database to work on. Additionally, you must have a shell available -
what implies that you run a *NIX operating system. Tested on IBM AIX with
the bash shell v3 and Oracle 9.2.0.8.

===============================================================================

3) Limitations
--------------

I tested the scripts successfully with Oracle 9.2.0.8. Basically, they should
work with any version starting with 9i - but I cannot promise this (reports are
welcome). So far, no limitations are known - except that it will probably work
on Oracle databases only :-)

===============================================================================

4) Scripts in this package and their usage
------------------------------------------

For the syntax of all scripts, just see within their header. Basically, the
script files are just intended for the installation process:

  Script           | Intention
  -----------------+-----------------------------------------------------------
  iz_migration.sh  | Create all necessary objects (tablespace, user, tables...)
                   | and install the iz_migration package
  owners.sql       | To specify the schemata which should be converted

For details on the usage, please refer to the included HTML documentation.

===============================================================================

5) Installation
---------------

1. Unpack this archive to any (temporary) location you like (since you're
   reading this, you probably have done so already)
2. Open the iz_migration.sh with your favorite editor, and adjust its
   configuration (documented within the file).
3. Execute the modified iz_migration.sh and verify that it succeeded
4. Edit the owners.sql to reflect your wishes
5. Run the file as iz_migration user, e.g. in SQL*Plus

If everything went well, you should now be able to use the package. Please refer
to the included HTML documentation for further details.

Have fun!
Izzy.
