Banner Financial Aid / Hosted Services Handbook / January 2012

Banner Financial Aid
Hosted Services Handbook
January 2012
Banner®, Colleague®, PowerCAMPUS®, Luminis® and Datatel® are trademarks of Ellucian or its affiliates and are registered in the U.S. and
other countries. Ellucian, Advance, DegreeWorks, fsaATLAS, Course Signals, SmartCall, Recruiter, MOX, ILP, and WCMS are trademarks of
Ellucian or its affiliates. Other names may be trademarks of their respective owners.
©2011-2012 Ellucian. All rights reserved. The unauthorized possession, use, reproduction, distribution, display or disclosure of this material or
the information contained herein is prohibited.
Contains confidential and proprietary information of Ellucian and its subsidiaries. Use of these materials is limited to Ellucian licensees, and is
subject to the terms and conditions of one or more written license agreements between Ellucian and the licensee in question.
In preparing and providing this publication, Ellucian is not rendering legal, accounting, or other similar professional services. Ellucian makes no
claims that an institution's use of this publication or the software for which it is provided will insure compliance with applicable federal or state
laws, rules, or regulations. Each organization should seek legal, accounting and other similar professional services from competent providers of
the organization’s own choosing.
Prepared by: Ellucian
4375 Fair Lakes Court
Fairfax, Virginia 22033
United States of America
Revision History
Publication Date
Summary
January 2012
New version that supports Banner Financial Aid software.
Banner Financial Aid
Hosted Services Handbook
Contents
Chapter 1
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
Banner Financial Aid Hosted Services . . . . . . . . . . . . . . . . . . . . . . . 1-1
Chapter 2
FM Need Analysis Off-Premise Configuration
. . . . . . . . . . . . . . . . . . . . 2-1
Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
OC4J of iAS 10.1.3.x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Off-Premise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Object List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
Configuration Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4
Batch Need Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4
Immediate Processing (Job Submission Process vs. Servlet) . . . . . . . . . . . . 2-4
Off-Premise vs. On-Premise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5
Configuration Checklists. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7
Batch Need Analysis (Required) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-7
Run immediate Need Analysis using the job submission option . . . . . . . . . . 2-7
Run immediate Need Analysis using the servlet option . . . . . . . . . . . . . . . 2-8
Redeploying the servlet rnpfmxx.war . . . . . . . . . . . . . . . . . . . . . . . . . . 2-9
Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10
Updating finaidfmlogin.jar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10
Updating finaiddbseed.jar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-11
Internet Native Banner (INB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12
iAS 10.1.3.x OC4J . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-14
Loading Certificate to JVM for RNPFM12 or RNPFM13 . . . . . . . . . . . . . . . 2-23
January 2012
Banner Financial Aid
Hosted Services Handbook
Contents
iii
Redeploy Servlet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-25
Proxy Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-26
Configure Servlet for SSL (optional) . . . . . . . . . . . . . . . . . . . . . . . . . . 2-31
Redirecting INB to the Plus one (+1) URL . . . . . . . . . . . . . . . . . . . . . . . 2-32
Alternative Install to Full iAS 10.1.3.x . . . . . . . . . . . . . . . . . . . . . . . . 2-35
OC4J install of iAS 10.1.3.x only . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-35
WebLogic Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-37
Installation of servlet on WebLogic (optional) . . . . . . . . . . . . . . . . . . . . . 2-37
Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-56
Missing finaidutils.jar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-56
Unable to connect to servlet rnpfmxx.war . . . . . . . . . . . . . . . . . . . . . . . 2-56
Connection timed out . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-56
Proxy not authorized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-57
Unauthorized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-58
Certification path . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-58
FAQs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-59
FM Need Analysis FAQs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-59
WebLogic FAQs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-66
Chapter 3
FM Need Analysis On-Premise Configuration . . . . . . . . . . . . . . . . . . . . . 3-1
Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
OC4J of iAS 10.1.3.x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
On-Premise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Object List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
Configuration Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
Batch Need Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
Immediate Processing (Job Submission Process vs. Servlet) . . . . . . . . . . . . 3-4
Off-Premise vs. On-Premise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5
iv
Banner Financial Aid
Hosted Services Handbook
Contents
January 2012
Configuration Checklists. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-7
Batch Need Analysis (Required) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-7
Run immediate Need Analysis using the job submission option . . . . . . . . . . 3-7
Run immediate Need Analysis using the servlet option . . . . . . . . . . . . . . . 3-7
On-Premise Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-9
Redeploying the servlet rnpfmxx.war . . . . . . . . . . . . . . . . . . . . . . . . . . 3-9
Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-10
Updating finaidfmlogin.jar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-10
Updating finaiddbseed.jar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-11
Internet Native Banner (INB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-12
iAS 10.1.3.x OC4J . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-14
On-Premise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-23
Loading Certificate to JVM for RNPFM12 or RNPFM13 . . . . . . . . . . . . . . . 3-31
Redeploy Servlet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-32
Proxy Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-34
Configure Servlet for SSL (optional) . . . . . . . . . . . . . . . . . . . . . . . . . . 3-39
Alternative Install to Full iAS 10.1.3.x . . . . . . . . . . . . . . . . . . . . . . . . 3-41
OC4J install of iAS 10.1.3.x only . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-41
WebLogic Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-43
Installation of servlet on WebLogic (optional) . . . . . . . . . . . . . . . . . . . . . 3-43
Windows Server Platform Certification (On-Premise Only) . . . . . . . . . . . 3-62
Windows Server 2008 Platform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-62
Configuration Points Tested . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-63
Helpful Screen Shots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-66
Certification Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-67
Issues Identified . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-68
Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-69
Additional Supporting Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-70
Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-71
Missing finaidutils.jar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-71
Unable to connect to servlet rnpfmxx.war . . . . . . . . . . . . . . . . . . . . . . . 3-71
Connection timed out . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-72
January 2012
Banner Financial Aid
Hosted Services Handbook
Contents
v
Proxy not authorized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-72
Unauthorized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-73
FAQs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-74
FM Need Analysis FAQs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-74
WebLogic FAQs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-81
Appendix A FM Need Analysis Schema
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1
Appendix B Enabling Secure Sockets Layer (SSL) Communication
. . . . . . . . . . B-1
Recommendations for securing applications in Oracle Application Server . B-1
Recommendation #1: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1
Recommendation #2: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-2
Recommendations for enabling SSL in a test environment . . . . . . . . . . . B-2
Configuring the Oracle Application Server to trust a customer generated
self-signed certificate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-3
Index
vi
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . I-1
Banner Financial Aid
Hosted Services Handbook
Contents
January 2012
1
Introduction
Banner Financial Aid Hosted Services
This handbook describes the variety of external hosted services offered by Ellucian in
support of the Banner Financial Aid product. Each chapter contains specific installation,
configuration, and administrative materials.
Additionally, this handbook also includes other supplemental details in related
Appendices.
Descriptions of the following hosted services are provided:
• FM Need Analysis Off-Premise Configuration
• FM Need Analysis On-Premise Configuration
January 2012
Banner Financial Aid
Hosted Services Handbook
Introduction
1-1
1-2
Banner Financial Aid
Hosted Services Handbook
Introduction
January 2012
2
FM Need Analysis OffPremise Configuration
Introduction
This chapter supplies technical details associated with installation and configuration of the
hosted FM Need Analysis solution, supported by the system’s Infinity platform.
Configurations, both required and optional, are included to achieve successful 2011-2012
FM Need Analysis calculations associated with release 7.19/8.10, or above. As such, this
chapter is written with references specific to the RNPFM12 object. However, the steps
associated with RNPFM12 can also be applied to the new version of the object
(RNPFM13).
Note
Information found in this chapter supersedes all configuration
requirements noted in prior release documentation.

Tip
Please note that issues regarding the hosted Banner Financial Aid FM
Need Analysis solution should be submitted to the Banner Financial Aid
ActionLine under the Product Line: Financial Aid and the Product: FM
Need Analysis.
When submitting a Service Request from the Customer Support Center,
select the correct Product Line (Financial Aid) and Product

(FM Need Analysis) options from the available drop down lists.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-1
Requirements
OC4J of iAS 10.1.3.x
The servlet rnpfmxx.war must be installed on an OracleAS Containers for Java (OC4J)
version 10.1.3.x. This version of the OC4J is available with the Internet Application
Server (iAS) 10.1.3.x. Because iAS 10.1.3.x does not contain an Oracle forms server, the
OC4J of iAS 10.1.3.x must be installed in addition to the existing OAS 10.1.2.x. The
installation of iAS 10.1.3.x can be done on to the same environment as
OAS 10.1.2.x.
Note
This document is written based on iAS version 10.1.3.5. The screen
samples and implementation steps are therefore based solely on this
version. Slightly older or newer versions of iAS may not match exactly. 
Off-Premise
If the institution applied for their status to host the Financial Aid Need Analysis as
Off-Premise, there are no additional requirements. The web service will be hosted and
maintained by Infinity.
2-2
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
January 2012
Object List
The following objects are associated with FM Need Analysis:
• finaiddbseed.jar
• finaidfmlogin.jar
• finaidutils.jar
• fm1_sungardhe_v2.cer
• fm2_sungardhe_v2.cer
• rnpfmxx.war
• rnpfm13.jar
• rnpfm13.com
• rnpfm13.pl
• rnpfm13.shl
• rnpfm12.jar
• rnpfm12.com
• rnpfm12.pl
• rnpfm12.shl
• rnpfmxx_plan.dat
Note
In INB, access to the RORPARM form will also be needed to update
references to the servlet.
January 2012

Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-3
Configuration Options
Several options are available for running FM Need Analysis. The following diagrams
illustrate the various FM Need Analysis configuration options:
Batch Need Analysis
The most efficient way to process large numbers of students for FM Need Analysis is
by using job submission to run the RNPFM12 process. Therefore, this is a required
configuration:
Immediate Processing (Job Submission Process vs.
Servlet)
There are two configuration options available to perform immediate student
processing for FM Need Analysis.
Running immediate FM Need Analysis using the traditional job submission:
Running immediate FM Need Analysis using the servlet:
2-4
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
January 2012
While better performance is noted using the immediate FM Need Analysis configuration
using the servlet, this configuration will require more configuration time and requires
OC4J version 10.1.3.x or Oracle WebLogic Server.
Configuration Times
Processing Time per Student
Job Submission
1 minute
6 - 30 seconds
Servlet
Approximately 1 - 2 hours
2 - 6 seconds
Off-Premise vs. On-Premise
Hosted solutions for Banner FM Need Analysis are separated into two major
components, Banner and software-as-a-service (SaaS). The Banner element is
required and must be implemented. However, two options exist for the SaaS
implementation:
• Off-Premise
• On-Premise
Off-Premise
The preferred SaaS option is Off-Premise. This configuration requires no additional
implementation and no maintenance. The Off-Premise service is hosted by Infinity.
Off-Premise service offers uptime measured near 100% (based on current 2011
statistics). The service is secured by (Secure Socket Layer) SSL technology and
requires a unique login for each institution. Software updates to the SaaS
implementation are automatic and instantaneous (no update/upgrade actions are
required by the institution).
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-5
On-Premise
As an alternative, institutions may elect to use a locally hosted, On Premise, configuration
(non-Infinity based). This optional service requires that the institution download, install,
configure, and provide ongoing maintenance. With respect to On-Premise hosting
maintenance, the institution is expected to monitor communication for a standard “update”
message. In turn, the institution is expected to download, install, and configure any and all
available software updates. Use of the On-Premise FM Need Analysis option also requires
that either the Windows 2003 or 2008 server with IIS be installed.
Note
Two separate installation procedures are provided, one each for Windows
2003 and Windows 2008. Only one of the two Web Service options must

be implemented if the On-Premise option is chosen.
Please refer to Chapter 3, FM Need Analysis On-Premise Configuration for installation
and deployment information for this option.
2-6
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
January 2012
Configuration Checklists
This section includes a series of checklist items, based on desired function.
Batch Need Analysis (Required)
1. The finaidfmlogin.jar must be updated with the institution’s login credentials
for Infinity. Refer to the Updating finaidfmlogin.jar procedure.
2. The job submission server must open outgoing port 443 to allow the batch process
rnpfm12.jar to connect to the Infinity URLs:
https://fm1.sungardhe.com
AND
https://fm2.sungardhe.com
Run immediate Need Analysis using the job
submission option
1. In INB, navigate to the RORPARM form.
2. Change the value for parameter USE_JOBSUB to Y and save.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-7
Run immediate Need Analysis using the servlet option
1. All FINAID users must be granted the banproxy permission to login as a proxy user.
Refer to the Internet Native Banner, Configure banproxy procedure.
2. The finaidutils.jar must be deployed onto the OAS 10.1.2.x Oracle forms
server. Refer to the Internet Native Banner (INB), Installing finaidutils.jar procedure.
3. The finaiddbseed.jar must be updated with the institution’s seed numbers. Refer
to the Updating finaiddbseed.jar procedure.
4. Copy the following four files from <BANNER_HOME>/finaid/java to a temporary
location that can be accessed by a web browser:
• rnpfmxx.war
• rnpfmxx_plan.dat
• finaidfmlogin.jar
• finaiddbseed.jar
5. These four files must be deployed on to the OC4J of the iAS 10.1.3.x. Refer to the
iAS 10.1.3.x OC4J procedure.
5.1.
Create the rnpfmxx OC4J Instance
5.2.
Installing the Share Library
5.3.
Installing the Servlet
5.4.
Creating the Connection Pool and Data Source
6. In INB, navigate to the RORPARM form.
7. Change the value for parameter USE_JOBSUB to N.
2-8
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
January 2012
8. Change the value for parameter SERVLET_URL to the URL of the servlet that was
installed in step 2 above and save.
The servlet URL uses the following format:
• http://<SERVER>:<PORT>/rnpfmxx/FmCalxx
• <SERVER> the name of the Server where rnpfmxx.war is deployed
• <PORT> the port number
9. The environment that is hosting OC4J must open outgoing port 443 to allow the
servlet rnpfmxx.war to connect to the Infinity URLs:
https://fm1.sungardhe.com
AND
https://fm2.sungardhe.com
Redeploying the servlet rnpfmxx.war
Once the servlet rnpfmxx.war has been deployed for the first time, subsequent
installations require a redeployment only. Refer to the Redeploy Servlet procedure.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-9
Procedures
This section describes individual procedures associated with FM Need Analysis
operations. Each procedure provides a stand-alone set of instructions associated with a
particular FM Need Analysis function.
This is a reference section only and is not intended to be followed sequentially. Other
sections in this chapter point back to this section to reinforce or instruct the user to
perform certain necessary steps.
The following procedural information is listed in this section:
• Updating finaidfmlogin.jar
• Updating finaiddbseed.jar
• Internet Native Banner (INB)
• iAS 10.1.3.x OC4J
• Loading Certificate to JVM for RNPFM12 or RNPFM13
• Redeploy Servlet
• Proxy Settings
• Configure Servlet for SSL (optional)
Updating finaidfmlogin.jar
Embedded within the object finaidfmlogin.jar, is a nas.properties file. This file
must be modified to allow each institution to connect to the Infinity Financial Aid Need
Analysis system. The finaidfmlogin.jar file can be found:
• Under OpenVMS
$BANNER_HOME/finaid/java under UNIX, BAN_HOME:[finaid.java]
• Under Windows
${banner_home}\finaid\java
1. Use the following command to extract the nas.properties file from
finaidfmlogin.jar:
jar xf finaidfmlogin.jar com/sungardhe/finaid/login/
nas.properties
2. Open the com/sungardhe/finaid/login/nas.properties file in a text editor.
2-10
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
January 2012
3. Change the user name and password values, the text to the right of the equal sign, for
these properties. Be careful not to leave any trailing spaces after the values.
httpusername=
httppassword=
Note
Use the authentication code provided when the institution applied for the

off-premise status.
4. Use the following command to update the finaidfmlogin.jar with the edited
nas.properties:
jar uf finaidfmlogin.jar com/sungardhe/finaid/login/
nas.properties
Updating finaiddbseed.jar
Embedded within the object finaiddbseed.jar is a seed.properties file. This file
must be modified to allow each institution to connect to the Oracle database. The
finaiddbseed.jar can be found:
• Under OpenVMS
$BANNER_HOME/finaid/java
• Under UNIX
BAN_HOME:[finaid.java]
• Under Windows
${banner_home}\finaid\java
1. Use the following command to extract the seed.properties file from
finaiddbseed.jar:
jar xf finaiddbseed.jar com/sungardhe/finaid/dbseed/
seed.properties
2. Open the com/sungardhe/finaid/login/seed.properties file in a text
editor.
3. Using the institution security seed number, change the values, text to the right of the
equal sign, for these properties. Be careful not to leave any trailing spaces after the
values.
seed1=
seed3=
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-11
4. Use the following command to update the finaiddbseed.jar with the edited
seed.properties:
jar uf finaiddbseed.jar com/sungardhe/finaid/dbseed/
seed.properties
Internet Native Banner (INB)
Configure banproxy
A proxy connection must be configured for each FINAID user who will be responsible for
running a FM Need Analysis. The INB banproxy user will be configured to act as the
proxy user. Appropriate permission is required for each user to allow banproxy to connect
to Oracle on that login user’s behalf.
1. As the bansecr userid, open the Oracle/Banner Security Maintenance (GSASECR)
form.
2. Select the User ID that will use the proxy connection and click the Alter button.
2-12
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
January 2012
3. The User ID’s credentials are displayed on the Authorize or Create an ORACLE ID
window. Check the Authorize BANPROXY checkbox and click the Save button.
Installing finaidutils.jar
For INB to communicate with the servlet, the finaidutils.jar must be deployed on to
the OAS 10.1.2.x forms server or the WebLogic domain hosting INB.
1. The finaidutils.jar file (<BANNER_HOME>/finaid/java/
finaidutils.jar) must be copied to the OAS 10.1.2.x (<ORACLE_HOME>/
forms/java) directory.
• For Oracle 10g the destination environment is the OAS 10.1.2.x form server.
• For Oracle 11g the destination environment is the WebLogic domain that is hosting
INB.
2. The file name finaidutils.jar must be appended to the end of the CLASSPATH
in the file:
OAS_HOME/forms/server/default.env
Note
The environment file is the file used to run the INB instance. For example,

it may be prod.env.
3. Once the above changes are made, INB must be restarted.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-13
iAS 10.1.3.x OC4J
Creating the rnpfmxx OC4J Instance
1. Click the default Application Server that was created with the installation of the iAS
10.1.3.x.
2. Click the Create OC4J Instance button.
3. Enter the following attributes and click Create:
• OC4J instance name = rnpfmxx
• Click the Add to a new group with name radio button and enter the following
New Group Name = sghe_group
• Check the Start this OC4J instance after creation checkbox
2-14
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
January 2012
4. Once created, click the new rnpfmxx.
5. Go to the Administration tab and click Server Properties.
6. Change the following attributes, then click Apply:
• Port = 8860 or a free port number
• Protocol = http
• Maximum heap size = 1024m
• Initial heap size = 512m
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-15
Installing the Share Library
Before installing the Share Library, make sure modifications have been made to the
finaidfmlogin.jar and finaiddbseed.jar. Refer to the following procedures:
Updating finaidfmlogin.jar and Updating finaiddbseed.jar.
1. Click the rnpfmxx Application Server to go to the OC4J rnpfmxx Instance.
2. From the Administration tab, click the Shared Libraries task icon.
3. On the following page, click on the Create button.
4. Make the following attribute changes for the new Shared Library and click Next.
• Shared Library Name = banner_finaid
• Shared Library Version = 1.0
2-16
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
January 2012
5. Add the following jar files to the library (one at a time):
• finaiddbseed.jar
• finaidfmlogin.jar
6. After adding both files, click Finish.
Installing the Servlet
1. Click the rnpfmxx Application Server to go to the OC4J rnpfmxx Instance.
2. From the Applications tab, click the Deploy button.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-17
3. From the Deploy: Select Archive page, set the following archive attributes:
• Archive Location = rnpfmxx.war
• Deployment Plan = rnpfmxx_plan.dat
• Click Next
4. Click on Next.
5. On the Deploy: Deployment Settings page, click the Configure Class Loading task
icon.
2-18
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
January 2012
6. Select the Import checkbox for the banner_finaid Shared Library, followed by
the OK button.
7. At the Deployment Settings page, click the Deploy button.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-19
Creating the Connection Pool and Data Source for RNPFMXX
1. From the OC4J: rnpfmxx Instance, under the Administration tab, click the JDBC
Resources Services task icon.
2. In the Application pull-down box, select rnpfmxx, and click the Create button to
create a Connection Pool.
The screen changes to show:
2-20
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
January 2012
3. On the following page, make the following attribute changes and click the Finished
button:
• Name = jdbc:java/banner/finaid
• JDBC URL = jdbc:oracle:thin:@<HOST>:<PORT>:<SERVICE_NAME>
Note
Replace the <HOST>, <PORT> and <SERVICE_NAME> with the
appropriate values to make a connection to the desired institution Oracle

database.
• Username = banproxy
• Cleartext Password = the institution password defined for user banproxy
4. From the Data Sources page, select rnpfmxx from the Application pull-down box, to
create a Data Source.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-21
The screen changes to show:
5. On the following page, make the following attribute changes and click the Finished
button:
• Name = BannerFinaid
• JNDI Location = jdbc:java/banner/finaid
• Connection Pool = jdbc:java/banner/finaid
2-22
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
January 2012
Loading Certificate to JVM for RNPFM12 or RNPFM13
When connecting to a HTTPS URL (SSL is enabled on the server side) the connecting
JVM may need to load the client side certificate.
Warning
As of the Banner Financial Aid 8.13 release, the system enforces the
Java Virtual Machine (JVM) 1.5 or higher requirement. With JVM 1.5 and
higher, the certificates needed to connect to the Infinity server are preloaded. The one known exception to this situation is the JVM for
OpenVMS. This procedure should not be used by the majority of

institutions.
Use the following steps to load the client side certificate:
1. Navigate to the following directory of the job submission server:
<JAVA_HOME>/bin
2. Copy the following two certificates to this same directory:
• fm1_sungardhe_v2.cer
• fm2_sungardhe_v2.cer
3. Execute the following command:
Tip
The command strings in this step must be applied in a single line format.
If you choose use these strings, 1) Highlight and copy the desired code
string and paste the text into a text editor. 2) From the text editor, remove
any line breaks (ultimately forcing the text onto a single line), replacing
the line breaks with a single space character.
The commands described here are intended for a Windows based
environment. For UNIX and equivalent environments, replace the
backslash character “\” with the forward slash character “/”.

Note
The dash character (-), shown in the command strings below, is used as a
switch within the command and should never be followed directly by a

