MigrationLogiK User Guide

MigrationLogiK http://migrationlogik.
com
Migration LogiK
Users Guide.
A-1116
January 10
MigrationLogiK by iTerra Consulting Inc. 2009 User Guide. A-1116

All questions and comments email to support@migrationlogik.com
1
MigrationLogiK http://migrationlogik.com
Migration LogiK .......................................................................................................... 1

Introduction to Migration LogiK................................................................................ 3
System requirements .................................................................................................... 3
1. Overview ................................................................................................................. 4
MigrationLogiK ............................................................................................................................... 4
Setup repository structure on the client machine. .............................................................................. 4
2. FILE Menu ............................................................................................................... 5
Start new project ............................................................................................................................ 5
Editing Project: ............................................................................................................................... 8
Open an existing Project: ................................................................................................................ 9
Close Project: ................................................................................................................................ 12
3. TOOLS Menu ......................................................................................................... 13
Log Download: .............................................................................................................................. 13
Log Upload: .................................................................................................................................. 13
Generate Batch Script for Download: ............................................................................................... 13
Generate Batch Script for Upload: ................................................................................................... 13
4. DATABASE Menu ................................................................................................. 16
Connect to Database instance:........................................................................................................ 16
5. CHOOSE AOL Objects. ........................................................................................ 18
6. Search Controller Features: ................................................................................ 21
Delete a row from the operational panel tab. ................................................................................... 21
7. ACTIONS menu. .................................................................................................... 22
8. PARAMETERS menu. ........................................................................................... 23
Custom Mode ................................................................................................................................ 23
UPLOAD_MODE ............................................................................................................................. 23
Appendix A. .................................................................................................................. 24
Directory Structure. ..................................................................................................... 24
Client: .......................................................................................................................................... 24
Server: ......................................................................................................................................... 25

2
Introduction to Migration LogiK

Migration LogiK is a GUI application that acts as a front end for the Oracle FNDLOAD
utility. Migration LogiK is the solution for technical and functional professionals that allows
quickly download or upload/migrate custom AOL objects.
Customers can use Migration LogiK to quickly save the definitions of the custom and
seeded AOL objects - while performing configuration management or development migration
activities.
Migration LogiK uses an innovative approach to effectively access and to build a list of
AOL objects. Migration LogiK is then used again during the implementation step of the
customization activity or for the initial setup integration.
The list of the objects organized into the project can be easily transferred from one EBS
instance to another due to its portable content and structure.
Migration LogiK works with Oracle EBS in fact, its server listener resides in the same
environment and utilizes the power of FNDLOAD (Generic Loader) utility to speed up and
ease the migration process.
----------------------
System requirements
Client Machine:
The following hardware and software is required to run Migration LogiK(TM): For Microsoft
Windows - An Intel Pentium IV or equivalent processor running Windows XP, Vista. 512
MB of RAM. Java JRE version 1.5 or higher.
Internet connection allowing access to http://migrationlogik.com.

Oracle client 8.x or higher.
Tnsnames.ora file.
Server:
Java JRE version 1.5 or higher.

3
1. Overview
MigrationLogiK is a GUI application that serves as a front end for the Oracle Generic Loader
(FNDLOAD) utility.
This tool provides an advanced approach to the Oracle Foundation objects migration process. The
tool also allows easy collection, analysis and object storage.
A rich graphical interface features intuitive browsing through the Oracle EBS foundation objects. The
application contains an internal knowledge base that provides a syntax and parameters list for
potential migrated objects. Consequently, users can stay completely focused on development, setup
and customization efforts.
All objects are organized into projects using the OS directory based repository - this feature makes
the application light and portable.
Setup repository structure on the client machine.
Prior to using Migration LogiK - create a projects repository, using Windows Explorer.
This repository is a custom directory and users are free to create the repository in any
convenient location. Moreover, there are no naming restrictions on the directory. For the
software and hardware requirements please refer to the System Requirements document.

4
2. FILE Menu
Start new project.

Choose File > New Project.
A New Project pop up window appears.
Enter Project Name.

Enter Description.
Click the Browse button to define the main project repository folder. A small Windows Explorer window will
appear.
Choose the repository folder. Click Open.

5
The Project Name and Path will be stored in the Project data properties. The Project properties tab content is
changed to reflect the assigned Project Name and Project Path.

