Banner Translation

Service Installation and

Administration Guide
Release
8.1.4
January
2014
Banner®, Colleague®, PowerCampus™, and Luminis® are trademarks of Ellucian Company L.P. or its affiliates
and are registered in the U.S. and other countries. Ellucian®, Ellucian Advance™, Ellucian Degree Works™,
Ellucian Course Signals™, Ellucian SmartCall™, and Ellucian Recruiter™ are trademarks of Ellucian Company
L.P. or its affiliates. Other names may be trademarks of their respective owners.

©2008-2014 Ellucian Company L.P. and its affiliates.

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 guarantee 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 2014 New version that supports Banner Translation Service 8.1.4 software.
Banner Translation Service
8.1.4 Installation and
Administration Guide

Contents

Chapter 1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5 Interfaces .

. . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . 5

Database . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . 5 Chapter 2

Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . .7

Requirements . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . 7

Recommended configuration . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . 7

Installation steps . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . 8
Step 1 Extract the zip file. . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . 8 Step 2
Configure the database user . . . . . . . . . . . . .
. . . . . . . . . . . . . 8 Step 3 Configure the
database tables . . . . . . . . . . . . . . . . .
. . . . . . . . 9 Step 4 Configure logging (optional). .
. . . . . . . . . . . . . . . . . . . . . . .
. . 10 Step 5 Create a Managed Server. . . . . . . . .
. . . . . . . . . . . . . . . . . . . 10 Step 6
 Create a JAAS configuration file . . . . . . . . . . .
. . . . . . . . . . . . . 11 Step 7 Configure the
Managed Server to use the authentication provider. . . . .
11 Step 8 Restart the Managed Server . . . . . . . . . .
. . . . . . . . . . . . . . . . 14 Step 9 Define the
data source. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . 17 Step 10 Install the Banner
Translation Service . . . . . . . . . . . . . . . .
. . . . 24 Step 11 Configure the security group and user . .
. . . . . . . . . . . . . . . . . . 29 Step 12
Populate the Banner Translation Service . . . . . . . .
. . . . . . . . . . 35

Chapter 3 Administration. . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37 Terminology . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . 37

Access the Web console. . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . 38

January 2014 Banner Translation Service

8.1.4 3 Installation and Administration Guide
Contents
Manage data translations . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . 38 Import

enterprise fields. . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . 38 Export

enterprise fields. . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . 40 List

enterprise fields . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . 41 Add an

enterprise field . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . 42 Add an

enterprise field value . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . 44 Add a field

translation . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . 46 Delete an

enterprise field value . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . 48 Delete a field

translation . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . 49 Disable and enable a

field translation . . . . . . . . . . . . . . . . .

. . . . . . . . 50

Process translation requests via a Web service. . . . . . . .

. . . . . . . . . . 52

Test data translations. . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . 52 Steps to

test data translations . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . 53 Required parameters

. . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . 54 Example . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . 55