space character.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-23
• If the JVM is a JRE:
keytool -import -alias fm1_sungardhe -file fm1_sungardhe_v2.cer -keystore
..\lib\security\cacerts -storepass changeit -noprompt
keytool -import -alias fm2_sungardhe -file fm2_sungardhe_v2.cer -keystore
..\lib\security\cacerts -storepass changeit -noprompt
• If the JVM is a JDK:
keytool -import -alias fm1_sungardhe -file fm1_sungardhe_v2.cer -keystore
..\jre\lib\security\cacerts -storepass changeit -noprompt
keytool -import -alias fm2_sungardhe -file fm2_sungardhe_v2.cer -keystore
..\jre\lib\security\cacerts -storepass changeit -noprompt
Note
To load other certificates unique to the institution, use the following
format:
keytool -import -alias <mycert> -file <mycertfile.cer>
-keystore ..\lib\security\cacerts -storepass changeit

-noprompt
4. Disable Loading of Infinity.keystore. The Infinity.keystore is
automatically loaded by the year specific process, rnpfm12.jar. This must be
disabled so the new certificate loaded to the JVM can be used.
4.1.
Open the appropriate script for the environment in a text editor.
• For UNIX based system use script rnpfm12.shl.
• For VMS based system use script rnpfm12.com.
• For Windows based system use script rnpfm12.pl.
4.2.
Rename the property:
• From:
-Dcert=
• To:
-Dcert_HOLD=
Note
Scripts rnpfm13.shl, rnpfm13.com, and rnpfm13.pl are delivered

with the -Dcert removed. No modifications are needed.
2-24
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
January 2012
Redeploy Servlet
Once a servlet and its supporting share lib, connection pool, and data source have been
deployed, subsequent deployment of the servlet, rnpfmxx.war, only requires a
redeployment. The share lib, connection pool, and data source do not need to be
redeployed.
1. From the rnpfmxx OC4J instance, under the Applications tab, select the rnpfmxx
application and then the Redeploy button.
2. On redeployment, ONLY choose the Archive rnpfmxx.war. Do not redeploy the
Deployment Plan.
3. Click Next and then Next a second time.
4. Click the Configure Class Loading task.
5. Ensure that the banner_finaid Shared Library remains checked and click the OK
button.
6. Click the Redeploy button.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-25
Proxy Settings
Warning
Do not implement these proxy settings unless it is certain that the
institution has a proxy server in place and is required for a connection to
the internet. Unnecessarily implementing these steps will create

connection problems where none existed.
The servlet rnpfmxx.war and the process rnpfm12.jar and its aid year equivalent
require internet access to connect to Infinity. If the institution requires the connection be
made through a proxy server, the following steps must be implemented.
Proxy settings for process rnpfm12.jar
Process rnpfm12 comes with two properties, http.proxyHost and http.proxyPort,
that can be added to allow the process to navigate through a proxy to connect to the
internet.
1. To modify these properties, open the appropriate script for the environment in a text
editor.
• For UNIX based system use script rnpfm12.shl.
• For VMS based system use script rnpfm12.com.
• For Windows based system use script rnpfm12.pl.
2. Make the changes by adding the properties and replacing the default values with the
appropriate values for your institution. Below the existing property -Dcert, the
following properties must be added:
• -Dhttp.proxyHost=my_proxy_host
• -Dhttp.proxyPort=my_proxy_port
Note
Replace the my_proxy_host and my_proxy_port with the appropriate

values for your institution’s proxy server.
3. For example, if the host is www-proxy.sct.com and the port is 8080:
For UNIX
. -Dhttp.proxyHost=www-proxy.sct.com \
. -Dhttp.proxyPort=8080 \
2-26
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
January 2012
For VMS
"-Dhttp.proxyHost=www-proxy.sct.com " "-Dhttp.proxyPort=8080 " -
For Windows
"-Dhttp.proxyHost=www-proxy.sct.com "
"-Dhttp.proxyPort=8080 "
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-27
Proxy settings for servlet rnpfmxx.war
OC4J Proxy Settings
To change the servlet rnpfmxx.war to use a proxy server to access the internet, changes
must be made to the Start-parameters for the rnpfmxx OC4J instance.
1. Navigate to the Server Properties page for the rnpfmxx OC4J instance.
2-28
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
January 2012
2. Add the following two properties under the Start-parameters: Java Options, then click
Apply.
Note
Replace the www-proxy.sct.com and 8080 with the appropriate
values for your institution’s proxy server.

3. Restart the rnpfmxx OC4J instance.
WebLogic Proxy Settings
To adjust the rnpfmxx_prod.war servlet to use a proxy server to access the internet,
changes must be made to the Start-parameters for the rnpfmxx_prod server.
1. In the Change Center window, click the Lock & Edit button.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-29
2. In the Domain Structure window, click Environment > Servers, and then select the
rnpfmxx_prod server (or another listed server, as desired).
3. From the Configuration tab and the Server Start sub-tab, add the following two
properties to the Arguments and click the Save button:
• Dhttp.proxyHost=www-proxy.sct.com
• Dhttp.proxyPort=8080
Note
Replace the www-proxy.sct.com and 8080 with the appropriate values

for your institution’s proxy server.
4. In the Change Center window, click the Activate Changes button.
2-30
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
January 2012
Configure Servlet for SSL (optional)
By default, the communication protocol between INB and the servlet is http. There is no
sensitive data being passed between the two. So, for most institutions, this meets the
requirements for a secure intranet. However, some institutions may require a more secure
communication protocol for their entire intranet. This procedure outlines the basic
configuration of the servlet to allow SSL communication from INB.
Note
This procedure only configures the servlet for SSL. Additional
configuration is required on the http server. Please refer to Appendix B Enabling Secure Sockets Layer (SSL) Communication for additional

information.
1. Click the rnpfmxx Application Server to go to the OC4J rnpfmxx Instance.
2. From the Administration tab, click on the Server Properties icon.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-31
3. Change the Port and Protocol attributes and click Apply:
• Port = 12501-12600
• Protocol = ajp
4. Restart the OC4J rnpfmxx Instance.
Redirecting INB to the Plus one (+1) URL
When there are changes made to the FM Need Analysis calculation (at Infinity),
institutions will have the opportunity to direct their INB test environment’s FM Calculator
to this pre-production code. The pre-production URL is also called the Plus one, or simply
+1. Whenever this URL is available, a separate communication will be sent to alert the
Banner Financial Aid community of its status. The following configuration procedures
describes the steps necessary to switch an INB test environment to use the +1 URL.
After completing these steps, the institution will only be able to do FM Need Analysis
calculations using the job submission option for online/immediate processing.
Note
The servlet option should not be used with the +1 URL.

Batch processing of FM Need Analysis will continue to work as before, except it will
reference the +1 calculator.
Note
The +1 URL is intended to be used for client testing only. It is not meant to
be used for production. In addition, the purpose of the testing is to
evaluate the latest changes to the functionality of the Need Analysis
calculation that resides on Infinity. The +1 URL is not intended to test the

institutions installation of Need Analysis on Banner.
Switch the FM Need Analysis Calculator to use the
pre-production Infinity (+1) URL:
1. Login into INB and navigate to the RORPARM form.
2. Make sure the value for USE_JOBSUB is set to Y.
2-32
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
January 2012
3. For parameter WS_ENDPOINT:
• Uncheck the Active indicator for URL:
https://fm1.sungardhe.com/EFCService/
EFCCalculationService.asmx
• Check the Active indicator for URL:
https://fm1.sungardhe.com/EFCService_1/
EFCCalculationService.asmx
4. Take the steps necessary to save your RORPARM changes.
Switch the FM Need Analysis Calculator back to the
production Infinity URL
1. Login into INB and navigate to the RORPARM form.
2. If necessary, revert the value of USE_JOBSUB to its value prior to testing.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-33
3. For parameter WS_ENDPOINT:
• Check the Active indicator for URL:
https://fm1.sungardhe.com/EFCService/
EFCCalculationService.asmx
• Uncheck the Active indicator for URL:
https://fm1.sungardhe.com/EFCService_1/
EFCCalculationService.asmx
4. Take the steps necessary to save your RORPARM changes.
2-34
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
January 2012
Alternative Install to Full iAS 10.1.3.x
OC4J install of iAS 10.1.3.x only
The full installation of iAS 10.1.3.x suite is not necessary to support FM Need Analysis. A
customized installation will allow an institution to install only those components of the
suite that are necessary. Only the following two components are required:
• J2EE Server – the OC4J installation
• Web Server – the web enabled administrator.
This section provides the necessary steps to quickly install a minimal working OC4J that
can support deployment of the FM Need Analysis sevlet, rnpfmxx.war.
Note
This installation is based on a Windows 2008 Server with Service
Pack 2.

1. Run the setup.exe of the iAS 10.1.3.x.
2. Select the Advanced Install radio button and click Next.
3. Click Yes on the next two Warnings.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-35
4. Select the J2EE Server and Web Server radio button and click Next.
5. On the Port Configuration Options, leave the selection on Automatic and click Next.
6. Complete entry on all required fields. Make sure to check the Configure this as an
Administration OC4J instance checkbox and click Next.
7. Click Next, followed by the Install option.
8. Once the installation is complete, click Exit.
9. Done.
2-36
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
January 2012
WebLogic Configuration
Installation of servlet on WebLogic (optional)
Introduction
Use the following configuration procedures to install the rnpfmxx.war servlet and
supporting objects on an existing WebLogic server.
Note
This document is written based on WebLogic version 10.3.3.0. The
screen samples and implementation steps are therefore based solely on

this version.
Changes from the prior version of WebLogic install:
A draft version of this WebLogic Configuration procedure was provided in February of
2011. This section outlines the differences that have been made since publication of that
draft document:
• Shared libraries – For the WebLogic installation of the servlet,
finaiddbseed.jar and finaidfmlogin.jar will no longer be used as shared
libraries. Instead, these jar files will be embedded within the rnpfmxx.war
servlet. This decision was made because the behaviors of the jar files as shared
libraries are not consistent for all supported application servers.
• AdminServer – During installation of the rnpfmxx.war servlet, the AdminServer
should not be used as the target. Instead, a separate server, under the
sghe_domain domain, must be created. This new server will then be used as the
target. As the AdminServer is not always running for WebLogic servers, it is not a
desirable installation target for the application.
Requirements
1. There must already be a completed WebLogic installation with a production domain.
For this document, the production domain is:
• sghe_domain.
Note
A name other than sghe_domain can be used for your institution. While
following these installation instructions, substitute the name of the
existing WebLogic domain you intend to use to host this application for
each occurrence of sghe_domain. The ClassicDomain, created during

the installation of INB, can be use if it exists.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-37
2. The environment used to host the WebLogic server where rnpfmxx.war will be
deployed must allow outgoing communication to port 443 for all of the following
Infinity URLs:
• https://fm1.sungardhe.com
• https://fm2.sungardhe.com
Object List
The following objects needed for the installation of the servlet on a WebLogic server.
• finaidutils.jar
• finaidfmlogin.jar
• finaiddbseed.jar
• rnpfmxx.war
• rnpfmxx_upd_weblogic.shl (Unix)
• rnpfmxx_upd_weblogic.com (VMS)
• rnpfmxx_upd_weblogic.bat (Windows)
Note
In INB, access to the RORPARM form will also be needed to update
references to the servlet.

Multiple simultaneous rnpfmxx servlet installations
Most institutions will wish to install the servlet and target in more than a single Banner
database instance. For example, you may wish to install the servlet on your WebLogic
server for your pre-production Banner instance and then, later, install the servlet on the
same WebLogic server but connected to your production Banner database instance.
To accommodate this, determine a short string that uniquely identifies the target database
for which you are installing the servlet. The target database SID or Service Name is
recommended.
For example, to target the install at the production database instance, with an Oracle SID
of, “PROD”, it would be logical to use the string, “prod” as the unique identifier in the
following steps. This value will be referred to in the following documentation as <unique
db id>. Anytime you see this text in input values, replace it with your unique database id
value, where indicated, like this:
Target Server
Documentation value: rnpfmxx_<unique db id>
Your value:
2-38
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
rnpfmxx_prod
January 2012
Servlet/application name
Documentation value: rnpfmxx_<unique db id>
Your value:
rnpfmxx_prod
Data source name
Documentation value: BannerFinaid_<unique db
id>
Your value:
BannerFinaid_prod
When necessary, the following procedures will identify when you need to append this
string to file names or configuration values.
Pre-configuration
Define the necessary environments and files in preparation for deployment of the rnpfmxx
servlet:
1. The finaidutils.jar must be deployed onto the INB forms server for the target
database. Refer to the Internet Native Banner, Installing finaidutils.jar procedure.
2. The finaidfmlogin.jar must be updated with the institution’s login credentials
for Infinity. Refer to the Updating finaidfmlogin.jar procedure.
3. The finaiddbseed.jar must be updated with the institution’s seed numbers. Refer
to the Updating finaiddbseed.jar procedure.
4. Run the rnpfmxx_upd_weblogic script to create an rnpfmxx servlet install package
file which includes the two modified jar files: finaidfmlogin.jar and
finaiddbseed.jar.
• For UNIX based systems use script:
$BANNER_HOME/finaid/java/rnpfmxx_upd_weblogic.shl
• For VMS based systems use script
BAN_HOME:[finaid.java]rnpfmxx_upd_weblogic.com
• For Windows based systems use script
${BANNER_HOME}\finaid\java\rnpfmxx_upd_weblogic.bat
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-39
Note
The script should be run from the location where it was extracted,
<BANNER_HOME>/finaid/java. This script requires one parameter, a
new file name (minus the extension).
Use rnpfmxx_<unique db id> as the first parameter to the script.
For example, running the command:
rnpfmxx_upd_weblogic rnpfmxx_prod
will create a new file named rnpfmxx_prod.war, which is the rnpfmxx
servlet install package, custom configured for your institution and target

database.
5. This newly created rnpfmxx_<unique db id>.war file must be copied to a
temporary area accessible to your web browser.
Create a target machine
If no target machines exist, one must be created to host the logical WebLogic server(s)
which, in turn, will host the servlet(s). A single machine can host multiple servers, so this
step only needs to be performed one time.
1. Confirm that the Node Manager is running.
2. Start the Admin Server for WebLogic for the sghe_domain domain.
3. Using your web browser, login into the Oracle WebLogic Server Administration
Console for the sghe_domain domain.
4. In the Change Center window, click the Lock & Edit button.
2-40
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
January 2012
5. In the Domain Structure window, choose Environment > Machines, and then click
the New button.
Note
The machine name must be unique for each domain. The physical
machine host name is valid and can be used for the WebLogic logical
machine name. For this document, the machine name, m037056 is
used.

6. In the Change Center window, click the Activate Changes button.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-41
Create a server
This step must be performed once for each deployment of the rnpfmxx servlet.
1. In the Change Center window, click the Lock & Edit button.
2. In the Domain Structure window, choose Environment > Servers, and then click the
New button.
3. Enter the following in the two required fields and click the Finish button:
• Server Name = rnpfmxx_<unique db id>
• Server Listen Port = 10001 or any available port number
Warning
Do not use the same port number as the AdminServer. The default port
number for the AdminServer is 7001. If this is used you may cause the
AdminServer to become unstable and unreachable. This may cause the
administration console to be inaccessible from a web browser.
Do not use the same port number as the Node Manager. The default port
number for the Node Manager is 5556. If this is used you may cause the
Node Manager to become unstable and unreachable. This in turn may

take down WebLogic.
2-42
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
January 2012
4. Click on the newly created rnpfmxx_<unique_db_id> server, select the machine
name, and then click on Save button.
5. In the Change Center window, click the Activate Changes button.
Configure target server
1. In the Change Center window, click the Lock & Edit button.
2. In the Domain Structure window choose Environment > Servers, and then select the
server you will use to deploy the servlet. The following steps assume your server is
named rnpfmxx_<unique_db_id>.
3. Under the Configuration tab and the Keystores sub-tab, change the default
Keystores value.
4. Select the Custom Identity and Java Standard Trust option and click the Save button.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-43
5. In the Change Center window, click the Activate Changes button.
6. From the Domain Structure window, choose Environment > Servers, and then click
on the Control tab. Select the rnpfmxx_<unique_db_id> server from the
displayed table and click the Start button.
7. On the confirmation page, click the Yes button.
8. Click the auto refresh icon and wait until the status of the server changes to
“RUNNING”.
Note
Please be patient as this process may take a few minutes for the server to

start.
2-44
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
January 2012
Installing the servlet
1. In the Change Center window, click the Lock & Edit button.
2. From the Domain Structure window, click Deployments, and then click on the
Install button.
3. Click the upload your files(s) link.
4. Click the Browse button on the Deployment Archive line, navigate to the
rnpfmxx_<unique db id>.war file (created for your target database) and click
Open. Once opened, click the Next button.
Note
Based on your web browser, your screen may differ from the one shown
above. This example was created using Internet Explorer 7 (running on
Windows XP). The process should be similar. For example, the Google
Chrome browser would display a Choose File button, instead of the

Browse button.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-45
5. Once the rnpfmxx_<unique db id>.war file has been successfully uploaded, a
confirmation message (similar to the one shown below) will be displayed. Click the
Next button.
6. When asked to choose a targeting style, select the Install this deployment as an
application option and click the Next button.
7. Select rnpfmxx_<unique db id> as the target server and click the Next button.
8. On the Optional Settings page, click the Finish button.
9. In the Change Center window, click the Activate Changes button
2-46
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
January 2012
Creating the Data Source
This section will create a data source and the associated connection that will allow the
servlet to connect to the Oracle database used by Banner.
1. In the Change Center window, click the Lock & Edit button.
2. In the Domain Structure window, select Services > JDBC > Data Sources, and click
the New button.
Note
Depending on the version of WebLogic, your screen may differ. The Data
Sources may be located under Services > Data Sources instead.
Clicking on the New button may cause additional pop-up selections. If so,

select the Generic Data Source. Refer to the screen shot below.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-47
3. Enter the following attributes and click the Next button.
• Name = BannerFinaid_<unique db id>
• JNDI Name = jdbc:java_banner_finaid
4. Select the *Oracle’s Driver (Thin) for Instance connections and click the Next
button.
Note
Depending on the version of WebLogic, your screen may differ.
Regardless, make sure to select the (Thin), not (Thin XA) drivers.

5. There is no need to change any options listed on the Transaction Options screen.
Click the Next button to continue without changes.
2-48
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
January 2012
6. On the Connection Properties screen, enter the following attributes and click the
Next button:
• Database Name = The target Oracle database SID or service name for INB
• Host Name = The machine name that is hosting the Oracle database for INB
(IP address or hostname)
• Port = The listening port of the target Oracle database for INB
• Database User Name = banproxy
• Password = The password for user banproxy
• Confirm Password = The password for user banproxy
Note
The Database User Name must be banproxy.

7. Click the Test Configuration button.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-49
8. With a successful configuration test, the Connection test succeeded message will be
displayed. Click the Finish button.
9. Select the newly created BannerFinaid_<unique db id> Data Source form those
listed in the displayed table.
10. Under the Configuration tab and the Connection Pool sub-tab, change the Statement
Cache Size to 0 and click the Save button.
2-50
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
January 2012
11. Click the Targets tab to select the rnpfmxx_<unique db id> server as the target
and click the Save button.
12. In the Change Center window, click the Activate Changes button.
Starting the servlet
1. In the Domain Structure window, click Deployments, and confirm the status of the
rnpfmxx_<unique db id> servlet.
2. If the servlet is not Active, select the rnpfmxx_<unique db id> servlet and click the
Start button followed by selecting the Servicing all requests option.
3. Click the Yes button on the confirmation page.
4. The servlet is now active and ready to service requests.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-51
Test the servlet install
1. In the Domain Structure window, click Deployments followed by selecting the
rnpfmxx_<unique db id> servlet.
2. Under the Testing tab, click the link for the second URL under
rnpfmxx_<unique db id>.
3. Because the default user user_name is most likely invalid, the following result will
be displayed:
rnpfmxx version: 8.10.0.2
ERROR.
java.sql.SQLException
- ORA-01017: invalid username/password; logon denied
4. In your web browser, modify the URL to specify a valid user name and also include
the debug and webservice parameters, as in the following example:
http://149.24.37.56:10001/rnpfmxx_prod/FmCalxx?user=faisusr&debug=Y&
webservice=Y
A successful test of the servlet will return the following result:
rnpfmxx version: 8.10.0.2
Database connection Ok.
Web Service connection Ok.
2-52
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
January 2012
Update form RORPARM in INB
1. In INB, navigate to the RORPARM form.
2. Change the value for parameter USE_JOBSUB to N.
3. Change the value for parameter SERVLET_URL with the URL of the servlet and save.
Note
Refer to the previous section, Test the servlet install, determine the
URL.

The servlet URL uses the following format:
• http://<SERVER>:<PORT>/ rnpfmxx_<unique_db_id>/FmCalxx
• <SERVER> the name of the Server where rnpfmxx.war is deployed
• <PORT> the port number
Note
The IP number can be replaced with the host name. A valid value for the
SERVLET_URL could be

http://m037056:10001/rnpfmxx_prod/FmCalxx.
Reinstalling over an existing servlet
1. Start this process by completing steps 2 through 5 found in the Pre-configuration
section.This will create a new rnpfmxx_<unique_db_id>.war file from the
base-lined version of rnpfmxx.war.
2. Under the Deployments Domain Structure, select the rnpfmxx_<unique_db_id>
servlet and click the Stop button, followed by the Force Stop Now option.
3. From the Confirmation page, click the Yes button.
4. In the Change Center window, click the Lock & Edit button.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-53
5. Under Deployments, select the rnpfmxx servlet and click the Update button.
6. Click the Change Path button.
7. Click the upload your files(s) link.
8. Click the Browse button on the Deployment Archive line. Navigate to the
rnpfmxx_<unique_db_id>.jar file you created for your intended target database
and click the Open button. Once opened, click the Next button.
Note
Based on your web browser, your screen may differ from the one shown.
This example was created using Internet Explorer 7, running on Windows
XP. But, the process should be similar. For example, the Google Chrome
browser would display a Choose File button, instead of the Browse

