This action might not be possible to undo. Are you sure you want to continue?
Welcome, Guest Sign In / Register
Guest Settings Planned upgrade has been postponed. More information available Search here. FAQ Back to Forum Announcement: How to use iSetup ? Posted By: Created in: Posted: Hi All, 637018 Forum: Technology - LCM: Oracle iSetup Dec 3, 2009 9:16 PM
This is Mugunthan from iSetup development. Based on my interaction with customers and Oracle functional experts, I had documented list of manual setups that are required for smooth loading of selection sets. I am sharing the same. Please let me know if I anyone had to enter some manual setup while using iSetup. Understanding iSetup iSetup is a tool to migrate and report on your configuration data. Various engineering teams from Oracle develop the APIs/Programs, which migrates the data across EBS instances. Hence all your data is validated for all business cases and data consistency is guarantied. It requires good amount of setup functional knowledge and bit of technical knowledge to use this tool. Prerequisite setup for Instance Mapping to work · ATG patch set level should be same across all EBS instances. · Copy DBC files of each other EBS instances participating in migration under $FND_SECURE directory (refer note below for details). · Edit sqlnet.ora to allow connection between DB instacnes(tcp.invited_nodes=(<source>,<central>)) · Make sure that same user name with iSetup responsibility exists in all EBS instances participating in migration. Note:- iSetup tool is capable of connecting to multiple EBS instances. To do so, it uses dbc file information available under $FND_SECURE directory. Let us consider three instances A, B & C, where A is central instance, B is source instance and C is target instances. After copying the dbc file on all nodes, $FND_SECURE directory would look like this on each machine. A => A.dbc, B.dbc, C.dbc B => A.dbc, B.dbc C => A.dbc, C.dbc Prerequisite for registering Interface and creating Custom Selection Set
there is a workaround. · Custom interfaces should be registered in all EBS instances. UAT. Source and Target instances. Edit AZ_Prevalidator_1. It uses Concurrent Manager framework to lunch concurrent programs on source and target instances. Test. download to desktop and upload into Production · Option 3: Download and upload into each instance Security Considerations · iSetup does not use SSH to connect between instances. · The “Download” capability offers a way to share extracts. you would be able to load to target instance. or reports across different instances. Implications for Extract/Load Management · Option 1: Same owner across all instances · Option 2: Same owner in Dev. Now. · iSetup does not write password to any files or tables. Zip it back and upload to iSetup repository. However. If your case is so. Registering it on Central/Source is not sufficient. etc – but not Production o Extract/Load operations in non-Production instances o Once thoroughly tested and ready to load into Production. · iSetup financial and SCM modules are supported from 12. You must ensure that this would not corrupt data in DB. This is considered as customization and any data issue .xml to match your target instance language and DB Charset. Understanding how to access/share extracts across instances Sharing iSetup artifacts · Only the exact same user can access extracts.0. · iSetup is not certified on RAC. Download the extract zip file to desktop and unzip it. transforms. · Standard Concurrent Manager should up for picking up iSetup concurrent requests. you may still work with iSetup if you could copy the DBC file on all nodes with the same name as it had been registered through Instance Mapping screen. You must register the API on all instances participating in migration/reporting. Installed Languages iSetup has limitations where it cannot Load or Report if the number and type of installed languages and DB Charset are different between Central. It is not sufficient if you register API on central/source instance alone. and loads.4 onwards. transforms.Announcement: How to use iSetup ? iSetup super role is mandatory to register and create custom selection set. · It uses JDBC connectivity obtained through standard AOL security layer Common Incorrect Setups · Failure to complete/verify all of the steps in “Mapping instances” · DBC file should be copied again if EBS instance has been refreshed or autoconfig is run.
So. This improves the performance. . it won‟t change last_update_by or last_updated_date columns.Announcement: How to use iSetup ? coming out this modification is not supported. it would update the records with user who customized the records in source instance. Profiles HR: Business Group => Set the name of the Business Group for which you would like to extract data from source instance. then it would update the record based on last_update_date column. Since most of the AOL setup data such as Menus. the default owner of the record would be Oracle and it would skip these records. then FNDLOAD would not update the record. Responsibility. then FNDLOAD would not update the record. iSetup does not migrate Custom Applications as of now. then it would update the record based on last_update_date column. After loading Business Group onto the target instance. it would update the records with user who customized the records in source instance. it won‟t change last_update_by column. Case 1 – Shipped by Oracle (Seed Data) FNDLOAD checks last_update_date and last_updated_by columns to update a record. and Concurrent programs.e. Otherwise. please manually create them on the target instance before moving Application Object Library (AOL) data. iSetup uses FNDLOAD (seed data loader) to migrate most of the AOL Setups. make sure that this profile option is set appropriately. it does not make sense to migrate all of them to target instance since they would be available on target instance. if you have created any custom application on source instance. General Foundation Selection Set Setup objects in General foundation selection set supports filtering i. HR: Security Profile => Set the name of the Business Group for which you would like to extract data from source instance. it won‟t change last_update_by column. Hence. which are edited/added by you to target instance. After loading Business Group onto the target instance. ability to extract specific setups. which are identical. If the last_update_date of the record in the target were more recent. make sure that this profile option is set appropriately. Otherwise. If the last_update_date in the target were more recent. The default behavior of FNDLOAD is given below. Custom Applications Application data is the prerequisite for the most of the Application Object Library setups such as Menus. If it is shipped by Oracle. So. Responsibilities and Request Groups are shipped by Oracle itself. Case 3 – Created and maintained by customers If a record were newly added/edited in source instance by you. So. Case 2 – Shipped by Oracle and customized by you If a record were customized in source instance. it is strongly recommended to extract only those setup objects. So.
Concurrent Programs and Request Groups Concurrent program API migrates the program definition(Definition + Parameters + Executable) only. API will fail as Loc3 and Loc4 are not there in target instance. Please verify that all the data been extracted by reporting on your extract before loading to ensure data consistency. Loc5 and Loc6 If you provide values for Loc1 (Mandate). Loc4. Loc2 (Mandate). Navigation path to do the above setup: System Administrator -> Profile -> System. Please use custom solution to migrate executable files. and Loc4 Target=> Loc1 (Mandate). Query for the above profiles and set the values accordingly. Loc2 (Mandate). Case 2: Source => Loc1 (Mandate). make sure that this profile option is set if required. Loc4. it would result in partial migration of data. Otherwise. then locations will be loaded to target instance without any issue. Loc3. Loc2 If you provide values for Loc1 (Mandate). Case 1: Source => Loc1 (Mandate). . as Loc3 is a mandatory field. Descriptive & Key Flex Fields You must compile and freeze the flex field values before extracting using iSetup. It is always recommended that KFF/DFF structure should be same for both source as well as target instances. Loc3. You can load the KFF/DFF data to target instance even the structures in both source as well as target instances are different only in the below cases. Load Concurrent Programs prior to loading Request Groups. Loc3. After loading Operating Unit onto the target instance.Announcement: How to use iSetup ? MO: Operating Unit => Set the Operating Unit name for which you would like to extract data from source instance. Loc2. then API will fail. If you do not provide value for Loc3. Loc3 and Loc4 and load data to target instance. Loc2 (Mandate). and Loc4 Target=> Loc1. Loc2 (Mandate). Loc3 (Mandate). associated concurrent program meta-data will not be moved even through the Request Group extract contains associated Concurrent Program definition. It does not migrate physical executable files under APPL_TOP. Otherwise.
Inventory Organization API . To update Inventory Parameters. .Discrete Mfg & Distribution Selection Set Inventory Organization API will extract Inventory Organization information only. you should use Business Group API. Inventory Parameters API does not support update. In progress or not-completed Accounting Setups would not be migrated successfully. To migrate Inventory Organization. Mapping rule name should match with XML tag “SlCoaMappingName”. After that you would be able to load Accounting Setup to target instance. Organization API . To extract Business Group. Business Group. Accounting Setup Make sure that all Accounting Setups that you wish to migrate are in status “Complete”. Currencies Types iSetup does not have API to migrate Currency types. This API will not extract Inventory Organization. you have to use Inventory Organization API under Discrete Mfg. Enter them manually before loading Locations API.> types Associating an Employee details to an User The extract process does not capture employee details associated with users. iSetup does not have any API to migrate this setup.Product Foundation Selection Set All Organizations which are defined in HR module will be extracted by this API.1 for more information how to migrate SLA. then mapping rules should be defined in the target instance manually. Inventory Organization API Supports Update which means that you can update existing header level attributes of Inventory Organization on the target instance. So. If a Primary Ledger associated with Secondary Ledgers using different Chart of Accounts. You may make use of these two. Note: Currently iSetup does not migrate Sub-Ledger Accounting methods (SLA). Enter them manually on target instance after loading Currency API.Announcement: How to use iSetup ? Locations . Oracle supports some default SLA methods such as Standard Accrual and Standard Cash. If you want to use your own SLA method then you need to manually create it on target instances because iSetup does not have API to migrate SLA. and Distribution Selection Set. You should use Inventory Parameters API to move parameters such as Accounting Information. use Inventory Parameters Update API. You can refer note:736722. after loading the employee data successfully on the target instance. you have to configure them again on target instance.Geographies If you have any custom Geographies. GL Fiscal Super user--> setup--> Currencies --> rates -.
Product Foundation Selection Set Freight Carriers API in Product Foundation selection set requires Inventory Organization and Organization Parameters as prerequisite setup. Example. So. To view actual log. Appendix How to read logs · Logs are very important to diagnose and troubleshoot iSetup issues.Carrier-Org. Navigate to Organization XML and edit the XML tag <ProcessEnabledFlag>Y</ProcessEnabledFlag> to <ProcessEnabledFlag>N</ProcessEnabledFlag>. Legal Entities. Logs contain both functional and technical errors. Zip it back the extract and upload to target instance. Methods. and Distribution Selection Set. set the filter for a specific Business Group and then extract and load the data to target instance. use Discrete Mfg selection set to load Freight Carriers. Also. You can load the extract now. In next rollup release Freight Carriers API would be removed from Product Foundation Selection Set. So. setup objects such as Locations. · Generic Loader (FNDLOAD or Seed data loader) logs are not printed as a part of main log. · To find the log. After successful completion of load. If your inventory organization is process enabled. Download the extract zip file to desktop and unzip it. trying to load “Accounting Setup” without loading “Chart of Accounts” would result in this kind of error. Example. o Business validation failure – Setup is incorrect as per business rule. Carrier-ModeServ.Organizations and Organization Structure Versions support filter by Business Group. · Functional errors are mainly due to o Missing prerequisite data – You did not load one more perquisite API before loading the current API. List of mandatory iSetup Fwk patches Please refer to other announcements for patches specific to releases.Freight Carriers API is available under Discrete Mfg and Distribution Selection Set with name Carriers. For example. then you can migrate them by a simple workaround. Freight Carriers API . you can manually enable the flag through Form UI. you have to take the request_id specified in the concurrent log and search for the same in Forms Request Search Window in the instance where the request was launched. We are working on this issue and update you once patch is released to metalink. navigate to View Detail screens of Extracts/ Transforms/Loads/Standard/Comparison Reports and click on View Log button to view the log. . Start data cannot be greater than end date.Operating Units.Announcement: How to use iSetup ? We have a known issue where Inventory Organization API migrates non process enabled organization only. Organization Structure Selection Set It is highly recommended to set filter and extract and load data related to one Business Group at a time. These two APIs are available under Discrete Mfg.
then you would get this kind of errors. Example – business validation failure o Tokens: VONAME = Banks PLSQL o BANKNAME = 'OLD_ROYAL BANK OF MY INDIA' o EXCEPTION = End date cannot be earlier than the start date Example – missing prerequisite data.Announcement: How to use iSetup ? o API does not support Update Records – If the there is a matching record in the target instance and If the API does not support update. The 020. o You unselected Update Records while launching load . bank branch number. o VONAME = Operating Unit. . Example – technical or fwk error o Number of installed languages on source and target does not match. Application: PER. 26042. and country combination. KEY = Name = 'CAN OU' o Group Name = 'Setup Business Group' o . EXCEPTION = Message not found. o Action: Contact your system administrator quoting the procedure and Step 40. KEY = BANKNAME = 'AIBC„ o BRANCHNAME = 'AIBC' o EXCEPTION = Please provide a unique combination of bank number. then you would get this kind of errors.If the there is a matching record in the target instance and If you do not select Update Records. Example – business validation failure o VONAME = Branches PLSQL. Message Name: HR_ORG_SOB_NOT_FOUND (Set of books not found for „Setup Business Group‟) Example – technical or fwk error o OAException: System Error: Procedure at Step 40 o Cause: The procedure has created an error at Step 40. KA combination already exists.
This action might not be possible to undo. Are you sure you want to continue?
We've moved you to where you read on your other device.
Get the full title to continue listening from where you left off, or restart the preview.