6
Navigate to File -> Save to save a new project.

The application creates the project working directory structure under the main projects repository folder.
The working directory contains the Migration Content folder, AllTabs.dat binary file storing FND objects
definitions and the [Project Name].properties file.

7
Editing Project:
Choose File > Edit urrent Project to edit a currently opened project.
If the project is not opened, the Edit Concurrent Project menu item is not accessible.
A Project window will appear. Update the Project Name, description or path.
Click Done.
The updated information will be saved into the project data repository.

8
Open an existing Project:
Choose File > Open Project to open a saved project.
The Windows Explorer window will appear. Navigate to your projects repository folder; highlight the project
folder and click Open.

9
The Project Information window will appear. The Project information can be updated if needed.
Click the Done button. The Project is opened and the Project information is loaded into the application.

10

11
Close Project:
Navigate to the File>Close menu item. Click Close. The Project is now closed. Open database connections
are closed. All project related information is being deleted from the application.
Before closing the project, make sure that the project is saved!
To save the project navigate to File > Save or File > Save As and save your work.

12
3. TOOLS Menu
Log Download:
When Log Download option is chosen new window will appear. This window displays
excerpts from the log files generated as a result of the FNDLOAD runs in Download mode.
Log Upload:
When Log Upload option is chosen new window will appear. This window displays
excerpts from the log files generated as a result of the FNDLOAD runs in Upload mode.
Generate Batch Script for Download:

When this option is selected new window will appear. New window contains automatically
generated UNIX/LINUX shell script with the set of FNDLOAD commands to perform download action
for the AOL objects which user has selected for Download. This script can be Copied and Pasted
in the server environment and then executed to generate FNDLOAD definition and log files.
Generate Batch Script for Upload:

When this option is selected new window will appear. New window contains automatically
generated UNIX/LINUX shell script with the set of FNDLOAD commands to perform upload action for
the AOL objects which user has selected. This script can be Copied and Pasted in the server
environment and then executed to generate FNDLOAD definition and log files.

13
Example of the download script is shown below:

#!/usr/bin/sh
# Generated by MigrationLogiK(TM). iTerra Consulting Inc(C) 2009
# Date: 01/22/2010 00:22:00
# User: user
# Usage: sh script.sh apps_password
ARGV="$@"
if [ "x"$ARGV = "x" ] ; then
echo "usage: sh script_name apps_passwd"
exit 0;
fi
pwd=$1
## ------------- User ------------------

FNDLOAD apps/$pwd 0 Y DOWNLOAD $FND_TOP/patch/115/import/afscursp.lct ADALE_USR.ldt
FND_USER USER_NAME=ADALE
FNDLOAD apps/$pwd 0 Y DOWNLOAD $FND_TOP/patch/115/import/afscursp.lct
CADAMS_USR.ldt FND_USER USER_NAME=CADAMS
## ------------- DFF Context Code ------------------
FNDLOAD apps/$pwd 0 Y DOWNLOAD $FND_TOP/patch/115/import/afffload.lct
GLOBAL_DATA_ELEMENTS_DFF_CONTEXT_1.ldt DESC_FLEX
APPLICATION_SHORT_NAME=FND
DESCRIPTIVE_FLEX_CONTEXT_CODE=Global_Data_Elements
DESCRIPTIVE_FLEXFIELD_NAME="FND_COMMON_LOOKUPS"
GLOBAL_DATA_ELEMENTS_DFF_CONTEXT_2.ldt DESC_FLEX
APPLICATION_SHORT_NAME=SQLGL
DESCRIPTIVE_FLEX_CONTEXT_CODE=Global_Data_Elements
DESCRIPTIVE_FLEXFIELD_NAME="GL_SHARES_ACTIVITY"
## ------------- DFF ------------------
FND_COMMON_LOOKUPS_DFF.ldt DESC_FLEX APPLICATION_SHORT_NAME=FND
DESCRIPTIVE_FLEXFIELD_NAME=FND_COMMON_LOOKUPS
## ------------- KFF ------------------
LOCATION_FLEXFIELD_KFF.ldt KEY_FLEX
P_LEVEL='COL_ALL:FQL_ALL:SQL_ALL:STR_ONE:WFP_ALL:SHA_ALL:CVR_ALL:SEG_ALL'
APPLICATION_SHORT_NAME=OFA ID_FLEX_STRUCTURE_CODE=LOCATION_FLEXFIELD
14
## ------------- Profile Option ------------------
FNDLOAD apps/$pwd 0 Y DOWNLOAD $FND_TOP/patch/115/import/afscprof.lct
INVENTER_REPLENISH_COUNT_PO.ldt PROFILE
PROFILE_NAME=INV:ENTER_REPLENISH_COUNT APPLICATION_SHORT_NAME=INV
INV_UOM_DEFAULT_PO.ldt PROFILE PROFILE_NAME=INV_UOM_DEFAULT
APPLICATION_SHORT_NAME=INV
OE_IMMEDIATE_INVENTORY_UPDATE_PO.ldt PROFILE
PROFILE_NAME=OE_IMMEDIATE_INVENTORY_UPDATE APPLICATION_SHORT_NAME=OE