button.
2-54
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
January 2012
9. Once the rnpfmxx_<unique_db_id>.war file has been successfully uploaded, a
confirmation message, similar to the one shown below, will be displayed. Click the
Next button.
10. Click the Finish button.
11. In the Change Center window, click the Activate Changes button.
12. Follow the steps in the Starting the servlet section, to make the servlet active.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-55
Troubleshooting
Missing finaidutils.jar
Related Error Message
java.lang.Exception: java.lang.NoClassDefFoundError:
com/sct/banner/forms/ui/HttpPost
Description
Symptom:
OAS 10.1.2.x Oracle forms server is missing the finaidutils.jar file
Solution:
Review: Internet Native Banner (INB), Installing finaidutils.jar
Unable to connect to servlet rnpfmxx.war
Related Error Message
Servlet url is invalid.
Description
Symptom:
The parameter SERVLET_URL defined on the Project Based Parameter Setup
Form (RORPARM) has not been updated with the correct URL.
Solution:
Review: Run immediate Need Analysis using the servlet (step 5).
Connection timed out
Related Error Message
IOException Connection timed out.
2-56
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
January 2012
Description
Symptom:
A parameter for SERVLET_URL was provided on the Project Based Parameter
Setup Form (RORPARM). The URL provided is valid, but the service related to
the URL is not responding.
Diagnostic
Double check the URL and make sure the value specifies the rnpfmxx.war
servlet.
Note: The www.sungardhe.com web address is a valid URL. However, its
value is not the correct URL for the servlet.
Solution:
Review: Run immediate Need Analysis using the servlet (step 5).
Proxy not authorized
Related Error Message
java.sql.SQLException
ORA-28150: proxy not authorized to connect as client
Description
Symptom:
The user login into INB is not setup to allow proxy login.
Solution:
Review: Required installation (step 1).
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-57
Unauthorized
Related Error Message
org.apache.axis2.AxisFault: Transport error: 401 Error: Unauthorized
Description
Symptom:
The nas.properties file embedded within the finaidfmlogin.jar must
be updated with the correct user name and password to allow a successful login
to Infinity.
Solution:
Review: Required installation (step 3).
Certification path
Related Error Message
org.apache.axis2.AxisFault: sun.security.validator.ValidatorException: PKIX path
building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to
find valid certification path to requested target.
OR
org.apache.axis2.AxisFault: com.ibm.jsse2.util.h: PKIX path building failed:
java.security.cert.CertPathBuilderException: PKIXCertPathBuilderImpl could not build
a valid CertPath.
Description
Symptom:
The JVM does not have the correct certificate loaded to connect to Infinity using
HTTPS (SSL enabled).
Solution:
Review: Loading certificate to JVM. Two certificates need to be loaded,
fm1_sungardhe_v2.cer and fm2_sungardhe_v2.cer. Both can be found
in the /finaid/java/ directory.
Note
If this is an on-premise solution and SSL is enabled on IIS, the institution
client side certificate must be used rather than the one provided by

Ellucian.
2-58
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
January 2012
FAQs
FM Need Analysis FAQs
Q1: What if the job submission server must use a proxy server to connect to the internet?
A: Refer to the Proxy Settings procedure (Proxy settings for process rnpfm12.jar).
Q2: What if the OC4J 10.1.3.x must use proxy server to connect to the internet?
A: Refer to the Proxy Settings procedure (Proxy settings for servlet rnpfmxx.war).
Q3: Can I install iAS 10.1.3.x on the same computer as the existing OAS 10.1.2.x?
A: Yes.
Q4: Can I install multiple versions of the servlet on the same OC4J instance and have
each connect to a different Oracle database?
A: Yes.
1. Follow the steps for Creating the rnpfmxx OC4J Instance, if one does not already
exist.
2. Follow the steps for Installing the Share Library, Banner_finaid, if one does not
already exist. The same share library can be used by multiple servlets as long as they
use the same seed number. Otherwise, create a different Share library for each
database. For example, BannerFinaid_prod and BannerFinaid_test.
3. Follow the steps for Installing the Servlet. In step 4, change the Application Name
and the Context Root to make it unique. For example, rnpfmxx_test. In step 6,
choose the Share Library that has the correct seed number to support the database.
Finish the rest of the installation.
4. Follow the steps for Creating the Connection Pool and Data Source for RNPFMXX.
In step 2 and step 4, make sure to select the Application to rnpfmxx_test. Finish
the rest of the installation.
5. The servlet URL then would be:
http://<SERVER>:<PORT>/rnpfmxx_test/FmCalxx
Q5: Where do I deploy the finaidutils.jar?
A: The finaidutils.jar must be copied from the <BANNER_HOME>/finaid/java/ over to
the Forms OAS 10.1.2.x server <ORACLE_HOME>/forms/java/ directory.
First, edit the <ORACLE_HOME>/forms/server/prod.env or the .env file that is
used by INB. Second, add finaidutils.jar into the CLASSPATH environmental
variable.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-59
For example:
CLASSPATH=D:/ORACLE/OAS_10/j2ee/OC4J_BI_Forms/applications/
formsapp/formsweb/WEB-INF/lib/frmsrv.jar;D:/ORACLE/OAS_10/jlib/
repository.jar; D:/ORACLE/OAS_10/jlib/ldapjclnt10.jar;D:/
ORACLE/OAS_10/jlib/debugger.jar;D:/ORACLE/OAS_10/jlib/
ewt3.jar;D:/ORACLE/OAS_10/jlib/share.jar;D:/ORACLE/OAS_10/jlib/
utj.jar;D:/ORACLE/OAS_10/jlib/zrclient.jar;D:/ORACLE/OAS_10/
reports/jlib/rwrun.jar;D:/ORACLE/OAS_10/forms/java/
frmwebutil.jar;D:/ORACLE/OAS_10/forms/java/finaidutils.jar
Q6: Where do I get the seed number to update the seed.properties file within the
finaiddbseed.jar?
A: If you have enough permission you can use the following SQL statement to retrieve
the seed numbers:
SELECT GUBIPRF_SEED1,GUBIPRF_SEED3 FROM bansecr.gubiprf;
GUBIPRF_SEED1 GUBIPRF_SEED3
------------- ------------12345678
87651234
Q7: How do I test my deployment of the servlet rnpfmxx.war outside of Banner?
A: From a web browser, connect to the servlet URL:
1. For example
• If the servlet URL is http://mtestcomp.corp.sct.com:8860/rnpfmxx/
FmCalxx
• If a valid FINAID user is: faisusr
• In a web browser, go to the following address:
http://mtestcomp.corp.sct.com:8860/rnpfmxx/FmCalxx?user=faisusr&debug=Y&
webservice=Y
2. If everything is successful, you would get this or the equivalent. If there are failures,
the appropriate error messages would show accordingly.
rnpfmxx version: 8.10
Database connection Ok.
Web Service connection Ok.
Q8: How do I test my login credential to Infinity for validity?
A: You can test the credential from a web browser.
1. From a web browser, go to the following URL:
https://fm1.sungardhe.com/EFCService/
EFCCalculationService.asmx
2-60
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
January 2012
2. In the login popup screen, type in the institution login user name and password.
3. If login is successful an EFCCalculationService web page is displayed.
Q9: Do I have to install the servlet rnpfmxx.war?
A: No.
You can run the immediate Need Analysis using the job submission process rnpfm12
or its aid year equivalent instead. Go to INB and access form RORPARM. Change the
parameter value USE_JOBSUB to Y.
Note
The servlet implementation is a performance enhancement. This
represents an improvement from 2 to 6 seconds per calculation using the

servlet vs. 6 to 30 seconds using the job submission process.
Q11: Where is the log file when running the servlet rnpfmxx.war?
A: The servlet rnpfmxx.war does not generate the traditional .log and .lis files like
process rnpfm12.jar and its aid year equivalent. Instead, if there are any errors, they
will appear as a popup in INB. There is also a continuous log on the OC4J hosting the
servlet. Additional information can found here to help debug the deployment of the
servlet. The log files can be found here <ORACLE_HOME>/opmn/logs/. An example of
the file name is: sghe_group~rnpfmxx~sghe_group~1.log.
Q12: There was an additional record introduced for the 7.19/8.10 Winter release in
RORPARM called WS_ENDDPOINT. How is this additional record used?
A: No action is required. This record is for future use only.
Q13: We have a load balancer for the OC4J (10.1.3.x) with the servlet rnpfmxx.war
deployed on it, what URL should we use to check the status of the OC4J or the servlet?
A: You can use the OC4J root URL. This will return a web page. For example, if the
servlet’s URL is:
http://myhost.com:8860/rnpfmxx/FmCalxx
The root would be:
http://myhost.com:8860/
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-61
We do not recommend using the servlet’s actual URL for the test. This will generate a
large number of extraneous errors in the rnpfmxx OC4J instance logs which will make it
difficult to locate “legitimate” errors.
Q14: Do I need to open port 443 on the Oracle database server to allow connection to
Infinity?
A: No. For security reason, Ellucian has intentionally not coded the Need Analysis to
make a web service call directly from the Oracle database server and the INB server.
However, the job submission server will need port 443 open to allow the batch process to
connect to Infinity. In addition, if the servlet option is chosen for immediate processing of
Need Analysis, port 443 will also need to be open for the environment hosting the OC4J
10.1.3.x.
Q15: If the Off-Premise option has been chosen, do we still need to change anything in
RORPARM?
A: No. The default configuration is for Off-Premise.
Q16: If we do not setup the servlet, do we need to change anything in RORPARM?
A: Yes. In RORPARM change the value for parameter USE_JOBSUB from N to Y.
Q17: We are an Off-Premise client and have just upgraded from 8.8.1 to 8.10. The servlet
was working fine for us prior to the upgrade. With the recent upgrade to release 8.10, we
now get the following error when doing a calculation from ROAIMMP:
ERROR. org.apache.axis2.AxisFault - Connection timed out:
connect
org.apache.axis2.AxisFault.makeFault(AxisFault.java:430)
And this message when testing from a web browser:
Web Service connection Failed. ERROR. Invalid login credential or certificate.
ERROR. org.apache.axis2.AxisFault - Connection timed out:
connect
org.apache.axis2.AxisFault.makeFault(AxisFault.java:430)
A: With the 8.10 release, a second URL was added for immediate Need Analysis
processing. Open the firewall and/or VPN to allow connections to both Infinity URLs,
using port 443:
https://fm1.sungardhe.com
https://fm2.sungardhe.com
2-62
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
January 2012
Q18: Where do I get the URL to populate the SERVLET_URL in RORPARM?
A: First, follow all steps outlined in item 4, below (4.1 through 4.4) found in the Run
immediate Need Analysis using the servlet option section of this Handbook.
Next, use the following steps to get the correct URL of the deployed servlet:
1. Login in to the Enterprise Manager/Application Server Control.
2. Expand the rnpfmxx OC4J instance so the rnpfmxx application is visible, then click
the rnpfmxx application.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-63
3. Click the rnpfmxx Web Module.
x
4. Click on the Test Web Module icon.
5. The displayed URL is the first part of the servlet URL. Append “/FmCalxx” to the
end of the existing URL.
For example:
http://m037056:8860/rnpfmxx/FmCalxx
Q19: For RORPARM settings, what is the difference between WS_ENDPOINT and
WS_ENDPOINT_ONLINE?
A: WS_ENDPOINT is used by processes rnpfm11/12.jar whereas,
WS_ENDPOINT_ONLINE is used by the servlet rnpfmxx.war.
2-64
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
January 2012
Q20: For RORPARM settings, why does Ellucian have three sites?
A: For best performance when doing a single calculation from immediate processing or
ONLINE processing, the servlet is the best option.
To help with performance, the servlet connects a set of calculators that are separated
from the batch processing. This way, the servlet is not competing for the same
resources as the batch processing of thousands of student records.
• Batch processing (production version of the calculator):
https://fm1.sungardhe.com/EFCService/
EFCCalculationService.asmx
• ONLINE processing (production version of the calculator):
https://fm2.sungardhe.com/EFCService_IMMP/
EFCCalculationService.asmx
• Batch processing (BETA/pre-production version of the calculator):
https://fm1.sungardhe.com/EFCService_1/
EFCCalculationService.asmx
Note
There is no pre-production version of the calculator dedicated for
ONLINE. If a client wishes to test ONLINE processing, they must switch

to job submission (RORPARM USE_JOBSUB = Y).
Q21: Our institution has a load balancer to support the OC4J hosting the servlet
rnpfmxx.war. We want to use a health check on the servlet to see if it is active.
What URL should we use?
A: You must have at least configured rnpfmxx.war with version 7.19.0.2 or 8.10.0.2 or
later. The URL must include the “?user=faisusr&webservice=N” string appended to
the address.
For example, if this is the URL for the servlet:
htttp://myhost.com:8860/rnpfmxx/FmCalxx
The health check URL would be:
htttp://myhost.com:8860/rnpfmxx/
FmCalxx?user=faisusr&webservice=N
Note
If the user faisusr is not configured as a valid FINAID user, replace it with

a valid user.
Q22: How do I setup SSL between INB and the servlet?
A: Review the optional procedure, Configure Servlet for SSL and
Appendix B - Enabling Secure Sockets Layer (SSL) Communication.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-65
WebLogic FAQs
Q1: Where are the log files for the domain?
A: If the domain is sghe_domain and the target server is rnpfmxx_prod, then the log
files can be found under:
<WEB_LOGIC_INSTALL>/user_projects/domains/sghe_domain/servers/
rnpfmxx_prod/logs
Q2: In the Configure target server section, I am unable to start the server. The state of the
server is FAILED_NOT_RESTARTABLE.
A: Check to make sure the Node Manger is running.
Check to make sure the port number for the target server is not already in use. Try
changing the port number to one that is not already in use.
Q3: When I tried to test the servlet from a web browser, it cannot find the servlet.
A: Make sure the state of the target server for the servlet is “RUNNING”. See Configure
target server section.
Q4: When I tried to test the servlet from a web browser, I am getting an:
“Error 503--Service Unavailable”.
A: Make sure the state of the servlet is Active. See Starting the servlet section.
Q5: When I tried to test the servlet from a web browser, I am getting an:
“Error 500--Internal Server Error”.
In the log file I’m getting this:
com.sungardhe.messaging.servlet.FmCalxx.doGet
com.sungardhe.messaging.servlet.BannerFinaidException: ERROR!
Properties file not found: /com/sungardhe/finaid/login/
nas.properties
A: Make sure you complete the steps in the Pre-configuration section. Make sure you use
the newly created war file for the Installing the servlet section.
Q6: I’m getting this error from the servlet:
ERROR.
java.sql.SQLException
- Closed Statement
A: Check your data source. The connection pool Statement Cache Size must be 0. This can
be found under the Configuration tab and Connection Pool sub-tab of the data source.
2-66
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
January 2012
Check the Driver Class Name. It should have the prefix of oracle.jdbc.thin. If it is
oracle.jdbc.xa, then you will need to delete the data source and recreate it with the
correct driver. See Creating the Data Source section.
Note
If you make changes to the data source. You will need to stop the target

server and restart it.
Q7: When I tried to test the servlet from a web browser, I am getting this:
ERROR.
javax.naming.NameNotFoundException
- Unable to resolve 'jdbc:java_banner_finaid'. Resolved ''
A: Check to make sure both the servlet and the corresponding data source use the same
target server. See Installing the Servlet and Creating the Data Source sections.
Double check the spelling of the JNDI Name for the data source. It must be:
jdbc:java_banner_finaid.
Q8: Can I install multiple servlets to support multiple INB on the same domain?
A: Yes. For example, to install two servlets one for production and one for testing, the first
installation is prod the second is test.
Follows all of the steps to install the first Need Analysis servlet for the domain:
• Pre-configuration – create the rnpfmxx_prod.war file.
• Creating a target machine
• Creating a server – create a new rnpfmxx_prod target server
• Configure target server
• Installing the servlet
• Creating the Data Source – create a new BannerFinaid_prod data source
• Starting the servlet
• Test the servlet install
• Update form RORPARM in INB
Repeat the installation for the second Need Analysis servlet:
• Pre-configuration – create the rnpfmxx_test.war file
• Creating a target machine – this section can be skipped. The same machine can be
reused by both servlets
• Creating a server – create a new rnpfmxx_test target server
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
2-67
• Configure target server
• Installing the servlet
• Creating the Data Source – create a new BannerFinaid_test data source
• Starting the servlet
• Test the servlet install
• Update form RORPARM in INB
2-68
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Off-Premise Configuration
January 2012
3
FM Need Analysis OnPremise Configuration
Introduction
This chapter supplies technical details associated with installation and configuration of the
hosted FM Need Analysis solution, supported by the system’s Infinity platform.
Configurations, both required and optional, are included to achieve successful 2011-2012
FM Need Analysis calculations associated with release 7.19/8.10, or above. As such, this
chapter is written with references specific to the RNPFM12 object. However, the steps
associated with RNPFM12 can also be applied to the new version of the object
(RNPFM13).
Note
Information found in this chapter supersedes all configuration
requirements noted in prior release documentation.

Tip
Please note that issues regarding the hosted Banner Financial Aid FM
Need Analysis solution should be submitted to the Banner Financial Aid
ActionLine under the Product Line: Financial Aid and the Product: FM
Need Analysis.
When submitting a Service Request from the Customer Support Center,
select the correct Product Line (Financial Aid) and Product

(FM Need Analysis) options from the available drop down lists.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-1
Requirements
OC4J of iAS 10.1.3.x
The servlet rnpfmxx.war must be installed on an OracleAS Containers for Java (OC4J)
version 10.1.3.x. This version of the OC4J is available with the Internet Application
Server (iAS) 10.1.3.x. Because iAS 10.1.3.x does not contain an Oracle forms server, the
OC4J of iAS 10.1.3.x must be installed in addition to the existing OAS 10.1.2.x. The
installation of iAS 10.1.3.x can be done on to the same environment as
OAS 10.1.2.x.
Note
This document is written based on iAS version 10.1.3.5. The screen
samples and implementation steps are therefore based solely on this
version. Slightly older or newer versions of iAS may not match exactly. 
On-Premise
If the institution applied for their status to host the Financial Aid Need Analysis as
On-Premise, there are additional requirements. The web service must be installed and
maintained by the institution on either:
• Windows 2003 server running Internet Information Services (IIS) 6 or 7
OR
• Windows 2008 server running IIS 7
3-2
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
Object List
The following objects are associated with FM Need Analysis:
• finaiddbseed.jar
• finaidfmlogin.jar
• finaidutils.jar
• fm1_sungardhe_v2.cer
• fm2_sungardhe_v2.cer
• rnpfmxx.war
• rnpfm13.jar
• rnpfm13.com
• rnpfm13.pl
• rnpfm13.shl
• rnpfm12.jar
• rnpfm12.com
• rnpfm12.pl
• rnpfm12.shl
• rnpfmxx_plan.dat
Note
In INB, access to the RORPARM form will also be needed to update
references to the servlet.
January 2012

Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-3
Configuration Options
Several options are available for running FM Need Analysis. The following diagrams
illustrate the various FM Need Analysis configuration options:
Batch Need Analysis
The most efficient way to process large numbers of students for FM Need Analysis is
by using job submission to run the RNPFM12 process. Therefore, this is a required
configuration:
Immediate Processing (Job Submission Process vs.
Servlet)
There are two configuration options available to perform immediate student
processing for FM Need Analysis.
Running immediate FM Need Analysis using the traditional job submission:
Running immediate FM Need Analysis using the servlet:
3-4
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
While better performance is noted using the immediate FM Need Analysis configuration
using the servlet, this configuration will require more configuration time and requires
OC4J version 10.1.3.x or Oracle WebLogic Server.
Configuration Times
Processing Time per Student
Job Submission
1 minute
6 - 30 seconds
Servlet
Approximately 1 - 2 hours
2 - 6 seconds
Off-Premise vs. On-Premise
Hosted solutions for Banner FM Need Analysis are separated into two major
components, Banner and software-as-a-service (SaaS). The Banner element is
required and must be implemented. However, two options exist for the SaaS
implementation:
• Off-Premise
• On-Premise
Off-Premise
The preferred SaaS option is Off-Premise. This configuration requires no additional
implementation and no maintenance. The Off-Premise service is hosted by Infinity.
Off-Premise service offers uptime measured near 100% (based on current 2011
statistics). The service is secured by (Secure Socket Layer) SSL technology and
requires a unique login for each institution. Software updates to the SaaS
implementation are automatic and instantaneous (no update/upgrade actions are
required by the institution).
Please refer to Chapter 2, FM Need Analysis Off-Premise Configuration for installation
and deployment information for this option.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-5
On-Premise
As an alternative, institutions may elect to use a locally hosted, On Premise, configuration
(non-Infinity based). This optional service requires that the institution download, install,
configure, and provide ongoing maintenance. With respect to On-Premise hosting
maintenance, the institution is expected to monitor communication for a standard “update”
message. In turn, the institution is expected to download, install, and configure any and all
available software updates. Use of the On-Premise FM Need Analysis option also requires
that either the Windows 2003 or 2008 server with IIS be installed.
Note
Two separate installation procedures are provided, one each for Windows
2003 and Windows 2008. Only one of the two Web Service options must

be implemented if the On-Premise option is chosen.
3-6
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
Configuration Checklists
This section includes a series of checklist items, based on desired function.
Batch Need Analysis (Required)
• The finaidfmlogin.jar may be updated with the institution’s login credentials
for Infinity. Refer to the Updating finaidfmlogin.jar procedure.
Run immediate Need Analysis using the job
submission option
1. In INB, navigate to the RORPARM form.
2. Change the value for parameter USE_JOBSUB to Y and save.
Run immediate Need Analysis using the servlet option
1. All FINAID users must be granted the banproxy permission to login as a proxy user.
Refer to the Internet Native Banner, Configure banproxy procedure.
2. The finaidutils.jar must be deployed onto the OAS 10.1.2.x Oracle forms
server. Refer to the Internet Native Banner (INB), Installing finaidutils.jar procedure.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-7
3. The finaiddbseed.jar must be updated with the institution’s seed numbers. Refer
to the Updating finaiddbseed.jar procedure.
4. Copy the following four files from <BANNER_HOME>/finaid/java to a temporary
location that can be accessed by a web browser:
• rnpfmxx.war
• rnpfmxx_plan.dat
• finaidfmlogin.jar
• finaiddbseed.jar
5. These four files must be deployed on to the OC4J of the iAS 10.1.3.x. Refer to the
iAS 10.1.3.x OC4J procedure.
5.1.
Create the rnpfmxx OC4J Instance
5.2.
Installing the Share Library
5.3.
Installing the Servlet
5.4.
Creating the Connection Pool and Data Source
6. In INB, navigate to the RORPARM form.
7. Change the value for parameter USE_JOBSUB to N.
8. Change the value for parameter SERVLET_URL to the URL of the servlet that was
installed in step 2 above and save.
The servlet URL uses the following format:
• http://<SERVER>:<PORT>/rnpfmxx/FmCalxx
• <SERVER> the name of the Server where rnpfmxx.war is deployed
• <PORT> the port number
3-8
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
On-Premise Installation
Because the institution has selected the on-premise status, a locally hosted version of the
Financial Aid Need Analysis must be installed.
1. Check for the latest version of FinAidNeedAnalysis.xxxxxx.x.zip and
download the file if needed.
2. Install the web service on to an IIS server. There are two installation guides provided:
• Windows 2003 running IIS 6
• Windows 2008 running IIS 7
3. Choose the appropriate guide for your institution. Refer to the On-Premise procedure.
Redeploying the servlet rnpfmxx.war
Once the servlet rnpfmxx.war has been deployed for the first time, subsequent
installations require a redeployment only. Refer to the Redeploy Servlet procedure.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-9
Procedures
This section describes individual procedures associated with FM Need Analysis
operations. Each procedure provides a stand-alone set of instructions associated with a
particular FM Need Analysis function.
This is a reference section only and is not intended to be followed sequentially. Other
sections in this chapter point back to this section to reinforce or instruct the user to
perform certain necessary steps.
The following procedural information is listed in this section:
• Updating finaidfmlogin.jar
• Updating finaiddbseed.jar
• Internet Native Banner (INB)
• iAS 10.1.3.x OC4J
• On-Premise
• Redeploy Servlet
• Proxy Settings
• Configure Servlet for SSL (optional)
Updating finaidfmlogin.jar
If Basic Authentication was used during the Windows IIS installation, the following
procedure must be done. Otherwise, no changes are needed.
Embedded within the object finaidfmlogin.jar, is a nas.properties file. This file can
be modified to allow connection to Windows IIS with the credential created when Basic
Authentication was turned on. The finaidfmlogin.jar file can be found:
• Under OpenVMS
$BANNER_HOME/finaid/java under UNIX, BAN_HOME:[finaid.java]
• Under Windows
${banner_home}\finaid\java
1. Use the following command to extract the nas.properties file from
finaidfmlogin.jar:
jar xf finaidfmlogin.jar com/sungardhe/finaid/login/
nas.properties
2. Open the com/sungardhe/finaid/login/nas.properties file in a text editor.
3-10
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
3. Change the user name and password values, the text to the right of the equal sign, for
these properties. Be careful not to leave any trailing spaces after the values.
httpusername=
httppassword=
Note
Use the credentials created during the Windows IIS installation.

