SWIFTREVERSE USER GUIDE

SWIFTREVERSE USER GUIDE
FOR ORACLE

Prepared by: Last Updated: Document Ref:

Rapid Solutions and Consulting December 16, 2009 SWIFTReverse User Guide

Copyright © 2009, Rapid Solutions and Consulting Pte Ltd. All Rights reserved.

TABLE OF CONTENTS
Page
1. INTRODUCTION .................................................................................................................................................................3 2. OBTAINING YOUR COPY OF SWIFTREVERSE ..........................................................................................................3 3. INSTALLATION PROCESS ...............................................................................................................................................4 4. GETTING STARTED...........................................................................................................................................................9 5. RUNNING SWIFTREVERSE............................................................................................................................................13 6. REVERSE OPTIONS..........................................................................................................................................................20 7. TEMPLATE SELECTION.................................................................................................................................................22 8. PATCHES ............................................................................................................................................................................22 APPENDIX 1............................................................................................................................................................................24 KNOWN ISSUES .................................................................................................................................................................24

SWIFTReverse User Guide.doc Confidential

Page 2 of 24

The following screen should appear SWIFTReverse User Guide. each column in the table represents a field on the screen and the value in each column represents the data that would be entered into that field.doc Confidential Page 3 of 24 .com/ 2. The username and password should have already been supplied – this is a secure site 3. Obtaining your copy of SWIFTReverse 1. With this method the REVERSE process is able to run on the source ORACLE instance in a SECURE environment. 2. Where data volumes are large – REVERSE will create multiple worksheets within the spreadsheet to keep within the MS-EXCEL limits. The extracted configuration data is placed into excel sheets in the BR100 format for each screen that was extracted. Proceed to the download site http://downloads. The choice of using excel is primarily due to the ability of SWIFTConfigurator to load configuration data into the KNOWLEDGE BASE directly from excel sheets.erapidsuite. The resulting excel sheets can then be uploaded to the KNOWLEDGE BASE as a separate step and no direct connection is needed between the KNOWLEDGEBASE and the ORACLE INSTANCE. Introduction SWIFTReverse extracts configurations from an Oracle instance and reformats those configurations into BR100 style in excel sheets. The BR100 format is an ORACLE AIM METHOD step where the detail of each screen to be used in configuring the oracle system is documented in a table format.1.

then you will need to unpack the file into a folder of your choice.6 manually before using SwiftReverse.doc Confidential Page 4 of 24 . Installation Process 1. This following screen will appear SWIFTReverse User Guide.exe once completion downloads from the step above. Double click on the executable file: swiftReverse.4. You can install SwiftReverse from the installShield installer for an automated installation or install it directly from the ZIP file. If installing from the ZIP archive. 2. 3. and install Java JRE 1.

3.doc Confidential Page 5 of 24 . Click Next > Select the directory that you need to install reverse software SWIFTReverse User Guide.

Click Next > Next SWIFTReverse User Guide.doc Confidential Page 6 of 24 .4.

doc Confidential Page 7 of 24 . Click [Button] Install SWIFTReverse User Guide.5.

Click [Button] Finished The SwiftReverse is ready to use for Configuration Analysis and Extraction.doc Confidential Page 8 of 24 . SWIFTReverse User Guide.6.

oracle. Change the details to reflect the host and database being connected to and SAVE. you can then select this BWE file from the main menu. SSH Secure Shell Client to the Linux server where the Oracle DB is located. The BWE file will need to contains the following lines Database Host Name=oracle-erp.5.sql (NOTE: YOU MUST perform this step before proceed to extracting the configuration. Transfer the file to a local home directory 3. Getting Started 1.10/trunk/functions./control/functions” subfolders) Example: .properties: #DEFAULT_BWE_LOCATION=.doc Confidential Page 9 of 24 ./bweTemplate. 4. Also exit the SSH window 6./control/functions/11. You can execute this script via sqlplus as following: 1. 2. sqlplus apps/Apps @functions. Type exit to leave the sqlplus 5.bwe Make sure to remove the sharp sign (#) at the beginning if you want to use this feature.bwe in the PROGRAM folder using an editor such as WORDPAD 2. Execute the following SQL script on every Oracle server that you want to reverse data from: functions.com Database Password=Apps Database Port Number=1521 Database SID=ERPP Database User=apps 3. you can set the location of a default BWE file in the configuration file: target. Export Package needed for Reverse as per your scenarios. If you wish. 5. Below are the step on how to export scenario: • Log on to SwiftConfigurator • Enter Username and Password • Select “Scenario Maintenance” SWIFTReverse User Guide.4. those functions DO NOT update/insert anything on the Oracle server). instead of selecting a BWE every times that you start SwiftReverse. This script will create lookup functions necessary for SwiftReverse to run successfully. Use your BWE or edit the file bweTemplate.sql – use the appropriate username/password for your environment 4.sql (Version of the file for each Oracle version located in the “.