15
4. DATABASE Menu
Connect to Database instance:

When being loaded initially, Migration LogiK recognizes Oracle Homes installed on the client
machine and retrieves TNSNAMES.ora entries to populate its internal repository (with the available
Oracle instances connection information). Any changes to the TNSNAMES.ora will require users to
open the projects affected by the change, refresh the connection information, and save any updated
projects.
To connect to the source database:
Choose Database > Oracle Homes.

Then select Oracle Home.
Choose Database > Oracle Homes > Source Instance.

Select database instance. If the TNSNAMES.ora file contains more than 20 entries, the application builds an
alphabetically organized additional menu layer.

16
After the database instance is selected, the properties section is updated with the instance information.

17
To connect to the Source instance, click Connect to Source DB. A user authentication popup
window will appear.
Enter apps user and password values and click Connect.
After a connection is established to the Source Database, the Download menu option of Actions menu
becomes active.
The Choose AOL Objects menu becomes active when the connection to the Source database is established.
Note: When the existing project is opened, users can immediately connect to the database without Oracle
Home or instance selection.
5. CHOOSE AOL Objects.

Note: The list of the objects available for download may be different from the documented version.
To choose objects for download, navigate to the Choose AOL objects menu and select the object type for
download. For example, User.

18
Select User
The search controller window appears
o The search controller contains 3 search parameters:
o Updated By, User Name, Full Name
o % sign is used as a wild card
The message at the bottom of the Search Controller windows indicates the number of records retrieved or
displays the exception message if an error occurs.
To select objects for download, click on the objects table row. Check box in the left column is checked.

19
Continue your selection until all of the objects intended to be migrated are selected.
After the selection is completed, press either Append to Migration List to add objects to the migration list or
Replace Migration List to substitute objects in the list with the ones that are checked. Only the objects of the
active tab are affected - and in our case, only the User objects list is affected by the Replace... or Append...
actions.
As the result of Append.. action the User tab is created.
Close the Search Controller window after you finish by pressing the icon.
The image below demonstrates an operational panel with two tabs: User and Profile option.

20
6. Search Controller Features:
Delete a row from the operational panel tab.

Point the mouse cursor at the row to be deleted and press the right button.
A popup menu will appear. Choose the Delete Row option. The row will be deleted immediately.
Note: There is no Undo feature on versions 1.1.1x.
To copy FNDLOAD DOWNLOAD syntax to the clipboard, point the mouse cursor over the row, press the right
button on the mouse and choose the Send DOWNLOAD command to clipboard option. Using the Ctrl-V key,
users can paste FNDLOAD syntax to the text editor.
To copy the FNDLOAD UPLOAD syntax to clipboard point the mouse cursor over the row, press the right
button on the mouse and choose the Send UPLOAD command to clipboard option. Using the Ctrl-V key,
users can paste FNDLOAD syntax to the text editor.

21
7. ACTIONS menu.
* Not available in (G) releases.
Currently, there are two options available: Download or Upload.

Initially, both options are disabled. However, after the connection to the Source database is
established, the DOWNLOAD feature is activated.
After the connection to the Target database is established, the UPLOAD action is
activated.
When the Download or Upload option is chosen, the client establishes a connection to the
server listener. If the server listener is not up and running, the following message is
displayed at the bottom of the application window: Server listener is not running! Contact
System Administrator.
Users can continue the object selection without the server listener running, but the Download
or Upload actions cannot be performed. Both of these options are also disabled if the user is
running an unlicensed version of the application. To correct the issue, contact iTerra
support: support@migrationlogik.com.