4. Use the following command to update the finaidfmlogin.jar with the edited
nas.properties:
jar uf finaidfmlogin.jar com/sungardhe/finaid/login/
nas.properties
Updating finaiddbseed.jar
Embedded within the object finaiddbseed.jar is a seed.properties file. This file
must be modified to allow each institution to connect to the Oracle database. The
finaiddbseed.jar can be found:
• Under OpenVMS
$BANNER_HOME/finaid/java
• Under UNIX
BAN_HOME:[finaid.java]
• Under Windows
${banner_home}\finaid\java
1. Use the following command to extract the seed.properties file from
finaiddbseed.jar:
jar xf finaiddbseed.jar com/sungardhe/finaid/dbseed/
seed.properties
2. Open the com/sungardhe/finaid/login/seed.properties file in a text
editor.
3. Using the institution security seed number, change the values, text to the right of the
equal sign, for these properties. Be careful not to leave any trailing spaces after the
values.
seed1=
seed3=
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-11
4. Use the following command to update the finaiddbseed.jar with the edited
seed.properties:
jar uf finaiddbseed.jar com/sungardhe/finaid/dbseed/
seed.properties
Internet Native Banner (INB)
Configure banproxy
A proxy connection must be configured for each FINAID user who will be responsible for
running a FM Need Analysis. The INB banproxy user will be configured to act as the
proxy user. Appropriate permission is required for each user to allow banproxy to connect
to Oracle on that login user’s behalf.
1. As the bansecr userid, open the Oracle/Banner Security Maintenance (GSASECR)
form.
2. Select the User ID that will use the proxy connection and click the Alter button.
3-12
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
3. The User ID’s credentials are displayed on the Authorize or Create an ORACLE ID
window. Check the Authorize BANPROXY checkbox and click the Save button.
Installing finaidutils.jar
For INB to communicate with the servlet, the finaidutils.jar must be deployed on to
the OAS 10.1.2.x forms server or the WebLogic domain hosting INB.
1. The finaidutils.jar file (<BANNER_HOME>/finaid/java/
finaidutils.jar) must be copied to the OAS 10.1.2.x (<ORACLE_HOME>/
forms/java) directory.
• For Oracle 10g the destination environment is the OAS 10.1.2.x form server.
• For Oracle 11g the destination environment is the WebLogic domain that is hosting
INB.
2. The file name finaidutils.jar must be appended to the end of the CLASSPATH
in the file:
OAS_HOME/forms/server/default.env
Note
The environment file is the file used to run the INB instance. For example,

it may be prod.env.
3. Once the above changes are made, INB must be restarted.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-13
iAS 10.1.3.x OC4J
Creating the rnpfmxx OC4J Instance
1. Click the default Application Server that was created with the installation of the iAS
10.1.3.x.
2. Click the Create OC4J Instance button.
3. Enter the following attributes and click Create:
• OC4J instance name = rnpfmxx
• Click the Add to a new group with name radio button and enter the following
New Group Name = sghe_group
• Check the Start this OC4J instance after creation checkbox
3-14
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
4. Once created, click the new rnpfmxx.
5. Go to the Administration tab and click Server Properties.
6. Change the following attributes, then click Apply:
• Port = 8860 or a free port number
• Protocol = http
• Maximum heap size = 1024m
• Initial heap size = 512m
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-15
Installing the Share Library
Before installing the Share Library, make sure modifications have been made to the
finaidfmlogin.jar and finaiddbseed.jar. Refer to the following procedures:
Updating finaidfmlogin.jar and Updating finaiddbseed.jar.
1. Click the rnpfmxx Application Server to go to the OC4J rnpfmxx Instance.
2. From the Administration tab, click the Shared Libraries task icon.
3. On the following page, click on the Create button.
4. Make the following attribute changes for the new Shared Library and click Next.
• Shared Library Name = banner_finaid
• Shared Library Version = 1.0
3-16
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
5. Add the following jar files to the library (one at a time):
• finaiddbseed.jar
• finaidfmlogin.jar
6. After adding both files, click Finish.
Installing the Servlet
1. Click the rnpfmxx Application Server to go to the OC4J rnpfmxx Instance.
2. From the Applications tab, click the Deploy button.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-17
3. From the Deploy: Select Archive page, set the following archive attributes:
• Archive Location = rnpfmxx.war
• Deployment Plan = rnpfmxx_plan.dat
• Click Next
4. Click on Next.
5. On the Deploy: Deployment Settings page, click the Configure Class Loading task
icon.
3-18
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
6. Select the Import checkbox for the banner_finaid Shared Library, followed by
the OK button.
7. At the Deployment Settings page, click the Deploy button.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-19
Creating the Connection Pool and Data Source for RNPFMXX
1. From the OC4J: rnpfmxx Instance, under the Administration tab, click the JDBC
Resources Services task icon.
2. In the Application pull-down box, select rnpfmxx, and click the Create button to
create a Connection Pool.
The screen changes to show:
3-20
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
3. On the following page, make the following attribute changes and click the Finished
button:
• Name = jdbc:java/banner/finaid
• JDBC URL = jdbc:oracle:thin:@<HOST>:<PORT>:<SERVICE_NAME>
Note
Replace the <HOST>, <PORT> and <SERVICE_NAME> with the
appropriate values to make a connection to the desired institution Oracle

database.
• Username = banproxy
• Cleartext Password = the institution password defined for user banproxy
4. From the Data Sources page, select rnpfmxx from the Application pull-down box, to
create a Data Source.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-21
The screen changes to show:
5. On the following page, make the following attribute changes and click the Finished
button:
• Name = BannerFinaid
• JNDI Location = jdbc:java/banner/finaid
• Connection Pool = jdbc:java/banner/finaid
3-22
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
On-Premise
IIS 6.0 on Windows Server 2003
This installation is only required if the institution applied for an on-premise install status.
Minimum requirements
1. The on-premise install of the Financial Aid Need Analysis is called the EFCService
web service and it can only be installed on a Windows Server:
• Windows Server 2003 running IIS 6
• Microsoft.NET Framework 3.5
• IIS configured to run ASP.net 2.0
2. Installing IIS 6.0 on Windows Server 2003
2.1.
A detailed set of instructions are available from Microsoft at the following
URL:
http://www.microsoft.com/technet/prodtechnol/WindowsServer2003/
Library/IIS/750d3137-462c-491d-b6c7-5f370d7f26cd.mspx?mfr=true
2.2.
Click Start->Programs->Administrative Tools->Manage Your Server.
2.3.
Click Add or remove a role.
2.4.
Use the Wizard to add the Application server (IIS, ASP.NET).
3. Installing EFCService web service:
Note
If you already have a working EFCService from a prior install, you must

stop the service before proceeding.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-23
3.1.
Unzip latest version of the FinAidNeedAnalysis.xxxxxx.x.zip into the
following folder:
C:\inetpub\wwwroot\EFCService.
The structures should include:
..\EFCService\App_Data\Config.xml
\bin\EFC.dll
\EFCSoapExtension.dll
\ExceptionHandling.dll
\FederalEFC1011.dll
\FederalEFC.dll
\FinancialAidService.dll
\efc_calculation_messages.xsd
\EFCCalculationService.asmx
\Web.config
Note
If you already have a working EFCService from a prior install, you can

now restart the service and skip to step 4, Test the Web Service.
3-24
3.2.
Start the Manage Your Server.
3.3.
Click Manage this application server.
3.4.
From the Application Server, navigate to the Default Web Site.
3.5.
Set the ASP.NET version.
3.5.1.
Right click on the Default Web Site and select Properties.
3.5.2.
On the ASP.NET tab, set the ASP.NET version to 2.0.x. Click Ok.
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
3.6.
Create a Virtual Directory
3.6.1.
Right click on the Default Web Site and select New->Virtual
Directory.
3.6.2.
Use the Virtual Directory Creation Wizard:
Alias use EFCService.
Path use the path from step 3.3 above.
On the Virtual Directory Access Permissions check both
• Read
• Run scripts (such as ASP)
4. Test the Web Service:
4.1.
Enter and go to the following URL in a web browser:
http://localhost/EFCService/EFCCalculationService.asmx
4.2.
If the EFCCalculationService page is displayed, the Web Service test was
successful.
5. Configuring the EFCService to use Basic Authentication (optional):
January 2012
5.1.
Navigate back to the Default Web Site on the Application Server (refer to steps
3.4 – 3.5, earlier in this procedure).
5.2.
Right click on the Default Web Site and select Properties.
5.3.
On the Directory Security tab, edit the Authentication and access control.
5.4.
Uncheck Enable anonymous access.
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-25
5.5.
Check Basic authentication and enter the Default domain and Realm.
5.6.
Update the user name and password for Banner to make a connection. Refer to
the Updating finaidfmlogin.jar procedure.
6. Setup EFCService for SSL (optional).
6.1.
SSL requires obtaining and registering a certificate with the Web Server.
6.2.
The bit length must be 1024 or 2048.
6.3.
A detailed set of instructions are available from Microsoft at the following
URL:
http://www.microsoft.com/technet/prodtechnol/WindowsServer2003/
Library/IIS/89c7ef2f-f7d6-483c-8b08-ae0c6584dd4d.mspx?mfr=true
6.4.
The client side certificate must be loaded to both JVM. Refer to the Loading
Certificate to JVM procedure.
6.4.1.
JVM running JAVA processes on the job submission server.
6.4.2.
JVM running the OC4J 10.1.3.x which has the servlet rnpfmxx.war
deployed.
7. Update INB to recognize the on-premise FM Calculation Web Service.
3-26
7.1.
Login into INB and navigate to the RORPARM form.
7.2.
For both parameters, WS_ENDPOINT and WS_ENDPOINT_ONLINE, replace the
default value with URL from step 4 – Test the Web Service.
7.3.
Make sure to replace localhost with the correct address of the IIS.
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
IIS 7.0 on Windows Server 2008
This installation is only required if the institution applied for an on-premise install status.
Minimum requirements
1. The on-premise install of the Financial Aid Need Analysis is called the EFCService
web service and it can only be installed on a Windows Server:
• Windows 2008 running IIS 7
• Microsoft.NET Framework 3.5
• IIS configured to run ASP.net 2.0.
2. Installing IIS 7.0 on Windows Server 2008
2.1.
Detailed instructions are available from Microsoft at the following URL:
http://technet.microsoft.com/en-us/library/
cc771209(WS.10).aspx?ppud=4
2.2.
Click Start, point to Administrative Tools and then click Server Manager.
2.3.
In Roles Summary, click Add Roles.
2.4.
Use the Add Roles Wizard to add the Web Server role.
2.5.
During the Select Role Services, check to include the following items:
• ASP.NET
• Basic Authentication
3. Installing EFCService Web Service:
Note
If you already have a working EFCService from a prior install, you must

stop the service before proceeding.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-27
3.1.
Unzip latest version of the FinAidNeedAnalysis.xxxxxx.x.zip into the
following folder:
C:\inetpub\wwwroot\EFCService.
The structures should include:
..\EFCService\App_Data\Config.xml
\bin\EFC.dll
\EFCSoapExtension.dll
\ExceptionHandling.dll
\FederalEFC1011.dll
\FederalEFC.dll
\FinancialAidService.dll
\efc_calculation_messages.xsd
\EFCCalculationService.asmx
\Web.config
Note
If you already have a working EFCService from a prior install, you can

now restart the service and skip to step 4, Test the Web Service.
3.2.
From the Server Manager, expand Web Server (IIS) and select Internet
Information Service (IIS) Manager.
3.3.
From the Connection screen, right click the Default Web Site and select Add
Virtual Directory.
3.3.1.
3-28
Fill out the Add Virtual Directory popup. Make sure to use
EFCService for the Alias and click OK.
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
3.4.
From the Server Manager, expand Web Server (IIS) and select Internet
Information Service (IIS) Manager.
3.4.1.
From the Connections screen, select Default Web Site and do a
Refresh by pressing the F5 function key.
3.4.2.
The EFCService Folder is displayed:
3.4.3.
Right click the EFCService folder, select Convert to Application from
the popup menu and select OK.
4. Test the Web Service:
4.1.
Enter and go to the following URL in a web browser:
http://localhost/EFCService/EFCCalculationService.asmx
4.2.
If the EFCCalculationService page is displayed, the web service test was
successful.
5. Configuring the EFCService to use Basic Authentication (optional):
January 2012
5.1.
Navigate back to the Default Web Site on the Internet Information Service (IIS)
Manager.
5.2.
With the Features View on, select Authentication.
5.3.
Disable Anonymous Authentication.
5.4.
Enable Basic Authentication.
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-29
5.5.
Edit Basic authentication and enter the Default domain and Realm.
5.6.
The user name and password must be updated for Banner to connect. Refer to
the Updating finaidfmlogin.jar procedure.
6. Setup EFCService for SSL (optional).
6.1.
SSL requires obtaining and registering a certificate with the Web Server.
6.2.
The bit length must be 1024 or 2048.
6.3.
A detailed set of instructions are available from Microsoft at the following
URL:
http://www.microsoft.com/technet/prodtechnol/WindowsServer2003/
Library/IIS/89c7ef2f-f7d6-483c-8b08-ae0c6584dd4d.mspx?mfr=true
6.4.
The client side certificate must be loaded to both JVM. Refer to the Loading
Certificate to JVM procedure.
6.4.1.
JVM running JAVA processes on the job submission server.
6.4.2.
JVM running the OC4J 10.1.3.x which has the servlet rnpfmxx.war
deployed.
7. Update INB to recognize the on-premise FM Calculation Web Service.
3-30
7.1.
Login into INB and navigate to the RORPARM form.
7.2.
For both parameters, WS_ENDPOINT and WS_ENDPOINT_ONLINE, replace the
default value with URL from step 4 – Test the Web Service.
7.3.
Make sure to replace localhost with the correct address of the IIS.
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
Loading Certificate to JVM for RNPFM12 or RNPFM13
When connecting to a HTTPS URL (SSL is enabled on the server side) the connecting
JVM may need to load the client side certificate.
Use the following steps to load the client side certificate:
1. Navigate to the following directory of the job submission server:
<JAVA_HOME>/bin
2. Copy your client side SSL certificates to this same directory.
Note
Do not use the following Infinity Certificates:
fm1_sungardhe_v2.cer
fm2_sungardhe_v2.cer

3. Execute the following command:
Tip
The command strings in this step must be applied in a single line format.
If you choose use these strings, 1) Highlight and copy the desired code
string and paste the text into a text editor. 2) From the text editor, remove
any line breaks (ultimately forcing the text onto a single line), replacing
the line breaks with a single space character.
The commands described here are intended for a Windows based
environment. For UNIX and equivalent environments, replace the
backslash character “\” with the forward slash character “/”. ?

Note
The dash character (-), shown in the command strings below, is used as a
switch within the command and should never be followed directly by a

space character. ?
• If the JVM is a JRE:
keytool -import -alias <mycert> -file <mycertfile.cer> -keystore
..\lib\security\cacerts -storepass changeit -noprompt
• If the JVM is a JDK:
keytool -import -alias <mycert> -file <mycertfile.cer> -keystore
..\lib\security\cacerts -storepass changeit -noprompt
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-31
4. Disable Loading of Infinity.keystore. The Infinity.keystore is automatically loaded by
the year specific process, rnpfm12.jar. This must be disabled so the new certificate
loaded to the JVM can be used.
4.1.
Open the appropriate script for the environment in a text editor.
• For UNIX based system use script rnpfm12.shl.
• For VMS based system use script rnpfm12.com.
• For Windows based system use script rnpfm12.pl.
4.2.
Rename the property:
• From:
-Dcert=
• To:
-Dcert_HOLD=
Note
Scripts rnpfm13.shl, rnpfm13.com, and rnpfm13.pl are delivered with the

-Dcert removed. No modifications are needed.
Redeploy Servlet
Once a servlet and its supporting share lib, connection pool, and data source have been
deployed, subsequent deployment of the servlet, rnpfmxx.war, only requires a
redeployment. The share lib, connection pool, and data source do not need to be
redeployed.
1. From the rnpfmxx OC4J instance, under the Applications tab, select the rnpfmxx
application and then the Redeploy button.
3-32
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
2. On redeployment, ONLY choose the Archive rnpfmxx.war. Do not redeploy the
Deployment Plan.
3. Click Next and then Next a second time.
4. Click the Configure Class Loading task.
5. Ensure that the banner_finaid Shared Library remains checked and click the OK
button.
6. Click the Redeploy button.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-33
Proxy Settings
Warning
Do not implement these proxy settings unless it is certain that the
institution has a proxy server in place and is required for a connection to
the internet. Unnecessarily implementing these steps will create

connection problems where none existed.
The servlet rnpfmxx.war and the process rnpfm12.jar and its aid year equivalent
require internet access to connect to Infinity. If the institution requires the connection be
made through a proxy server, the following steps must be implemented.
Proxy settings for process rnpfm12.jar
Process rnpfm12 comes with two properties, http.proxyHost and http.proxyPort,
that can be added to allow the process to navigate through a proxy to connect to the
internet.
1. To modify these properties, open the appropriate script for the environment in a text
editor.
• For UNIX based system use script rnpfm12.shl.
• For VMS based system use script rnpfm12.com.
• For Windows based system use script rnpfm12.pl.
2. Make the changes by adding the properties and replacing the default values with the
appropriate values for your institution. Below the existing property -Dcert, the
following properties must be added:
• -Dhttp.proxyHost=my_proxy_host
• -Dhttp.proxyPort=my_proxy_port
Note
Replace the my_proxy_host and my_proxy_port with the appropriate

values for your institution’s proxy server.
3. For example, if the host is www-proxy.sct.com and the port is 8080:
For UNIX
. -Dhttp.proxyHost=www-proxy.sct.com \
. -Dhttp.proxyPort=8080 \
3-34
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
For VMS
"-Dhttp.proxyHost=www-proxy.sct.com " "-Dhttp.proxyPort=8080 " -
For Windows
"-Dhttp.proxyHost=www-proxy.sct.com "
"-Dhttp.proxyPort=8080 "
Proxy settings for servlet rnpfmxx.war
OC4J Proxy Settings
To change the servlet rnpfmxx.war to use a proxy server to access the internet, changes
must be made to the Start-parameters for the rnpfmxx OC4J instance.
1. Navigate to the Server Properties page for the rnpfmxx OC4J instance.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-35
2. Add the following two properties under the Start-parameters: Java Options, then click
Apply.
Note
Replace the www-proxy.sct.com and 8080 with the appropriate
values for your institution’s proxy server.

3. Restart the rnpfmxx OC4J instance.
3-36
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
WebLogic Proxy Settings
To adjust the rnpfmxx_prod.war servlet to use a proxy server to access the internet,
changes must be made to the Start-parameters for the rnpfmxx_prod server.
1. In the Change Center window, click the Lock & Edit button.
2. In the Domain Structure window, click Environment > Servers, and then select the
rnpfmxx_prod server (or another listed server, as desired).
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-37
3. From the Configuration tab and the Server Start sub-tab, add the following two
properties to the Arguments and click the Save button:
• Dhttp.proxyHost=www-proxy.sct.com
• Dhttp.proxyPort=8080
Note
Replace the www-proxy.sct.com and 8080 with the appropriate values

for your institution’s proxy server.
4. In the Change Center window, click the Activate Changes button.
3-38
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
Configure Servlet for SSL (optional)
By default, the communication protocol between INB and the servlet is http. There is no
sensitive data being passed between the two. So, for most institutions, this meets the
requirements for a secure intranet. However, some institutions may require a more secure
communication protocol for their entire intranet. This procedure outlines the basic
configuration of the servlet to allow SSL communication from INB.
Note
This procedure only configures the servlet for SSL. Additional
configuration is required on the http server. Please refer to Appendix B Enabling Secure Sockets Layer (SSL) Communication for additional

information.
1. Click the rnpfmxx Application Server to go to the OC4J rnpfmxx Instance.
2. From the Administration tab, click on the Server Properties icon.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-39
3. Change the Port and Protocol attributes and click Apply:
• Port = 12501-12600
• Protocol = ajp
4. Restart the OC4J rnpfmxx Instance.
3-40
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
Alternative Install to Full iAS 10.1.3.x
OC4J install of iAS 10.1.3.x only
The full installation of iAS 10.1.3.x suite is not necessary to support FM Need Analysis. A
customized installation will allow an institution to install only those components of the
suite that are necessary. Only the following two components are required:
• J2EE Server – the OC4J installation
• Web Server – the web enabled administrator.
This section provides the necessary steps to quickly install a minimal working OC4J that
can support deployment of the FM Need Analysis sevlet, rnpfmxx.war.
Note
This installation is based on a Windows 2008 Server with Service
Pack 2.