doc Confidential Page 10 of 24 . • ERP REVERSE SCENARIO Æ This scenario will extract all configuration which will include Instance level and Operating Unit level configuration • A NEW BUSINESS UNIT SCENARIOS Æ This scenario will extract Operating Unit level configuration and some of Instance Level Configuration SWIFTReverse User Guide.Select “Scenario Maintenance” • Select hyper link “Export Inventories” of the scenario you need to get the package. Scenario bellows are sample for your extraction.

Select “Export Inventories” from scenario name = ERP REVERSE SCENARIO SWIFTReverse User Guide.doc Confidential Page 11 of 24 .

doc Confidential Page 12 of 24 . Select “Click here to download the ZIP file” • Select [button] OK and to save .• Once the export process is completes.zip. SWIFTReverse User Guide.zip file in to your dedicate directory. SwiftConfigurator will show the status and generate the link to download package.

doc Confidential Page 13 of 24 . Running SWIFTReverse • Double click at icon or if you installed from the Unpacked version run swiftreverse-sql.5.bat: • Select the correct Reverse package file (ZIP) (Ref: please refer to step 6 for export package) Note that a default reverse package file can be specified in the “target.properties” file (DEFAULT_REVERSE_PACKAGE_LOCATION). SWIFTReverse User Guide.

Normally this is automatically detected by the program so that you don’t need to change it.• Select the version of Oracle which you want to perform reverse.doc Confidential Page 14 of 24 . • Click Next SWIFTReverse User Guide.

Select the correct BWE file by click [button] Browse Æ then Click [button] Next (NOTE: You need to ensure the database connection is established before you can proceed next step) SWIFTReverse User Guide.doc Confidential Page 15 of 24 .

doc Confidential Page 16 of 24 .• Select Operating Unit names you need to Reverse SWIFTReverse User Guide.

• • Click [button] Start The extraction progress will be shown on the screen as shown below SWIFTReverse User Guide.doc Confidential Page 17 of 24 .

doc Confidential Page 18 of 24 .When REVERSE has completed all the tasks a summary will be displayed as show below All the output is stored in various excel sheets locate in the OUTPUT folder SWIFTReverse User Guide.

Open the OUTPUT folder to review the excel spreadsheet output.doc Confidential Page 19 of 24 . SWIFTReverse User Guide.

doc Confidential Page 20 of 24 .6. Reverse Options SWIFTReverse User Guide.

Run in Analysis mode: • Ticked o The System will not Extract the configuration. All other data will be ignored. • Unticked o The System will perform configuration extraction without analysis record count for each table. so that you can plan. will be zipped or not. You can change the default value in the replacement. Clean output between runs: • Ticked o All data in the output folder will be removed on the next attempt to run SWIFTReverse • Unticked o Any new data extracted will be ADDED to any existing data in the output folder [beware – this could create duplicate entries in the excel data] Zip Output folder: • Specify if the output folder.properties: ZIP_FILE_LOCATION Threshold date: • All data that have been created or updated after this Threshold date will be reversed. if there any are huge data.properties file. SWIFTReverse User Guide. containing the reversed data files.doc Confidential Page 21 of 24 . but provide the analysis record count for each table. Note that the zipped file location is specified in the target.

selected branches. inventories to reverse. operating unit names. This is very Helpful if you don’t want to reselect all the options. SWIFTReverse User Guide.7.doc Confidential Page 22 of 24 .…). Template selection You can save all the options that you selected (checkboxes.… Next time that you start SwiftReverse. this is called a “template”.

zip and will need to be downloaded to the PC where SwiftReverse is installed. unpacked and installed following the instructions in their README file.8. SWIFTReverse User Guide.doc Confidential Page 23 of 24 .2-R11-ERP-S-0001.com/ Patches are of this format: PATCH-SS1. Important note: The sequence when applying the patches is crucial. as SQL files may overwritten in some latest patches. so there is a README file in the patches folder on the download site that will specify in which order the patches must be applied.erapidsuite. then selecting the SWIFTREVERSE folder on the download site http://downloads. Check for patches to apply to your current SwiftReverse version by browsing the appropriate version of SWIFTSuite that you are running and selecting PATCHES FOLDER. Patches Patches are periodically issued and those patches fixes issues regarding SQL statements or the engine itself.

Navigation tags are currently only allocated to 70% of all data due to business rule complexity. 5. The work around for these issues is to uncheck the appropriate file in the SWIFTReverse screen and extract the data manually. Further work on the business rules is being undertaken and will be enhanced in future releases.APPENDIX 1 KNOWN ISSUES 1. Data extracted is tagged as INSERT or UPDATE – depending on how it should be used – when the data is loaded to the KNOWLEDGEBASE that tag is replaced with a NAVIGATION TAG.doc Confidential Page 24 of 24 . KnowledgeBase structure differences may cause data to fail when loading into SWIFTConfigurator. 4. *********************** END OF DOCUMENT ************************* SWIFTReverse User Guide. It is possible the SQL statements may in some cases not execute – this is primarily due to Oracle application patch levels creating differences or SWIFTConfigurator Inventory issues. Instance level configurations are extracted but are not identified in any way as instance level 2. Seeded data may also be extracted in some cases and is not clearly identified 3.

Sign up to vote on this title
UsefulNot useful