Professional Documents
Culture Documents
o set up Discoverer to work with E-Business Suite (page 8) A workflow to patch Discoverer to the correct level (page 11) A workflow to create an E-Business Suite End User Layer (page 13) A workflow to assign administrative privileges to an E-Business Suite user (page 20)
3. If all prerequisites are met, you will be presented with the following Welcome screen, click the Next button
4. On the Specify File Locations screen, you are required to provide a Name and Path for the Instance that you are creating. The Name must begin with a character. In our example the name used was BIToolsHome1 and the path was C:\oracle\BIToolsHome_1. When done, click the Next button
5. For Select Installation Type, select Custom and click the Next button
6. On the Available Product Components screen, select one or both of Oracle Discoverer Administrator and Oracle Discoverer Desktop and click the Next button
7. If you are offered a chance to provide Outgoing Mail Server Information, ignore it and just click the Next button.
8. Finally, when presented with the following Summary screen, click the Install button. The actual install will now start.
9. During the later stages the installer will configure all of the components needed to run Discoverer. This step will not take very long. However, you must not stop the installer.
10. During the configuration stage the Net Configuration Assistant will launch. Click Next
11. The Net Configuration Assistant requires no manual intervention and is fully automated. When the install is complete, click Finish
12. At the end of the installation you will see the following End of Installation screen. When done, click Exit
Congratulations, you have successfully installed the Discoverer Admin and Desktop software. Next we need to set up Discoverer to work with EBusiness Suite.
5. Get the dbc file from the EBS environment and place it in the above secure folder 6. Copy or update your TNS Names entry, making sure you have an entry named to match the name of the dbc file referred to in step 5 7. Create these registry settings (back up your register first):
HKEY_CURRENT_USER\Software\Oracle\Discoverer 10\Database\EnableTriggers REG_DWORD 1 HKEY_CURRENT_USER\Software\Oracle\Discoverer 10\Database\DefaultPreserveDisplayPropertyForRefresh REG_DWORD 1
8. Launch Discoverer Admin but click the Cancel button at the login prompt
9. From the Discoverer Admin toolbar select Tools | Properties 10. Make sure the Connection tab has these settings:
12. From the Discoverer Admin toolbar, use File | Connect to launch the Discoverer Admin login box:
Note: Notice how this time there is a box called Oracle Application User. You will need to check this for logging in to E-Business Suite
13. Do not log in at this time. For the time being, close Discoverer Admin. Congratulations, you have successfully installed the Discoverer Admin and Desktop software, and set it up to operate with E-Business Suite. The last step is to patch Discoverer up to the correct version.
Part 1: Patch Discoverer Admin to this level: 10.1.2.2 using patch number 4960210.
Note: If you do not have any of the patches referred to in this document, you need to go to Oracle MetaLink and download them
1. After downloading patch 4960210 from MetaLink, unzip the patch to a temporary location (i.e. Patch10122) on the PC. 2. Using Windows Explorer, locate the folder where you unzipped the patch, go into the sub-folder called Install and double-click the file called setup.exe. This will start the Oracle Universal Installer. 3. After the installer starts, click on the Installed Oracle Products button and confirm that Discoverer Administration Edition/Desktop 10.1.2.48.18 is already installed. You should see a home called: BIToolsHome1. Make note of home name and the actual physical path for the home (i.e. C:\Oracle\BIToolsHome_1). 4. Click the Next button 5. When the installer prompts for the NAME and PATH of your Oracle Home, be sure to enter or select the values you noted in step 4 above. 6. Click the Next button 7. On the next screen, select Oracle Application Server and Developer Suite 10g Rel 2 Software Update then click the Next button 8. The installer will then check the inventory and proceed to install the patch in the home you have specified.
9. When done, close the installer program. Note: After applying patch 4960210, the Discoverer Administration Edition/Desktop software will be version 10.1.2.54.25.
Part 2: Patch Discoverer Admin to work with E-Business Suite using patch 5985072
10. After downloading patch 5985072 from MetaLink, unzip the patch to a temporary location (i.e. Patch598) on the PC. 11. Using Windows Explorer, make a backup copy of this folder: C:\oracle\BIToolsHome_1\bin 12. Locate the folder where you unzipped the patch and go into the sub-folder called files\bin 13. Copy all of the files from that location and paste them into this location: C:\oracle\BIToolsHome_1\bin Congratulations, you have successfully installed the Discoverer Admin and Desktop software, set it up to operate with E-Business Suite, and patched it up to the correct version
5. Complete this box as follows: User name - enter EUL_10G_US (case is unimportant) Password - enter the password Connect - enter the database (case is unimportant) Do not check the box entitled Oracle Applications User Click Connect
6. If your connection works, you will now be informed that you do not have access to any End User Layers and that you need to create one. When prompted Do you want to create an EUL now? click Yes
8. Complete the following Create EUL Wizard: Step 1 screen as follows: Click Select an existing user Check Grant access to PUBLIC Check New EUL is for use by Oracle Applications ONLY Click Select
9. On the Select User screen, locate the user called EUL_10G_US, or whatever user you used to connect to Discoverer Admin. After you have selected the user, click OK
10. You will now be returned to the Create EUL Wizard: Step 1 but this time you will notice that the User details have now been filled in and that the Next button has been activated. When ready, click Next Note: Because you selected the same user that you used to log in with you will not be prompted for the users password.
11. Complete the following Create EUL Wizard: Step 2 screen as follows: Schema - enter APPS Password - enter the APPS password Click Finish
12. Discoverer now begins the install of the EUL. As the install progresses you will see the following screens: Creating Tables and Views Populating tables with default data Granting access on EUL tables
13. Finally, you will see the following completion screen. When done, click OK
14. Having successfully installed the EUL, you will now be returned to the EUL Manager screen from where you should click Close
15. You will now see the following Load Wizard: Step 1
16. Because you will be administering this EUL using an E-Business Suite user, click the Cancel button Congratulations, you have successfully installed the Discoverer EBusiness Suite End User Layer. Next we need to assign an E-Business Suite user to become our administrator
Page 19 of 26 ASC0701 - Copyright: Armstrong-Smith Consulting Revised September 2008
As you can see in the above illustration, the Connection tab has three radio buttons and an area called Applications EUL Settings. The three radio buttons are: Connect to standard EULs - check this if your organization will only ever be using Discoverer in standard mode Connect to applications EULs - check this if your organization will only ever be using Discoverer in Apps mode Connect to both standard and applications EULs - check this if your organization will be using Discoverer in both Apps and standard modes. If you are wondering how this can be, let us explain. Some organizations use Discoverer in Apps mode against their Oracle Apps database but use it in standard mode against another database, such as a Data Warehouse. Because there is only one Administrator tool, the same tool needs to be able to administer Discoverer in both modes, hence the third option on the screen Having ensured that Discoverer is enabled for Apps mode, and specified whether you will only be administering Apps EULs or a combination of standard and Apps EULs, complete the Connection tab as follows: Click Connect to both standard and applications EULs Gateway User ID / password - enter applsyspub/pub Foundation Name - enter apps or whichever user your organization is using for the ownership of the Apps foundation tables Click OK
Notes: you are not asked for the Apps password because that was already entered during the EUL creation stage If your DBA has changed the APPLSYSPUB password from the default you will need to get that and use it instead
7. On the Select User/Responsibility screen, pick the Responsibility or Apps user that you want to use for managing Discoverer
Note: The recommended method is to use the SYSADMIN user account to administer the EUL. If this is not convenient you should select a user that has similar access rights.
Note: The Schedule Workbooks privilege can only be granted to a user. It cannot be granted to a responsibility
9. Now that you have assigned privileges to the SYSADMIN user or responsibility you now need to re-connect using SYSADMIN or a user that has the responsibility that you granted admin rights to
11. The Discoverer Administrator login screen will be displayed once more but this time you should reconnect as the SYSADMIN user. You will of course need to know the SYSADMIN password. As shown in the following illustration you will notice that there a additional checkbox called Oracle Applications User. In order to connect properly you will need to check this box.
12. Complete the above dialog box as follows: User name - enter sysadmin (case is unimportant) Password - enter the password Connect - enter the database (case is unimportant) Make sure Oracle Applications User is checked Click Connect
13. Discoverer will now authenticate the SYSADMIN user against the Oracle Applications E-Business Suite. If the credentials are correct, you will be presented with the following Choose a Responsibility Screen.
14. Select the System Administrator responsibility and click OK 15. From here on, you should only log in to the Administrator tool as the Apps SYSADMIN use. After you have done this the Load Wizard will be prompted. Do not attempt to administer an Apps mode EUL as the database EUL owner. This account is used to store the EUL tables and views but it is not an Apps account. You will run into serious trouble if you start administering the EUL with it, so please do not try.
Congratulations, you have successfully installed, configured and set up the End User Layer to work in Apps mode. The next step is over to you to create or import your business areas.
Page 26 of 26 ASC0701 - Copyright: Armstrong-Smith Consulting Revised September 2008