Configuring Domain for INB

Configure Domain for INB
Reference:
Sungard FAQ 1-BTZNOZ
Sample stop and start scripts can be downloaded for weblogic and INB located in
banner/prod/oracle/scripts/weblogic on ftp.usg.edu
Configure domain for INB:
=====================
To configure domain for INB run config.sh from PFR&D ORACLE_HOME/bin
/oracle/product/Middleware11g/fmw11g/bin[]
$ ./config.sh
Page 1
Click Next
Type username and password and make Domain Name INB and click Next
Page 2
Click Next
Click Yes
Page 3
Change Oracle Instance Location to /oracle/product/Middleware11g/inb_inst
Change Oracle Instance Name to inb_inst
Click Next
Page 4
Comment [VP1]: Make sure to deselect below
which were selected by default:
1.Oracle Portal
2.Oracle Discoverer
3.Oracle Web Cache (Forms do not work well
with webcache)
Follow comment then click on Next
Page 5
Page 6
Check Auto Port Configuration
Click Next
Page 7
Check Do Not Use Proxy Settings. Click Next
Page 8
Comment [VP2]: Make sure to deselect “Use
Application Level Identity Store”
Follow comment and click Next
Page 9
Click Configure
Page
10
Page
11
Click Next
Page
12
Click finsh
Page
13
Create boot.properties file under
$DOMAIN_HOME/servers/AdminServer/security
$DOMAIN_HOME/servers/WLS_FORMS/security
$DOMAIN_HOME/servers/WLS_REPORTS/security
e.g. of boot.properties
username=weblogic
password=abc123
================================================================
=========
INB Configuration
================================================================
=========
Page
14
================================
Copy files from database server
to OFM server
================================
Banner keymap file
Copy the fmrpcweb.res from your Banner Database
$BANNER_HOME/install/
to the directory
$ORACLE_INSTANCE/config/FormsComponent/forms/admin/resource
/US
and rename the file to
fmrweb_utf8.res
================================
Copy Banner jar files
================================
Copy Needed Banner jar files from your Banner Database
$BANNER_HOME/general/java
to the directory
$ORACLE_HOME/forms/java
banspecial.jar
banicons.jar
bannerui.jar
banorep_10_1_2_3.jar
bannersso.jar
sbanspecial.jar
sbanicons.jar
sbannerui.jar
sbanorep_10_1_2_3.jar
sbannersso.jar
================================
Compile Forms
================================
The strip_source=yes option is no longer valid in Forms Fusion
11g (see Defect 1-FV0U0D). Subsequently you will need to modify
each shell file (bat file in Windows) in order to compile Banner
forms. Example modified scripts are attached for your
Page
15
convenience. The scripts are current as of 6/10/2010 but some
scripts may have been changed with Banner upgrades to include
new forms.
UNIX
---Change
"pll") frmcmp_batch $source_bn $fgen_user/$fgen_pass
module_type=$mod_type batch=yes output_file=$target_fn
strip_source=yes compile_all=special;;
to
"pll") frmcmp_batch $source_bn $fgen_user/$fgen_pass
module_type=$mod_type batch=yes output_file=$target_fn
compile_all=special;;
Copy all fmb, pll, mmb files to /aux/ban8/fmb.
Verify you can connect to the Banner database
sqlplus baninst1/password
Execute the Banner compile script (eg genform.shl).
su - ban8
genform.shl
Move the resulting fmx,plx, and mmx files to /aux/ban8/fmx.
Note that NLS_LANG should be unset. If NLS_LANG is set this
error may be encountered when compiling pll files:
FRM-30312: Failed to compile the library.
================================
Start WebLogic Server
================================
To avoid being prompted for the weblogic password a
boot.properties file can be create in
$DOMAIN_HOME/servers/AdminServer/security
For example
boot.properties
username=weblogic
password=manager1
The password in the file will be encrypted once weblogic is
started.
To start WebLogic, a script similar to the example
startWebLogic attached can be used.
To execute,
su - oracle
Page
16
startWebLogic >>startWebLogic.log 2>&1 &
To stop WebLogic, a script similar to the example stopWebLogic
attached can be used.
================================
Start NodeManager
================================
To execute,
su - oracle
startNodeManager >>startNodeManager.log 2>&1 &
There is no script to stop NodeManager. This command can be
used to find the PID
and then execute a Unix kill -9 command on the PID
ps -elf |grep NodeManager |grep -v grep |awk '{print $3 " " $4 "
" $15}'
================================
Start opmnctl web services
================================
The oraenv file attached to this FAQ adds the
$ORACLE_INSTANCE/bin directory to oracle's
PATH so this command can be executed from oracle's $HOME.
su - oracle
opmnctl startall
================================
Scripts to Start and Stop all Processes
================================
To start WebLogic and NodeManager and Opmnctl, WLS_FORMS,
WLS_REPORTS, and BannerApps, the example start and stop scripts
attached can be used. (revised 6/9/11).
================================
Forms Configuration
Note: Please review your /etc/hosts file. Entries in the
format <ip> shortname fullname my cause your Middleware
Control to freeze when doing configuration. The suggested
format is <ip> fullname shortname.
Page
17
Using a browser,
http://wlServer.sct.com:7001/em
Login as weblogic/manager1
Expand the Forms folder and click Forms > web Configuration
Page
18
Page
19
Click Create to create a new Section to connect to the Banner
database.
Page
20
Section Name: dbServer_ban8(dbServer_ban8 is sid name)
Comments: Banner 8 database
In the Show drop down box, in the lower part of the page, Select
All.
The parameters listed below are required for Banner to function
as designed.
Page
21
Other parameters may be changed besides the ones listed below
for customers to customize as desired.
All parameters are described in
FAQ 1-BZBPJV Oracle Doc ID 118632.1 Webforms Parameter
Overview
Change these values using the Override button.
envFile = dbServer_ban8.env
form = guainit.fmx
width 1040
height 738
separate frame = true
colorScheme=blaf
background = ' '
logo = ' '
archive=banspecial.jar,banicons.jar,bannerui.jar,banorep_10
_1_2_3.jar,frmwebutil.jar,frmall.jar
jpi_mimetype application/x-java-applet
(remove the version in order to allow for different
versions of JPI to connect).
Click Apply to save Changes
Page
22
Add this value using the Add button.
workingDirectory= /aux/ban8/fmx
[Note: Adding workingDirectory here avoids the need to copy the
plx files to the $ORACLE_HOME/forms directory due to an Oracle
bug (FRM-40039: Cannot attach library goqrpls while opening form
GUAINIT - Oracle base bug 9356983), as was directed in a
previous version of this FAQ. For a description of
workingDirectory, please see FAQ 1-GD9WKB - Oracle Doc ID
551511.1 - What is Difference between the Forms_path and the
working directory.]
Click Apply to save Changes
Note the archive parameter above is using the latest
secured jar files from b_0510_gen8030003.trz
Page
23
Click Apply to save Changes
Click Home > Environment Configurations > Duplicate File
Page
24
Environment File: default.env
Name: dbServer_ban8.env (dbServer_ban8 is database name)
In the Show box select dbServer_ban8.env
Change these values
FORMS_PATH = c:\sghe\ban8\fmx
Add these values
TWO_TASK = dbServer_ban8.sct.com
LOCAL = dbServer_ban8.sct.com
NLS_LANG = AMERICAN_AMERICA.AL32UTF8
FORMS_USERNAME_CASESENSITIVE = 1
Click Apply
================================
Reports Configure
================================
Binary copy the bannerid.jar file to a new directory on the
WebLogic Forms/Reports server.
Page
25
For Example
c:\sghe\ban8\secure
Change directory into
C:\Oracle\Middleware\asinst_1\config\ReportsServerComponent\Repo
rtsServer_malaln24_asinst_
Backup the file rwserver.conf
Edit the file rwserver.conf
Add the defaultEnvId and classPath parameter to the engine ID
parameter.
In this example:
<engine minEngine="1" maxIdle="30" maxEngine="1" id="rwEng"
engLife="50" class="oracle.reports.engine.EngineImpl"/>
becomes:
<engine minEngine="1" maxIdle="30" maxEngine="1" id="rwEng"
engLife="50" class="oracle.reports.engine.EngineImpl"
defaultEnvId="ROCORAM2_BAN8"
classPath="c:\sghe\ban8\secure\bannerid.jar"/>
Using a browser,
http://malaln24.sct.com:7001/em
Login as weblogic/manager1
Expand Farm_ClassicDomain
Expand the Reports folder and click Reports -ReportsServer_malaln24_asinst_
In the Reports drop down at the top select
Report -- Administration -- Basic Configuration
Under Environment Configuration, add your environment.
example, DBSERVER_BAN8.
Add a New Environment = ROCORAM2_BAN8
Click "AddEvironment" button
Set Registered Enviroments = ROCORAM2_BAN8
Under
"Environment Variables associated with Envrionment
ROCORAM2_BAN8"
Click Add to add these variables
Name
Value
-------LOCAL
rocoram2_ban8
NLS_LANG
AMERICAN_AMERICA.AL32UTF8
REPORTS_PATH
c:\sghe\ban8\fmx
Click Apply
Page
26
In this
Confirm under the Reports Engine Parameters section on the right
hand side that it has the field
Default Env ID = ROCORAM2_BAN8
Which tells reports server which env file to use by default.
Restart the reports server from the Reports drop down, Reports - Control -- Restart
Logon to Banner (INB) as the BASELINE user
Open the General User Preferences Maintenance Form (GUAUPRF).
Select Directory Options.
Navigate to the record for the name of your Oracle Reports
server.
In the Default Value field, change the URL to the server address
used by your site.
Example:
Delivered value: http://yourservername/reports/rwservlet?
New value:
http://malaln24.sct.com:8888/reports/rwservlet?
Navigate to the record for the name of your Oracle Reports
service name.
In the Default Value field, change the reports server name to
the name used at your site.
Example:
Delivered value: rep_yourservername
New value:
ReportsServer_malaln24_asinst_
================================
Forms Font Configuration
================================
Using a browser,
http://malaln24.sct.com:7001/em
Login as weblogic/manager1
Expand the Forms folder and click Forms
At the top of Right frame select Forms drop down -- Font and
Icon Mapping
Change the value
default.fontMap.defaultFontname = Dialog
to
default.fontMap.defaultFontname = Arial Unicode MS
Click Apply
Now restart WLS_FORMS
Page
27
On the left hand frame open -- WebLogic Domain -- ClassicDomain
-- cluster_forms
At the top of Right frame select WebLogic Cluster drop down -Control -- Shutdown
At the top of Right frame select WebLogic Cluster drop down -Control -- Startup
================================
Test the INB Connection
================================
The HTTP server port (OHS_LISTEN_PORT) can be found in the
$ORACLE_HOME/install/portlist.ini.
The HTTP server port must be used for Forms and Reports
integration.
In the example below the HTTP server port is 8888.
http://malaln24.sct.com:8888/forms/frmservlet?config=dbServ
er_ban8
When bring INB for first time user may received the Registry.dat
missing
If you receive this error perform the following
Instructions to clear the Java cache
Clearing the Java Plug-in cache forces the browser to load the latest versions of web
pages and programs.
To clear the Java Plug-in cache:
Click Start > Control Panel.
1. Double-click the Java icon in the control panel.
The Java Control Panel appears.
Page
28
Page
29
3. Click Settings under Temporary Internet Files.
The Temporary Files Settings dialog box appears.
4. Click Delete Files.
The Delete Temporary Files dialog box appears.
Page
30
5. Click OK on Delete Temporary Files window.
Note: This deletes all the Downloaded Applications and Applets from the cache.
6. Click OK on Temporary Files Settings window.
Note: If you want to delete a specific application and applet from the cache, click
on View Application and View Applet options respectively.
================================
Test the Reports Connection
================================
Login to INB
http://malaln24.sct.com:8888/forms/frmservlet?config=dbServ
er_ban8
Run any of the compiled Oracle Banner reports from AR, Student
or Finance
For example run the report TGRDETC from GJAPCTL
When submitted it should open a new browser windows to the URL
Page
31
http://malaln24.sct.com:8888/reports/rwservlet?server=ReportsSer
ver_malaln24_asinst_&report=TGRDETC&destype=CACHE
&desformat=PDF&paramform=NO&userid=&PARM01=&PARM02=BKST&PARM03=A
&PARM04=A&PARM05=A&PARM06=&PARM07=&PARM08=&PARM09=C
and the PDF output should be displayed.
================================
Configure Web Output URL
================================
Logon to Banner as BASELINE.
Execute the GUAUPRF Form from the Banner Main Menu.
Click on Directory Options.
Scroll down to the field which has the Description
Web Output URL
Enter the following URL. The 9010 port and DAD (dbServer_ban8)
will be created in the "Configure SSB" section in this FAQ.
http://malaln24.sct.com:9010/dbServer_ban8/
================================
Banner Online Help
================================
See
- FAQ 1-C0W7P7 - Installing Banner online help - bannerOH.war
with Oracle WebLogic and Oracle Form Fusion – OFM
Page
32