22
8. PARAMETERS menu.
Two parameters are available: Custom Mode and Upload Mode.
Custom Mode has two options "FORCE or DEFAULT.

CUSTOM_MODE - Controls whether a customized row is updated or not.
# "FORCE" is to wipe out any customization.
# Any value other than "FORCE" is to preserve customization.
# Default value is to preserve customization.
UPLOAD_MODE - NLS: whenever you run to upload NLS translations.

# MERGE: find matching row (whether to update it is controlled
# by CUSTOM_MODE). If matching row not found, insert it.
# Default value is MERGE.

23
Appendix A.
Directory Structure.
Client:
[Project Repository Folder]
[Project Name Folder]
Migration Content
Logs

24
Server:
[ Current Directory ]
Migration Content
[ Client User Name ]
DOWNLOAD
UPLOAD

25

MigrationLogiK User Guide

Transféré par

Informations du document

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

MigrationLogiK User Guide

Transféré par

Droits d'auteur :

Formats disponibles

MigrationLogiK http://migrationlogik.

MigrationLogiK by iTerra Consulting Inc. 2009 User Guide. A-1116

Migration LogiK .......................................................................................................... 1

MigrationLogiK by iTerra Consulting Inc. 2009 User Guide. A-1116

Introduction to Migration LogiK

Internet connection allowing access to http://migrationlogik.com.

MigrationLogiK by iTerra Consulting Inc. 2009 User Guide. A-1116

Setup repository structure on the client machine.

MigrationLogiK by iTerra Consulting Inc. 2009 User Guide. A-1116

Start new project.

A New Project pop up window appears.

Enter Project Name.

MigrationLogiK by iTerra Consulting Inc. 2009 User Guide. A-1116

MigrationLogiK by iTerra Consulting Inc. 2009 User Guide. A-1116

Navigate to File -> Save to save a new project.

MigrationLogiK by iTerra Consulting Inc. 2009 User Guide. A-1116

MigrationLogiK by iTerra Consulting Inc. 2009 User Guide. A-1116

Open an existing Project:

Choose File > Open Project to open a saved project.

MigrationLogiK by iTerra Consulting Inc. 2009 User Guide. A-1116

MigrationLogiK by iTerra Consulting Inc. 2009 User Guide. A-1116

MigrationLogiK by iTerra Consulting Inc. 2009 User Guide. A-1116

MigrationLogiK by iTerra Consulting Inc. 2009 User Guide. A-1116

Generate Batch Script for Download:

Generate Batch Script for Upload:

MigrationLogiK by iTerra Consulting Inc. 2009 User Guide. A-1116

Example of the download script is shown below:

# Usage: sh script.sh apps_password

## ------------- User ------------------

MigrationLogiK by iTerra Consulting Inc. 2009 User Guide. A-1116

Connect to Database instance:

Choose Database > Oracle Homes.

Choose Database > Oracle Homes > Source Instance.

MigrationLogiK by iTerra Consulting Inc. 2009 User Guide. A-1116

MigrationLogiK by iTerra Consulting Inc. 2009 User Guide. A-1116

Enter apps user and password values and click Connect.

5. CHOOSE AOL Objects.

MigrationLogiK by iTerra Consulting Inc. 2009 User Guide. A-1116

MigrationLogiK by iTerra Consulting Inc. 2009 User Guide. A-1116

As the result of Append.. action the User tab is created.

MigrationLogiK by iTerra Consulting Inc. 2009 User Guide. A-1116

6. Search Controller Features:

Delete a row from the operational panel tab.

MigrationLogiK by iTerra Consulting Inc. 2009 User Guide. A-1116

Currently, there are two options available: Download or Upload.

MigrationLogiK by iTerra Consulting Inc. 2009 User Guide. A-1116

Two parameters are available: Custom Mode and Upload Mode.

Custom Mode has two options "FORCE or DEFAULT.

UPLOAD_MODE - NLS: whenever you run to upload NLS translations.

MigrationLogiK by iTerra Consulting Inc. 2009 User Guide. A-1116

[Project Name Folder]

MigrationLogiK by iTerra Consulting Inc. 2009 User Guide. A-1116

[ Client User Name ]

MigrationLogiK by iTerra Consulting Inc. 2009 User Guide. A-1116

Vous aimerez peut-être aussi