1. Run the setup.exe of the iAS 10.1.3.x.
2. Select the Advanced Install radio button and click Next.
3. Click Yes on the next two Warnings.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-41
4. Select the J2EE Server and Web Server radio button and click Next.
5. On the Port Configuration Options, leave the selection on Automatic and click Next.
6. Complete entry on all required fields. Make sure to check the Configure this as an
Administration OC4J instance checkbox and click Next.
7. Click Next, followed by the Install option.
8. Once the installation is complete, click Exit.
9. Done.
3-42
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
WebLogic Configuration
Installation of servlet on WebLogic (optional)
Introduction
Use the following configuration procedures to install the rnpfmxx.war servlet and
supporting objects on an existing WebLogic server.
Note
This document is written based on WebLogic version 10.3.3.0. The
screen samples and implementation steps are therefore based solely on

this version.
Changes from the prior version of WebLogic install:
A draft version of this WebLogic Configuration procedure was provided in February of
2011. This section outlines the differences that have been made since publication of that
draft document:
• Shared libraries – For the WebLogic installation of the servlet,
finaiddbseed.jar and finaidfmlogin.jar will no longer be used as shared
libraries. Instead, these jar files will be embedded within the rnpfmxx.war
servlet. This decision was made because the behaviors of the jar files as shared
libraries are not consistent for all supported application servers.
• AdminServer – During installation of the rnpfmxx.war servlet, the AdminServer
should not be used as the target. Instead, a separate server, under the
sghe_domain domain, must be created. This new server will then be used as the
target. As the AdminServer is not always running for WebLogic servers, it is not a
desirable installation target for the application.
Requirements
1. There must already be a completed WebLogic installation with a production domain.
For this document, the production domain is:
• sghe_domain.
Note
A name other than sghe_domain can be used for your institution. While
following these installation instructions, substitute the name of the
existing WebLogic domain you intend to use to host this application for
each occurrence of sghe_domain. The ClassicDomain, created during

the installation of INB, can be use if it exists.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-43
2. The environment used to host the WebLogic server where rnpfmxx.war will be
deployed must allow outgoing communication to port 443 for all of the following
Infinity URLs:
• https://fm1.sungardhe.com
• https://fm2.sungardhe.com
Object List
The following objects needed for the installation of the servlet on a WebLogic server.
• finaidutils.jar
• finaidfmlogin.jar
• finaiddbseed.jar
• rnpfmxx.war
• rnpfmxx_upd_weblogic.shl (Unix)
• rnpfmxx_upd_weblogic.com (VMS)
• rnpfmxx_upd_weblogic.bat (Windows)
Note
In INB, access to the RORPARM form will also be needed to update
references to the servlet.

Multiple simultaneous rnpfmxx servlet installations
Most institutions will wish to install the servlet and target in more than a single Banner
database instance. For example, you may wish to install the servlet on your WebLogic
server for your pre-production Banner instance and then, later, install the servlet on the
same WebLogic server but connected to your production Banner database instance.
To accommodate this, determine a short string that uniquely identifies the target database
for which you are installing the servlet. The target database SID or Service Name is
recommended.
For example, to target the install at the production database instance, with an Oracle SID
of, “PROD”, it would be logical to use the string, “prod” as the unique identifier in the
following steps. This value will be referred to in the following documentation as <unique
db id>. Anytime you see this text in input values, replace it with your unique database id
value, where indicated, like this:
Target Server
Documentation value: rnpfmxx_<unique db id>
Your value:
3-44
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
rnpfmxx_prod
January 2012
Servlet/application name
Documentation value: rnpfmxx_<unique db id>
Your value:
rnpfmxx_prod
Data source name
Documentation value: BannerFinaid_<unique db
id>
Your value:
BannerFinaid_prod
When necessary, the following procedures will identify when you need to append this
string to file names or configuration values.
Pre-configuration
Define the necessary environments and files in preparation for deployment of the rnpfmxx
servlet:
1. The finaidutils.jar must be deployed onto the INB forms server for the target
database. Refer to the Internet Native Banner, Installing finaidutils.jar procedure.
2. The finaidfmlogin.jar must be updated with the institution’s login credentials
for Infinity. Refer to the Updating finaidfmlogin.jar procedure.
3. The finaiddbseed.jar must be updated with the institution’s seed numbers. Refer
to the Updating finaiddbseed.jar procedure.
4. Run the rnpfmxx_upd_weblogic script to create an rnpfmxx servlet install package
file which includes the two modified jar files: finaidfmlogin.jar and
finaiddbseed.jar.
• For UNIX based systems use script:
$BANNER_HOME/finaid/java/rnpfmxx_upd_weblogic.shl
• For VMS based systems use script
BAN_HOME:[finaid.java]rnpfmxx_upd_weblogic.com
• For Windows based systems use script
${BANNER_HOME}\finaid\java\rnpfmxx_upd_weblogic.bat
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-45
Note
The script should be run from the location where it was extracted,
<BANNER_HOME>/finaid/java. This script requires one parameter, a
new file name (minus the extension).
Use rnpfmxx_<unique db id> as the first parameter to the script.
For example, running the command:
rnpfmxx_upd_weblogic rnpfmxx_prod
will create a new file named rnpfmxx_prod.war, which is the rnpfmxx
servlet install package, custom configured for your institution and target

database.
5. This newly created rnpfmxx_<unique db id>.war file must be copied to a
temporary area accessible to your web browser.
Create a target machine
If no target machines exist, one must be created to host the logical WebLogic server(s)
which, in turn, will host the servlet(s). A single machine can host multiple servers, so this
step only needs to be performed one time.
1. Confirm that the Node Manager is running.
2. Start the Admin Server for WebLogic for the sghe_domain domain.
3. Using your web browser, login into the Oracle WebLogic Server Administration
Console for the sghe_domain domain.
4. In the Change Center window, click the Lock & Edit button.
3-46
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
5. In the Domain Structure window, choose Environment > Machines, and then click
the New button.
Note
The machine name must be unique for each domain. The physical
machine host name is valid and can be used for the WebLogic logical
machine name. For this document, the machine name, m037056 is
used.

6. In the Change Center window, click the Activate Changes button.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-47
Create a server
This step must be performed once for each deployment of the rnpfmxx servlet.
1. In the Change Center window, click the Lock & Edit button.
2. In the Domain Structure window, choose Environment > Servers, and then click the
New button.
3. Enter the following in the two required fields and click the Finish button:
• Server Name = rnpfmxx_<unique db id>
• Server Listen Port = 10001 or any available port number
Warning
Do not use the same port number as the AdminServer. The default port
number for the AdminServer is 7001. If this is used you may cause the
AdminServer to become unstable and unreachable. This may cause the
administration console to be inaccessible from a web browser.
Do not use the same port number as the Node Manager. The default port
number for the Node Manager is 5556. If this is used you may cause the
Node Manager to become unstable and unreachable. This in turn may

take down WebLogic.
3-48
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
4. Click on the newly created rnpfmxx_<unique_db_id> server, select the machine
name, and then click on Save button.
5. In the Change Center window, click the Activate Changes button.
Configure target server
1. In the Change Center window, click the Lock & Edit button.
2. In the Domain Structure window choose Environment > Servers, and then select the
server you will use to deploy the servlet. The following steps assume your server is
named rnpfmxx_<unique_db_id>.
3. Under the Configuration tab and the Keystores sub-tab, change the default
Keystores value.
4. Select the Custom Identity and Java Standard Trust option and click the Save button.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-49
5. In the Change Center window, click the Activate Changes button.
6. From the Domain Structure window, choose Environment > Servers, and then click
on the Control tab. Select the rnpfmxx_<unique_db_id> server from the
displayed table and click the Start button.
7. On the confirmation page, click the Yes button.
8. Click the auto refresh icon and wait until the status of the server changes to
“RUNNING”.
Note
Please be patient as this process may take a few minutes for the server to

start.
3-50
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
Installing the servlet
1. In the Change Center window, click the Lock & Edit button.
2. From the Domain Structure window, click Deployments, and then click on the
Install button.
3. Click the upload your files(s) link.
4. Click the Browse button on the Deployment Archive line, navigate to the
rnpfmxx_<unique db id>.war file (created for your target database) and click
Open. Once opened, click the Next button.
Note
Based on your web browser, your screen may differ from the one shown
above. This example was created using Internet Explorer 7 (running on
Windows XP). The process should be similar. For example, the Google
Chrome browser would display a Choose File button, instead of the

Browse button.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-51
5. Once the rnpfmxx_<unique db id>.war file has been successfully uploaded, a
confirmation message (similar to the one shown below) will be displayed. Click the
Next button.
6. When asked to choose a targeting style, select the Install this deployment as an
application option and click the Next button.
7. Select rnpfmxx_<unique db id> as the target server and click the Next button.
8. On the Optional Settings page, click the Finish button.
9. In the Change Center window, click the Activate Changes button
3-52
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
Creating the Data Source
This section will create a data source and the associated connection that will allow the
servlet to connect to the Oracle database used by Banner.
1. In the Change Center window, click the Lock & Edit button.
2. In the Domain Structure window, select Services > JDBC > Data Sources, and click
the New button.
Note
Depending on the version of WebLogic, your screen may differ. The Data
Sources may be located under Services > Data Sources instead.
Clicking on the New button may cause additional pop-up selections. If so,

select the Generic Data Source. Refer to the screen shot below.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-53
3. Enter the following attributes and click the Next button.
• Name = BannerFinaid_<unique db id>
• JNDI Name = jdbc:java_banner_finaid
4. Select the *Oracle’s Driver (Thin) for Instance connections and click the Next
button.
Note
Depending on the version of WebLogic, your screen may differ.
Regardless, make sure to select the (Thin), not (Thin XA) drivers.

5. There is no need to change any options listed on the Transaction Options screen.
Click the Next button to continue without changes.
3-54
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
6. On the Connection Properties screen, enter the following attributes and click the
Next button:
• Database Name = The target Oracle database SID or service name for INB
• Host Name = The machine name that is hosting the Oracle database for INB (IP
address or hostname)
• Port = The listening port of the target Oracle database for INB
• Database User Name = banproxy
• Password = The password for user banproxy
• Confirm Password = The password for user banproxy
Note
The Database User Name must be banproxy.

7. Click the Test Configuration button.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-55
8. With a successful configuration test, the Connection test succeeded message will be
displayed. Click the Finish button.
9. Select the newly created BannerFinaid_<unique db id> Data Source form those
listed in the displayed table.
10. Under the Configuration tab and the Connection Pool sub-tab, change the Statement
Cache Size to 0 and click the Save button.
3-56
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
11. Click the Targets tab to select the rnpfmxx_<unique db id> server as the target
and click the Save button.
12. In the Change Center window, click the Activate Changes button.
Starting the servlet
1. In the Domain Structure window, click Deployments, and confirm the status of the
rnpfmxx_<unique db id> servlet.
2. If the servlet is not Active, select the rnpfmxx_<unique db id> servlet and click the
Start button followed by selecting the Servicing all requests option.
3. Click the Yes button on the confirmation page.
4. The servlet is now active and ready to service requests.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-57
Test the servlet install
1. In the Domain Structure window, click Deployments followed by selecting the
rnpfmxx_<unique db id> servlet.
2. Under the Testing tab, click the link for the second URL under
rnpfmxx_<unique db id>.
3. Because the default user user_name is most likely invalid, the following result will
be displayed:
rnpfmxx version: 8.10.0.2
ERROR.
java.sql.SQLException
- ORA-01017: invalid username/password; logon denied
4. In your web browser, modify the URL to specify a valid user name and also include
the debug and webservice parameters, as in the following example:
http://149.24.37.56:10001/rnpfmxx_prod/
FmCalxx?user=faisusr&debug=Y&webservice=Y
A successful test of the servlet will return the following result:
rnpfmxx version: 8.10.0.2
Database connection Ok.
Web Service connection Ok.
3-58
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
Update form RORPARM in INB
1. In INB, navigate to the RORPARM form.
2. Change the value for parameter USE_JOBSUB to N.
3. Change the value for parameter SERVLET_URL with the URL of the servlet and save.
Note
Refer to the previous section, Test the servlet install, determine the
URL.

The servlet URL uses the following format:
• http://<SERVER>:<PORT>/ rnpfmxx_<unique_db_id>/FmCalxx
• <SERVER> the name of the Server where rnpfmxx.war is deployed
• <PORT> the port number
Note
The IP number can be replaced with the host name. A valid value for the
SERVLET_URL could be

http://m037056:10001/rnpfmxx_prod/FmCalxx.
Reinstalling over an existing servlet
1. Start this process by completing steps 2 through 5 found in the Pre-configuration
section.This will create a new rnpfmxx_<unique_db_id>.war file from the
base-lined version of rnpfmxx.war.
2. Under the Deployments Domain Structure, select the rnpfmxx_<unique_db_id>
servlet and click the Stop button, followed by the Force Stop Now option.
3. From the Confirmation page, click the Yes button.
4. In the Change Center window, click the Lock & Edit button.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-59
5. Under Deployments, select the rnpfmxx servlet and click the Update button.
6. Click the Change Path button.
7. Click the upload your files(s) link.
8. Click the Browse button on the Deployment Archive line. Navigate to the
rnpfmxx_<unique_db_id>.jar file you created for your intended target database
and click the Open button. Once opened, click the Next button.
Note
Based on your web browser, your screen may differ from the one shown.
This example was created using Internet Explorer 7, running on Windows
XP. But, the process should be similar. For example, the Google Chrome
browser would display a Choose File button, instead of the Browse

button.
3-60
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
9. Once the rnpfmxx_<unique_db_id>.war file has been successfully uploaded, a
confirmation message, similar to the one shown below, will be displayed. Click the
Next button.
10. Click the Finish button.
11. In the Change Center window, click the Activate Changes button.
12. Follow the steps in the Starting the servlet section, to make the servlet active.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-61
Windows Server Platform Certification
(On-Premise Only)
Windows Server 2008 Platform
Introduction
Microsoft releases new operating systems every three to five years. This section contains
FM Need Analysis Service certification details for Windows Server 2008 operating
system platforms as follows:
• Windows 2008 (32 & 64 bit)
• Windows 2008 R2 (64 bit)
Windows Server 2008 (32 & 64 bit)
In the Windows Server 2008 operating system, Microsoft introduced many new features
and technologies, which were not available in Windows Server 2003 with Service Pack 2
(SP2), that help to increase the security of computers running Windows Server 2008,
increase productivity, and reduce administrative overhead. This OS is available on both
the 32 and 64 bit platform.
Windows Server 2008 R2 (64 bit)
The Windows Server 2008 R2 operating system has been built on the foundation of
Windows Server 2008, expanding existing technology and adding new features to enable
organizations to increase the reliability and flexibility of their server infrastructures. This
OS is only available on the 64 bit platform.
Microsoft has introduced powerful tools such as IIS version 7.5, updated Server Manager
and Windows Power Shell version 2.0 to give customers greater control, increased
efficiency, and the ability to react to front-line business needs faster than ever before. The
features of Windows Server 2008 R2 are:
• Improved Web Application Platform
• Server and Desktop Virtualization
• Improved Power Management
• Scalability
• Reliability
3-62
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
Certification Objective
The objective is to certify the Banner Financial Aid FM Need Analysis service for
compatibility against the following Windows operating system platforms:
• Windows 2008 (32 & 64 bit)
• Windows 2008 R2 (64 bit native)
Configuration Points Tested
Windows 2008 (32 bit)
The certification exercise determined the effect of installing Banner Financial Aid FM
Need Analysis Service on the application server running Microsoft Windows Server 2008
(32-bit).
The following table lists the various Windows 2008 (32 bit) server side features used for
validating the service:
Configuration Item
Option
Comments
Server Roles and Role services
Web role
Web role with Web server and
Management tools as the role
services is the minimal
requirement.
Role services for Web role
Role services installed:
• Web server
• Management tools
Supported versions of .NET
.NET 3.5
.NET 4.0
Supported versions of IIS
January 2012
IIS 7.0
.NET 3.5 is the minimal
requirement with the latest service
pack SP1 applied.
IIS 7.0 version is installed with
Web server role.
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-63
Configuration Item
Option
Comments
IIS Configuration
• Anonymous
• Application Authentication
• Basic
Virtual directory to be configured
as an application. Retain the
default setting of Anonymous
authentication.
IIS Application Pool .NET
Framework Version
Application Pool:
Managed pipeline mode: Integrated
Note: This is separate from the
installed version of the dotNET
Framework and refers to runtime
version of .NET)
• If .NET Framework 3.5 is installed
then .NET Framework version is
v2.0.50727
.NET Framework version
2.050727 and mode as Integrated
pipeline is the recommended
setting.
• If .NET Framework 4.0 is installed
then .NET Framework version of
v4.0.30319 needs to be selected.
Windows 2008 (64 bit)
The certification exercise determined the effect of installing FM Need Analysis Service on
the application server running Microsoft Windows Server 2008 (64-bit).
The following table lists the various Windows 2008 (64 bit) server side features used for
validating the service:
Configuration Item
Option
Comments
Server Roles and Role services
Web role
Web role with Web server and
Management tools as the role
services is the minimal
requirement.
Role services for Web role
Role services installed:
• Web server
• Management tools
Supported versions of .NET
.NET 3.5
.NET 4.0
Supported versions of IIS
3-64
IIS 7.0
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
.NET 3.5 is the minimal
requirement with the latest service
pack SP1 applied.
IIS 7.0 version is installed with
Web server role.
January 2012
Configuration Item
Option
Comments
IIS Configuration
• Anonymous
• Application Authentication
• Basic
Virtual directory to be configured
as an application. Retain the
default setting of Anonymous
authentication.
IIS Application Pool .NET
Framework Version
Application Pool:
Managed pipeline mode: Integrated
Note: This is separate from the
installed version of the dotNET
Framework and refers to runtime
version of .NET)
• If .NET Framework 3.5 is installed
then .NET Framework version is
v2.0.50727
.NET Framework version 2.0 and
mode as Integrated pipeline is the
recommended setting.
• If .NET Framework 4.0 is installed
then .NET Framework version of
v4.0.30319 needs to be selected.
Windows 2008 R2 (64 bit)
The certification exercise determined the effect of installing FM Need Analysis Service on
the application server running Microsoft Windows Server 2008 R2 (64-bit).
The following table lists the various Windows 2008 R2 (64 bit) server side features used
for validating the service:
Configuration Item
Option
Comments
Server Roles and Role services
Web role
Web role with Web server and
Management tools as the role
services is the minimal
requirement.
Role services for Web role
Role services installed:
• Web server
• Management tools
Server Features
.NET Framework 3.5.1 features
Remote server administration tools
Windows process activation service
These features will need to be
installed manually.
Supported versions of .NET
.NET 3.5
.NET 3.5 is the minimal
requirement with the latest service
pack SP1 applied. This is installed
as a part of Server Features.
.NET 4.0
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-65
Configuration Item
Option
Comments
Supported versions of IIS
IIS 7.5
IIS 7.5 version is installed with
Web server role.
IIS Configuration
• Anonymous
• Application Authentication
• Basic
Virtual directory to be configured
as an application. Retain the
default setting of Anonymous
authentication.
IIS Application Pool .NET
Framework Version
Application Pool:
Managed pipeline mode: Integrated
Note: This is separate from the
installed version of the dotNET
Framework and refers to runtime
version of .NET)
• If .NET Framework 3.5 is installed
then .NET Framework version is
v2.0.50727
.NET Framework version 2.0 and
mode as Integrated pipeline is the
recommended setting.
• If .NET Framework 4.0 is installed
then .NET Framework version of
v4.0.30319 needs to be selected.
Helpful Screen Shots
Windows Web Server Role & IIS Management Console
This is the IIS Manager console from which the IIS settings for various hosted web
applications will be configured.
3-66
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
Programs and Features
This was formerly Add Remove Programs and will show which version(s) of dotNET are
installed on the server. Programs and Features option is found in the Control Panel.
Application Pool Settings
This is the configuration settings for the application pool at the IIS level namely the .Net
framework version and the pipeline mode which will be applied to the associated
applications.
Certification Method
Certifying Banner Financial Aid FM Need Analysis Service involved the following tasks:
1. Identify the pre-requisites required for installing the Banner Financial Aid FM Need
Analysis Service on Windows 2008 server. These features and patterns form the
source for the certification testing of the service.
• Identify the server-level configurations, different server roles, and features to be
installed (i.e Application and Web server roles available).
• Identify the supported .Net framework versions to be installed on the server for the
service to be running.
• Identify the configurations required at the IIS level for hosting the web service
which includes the Application pool settings with respect to the .Net framework
version and mode & the virtual directory settings.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-67
2. The above step would also identify and analyze the behavioral changes in Windows
2008 which could affect the behavior of the Service.
3. Map the features and patterns identified to form combinations of server-level settings
to be evaluated for validation of the service.
4. Installing Banner Financial Aid FM Need Analysis Service on the application server
running Windows 2008.
5. Validating the invocation of the EFC Web service mapped to the chosen patterns and
reporting issues.
6. Debugging and documenting the issues resolved.
Issues Identified
Issue I (All Platforms)
.Net Framework 4.0 related issues were identified as part of the certification exercise.
Detailed description of each of the issues along with any known resolution is provided
below:
Scenario
Problem
Resolution
When .NET Framework 4.0 is installed and the application pool
is configured to run in the .NET Framework version 4.0.
There is a duplicate system.web.extensions/scripting/
scriptResourceHandler section defined.
Option 1:
• To set the .NET Framework version to v2.0.50727 for
DefaultAppPool in the application pool at the IIS level.
Option 2:
Comments
• With the .NET framework version set to 4.0 in the application
pool, the system.web.extensions section needs to be
commented out in the web.config file.
Refer to the following links for additional information:
• http://www.sitefinity.com/devnet/forums/sitefinity-3-x/
suggestions/config-error-there-is-a-duplicate-system-webextensions-scripting-scriptresourcehandler-sectiondefined.aspx
• http://forums.asp.net/p/1571308/3939106.aspx
3-68
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
Issues II & III (All Platforms)
The following are two known issues that can occur if ASP.NET framework has been
installed incorrectly:
Scenario
Problem
This error can occur when IIS is installed after installing .NET
Framework 4, or if the 3.0 or 3.5 version of the WCF Http
Activation module is installed after installing IIS and .NET
Framework 4.
Could not load type
System.ServiceModel.Activation.HttpModule from
assembly System.ServiceModel, Version=3.0.0.0,
Culture=neutral,
PublicKeyToken=b77a5c561934e089.
Resolution
Use the ASP.NET IIS Registration Tool
(Aspnet_regiis.exe) to register the correct version of
ASP.NET:
Run the following from command line:
aspnet_regiis.exe /iru
The aspnet_regiis.exe file can be found in either:
• %windir%\Microsoft.NET\Framework\v4.0.30319
Comments
• %windir%\Microsoft.NET\Framework64\v4.0.30319
(on a 64-bit machine)
Refer to the following links for additional information:
• http://devonenote.com/2010/06/could-not-load-type-systemservicemodel-activation-httpmodule/
• http://social.msdn.microsoft.com/Forums/eu/wcf/thread
/39571e42-aca7-469d-8c68-aa59c2da4fcc
Summary
Windows 2008 (32 & 64 bit)
The Banner Financial Aid FM Need Analysis Service is fully compatible with Windows
Server 2008 (32 & 64 bit) operating system version on the application server.
Windows 2008 R2 (64 bit)
The Banner Financial Aid FM Need Analysis Service is fully compatible with Windows
Server 2008 R2 (64-bit) operating system version on the application server.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-69
Additional Supporting Information
Download Location for .Net Framework 3.5 Service Pack 1
This page contains the link to download the installation package of .Net Framework
version 3.5 Service Pack 1 which is a full cumulative update with new features build
incrementally upon the .Net Framework 2.0, the .Net Framework 3.0, and the .Net
Framework 3.5 and also contains issue fixes. This service pack is the latest version
recommended for all operating systems.
http://www.microsoft.com/downloads/en/details.aspx?FamilyID=ab99342f-5d1a413d-8319-81da479ab0d7&displaylang=en
Download Location for .NET Framework 4.0
This page contains the link to download the installation package of .Net Framework
version 4.0 which introduces new features and improvements and is highly compatible
with applications that are built with earlier .Net Framework versions, except for some
changes that were made to improve security, standards compliance, correctness, reliability,
and performance.
http://www.microsoft.com/downloads/en/details.aspx?FamilyID=9cfb2d51-5ff44491-b0e5-b386f32c0992&displaylang=en
Windows Server 2008 Product Overview Guide
This page contains the Product Overview documentation for Windows Server 2008.
http://www.greymatter.com/StaticPages/ProductGuideWindowsServer2008/tabid
/212/Default.aspx
Windows Server 2008 R2 Product Overview Guide
This page contains the Product Overview documentation for Windows Server 2008 R2.
http://www.microsoft.com/windowsserver2008/en/us/overview.aspx
.Net Framework Support in Windows Server 2008
This page contains the available support provided by Windows Server 2008 for the
various .Net Framework versions.
http://msdn.microsoft.com/en-us/library/cc531167.aspx
3-70
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
Microsoft .NET Framework 4 Readme
This page contains a list of known issues with .Net Framework 4.0 version.
http://download.microsoft.com/download/B/5/7/B57D25A2-B3FD-4668-91B9DB43B6BD910D/NETFx4RTM.htm
ASP.NET IIS Registration Tool (Aspnet_regiis.exe)
This page contains the information about the ASP.NET IIS Registration tool
(Aspnet_regiis.exe) which is used to register ASP.NET applications with Internet
Information Services (IIS).
http://msdn.microsoft.com/en-us/library/k6h9cz8h.aspx
Troubleshooting
Missing finaidutils.jar
Related Error Message
java.lang.Exception: java.lang.NoClassDefFoundError:
com/sct/banner/forms/ui/HttpPost
Description
Symptom:
OAS 10.1.2.x Oracle forms server is missing the finaidutils.jar file
Solution:
Review: Internet Native Banner (INB), Installing finaidutils.jar
Unable to connect to servlet rnpfmxx.war
Related Error Message
Servlet url is invalid.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-71
Description
Symptom:
The parameter SERVLET_URL defined on the Project Based Parameter Setup
Form (RORPARM) has not been updated with the correct URL.
Solution:
Review: Run immediate Need Analysis using the servlet (step 5).
Connection timed out
Related Error Message
IOException Connection timed out.
Description
Symptom:
A parameter for SERVLET_URL was provided on the Project Based Parameter
Setup Form (RORPARM). The URL provided is valid, but the service related to
the URL is not responding.
Diagnostic
Double check the URL and make sure the value specifies the rnpfmxx.war
servlet.
Note: The www.sungardhe.com web address is a valid URL. However, its
value is not the correct URL for the servlet.
Solution:
Review: Run immediate Need Analysis using the servlet (step 5).
Proxy not authorized
Related Error Message
java.sql.SQLException
ORA-28150: proxy not authorized to connect as client
Description
Symptom:
The user login into INB is not setup to allow proxy login.
Solution:
Review: Required installation (step 1).
3-72
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
Unauthorized
Related Error Message
org.apache.axis2.AxisFault: Transport error: 401 Error: Unauthorized
Description
Symptom:
The nas.properties file embedded within the finaidfmlogin.jar must
be updated with the correct user name and password to allow a successful login
to Infinity.
Solution:
Review: Required installation (step 3).
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-73
FAQs
FM Need Analysis FAQs
Q1: What if the job submission server must use a proxy server to connect to the internet?
A: Refer to the Proxy Settings procedure (Proxy settings for process rnpfm12.jar).
Q2: What if the OC4J 10.1.3.x must use proxy server to connect to the internet?
A: Refer to the Proxy Settings procedure (Proxy settings for servlet rnpfmxx.war).
Q3: Can I install iAS 10.1.3.x on the same computer as the existing OAS 10.1.2.x?
A: Yes.
Q4: Can I install multiple versions of the servlet on the same OC4J instance and have
each connect to a different Oracle database?
A: Yes.
1. Follow the steps for Creating the rnpfmxx OC4J Instance, if one does not already
exist.
2. Follow the steps for Installing the Share Library, Banner_finaid, if one does not
already exist. The same share library can be used by multiple servlets as long as they
use the same seed number. Otherwise, create a different Share library for each
database. For example, BannerFinaid_prod and BannerFinaid_test.
3. Follow the steps for Installing the Servlet. In step 4, change the Application Name
and the Context Root to make it unique. For example, rnpfmxx_test. In step 6,
choose the Share Library that has the correct seed number to support the database.
Finish the rest of the installation.
4. Follow the steps for Creating the Connection Pool and Data Source for RNPFMXX.
In step 2 and step 4, make sure to select the Application to rnpfmxx_test. Finish
the rest of the installation.
5. The servlet URL then would be:
http://<SERVER>:<PORT>/rnpfmxx_test/FmCalxx
Q5: Where do I deploy the finaidutils.jar?
A: The finaidutils.jar must be copied from the <BANNER_HOME>/finaid/java/ over to
the Forms OAS 10.1.2.x server <ORACLE_HOME>/forms/java/ directory.
First, edit the <ORACLE_HOME>/forms/server/prod.env or the .env file that is
used by INB. Second, add finaidutils.jar into the CLASSPATH environmental
variable.
3-74
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
For example:
CLASSPATH=D:/ORACLE/OAS_10/j2ee/OC4J_BI_Forms/applications/
formsapp/formsweb/WEB-INF/lib/frmsrv.jar;D:/ORACLE/OAS_10/jlib/
repository.jar; D:/ORACLE/OAS_10/jlib/ldapjclnt10.jar;D:/
ORACLE/OAS_10/jlib/debugger.jar;D:/ORACLE/OAS_10/jlib/
ewt3.jar;D:/ORACLE/OAS_10/jlib/share.jar;D:/ORACLE/OAS_10/jlib/
utj.jar;D:/ORACLE/OAS_10/jlib/zrclient.jar;D:/ORACLE/OAS_10/
reports/jlib/rwrun.jar;D:/ORACLE/OAS_10/forms/java/
frmwebutil.jar;D:/ORACLE/OAS_10/forms/java/finaidutils.jar
Q6: Where do I get the seed number to update the seed.properties file within the
finaiddbseed.jar?
A: If you have enough permission you can use the following SQL statement to retrieve
the seed numbers:
SELECT GUBIPRF_SEED1,GUBIPRF_SEED3 FROM bansecr.gubiprf;
GUBIPRF_SEED1 GUBIPRF_SEED3
------------- ------------12345678
87651234
Q7: How do I test my deployment of the servlet rnpfmxx.war outside of Banner?
A: From a web browser, connect to the servlet URL:
1. For example
• If the servlet URL is http://mtestcomp.corp.sct.com:8860/rnpfmxx/
FmCalxx
• If a valid FINAID user is: faisusr
• In a web browser, go to the following address:
http://mtestcomp.corp.sct.com:8860/rnpfmxx/
FmCalxx?user=faisusr&debug=Y&webservice=Y
2. If everything is successful, you would get this or the equivalent. If there are failures,
the appropriate error messages would show accordingly.
rnpfmxx version: 8.10
Database connection Ok.
Web Service connection Ok.
Q8: How do I test my login credential to Infinity for validity?
A: You can test the credential from a web browser.
1. From a web browser, go to the following URL:
https://fm1.sungardhe.com/EFCService/
EFCCalculationService.asmx
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-75
2. In the login popup screen, type in the institution login user name and password.
3. If login is successful an EFCCalculationService web page is displayed.
Q9: Do I have to install the servlet rnpfmxx.war?
A: No.
You can run the immediate Need Analysis using the job submission process rnpfm12
or its aid year equivalent instead. Go to INB and access form RORPARM. Change the
parameter value USE_JOBSUB to Y.
Note
The servlet implementation is a performance enhancement. This
represents an improvement from 2 to 6 seconds per calculation using the

servlet vs. 6 to 30 seconds using the job submission process.
Q11: Where is the log file when running the servlet rnpfmxx.war?
A: The servlet rnpfmxx.war does not generate the traditional .log and .lis files like
process rnpfm12.jar and its aid year equivalent. Instead, if there are any errors, they
will appear as a popup in INB. There is also a continuous log on the OC4J hosting the
servlet. Additional information can found here to help debug the deployment of the
servlet. The log files can be found here <ORACLE_HOME>/opmn/logs/. An example of
the file name is: sghe_group~rnpfmxx~sghe_group~1.log.
Q12: There was an additional record introduced for the 7.19/8.10 Winter release in
RORPARM called WS_ENDDPOINT. How is this additional record used?
A: No action is required. This record is for future use only.
Q13: We have a load balancer for the OC4J (10.1.3.x) with the servlet rnpfmxx.war
deployed on it, what URL should we use to check the status of the OC4J or the servlet?
A: You can use the OC4J root URL. This will return a web page. For example, if the
servlet’s URL is:
http://myhost.com:8860/rnpfmxx/FmCalxx
The root would be:
http://myhost.com:8860/
3-76
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
We do not recommend using the servlet’s actual URL for the test. This will generate a
large number of extraneous errors in the rnpfmxx OC4J instance logs which will make it
difficult to locate “legitimate” errors.
Q14: Do I need to open port 443 on the Oracle database server to allow connection to
Infinity?
A: No. For security reason, Ellucian has intentionally not coded the Need Analysis to
make a web service call directly from the Oracle database server and the INB server.
However, the job submission server will need port 443 open to allow the batch process to
connect to Infinity. In addition, if the servlet option is chosen for immediate processing of
Need Analysis, port 443 will also need to be open for the environment hosting the OC4J
10.1.3.x.
Q15: If the Off-Premise option has been chosen, do we still need to change anything in
RORPARM?
A: No. The default configuration is for Off-Premise.
Q16: If we do not setup the servlet, do we need to change anything in RORPARM?
A: Yes. In RORPARM change the value for parameter USE_JOBSUB from N to Y.
Q17: We are an Off-Premise client and have just upgraded from 8.8.1 to 8.10. The servlet
was working fine for us prior to the upgrade. With the recent upgrade to release 8.10, we
now get the following error when doing a calculation from ROAIMMP:
ERROR. org.apache.axis2.AxisFault - Connection timed out:
connect
org.apache.axis2.AxisFault.makeFault(AxisFault.java:430)
And this message when testing from a web browser:
Web Service connection Failed. ERROR. Invalid login credential or certificate.
ERROR. org.apache.axis2.AxisFault - Connection timed out:
connect
org.apache.axis2.AxisFault.makeFault(AxisFault.java:430)
A: With the 8.10 release, a second URL was added for immediate Need Analysis
processing. Open the firewall and/or VPN to allow connections to both Infinity URLs,
using port 443:
https://fm1.sungardhe.com
https://fm2.sungardhe.com
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-77
Q18: Where do I get the URL to populate the SERVLET_URL in RORPARM?
A: First, follow all steps outlined in item 4, below (4.1 through 4.4) found in the Run
immediate Need Analysis using the servlet option section of this Handbook.
Next, use the following steps to get the correct URL of the deployed servlet:
1. Login in to the Enterprise Manager/Application Server Control.
2. Expand the rnpfmxx OC4J instance so the rnpfmxx application is visible, then click
the rnpfmxx application.
3-78
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
3. Click the rnpfmxx Web Module.
x
4. Click on the Test Web Module icon.
5. The displayed URL is the first part of the servlet URL. Append “/FmCalxx” to the
end of the existing URL.
For example:
http://m037056:8860/rnpfmxx/FmCalxx
Q19: For RORPARM settings, what is the difference between WS_ENDPOINT and
WS_ENDPOINT_ONLINE?
A: WS_ENDPOINT is used by processes rnpfm11/12.jar whereas,
WS_ENDPOINT_ONLINE is used by the servlet rnpfmxx.war.
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-79
Q20: For RORPARM settings, why does Ellucian have three sites?
A: For best performance when doing a single calculation from immediate processing or
ONLINE processing, the servlet is the best option.
To help with performance, the servlet connects a set of calculators that are separated
from the batch processing. This way, the servlet is not competing for the same
resources as the batch processing of thousands of student records.
• Batch processing (production version of the calculator):
https://fm1.sungardhe.com/EFCService/
EFCCalculationService.asmx
• ONLINE processing (production version of the calculator):
https://fm2.sungardhe.com/EFCService_IMMP/
EFCCalculationService.asmx
• Batch processing (BETA/pre-production version of the calculator):
https://fm1.sungardhe.com/EFCService_1/
EFCCalculationService.asmx
Note
There is no pre-production version of the calculator dedicated for
ONLINE. If a client wishes to test ONLINE processing, they must switch

to job submission (RORPARM USE_JOBSUB = Y).
Q21: Our institution has a load balancer to support the OC4J hosting the servlet
rnpfmxx.war. We want to use a health check on the servlet to see if it is active.
What URL should we use?
A: You must have at least configured rnpfmxx.war with version 7.19.0.2 or 8.10.0.2 or
later. The URL must include the "?user=faisusr&webservice=N" string appended to
the address.
For example, if this is the URL for the servlet:
htttp://myhost.com:8860/rnpfmxx/FmCalxx
The health check URL would be:
htttp://myhost.com:8860/rnpfmxx/
FmCalxx?user=faisusr&webservice=N
Note
If the user faisusr is not configured as a valid FINAID user, replace it with

a valid user.
Q22: How do I setup SSL between INB and the servlet?
A: Review the optional procedure, Configure Servlet for SSL and
Appendix B - Enabling Secure Sockets Layer (SSL) Communication.
3-80
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
WebLogic FAQs
Q1: Where are the log files for the domain?
A: If the domain is sghe_domain and the target server is rnpfmxx_prod, then the log
files can be found under:
<WEB_LOGIC_INSTALL>/user_projects/domains/sghe_domain/servers/
rnpfmxx_prod/logs
Q2: In the Configure target server section, I am unable to start the server. The state of the
server is FAILED_NOT_RESTARTABLE.
A: Check to make sure the Node Manger is running.
Check to make sure the port number for the target server is not already in use. Try
changing the port number to one that is not already in use.
Q3: When I tried to test the servlet from a web browser, it cannot find the servlet.
A: Make sure the state of the target server for the servlet is “RUNNING”. See Configure
target server section.
Q4: When I tried to test the servlet from a web browser, I am getting an:
“Error 503--Service Unavailable”.
A: Make sure the state of the servlet is Active. See Starting the servlet section.
Q5: When I tried to test the servlet from a web browser, I am getting an:
“Error 500--Internal Server Error”.
In the log file I’m getting this:
com.sungardhe.messaging.servlet.FmCalxx.doGet
com.sungardhe.messaging.servlet.BannerFinaidException: ERROR!
Properties file not found: /com/sungardhe/finaid/login/
nas.properties
A: Make sure you complete the steps in the Pre-configuration section. Make sure you use
the newly created war file for the Installing the servlet section.
Q6: I’m getting this error from the servlet:
ERROR.
java.sql.SQLException
- Closed Statement
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-81
A: Check your data source. The connection pool Statement Cache Size must be 0. This can
be found under the Configuration tab and Connection Pool sub-tab of the data source.
Check the Driver Class Name. It should have the prefix of oracle.jdbc.thin. If it is
oracle.jdbc.xa, then you will need to delete the data source and recreate it with the
correct driver. See Creating the Data Source section.
Note
If you make changes to the data source. You will need to stop the target

server and restart it.
Q7: When I tried to test the servlet from a web browser, I am getting this:
ERROR.
javax.naming.NameNotFoundException
- Unable to resolve 'jdbc:java_banner_finaid'. Resolved ''
A: Check to make sure both the servlet and the corresponding data source use the same
target server. See Installing the Servlet and Creating the Data Source sections.
Double check the spelling of the JNDI Name for the data source. It must be:
jdbc:java_banner_finaid.
Q8: Can I install multiple servlets to support multiple INB on the same domain?
A: Yes. For example, to install two servlets one for production and one for testing, the first
installation is prod the second is test.
Follows all of the steps to install the first Need Analysis servlet for the domain:
• Pre-configuration – create the rnpfmxx_prod.war file.
• Creating a target machine
• Creating a server – create a new rnpfmxx_prod target server
• Configure target server
• Installing the servlet
• Creating the Data Source – create a new BannerFinaid_prod data source
• Starting the servlet
• Test the servlet install
• Update form RORPARM in INB
3-82
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
Repeat the installation for the second Need Analysis servlet:
• Pre-configuration – create the rnpfmxx_test.war file
• Creating a target machine – this section can be skipped. The same machine can be
reused by both servlets
• Creating a server – create a new rnpfmxx_test target server
• Configure target server
• Installing the servlet
• Creating the Data Source – create a new BannerFinaid_test data source
• Starting the servlet
• Test the servlet install
• Update form RORPARM in INB
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
3-83
3-84
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis On-Premise Configuration
January 2012
A
FM Need Analysis
Schema
The following code represents the current FM Need Analysis Schema:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<!-- edited with XMLSpy v2005 rel. 3 U (http://www.altova.com)
by Martin Schwartz (Ellucian) -->
<xs:schema
xmlns:finaid="urn:sungardhe:enterprise:financial_aid:messages"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
targetNamespace="urn:sungardhe:enterprise:financial_aid:message
s" elementFormDefault="qualified"
attributeFormDefault="unqualified">
<!-- Input XML - Root Element Structure -->
<xs:element name="GetEFCCalculation">
<xs:complexType>
<xs:sequence>
<xs:element name="ISIR" maxOccurs="unbounded">
<xs:complexType>
<xs:sequence>
<xs:element name="TransactionNumber">
<xs:simpleType>
<xs:restriction base="xs:integer">
<xs:minInclusive value="00"/>
<xs:maxInclusive value="99"/>
<xs:fractionDigits value="0"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="TransactionReceiptDate"
type="finaid:DateBlankType" minOccurs="0"/>
<xs:element ref="finaid:ExternalRecordID"/>
<xs:element name="AwardYear"
type="finaid:AwardYearType"/>
<xs:element ref="finaid:EFCDuration"
minOccurs="0"/>
<xs:element name="OverrideRejects"
type="finaid:YesNoType" minOccurs="0"/>
<xs:element ref="finaid:Student"/>
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Schema
A-1
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<!-- Output XML - Root Element Structure -->
<xs:element name="ShowEFCCalculation">
<xs:complexType>
<xs:sequence>
<xs:element ref="finaid:EFCEstimate"
maxOccurs="unbounded">
<xs:annotation>
<xs:documentation>1 per ISIR record passed to the
service</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<!-- Input XML elements Definitions-->
<xs:element name="ExternalRecordID" type="xs:string"/>
<xs:element name="Student" type="finaid:ISIRStudentType"/>
<xs:complexType name="ISIRStudentType">
<xs:sequence>
<xs:element name="BirthDate" type="finaid:DateBlankType"
minOccurs="0"/>
<xs:element name="LastNameExists"
type="finaid:NameExistsType" minOccurs="0"/>
<xs:element name="FirstNameExists"
type="finaid:NameExistsType" minOccurs="0"/>
<xs:element name="AddressStateProvinceCode"
type="finaid:StateProvinceCodeType" minOccurs="0">
<xs:annotation>
<xs:documentation>Contact Address</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="CitizenshipStatusCode"
type="finaid:CitizenshipStatusCodeType" minOccurs="0"/>
<xs:element name="MaritalStatusCode"
type="finaid:StudentMaritalStatusCodeType" minOccurs="0"/>
<xs:element name="MaritalStatusDate"
type="finaid:DateBlankType" minOccurs="0"/>
A-2
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Schema
January 2012
<xs:element name="ResidencyStateProvinceCode"
type="finaid:StateProvinceCodeType" minOccurs="0"/>
<xs:element name="CalcPCforIndependentStudent"
type="finaid:YesNoType" minOccurs="0"/>
<xs:element name="StudentAlienRegistrationNoStatus"
type="finaid:YesNoWithBlankType" minOccurs="0"/>
<xs:element name="SSACitizenshipStatusCode"
type="finaid:SSACitStatCodeWithBlankType" minOccurs="0"/>
<xs:element name="HouseholdData"
type="finaid:HouseholdDataType" minOccurs="0"/>
<xs:element name="SubmissionInformation"
type="finaid:SubmissionInformationType" minOccurs="0"/>
<xs:element name="ProcessedApplicationInformation"
type="finaid:ProcessedApplicationInformationType"
minOccurs="0"/>
<xs:element name="ISIRCommentCodes"
type="finaid:ISIRComments" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="HouseholdDataType">
<xs:sequence>
<xs:element name="MembersInFamily"
type="finaid:Integer2DigitsWithBlankType" minOccurs="0"/>
<xs:element name="NumberInCollege"
type="finaid:Integer2DigitsWithBlankType" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="SubmissionInformationType">
<xs:sequence>
<xs:element name="AdditionalStudentData"
type="finaid:AdditionalStudentDataType" minOccurs="0"/>
<xs:element name="ParentData"
type="finaid:ParentDataType" minOccurs="0"/>
<xs:element name="AidAdministratorData"
type="finaid:AidAdministratorDataType" minOccurs="0"/>
<xs:element name="DateApplicationCompleted"
type="finaid:DateBlankType" minOccurs="0"/>
<xs:element name="SignatureSourceCode"
type="finaid:SignatureSourceType" minOccurs="0"/>
<xs:element name="ApplicationReceiptDate"
type="finaid:DateBlankType" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="AdditionalStudentDataType">
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Schema
A-3
<xs:sequence>
<xs:element name="FinancialData"
type="finaid:FinancialDataType" minOccurs="0"/>
<xs:element name="QuestionnaireResponses"
type="finaid:QuestionnaireResponsesType" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="FinancialDataType">
<xs:sequence>
<xs:element name="IncomeData"
type="finaid:IncomeDataType" minOccurs="0"/>
<xs:element name="AssetData" type="finaid:AssetDataType"
minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="IncomeDataType">
<xs:sequence>
<xs:element name="TaxReturnStatusCode"
type="finaid:TaxReturnStatusCodeType" minOccurs="0"/>
<xs:element name="TaxFormTypeCode"
type="finaid:TaxFormTypeCodeType" minOccurs="0"/>
<xs:element name="Form1040AEZEligibleCode"
type="finaid:Form1040AEZEligibleCodeType" minOccurs="0"/>
<xs:element name="AdjustedGrossIncome"
type="finaid:SignedInteger7DigitsWithBlankType" minOccurs="0"/>
<xs:element name="IncomeTaxPaid"
type="finaid:Integer6DigitsWithBlankType" minOccurs="0"/>
<xs:element name="ExemptionsClaimed"
type="finaid:Integer2DigitsWithBlankType" minOccurs="0"/>
<xs:element name="StudentEarnedIncome"
type="finaid:SignedInteger7DigitsWithBlankType" minOccurs="0"/>
<xs:element name="SpouseEarnedIncome"
type="finaid:SignedInteger7DigitsWithBlankType" minOccurs="0"/>
<xs:element name="FathersEarnedIncome"
type="finaid:SignedInteger7DigitsWithBlankType" minOccurs="0"/>
<xs:element name="MothersEarnedIncome"
type="finaid:SignedInteger7DigitsWithBlankType" minOccurs="0"/>
<xs:element name="EducationCredits"
type="finaid:Integer5DigitsWithBlankType" minOccurs="0"/>
<xs:element name="ChildSupportPaid"
type="finaid:Integer5DigitsWithBlankType" minOccurs="0"/>
<xs:element name="NeedBasedEmployment"
type="finaid:Integer5DigitsWithBlankType" minOccurs="0"/>
A-4
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Schema
January 2012
<xs:element name="GrantScholarshipAid"
type="finaid:Integer5DigitsWithBlankType" minOccurs="0"/>
<xs:element name="CombatPay"
type="finaid:Integer5DigitsWithBlankType" minOccurs="0"/>
<xs:element name="CoopEarnings"
type="finaid:Integer5DigitsWithBlankType" minOccurs="0"/>
<xs:element name="PensionPayments"
type="finaid:Integer5DigitsWithBlankType" minOccurs="0"/>
<xs:element name="IRAPayments"
type="finaid:Integer5DigitsWithBlankType" minOccurs="0"/>
<xs:element name="ChildSupportReceived"
type="finaid:Integer5DigitsWithBlankType" minOccurs="0"/>
<xs:element name="InterestIncome"
type="finaid:Integer5DigitsWithBlankType" minOccurs="0"/>
<xs:element name="IRADistributions"
type="finaid:Integer5DigitsWithBlankType" minOccurs="0"/>
<xs:element name="UntaxedPensions"
type="finaid:Integer5DigitsWithBlankType" minOccurs="0"/>
<xs:element name="MilitaryClergyAllowances"
type="finaid:Integer5DigitsWithBlankType" minOccurs="0"/>
<xs:element name="VeteranNonEducationBenefits"
type="finaid:Integer5DigitsWithBlankType" minOccurs="0"/>
<xs:element name="OtherUntaxedIncome"
type="finaid:Integer5DigitsWithBlankType" minOccurs="0"/>
<xs:element name="OtherNonReportedMoneyReceived"
type="finaid:Integer5DigitsWithBlankType" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="AssetDataType">
<xs:sequence>
<xs:element name="CashSavingsChecking"
type="finaid:Integer6DigitsWithBlankType" minOccurs="0"/>
<xs:element name="InvestmentNetWorth"
type="finaid:Integer6DigitsWithBlankType" minOccurs="0"/>
<xs:element name="BusinessFarmNetWorth"
type="finaid:Integer6DigitsWithBlankType" minOccurs="0"/>
<xs:element name="AssetThresholdExceeded"
type="finaid:YesNoWithBlankType" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="QuestionnaireResponsesType">
<xs:sequence>
<xs:element name="HighSchoolDiplomaOrGED"
type="finaid:HighSchoolDiplomaOrGEDType" minOccurs="0"/>
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Schema
A-5
<xs:element name="FirstBachelorsByCutoff"
type="finaid:YesNoBlankType" minOccurs="0"/>
<xs:element name="SSIBenefits"
type="finaid:YesNoBlankType" minOccurs="0"/>
<xs:element name="FoodStamps"
type="finaid:YesNoBlankType" minOccurs="0"/>
<xs:element name="FreeReducedPriceLunch"
type="finaid:YesNoBlankType" minOccurs="0"/>
<xs:element name="TANFBenefits"
type="finaid:YesNoBlankType" minOccurs="0"/>
<xs:element name="WICBenefits"
type="finaid:YesNoBlankType" minOccurs="0"/>
<xs:element name="DislocatedWorker"
type="finaid:YesNoBlankType" minOccurs="0"/>
<xs:element name="DependencyData"
type="finaid:DependencyQuestionnaireResponsesType"
minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="DependencyQuestionnaireResponsesType">
<xs:sequence>
<xs:element name="BornBeforeCutoffIndicator"
type="finaid:YesNoBlankType" minOccurs="0"/>
<xs:element name="MastersOrDoctorateIndicator"
type="finaid:YesNoBlankType" minOccurs="0"/>
<xs:element name="MarriedIndicator"
type="finaid:YesNoBlankType" minOccurs="0"/>
<xs:element name="SupportsChildrenIndicator"
type="finaid:YesNoBlankType" minOccurs="0"/>
<xs:element name="LegalDependentsIndicator"
type="finaid:YesNoBlankType" minOccurs="0"/>
<xs:element name="OrphanWardOfCourtIndicator"
type="finaid:YesNoBlankType" minOccurs="0"/>
<xs:element name="ActiveDutyMilitary"
type="finaid:YesNoBlankType" minOccurs="0"/>
<xs:element name="EmancipatedMinor"
type="finaid:YesNoBlankType" minOccurs="0"/>
<xs:element name="InLegalGuardianship"
type="finaid:YesNoBlankType" minOccurs="0"/>
<xs:element name="HomelessYouthSchool"
type="finaid:YesNoBlankType" minOccurs="0"/>
<xs:element name="HomelessYouthHUD"
type="finaid:YesNoBlankType" minOccurs="0"/>
<xs:element name="HomelessRisk"
type="finaid:YesNoBlankType" minOccurs="0"/>
A-6
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Schema
January 2012
<xs:element name="VeteranIndicator"
type="finaid:YesNoBlankType" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="ParentDataType">
<xs:sequence>
<xs:element name="FatherStepfatherBirthDate"
type="finaid:DateBlankType" minOccurs="0"/>
<xs:element name="FatherStepfatherSSNExists"
type="finaid:SSNExistsType" minOccurs="0"/>
<xs:element name="FatherStepfatherLastNameExists"
type="finaid:NameExistsType" minOccurs="0"/>
<xs:element name="MotherStepmotherBirthDate"
type="finaid:DateBlankType" minOccurs="0"/>
<xs:element name="MotherStepmotherSSNExists"
type="finaid:SSNExistsType" minOccurs="0"/>
<xs:element name="MotherStepmotherLastNameExists"
type="finaid:NameExistsType" minOccurs="0"/>
<xs:element name="MaritalStatusCode"
type="finaid:MaritalStatusCodeType" minOccurs="0"/>
<xs:element name="ResidencyStateProvinceCode"
type="finaid:StateProvinceCodeType" minOccurs="0"/>
<xs:element name="SSIBenefits"
type="finaid:YesNoBlankType" minOccurs="0"/>
<xs:element name="FoodStamps"
type="finaid:YesNoBlankType" minOccurs="0"/>
<xs:element name="FreeReducedPriceLunch"
type="finaid:YesNoBlankType" minOccurs="0"/>
<xs:element name="TANFBenefits"
type="finaid:YesNoBlankType" minOccurs="0"/>
<xs:element name="WICBenefits"
type="finaid:YesNoBlankType" minOccurs="0"/>
<xs:element name="DislocatedWorker"
type="finaid:YesNoBlankType" minOccurs="0"/>
<xs:element name="HouseholdData"
type="finaid:HouseholdDataType" minOccurs="0"/>
<xs:element name="ParentFinancialData"
type="finaid:ParentFinancialDataType" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="AidAdministratorDataType">
<xs:sequence>
<xs:element name="EFCAdjustmentCode"
type="finaid:EFCAdjustmentCodeType" minOccurs="0"/>
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Schema
A-7
<xs:element name="DependencyOverrideCode"
type="finaid:DependencyOverrideCodeType" minOccurs="0"/>
<xs:element name="RejectOverrides"
type="finaid:RejectOverridesType" minOccurs="0"/>
<xs:element name="AssumptionOverrides"
type="finaid:AssumptionOverridesType" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="ParentFinancialDataType">
<xs:sequence>
<xs:element name="IncomeData"
type="finaid:IncomeDataType" minOccurs="0"/>
<xs:element name="AssetData" type="finaid:AssetDataType"
minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="RejectOverridesType">
<xs:sequence>
<xs:element name="RejectOverrideCode"
type="finaid:RejectOverrideCodeType" minOccurs="0"
maxOccurs="18"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="AssumptionOverridesType">
<xs:sequence>
<xs:element name="AssumptionOverrideCode"
type="finaid:AssumptionOverrideCodeType" minOccurs="0"
maxOccurs="6"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="ProcessedApplicationInformationType">
<xs:sequence>
<xs:element name="DependencyStatusCode"
type="finaid:DependencyStatusCodeType" minOccurs="0"/>
<xs:element name="GraduateIndicator"
type="finaid:YesNoBlankType" minOccurs="0"/>
<xs:element name="StudentTaxFilingStatusCode"
type="finaid:TaxFilingStatusCodeType" minOccurs="0"/>
<xs:element name="ParentTaxFilingStatusCode"
type="finaid:TaxFilingStatusCodeType" minOccurs="0"/>
<xs:element name="MotherStepmotherSSNMatch"
type="xs:string" minOccurs="0"/>
<xs:element name="FatherStepfatherSSNMatch"
type="xs:string" minOccurs="0"/>
A-8
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Schema
January 2012
<xs:element name="StudentSSNMatch" type="xs:string"
minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="ISIRComments">
<xs:sequence>
<xs:element name="ISIRCommentCode" type="xs:string"
minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<!-- Output XML elements Definitions -->
<xs:element name="EFCEstimate">
<xs:complexType>
<xs:sequence>
<xs:element name="ResponseHeader">
<xs:complexType>
<xs:sequence>
<xs:element ref="finaid:ExternalRecordID"/>
<xs:element name="Response" type="xs:string"/>
<xs:element name="EFC" type="xs:int"
minOccurs="0"/>
<xs:element name="EFCDate" type="xs:dateTime"
minOccurs="0"/>
<xs:element ref="finaid:EFCDuration"
minOccurs="0"/>
<xs:element name="IsZeroEFC" type="xs:boolean"
minOccurs="0"/>
<xs:element name="FormulaName" minOccurs="0">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="Dependent"/>
<xs:enumeration value="Independent Without
Dependents"/>
<xs:enumeration value="Independent With
Dependents"/>
<xs:enumeration value="Simple Dependent"/>
<xs:enumeration value="Simple Independent
Without Dependents"/>
<xs:enumeration value="Simple Independent
With Dependents"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Schema
A-9
<xs:element name="IsFederal" type="xs:boolean"
minOccurs="0"/>
<xs:element name="Version" type="xs:string"
minOccurs="0"/>
<xs:element name="ProtectionAllowance"
type="finaid:Integer7DigitsType" minOccurs="0"/>
<xs:element name="Age" type="xs:string"
minOccurs="0"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="Assumptions"
type="finaid:AssumptionsType" minOccurs="0"/>
<xs:element name="RejectReasons"
type="finaid:RejectReasonsType" minOccurs="0"/>
<xs:element name="EFCCalculations"
type="finaid:EFCIntermediateValuesType" minOccurs="0"/>
<xs:element name="v4EFCCalculations"
type="finaid:v4EFCIntermediateValuesType" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:complexType name="v4EFCIntermediateValuesType">
<xs:sequence>
<xs:element name="Student"
type="finaid:StudentValuesType" minOccurs="0"/>
<xs:element name="Parent" type="finaid:ParentValuesType"
minOccurs="0"/>
<xs:element name="AlternativeEfcMonth1"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="AlternativeEfcMonth2"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="AlternativeEfcMonth3"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="AlternativeEfcMonth4"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="AlternativeEfcMonth5"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="AlternativeEfcMonth6"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="AlternativeEfcMonth7"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="AlternativeEfcMonth8"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
A-10
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Schema
January 2012
<xs:element name="AlternativeEfcMonth9"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="AlternativeEfcMonth10"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="AlternativeEfcMonth11"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="AlternativeEfcMonth12"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="EFCIntermediateValuesType">
<xs:sequence>
<xs:element name="TotalIncome"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="TotalIncomeAllowances"
type="finaid:Integer7DigitsType" minOccurs="0"/>
<xs:element name="StateTaxAllowance"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="ParentSocialSecurityTax"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="EmploymentAllowance"
type="finaid:Integer7DigitsType" minOccurs="0"/>
<xs:element name="IncomeProtectionAllowance"
type="finaid:Integer7DigitsType" minOccurs="0"/>
<xs:element name="AvailableIncome"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="AvailableIncomeContribution"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="DiscretionaryNetWorth"
type="finaid:SignedInteger9DigitsType" minOccurs="0"/>
<xs:element name="NetWorth"
type="finaid:Integer9DigitsType" minOccurs="0"/>
<xs:element name="AssetProtectionAllowance"
type="finaid:Integer9DigitsType" minOccurs="0"/>
<xs:element name="ParentAssetContribution"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="AdjustedAvailableIncome"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="TotalStudentContribution"
type="finaid:Integer7DigitsType" minOccurs="0"/>
<xs:element name="TotalParentContribution"
type="finaid:Integer7DigitsType" minOccurs="0"/>
<xs:element name="AlternativeTotalParentContribution"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Schema
A-11
<xs:element name="ParentContribution"
type="finaid:Integer7DigitsType" minOccurs="0"/>
<xs:element name="StudentTotalIncome"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="StudentSocialSecurityTax"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="StudentStateTaxAllowance"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="NegativeAdjustableIncomeOffset"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="StudentIncomeAllowances"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="StudentIncomeContribution"
type="finaid:Integer7DigitsType" minOccurs="0"/>
<xs:element name="StudentDiscretionaryNetWorth"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="StudentAssetContribution"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="FISAPTotalIncome"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="NineMonthEFC"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="ParentValuesType">
<xs:sequence>
<xs:element name="TotalIncome"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="StateTaxAllowance"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="IncomeProtectionAllowance"
type="finaid:Integer7DigitsType" minOccurs="0"/>
<xs:element name="EmploymentAllowance"
type="finaid:Integer7DigitsType" minOccurs="0"/>
<xs:element name="TotalIncomeAllowances"
type="finaid:Integer7DigitsType" minOccurs="0"/>
<xs:element name="AvailableIncome"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="NetWorth"
type="finaid:Integer9DigitsType" minOccurs="0"/>
<xs:element name="AssetProtectionAllowance"
type="finaid:Integer9DigitsType" minOccurs="0"/>
<xs:element name="DiscretionaryNetWorth"
type="finaid:SignedInteger9DigitsType" minOccurs="0"/>
A-12
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Schema
January 2012
<xs:element name="ParentAssetContribution"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="AdjustedAvailableIncome"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="TotalParentContribution"
type="finaid:Integer7DigitsType" minOccurs="0"/>
<xs:element name="ParentContribution"
type="finaid:Integer7DigitsType" minOccurs="0"/>
<xs:element name="ParentSocialSecurityTax"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="NegativeAdjustableIncomeOffset"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="AlternativeTotalParentContribution"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="StudentValuesType">
<xs:sequence>
<xs:element name="TotalIncome"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="StateTaxAllowance"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="IncomeProtectionAllowance"
type="finaid:Integer7DigitsType" minOccurs="0"/>
<xs:element name="EmploymentAllowance"
type="finaid:Integer7DigitsType" minOccurs="0"/>
<xs:element name="TotalIncomeAllowances"
type="finaid:Integer7DigitsType" minOccurs="0"/>
<xs:element name="AvailableIncomeContribution"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="AssetProtectionAllowance"
type="finaid:Integer9DigitsType" minOccurs="0"/>
<xs:element name="DiscretionaryNetWorth"
type="finaid:SignedInteger9DigitsType" minOccurs="0"/>
<xs:element name="StudentAssetContribution"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="TotalStudentContribution"
type="finaid:Integer7DigitsType" minOccurs="0"/>
<xs:element name="FISAPTotalIncome"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="AvailableIncome"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="NetWorth"
type="finaid:Integer9DigitsType" minOccurs="0"/>
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Schema
A-13
<xs:element name="StudentSocialSecurityTax"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="StudentTotalIncome"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="StudentStateTaxAllowance"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="StudentDiscretionaryNetWorth"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="StudentIncomeAllowances"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
<xs:element name="StudentIncomeContribution"
type="finaid:Integer7DigitsType" minOccurs="0"/>
<xs:element name="AdjustedAvailableIncome"
type="finaid:SignedInteger7DigitsType" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="RejectReasonsType">
<xs:sequence>
<xs:element name="RejectCode"
type="finaid:RejectCodeType" minOccurs="0" maxOccurs="32"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="AssumptionsType">
<xs:sequence>
<xs:element name="Assumption"
type="finaid:AssumptionType" minOccurs="0"
maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="AssumptionType">
<xs:sequence>
<xs:element name="FieldName" type="finaid:FieldNameType"/
>
<xs:element name="FieldValue"
type="finaid:FieldValueType"/>
</xs:sequence>
</xs:complexType>
<!-- Simple Types-->
<xs:simpleType name="AwardYearType">
<xs:restriction base="xs:int"/>
</xs:simpleType>
<xs:element name="EFCDuration">
A-14
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Schema
January 2012
<xs:simpleType>
<xs:restriction base="xs:byte">
<xs:minInclusive value="0"/>
<xs:maxInclusive value="12"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:simpleType name="YesNoType">
<xs:restriction base="xs:string">
<xs:enumeration value="Y"/>
<xs:enumeration value="N"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="YesNoWithBlankType">
<xs:restriction base="xs:string">
<xs:enumeration value="Y"/>
<xs:enumeration value="N"/>
<xs:enumeration value=""/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="CitizenshipStatusCodeType">
<xs:restriction base="xs:string">
<xs:enumeration value=""/>
<xs:enumeration value="1"/>
<xs:enumeration value="2"/>
<xs:enumeration value="3"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="StudentMaritalStatusCodeType">
<xs:restriction base="xs:string">
<xs:enumeration value="1"/>
<xs:enumeration value="2"/>
<xs:enumeration value="3"/>
<xs:enumeration value="4"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="MaritalStatusCodeType">
<xs:restriction base="xs:string">
<xs:enumeration value="1"/>
<xs:enumeration value="2"/>
<xs:enumeration value="3"/>
<xs:enumeration value="4"/>
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Schema
A-15
<xs:enumeration value=""/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="TaxReturnStatusCodeType">
<xs:restriction base="xs:string">
<xs:enumeration value=""/>
<xs:enumeration value="1"/>
<xs:enumeration value="2"/>
<xs:enumeration value="3"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="TaxFormTypeCodeType">
<xs:restriction base="xs:string">
<xs:enumeration value=""/>
<xs:enumeration value="1"/>
<xs:enumeration value="2"/>
<xs:enumeration value="3"/>
<xs:enumeration value="4"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="Form1040AEZEligibleCodeType">
<xs:restriction base="xs:string">
<xs:enumeration value=""/>
<xs:enumeration value="1"/>
<xs:enumeration value="2"/>
<xs:enumeration value="3"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="HighSchoolDiplomaOrGEDType">
<xs:restriction base="xs:string">
<xs:enumeration value="1"/>
<xs:enumeration value="2"/>
<xs:enumeration value="3"/>
<xs:enumeration value="4"/>
<xs:enumeration value=""/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="DependencyOverrideCodeType">
<xs:restriction base="xs:string">
<xs:enumeration value="Requested"/>
<xs:enumeration value="Cancelled"/>
<xs:enumeration value="Failed"/>
A-16
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Schema
January 2012
<xs:enumeration value="Processed"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="EFCAdjustmentCodeType">
<xs:restriction base="xs:string">
<xs:enumeration value="Processed"/>
<xs:enumeration value="Failed"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="RejectOverrideCodeType">
<xs:restriction base="xs:string">
<xs:enumeration value="A"/>
<xs:enumeration value="B"/>
<xs:enumeration value="C"/>
<xs:enumeration value="G"/>
<xs:enumeration value="N"/>
<xs:enumeration value="W"/>
<xs:enumeration value="3"/>
<xs:enumeration value="4"/>
<xs:enumeration value="12"/>
<xs:enumeration value="20"/>
<xs:enumeration value="21"/>
<xs:enumeration value="J"/>
<xs:enumeration value="K"/>
<xs:enumeration value="D"/>
<xs:enumeration value="E"/>
<xs:enumeration value="F"/>
<xs:enumeration value="R"/>
<xs:enumeration value="S"/>
<xs:enumeration value="T"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="AssumptionOverrideCodeType">
<xs:restriction base="xs:string">
<xs:enumeration value="1"/>
<xs:enumeration value="2"/>
<xs:enumeration value="3"/>
<xs:enumeration value="4"/>
<xs:enumeration value="5"/>
<xs:enumeration value="6"/>
</xs:restriction>
</xs:simpleType>
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Schema
A-17
<xs:simpleType name="SignatureSourceType">
<xs:restriction base="xs:string">
<xs:enumeration value="ApplicantOnly"/>
<xs:enumeration value="ApplicantAndParent"/>
<xs:enumeration value="ParentOnly"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="DependencyStatusCodeType">
<xs:restriction base="xs:string">
<xs:enumeration value="Dependent"/>
<xs:enumeration value="Independent"/>
<xs:enumeration value="DependentNoEFC"/>
<xs:enumeration value="IndependentNoEFC"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="SSNExistsType">
<xs:restriction base="xs:string">
<xs:enumeration value="E"/>
<xs:enumeration value="B"/>
<xs:enumeration value="0"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="NameExistsType">
<xs:restriction base="xs:string">
<xs:enumeration value="E"/>
<xs:enumeration value="B"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="StateProvinceCodeType">
<xs:restriction base="xs:token">
<xs:enumeration value="AA">
<xs:annotation>
<xs:documentation>MILITARY-AMERICAS</
xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="AB">
<xs:annotation>
<xs:documentation>ALBERTA</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="AE">
A-18
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Schema
January 2012
<xs:annotation>
<xs:documentation>MILITARY-EUROPE</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="AK">
<xs:annotation>
<xs:documentation>ALASKA</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="AL">
<xs:annotation>
<xs:documentation>ALABAMA</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="AP">
<xs:annotation>
<xs:documentation>MILITARY-PACIFIC</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="AR">
<xs:annotation>
<xs:documentation>ARKANSAS</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="AS">
<xs:annotation>
<xs:documentation>AMERICAN SAMOA</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="AZ">
<xs:annotation>
<xs:documentation>ARIZONA</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="BC">
<xs:annotation>
<xs:documentation>BRITISH COLUMBIA</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="CA">
<xs:annotation>
<xs:documentation>CALIFORNIA</xs:documentation>
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Schema
A-19
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="CO">
<xs:annotation>
<xs:documentation>COLORADO</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="CT">
<xs:annotation>
<xs:documentation>CONNECTICUT</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="CZ">
<xs:annotation>
<xs:documentation>CANAL ZONE</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="DC">
<xs:annotation>
<xs:documentation>DISTRICT OF COLUMBIA</
xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="DE">
<xs:annotation>
<xs:documentation>DELAWARE</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="FL">
<xs:annotation>
<xs:documentation>FLORIDA</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="FM">
<xs:annotation>
<xs:documentation>FEDERATED STATES OF MICRONESIA</
xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="GA">
<xs:annotation>
<xs:documentation>GEORGIA</xs:documentation>
A-20
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Schema
January 2012
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="GU">
<xs:annotation>
<xs:documentation>GUAM</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="HI">
<xs:annotation>
<xs:documentation>HAWAII</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="IA">
<xs:annotation>
<xs:documentation>IOWA</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="ID">
<xs:annotation>
<xs:documentation>IDAHO</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="IL">
<xs:annotation>
<xs:documentation>ILLINOIS</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="IN">
<xs:annotation>
<xs:documentation>INDIANA</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="KS">
<xs:annotation>
<xs:documentation>KANSAS</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="KY">
<xs:annotation>
<xs:documentation>KENTUCKY</xs:documentation>
</xs:annotation>
</xs:enumeration>
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Schema
A-21
<xs:enumeration value="LA">
<xs:annotation>
<xs:documentation>LOUISIANA</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="MA">
<xs:annotation>
<xs:documentation>MASSACHUSETTS</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="MB">
<xs:annotation>
<xs:documentation>MANITOBA</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="MD">
<xs:annotation>
<xs:documentation>MARYLAND</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="ME">
<xs:annotation>
<xs:documentation>MAINE</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="MH">
<xs:annotation>
<xs:documentation>MARSHALL ISLANDS</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="MI">
<xs:annotation>
<xs:documentation>MICHIGAN</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="MN">
<xs:annotation>
<xs:documentation>MINNESOTA</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="MO">
<xs:annotation>
A-22
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Schema
January 2012
<xs:documentation>MISSOURI</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="MP">
<xs:annotation>
<xs:documentation>NORTHERN MARIANA ISLANDS</
xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="MS">
<xs:annotation>
<xs:documentation>MISSISSIPPI</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="MT">
<xs:annotation>
<xs:documentation>MONTANA</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="NB">
<xs:annotation>
<xs:documentation>NEW BRUNSWICK</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="NC">
<xs:annotation>
<xs:documentation>NORTH CAROLINA</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="ND">
<xs:annotation>
<xs:documentation>NORTH DAKOTA</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="NE">
<xs:annotation>
<xs:documentation>NEBRASKA</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="NF">
<xs:annotation>
<xs:documentation>NEWFOUNDLAND</xs:documentation>
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Schema
A-23
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="NH">
<xs:annotation>
<xs:documentation>NEW HAMPSHIRE</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="NJ">
<xs:annotation>
<xs:documentation>NEW JERSEY</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="NL">
<xs:annotation>
<xs:documentation>NEWFOUNDLAND AND LABRADOR</
xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="NM">
<xs:annotation>
<xs:documentation>NEW MEXICO</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="NS">
<xs:annotation>
<xs:documentation>NOVA SCOTIA</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="NT">
<xs:annotation>
<xs:documentation>NORTHWEST TERRITORIES</
xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="NU">
<xs:annotation>
<xs:documentation>NUNAVUT</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="NV">
<xs:annotation>
<xs:documentation>NEVADA</xs:documentation>
A-24
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Schema
January 2012
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="NY">
<xs:annotation>
<xs:documentation>NEW YORK</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="OH">
<xs:annotation>
<xs:documentation>OHIO</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="OK">
<xs:annotation>
<xs:documentation>OKLAHOMA</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="ON">
<xs:annotation>
<xs:documentation>ONTARIO</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="OR">
<xs:annotation>
<xs:documentation>OREGON</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="PA">
<xs:annotation>
<xs:documentation>PENNSYLVANIA</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="PE">
<xs:annotation>
<xs:documentation>PRINCE EDWARD ISLAND</
xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="PR">
<xs:annotation>
<xs:documentation>PUERTO RICO</xs:documentation>
</xs:annotation>
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Schema
A-25
</xs:enumeration>
<xs:enumeration value="PW">
<xs:annotation>
<xs:documentation>REPUBLIC OF PALAU</
xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="QC">
<xs:annotation>
<xs:documentation>QUEBEC</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="RI">
<xs:annotation>
<xs:documentation>RHODE ISLAND</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="SC">
<xs:annotation>
<xs:documentation>SOUTH CAROLINA</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="SD">
<xs:annotation>
<xs:documentation>SOUTH DAKOTA</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="SK">
<xs:annotation>
<xs:documentation>SASKATCHEWAN</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="TN">
<xs:annotation>
<xs:documentation>TENNESSEE</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="TX">
<xs:annotation>
<xs:documentation>TEXAS</xs:documentation>
</xs:annotation>
</xs:enumeration>
A-26
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Schema
January 2012
<xs:enumeration value="UT">
<xs:annotation>
<xs:documentation>UTAH</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="VA">
<xs:annotation>
<xs:documentation>VIRGINIA</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="VI">
<xs:annotation>
<xs:documentation>VIRGIN ISLANDS</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="VT">
<xs:annotation>
<xs:documentation>VERMONT</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="WA">
<xs:annotation>
<xs:documentation>WASHINGTON</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="WI">
<xs:annotation>
<xs:documentation>WISCONSIN</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="WV">
<xs:annotation>
<xs:documentation>WEST VIRGINIA</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="WY">
<xs:annotation>
<xs:documentation>WYOMING</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="YT">
<xs:annotation>
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Schema
A-27
<xs:documentation>YUKON</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="CN"/>
<xs:enumeration value="FC"/>
<xs:enumeration value="PQ"/>
<xs:enumeration value="MX"/>
<xs:enumeration value=""/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="TaxFilingStatusCodeType">
<xs:restriction base="xs:string">
<xs:enumeration value="TaxFiler"/>
<xs:enumeration value="NonTaxFiler"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="BlankType">
<xs:restriction base="xs:string">
<xs:enumeration value=""/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="Integer1DigitType">
<xs:restriction base="xs:integer">
<xs:minInclusive value="0"/>
<xs:maxInclusive value="9"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="Integer1DigitWithBlankType">
<xs:union memberTypes="finaid:Integer1DigitType
finaid:BlankType"/>
</xs:simpleType>
<xs:simpleType name="Integer2DigitsType">
<xs:restriction base="xs:integer">
<xs:minInclusive value="0"/>
<xs:maxInclusive value="99"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="Integer2DigitsWithBlankType">
<xs:union memberTypes="finaid:Integer2DigitsType
finaid:BlankType"/>
</xs:simpleType>
A-28
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Schema
January 2012
<xs:simpleType name="Integer5DigitsType">
<xs:restriction base="xs:decimal">
<xs:minInclusive value="0"/>
<xs:maxInclusive value="99999"/>
<xs:fractionDigits value="0"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="Integer5DigitsWithBlankType">
<xs:union memberTypes="finaid:Integer5DigitsType
finaid:BlankType"/>
</xs:simpleType>
<xs:simpleType name="Integer6DigitsType">
<xs:restriction base="xs:integer">
<xs:minInclusive value="0"/>
<xs:maxInclusive value="999999"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="Integer6DigitsWithBlankType">
<xs:union memberTypes="finaid:Integer6DigitsType
finaid:BlankType"/>
</xs:simpleType>
<xs:simpleType name="SignedInteger6DigitsType">
<xs:restriction base="xs:decimal">
<xs:minInclusive value="-999999"/>
<xs:maxInclusive value="999999"/>
<xs:fractionDigits value="0"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="SignedInteger6DigitsWithBlankType">
<xs:union memberTypes="finaid:SignedInteger6DigitsType
finaid:BlankType"/>
</xs:simpleType>
<xs:simpleType name="SignedInteger7DigitsWithBlankType">
<xs:union memberTypes="finaid:SignedInteger7DigitsType
finaid:BlankType"/>
</xs:simpleType>
<xs:simpleType name="Integer7DigitsType">
<xs:restriction base="xs:decimal">
<xs:minInclusive value="0"/>
<xs:maxInclusive value="9999999"/>
<xs:fractionDigits value="0"/>
</xs:restriction>
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Schema
A-29
</xs:simpleType>
<xs:simpleType name="SignedInteger7DigitsType">
<xs:restriction base="xs:decimal">
<xs:minInclusive value="-9999999"/>
<xs:maxInclusive value="9999999"/>
<xs:fractionDigits value="0"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="Integer9DigitsType">
<xs:restriction base="xs:decimal">
<xs:minInclusive value="0"/>
<xs:maxInclusive value="999999999"/>
<xs:fractionDigits value="0"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="SignedInteger9DigitsType">
<xs:restriction base="xs:decimal">
<xs:minInclusive value="-999999999"/>
<xs:maxInclusive value="999999999"/>
<xs:fractionDigits value="0"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="YesNoBlankType">
<xs:union memberTypes="xs:boolean finaid:BlankType"/>
</xs:simpleType>
<xs:simpleType name="RejectCodeType">
<xs:restriction base="xs:string">
<xs:enumeration value="1"/>
<xs:enumeration value="2"/>
<xs:enumeration value="3"/>
<xs:enumeration value="4"/>
<xs:enumeration value="5"/>
<xs:enumeration value="6"/>
<xs:enumeration value="7"/>
<xs:enumeration value="8"/>
<xs:enumeration value="9"/>
<xs:enumeration value="10"/>
<xs:enumeration value="11"/>
<xs:enumeration value="12"/>
<xs:enumeration value="13"/>
<xs:enumeration value="14"/>
<xs:enumeration value="15"/>
A-30
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Schema
January 2012
<xs:enumeration value="17"/>
<xs:enumeration value="18"/>
<xs:enumeration value="20"/>
<xs:enumeration value="A"/>
<xs:enumeration value="B"/>
<xs:enumeration value="C"/>
<xs:enumeration value="D"/>
<xs:enumeration value="E"/>
<xs:enumeration value="F"/>
<xs:enumeration value="G"/>
<xs:enumeration value="J"/>
<xs:enumeration value="K"/>
<xs:enumeration value="N"/>
<xs:enumeration value="R"/>
<xs:enumeration value="S"/>
<xs:enumeration value="T"/>
<xs:enumeration value="W"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="FieldNameType">
<xs:restriction base="xs:string">
<xs:maxLength value="50"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="FieldValueType">
<xs:restriction base="xs:string">
<xs:maxLength value="50"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="DateBlankType">
<xs:union memberTypes="xs:date finaid:BlankType"/>
</xs:simpleType>
<xs:simpleType name="SSACitStatCode">
<xs:restriction base="xs:string">
<xs:minLength value="0"/>
<xs:maxLength value="1"/>
</xs:restriction>
</xs:simpleType>
<xs:simpleType name="SSACitStatCodeWithBlankType">
January 2012
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Schema
A-31
<xs:union memberTypes="finaid:SSACitStatCode
finaid:BlankType "/>
</xs:simpleType>
</xs:schema>
A-32
Banner Financial Aid
Hosted Services Handbook
FM Need Analysis Schema
January 2012
B
Enabling Secure
Sockets Layer (SSL)
Communication
The Oracle Application Server Administrator’s Guide provides recommendations and
instructions for enabling secure communications throughout the Oracle Application
Server (OAS) components. A typical application server deployment may consist of:
1. Network Load Balancer hardware which is used to route HTTP traffic to one or more
Oracle Application Server installations.
2. The Oracle HTTP Server component which is used to serve static HTML resources
and dynamic web applications using the mod_plsql module which is used by the
Banner Self-Service web applications.
3. Java Web containers which support deployment of system Java web applications.
Both the Oracle Containers for Java (OC4J) and Oracle Weblogic are web application
servers supported by Oracle Application Server.
An institution may choose to enable Secure Sockets Layer (SSL) communication in one or
more of the components listed above.
Please review the Oracle Application Server Administrator’s Guide, Part IV, Secure
Sockets Layer on how to enable SSL in one or more Oracle Application Server
components.
Recommendations for securing
applications in Oracle Application Server
Recommendation #1:
Enable SSL at the Network Load Balancer (NLB) hardware to support SSL
communications between the web browser and the NLB. SSL is terminated at the NLB
hardware and HTTP communication is continued to one or more Oracle Application
Server instances. This configuration can securely support a network configuration where a
Network Firewall resides between the NLB and OAS servers.
January 2012
Banner Financial Aid
Hosted Services Handbook
Enabling Secure Sockets Layer (SSL) Communication
B-1
Recommendation #2:
Enable SSL in the Oracle HTTP Server component. This allows SSL to be configured
once, at this component, and allows Oracle HTTP Server to route requests to one or more
Weblogic or OC4J web containers. This configuration supports a secure environment for
HTTPS communication between a web browser and the Oracle HTTP Server component.
SSL is terminated at the Oracle HTTP Server component and requests are either serviced
by this component or routed to one of more Java web containers. Because the Oracle
HTTP Server and Java web container are deployed on the same machine, SSL
communication is not required to be enabled in the Java Web container.
Institutions may follow either recommendation or use a combination of both.
Note
It is not recommended that SSL in the Weblogic or OC4J embedded
HTTP servers be enabled because this requires additional maintenance
to configure SSL and allows access to new HTTP ports. This
configuration typically requires additional firewall rule exceptions to allow
access. System Java web applications may be deployed in multiple
Weblogic or OC4J servers and each would carry the burden of

configuring SSL for each installation.
For additional information, please point your browser to the Ellucian Customer Support
Center page (http://crm.sungardhe.com/customer_support/) to review the following FAQ:
• 1-DTOVYK - How to configure SSL for INB & SSB under Oracle Fusion
Middleware 11g
Recommendations for enabling SSL in a
test environment
It is recommended that you enable SSL in the Oracle HTTP Server component to support
a testing environment. For production environments, Oracle and Ellucian recommend
customers obtain a Digital Certificate issued by a well known and reputable certification
authority. This allows trusted communication via HTTPS by many programs that know
and trust the chosen authority.
For test environments, customers may choose to create their own self-signed certificate
which is used only for testing purposes. Web browsers and other programs will not trust
this self-signed certificate and generate the appropriate warning messages, indicating that
the certificate is not signed by a well known and reputable certification authority.
B-2
Banner Financial Aid
Hosted Services Handbook
Enabling Secure Sockets Layer (SSL) Communication
January 2012
For additional information, please point your browser to the Ellucian Customer Support
Center page (http://crm.sungardhe.com/customer_support/) to review the following FAQ:
1-B8E7LJ - How To Generate A Wallet Containing A Self Signed Certificate Using
ORAPKI
Warning
This self-signed certificate should be used for testing purposes only with

Oracle Application Server
Configuring the Oracle Application Server to trust a
customer generated self-signed certificate
When a customer creates a self-signed certificate and enables SSL in the Oracle HTTP
Server component, web browsers will display a warning message that this website is not
trusted. This is because the certificate was not signed by a well know and reputable
certification authority.
System Java applications deployed in OAS can be configured to communicate to other
related system applications via HTTPS. The Java environment that is installed with OAS
will generate the following error (as the certificate is not trusted):
javax.net.ssl.SSLException: SSL handshake failed
The institution can modify the OAS test Java environment by importing the self-signed
certificate as a trusted certificate into the Java trusted certificate authority key store file.
This is located in:
$ORACLE_HOME/jdk/jre/lib/security/cacerts
The following command is used to import a self-signed certificate which will be trusted by
the Java environment and allow HTTPS communication:
$keytool –import –trustcacerts –alias “pickAnAliasName” –file
“pathOfSelfSignedCert” –keystore $ORACLE_HOME/jdk/jre/lib/
security/cacerts
This will allow system Java applications, such as Cascade, to communicate to other
system web applications via HTTPS and not encounter this error because the Java
environment will trust this certificate to support HTTPS communication.
January 2012
Banner Financial Aid
Hosted Services Handbook
Enabling Secure Sockets Layer (SSL) Communication
B-3
B-4
Banner Financial Aid
Hosted Services Handbook
Enabling Secure Sockets Layer (SSL) Communication
January 2012
Index
A
E
Alternative Install to Full iAS 10.1.3.x 2-35,
3-41
Enabling Secure Socket Layer (SSL)
Communication B-1
B
F
Banner
Internet Native (INB) 2-12, 3-12
Banner Financial Aid Hosted Services 1-1
banproxy
Configure 2-12, 3-12
FAQs 2-59, 3-74
FM Need Analysis 2-59, 3-74
WebLogic 2-66, 3-81
finaiddbseed.jar
Updating 2-11, 3-11
finaidfmlogin.jar
Updating 2-10, 3-10
finaidutils.jar
Installing 2-13, 3-13
Missing 2-56, 3-71
FM Need Analysis
FAQs 2-59, 3-74
Off-Premise Configuration 2-1
On-Premise Configuration 3-1
Schema A-1
C
Certification
Windows Server Platform 2-56
Windows Server Platform (On-Premise
Only) 3-62
Certification path 2-58
Checklists
Off-Premise Configuration 2-7
On-Premise Configuration 3-7
Configuration
FM Need Analysis Off-Premise 2-1
FM Need Analysis On-Premise 3-1
WebLogic 2-37, 3-43
Configure
banproxy 2-12, 3-12
Configure Servlet for SSL 2-31, 3-39
Connection Pool and Data Source for
RNPFMXX
Creating 2-20, 3-20
Connection timed out 2-56, 3-72
Creating
Connection Pool and Data Source for
RNPFMXX 2-20, 3-20
Creating the rnpfmxx OC4J Instance 2-14,
3-14
January 2012
H
Hosted Services
Banner Financial Aid 1-1
I
iAS 10.1.3.x
Alternative Install to Full 2-35, 3-41
iAS 10.1.3.x OC4J 2-14, 3-14
IIS 6.0
Windows Server 2003 3-23
IIS 7.0
Windows Server 2008 3-27
INB
Internet Native Banner 2-12, 3-12
Installation of servlet on WebLogic (optional)
2-37, 3-43
Banner Financial Aid
Hosted Services Handbook
Index
I-1
Installing
finaidutils.jar 2-13, 3-13
Servlet 2-17, 3-17
Share Library 2-16, 3-16
Internet Native Banner (INB) 2-12, 3-12
Introduction
Off-Premise 2-1
On-Premise 3-1
Checklists 3-7
Options 3-4
On-Premise Introduction 3-1
optional installation
servlet on WebLogic 2-37, 3-43
Options
Off-Premise Configuration 2-4
On-Premise Configuration 3-4
L
P
Loading Certificate to JVM for RNPFM12 or
RNPFM13
Off-Premise 2-23
On-Premise 3-31
Plus one (+1) URL
Redirecting INB (Off-Premise Only) 2-32,
3-41
Proxy not authorized 2-57, 3-72
Proxy Settings 2-26, 3-34
OC4J 2-28, 3-35
WebLogic 2-29, 3-37
Proxy settings
for process rnpfm12.jar 2-26, 3-34
for servlet rnpfmxx.war 2-28, 3-35
M
Missing finaidutils.jar 2-56, 3-71
N
not authorized
Proxy 2-57, 3-72
O
OC4J
Proxy Settings 2-28, 3-35
OC4J of iAS 10.1.3.x 2-2, 3-2
Off-Premise 2-2
Loading Certificate to JVM for RNPFM12
or RNPFM13 2-23
Object List 2-3
Procedures 2-10
Requirements 2-2
Off-Premise Configuration
Checklists 2-7
Options 2-4
Off-Premise Introduction 2-1
On-Premise 3-2, 3-23
Loading Certificate to JVM for RNPFM12
or RNPFM13 3-31
Object List 3-3
Procedures 3-10
Requirements 3-2
On-Premise Configuration
I-2
Banner Financial Aid
Hosted Services Handbook
Index
R
Redeploy
Servlet 2-25, 3-32
Redeploying the servlet rnpfmxx.war 2-9, 3-9
Redirecting INB to the Plus one (+1) URL
(Off-Premise Only) 2-32, 3-41
Requirements
Off-Premise 2-2
On-Premise 3-2
rnpfm12.jar
Proxy settings for process 2-26, 3-34
rnpfmxx.war
Proxy settings for servlet 2-28, 3-35
Redeploying the servlet 2-9, 3-9
Unable to connect to servlet 2-56, 3-71
S
Schema
FM Need Analysis A-1
Secure Socket Layer (SSL) Communication
Enabling B-1
Servlet
Configure for SSL 2-31, 3-39
January 2012
Installing 2-17, 3-17
Redeploy 2-25, 3-32
servlet installation
WebLogic (optional) 2-37, 3-43
Settings
Proxy 2-26, 3-34
Share Library
Installing 2-16, 3-16
SSL
Configure Servlet for 2-31, 3-39
T
timed out
Connection 2-56, 3-72
Troubleshooting 2-56, 3-71
U
Unable to connect to servlet rnpfmxx.war
2-56, 3-71
Unauthorized 2-58, 3-73
Updating
finaiddbseed.jar 2-11, 3-11
finaidfmlogin.jar 2-10, 3-10
W
WebLogic
Configuration 2-37, 3-43
FAQs 2-66, 3-81
Proxy Settings 2-29, 3-37
Windows Server 2003
IIS 6.0 3-23
Windows Server 2008
IIS 7.0 3-27
Windows Server Platform Certification 2-56
Windows Server Platform Certification (OnPremise Only) 3-62
January 2012
Banner Financial Aid
Hosted Services Handbook
Index
I-3
4375 Fair Lakes Court
Fairfax, Virginia 22033
United States of America
www.ellucian.com
Download PDF
Similar pages